...
| Table of Contents | ||
|---|---|---|
|
一般的な構造
システムにYellowfinをインストールすると、インスタンス上にapplication/programフォルダーが作成されます。こちらのページでは、フォルダー内に配置される主なファイルやフォルダーについて紹介します。
| ディレクトリパス、またはファイル | 説明 |
| appserver | このフォルダーには、Apache Tomcat Javaアプリケーションサーバのバイナリ、スクリプト、構成ファイルが含まれます。 |
| appserver > bin | Yellowfin/Tomcatの起動、終了スクリプトです。 |
| appserver > conf | server.xmlを含むTomcatの構成ファイルです。 |
| appserver > logs | YellowfinとTomcatのログファイルです。 |
| appserver > webapps > ROOT | Yellowfin webアプリケーションサーバのバイナリ、スクリプト、構成ファイルです。 |
| data | Yellowfinシステム構成データベースプロパティのデフォルトとスクリプトファイルです。 |
| development | Yellowfinの開発ライブラリー、ドキュメント、サンプルコードです。 |
| development > doc > webservices > javadoc | Yellowfin webサービスのドキュメントです。 |
| doc | 空のフォルダー |
| legal | このフォルダーには、Yellowfinとサードパーティライセンスの使用許諾契約書と注釈が含まれます。 |
| tutorialdata | Ski Teamチュートリアルデータベースファイルです。 |
| Uninstaller | システムからYellowfinをアンインストールするためのプログラムです。 |
| yellowfin.war | Apache Tomcat Javaアプリケーションサーバが使用するYellowfin webアプリケーションのアーカイブです。 |
| YellowfinInstallLog-YYYYMMDD.log | Yellowfinのインストーラーにより作成されるログファイルです。 |
ROOTディレクトリ
appserver > webappsに含まれるROOTフォルダーにも、ウェブアプリケーションの主要なスクリプトやファイルが含まれています。
| ディレクトリパス、またはファイル | 説明 |
| ROOT > customcss | カスタマイズしたcssファイルは、こちらのディレクトリに配置します。このディレクトリに配置されたcss形式のファイルはすべてのページに含まれることになります。 |
| ROOT > customimages | カスタマイズしたイメージファイルは、こちらのディレクトリに配置します。このディレクトリに配置されたファイルは、イメージディレクトリにある同一名のファイルを上書きます。 |
| ROOT > js > chartingLibraries | JavaScriptグラフライブラリーをこちらへ追加することができます。 |
| ROOT > WEB-INF > custom-functions.xml | こちらのファイルに、カスタムSQL機能を追加することができます。 |
| ROOT > WEB-INF > lib | JDBCドライバーをこちらへ追加することができます。 |
| ROOT > WEB-INF > log4j.properties | Yellowfinのログレベルは、こちらのファイルで設定します。 |
| ROOT > WEB-INF > web.xml | Yellowfinウェブアプケーションの主要な構成ファイルです。 |
ログ取得の仕組み
YellowfinやTomcatのログファイルは、トラブルシューティングや、現在の実行状況を把握する際に非常に有益です。
ログファイル（デフォルトオプション）の一覧は以下の通りです。
| ログ名 | ディレクトリパス | 説明 |
YellowfinInstallLog-XXXX.log （XXXXはインストールを実行した日付です） | Yellowfin applicationフォルダー内のディレクトリ | インストールログファイルで、選択したすべてのインストールオプションと、インストール中に発生しエラーが含まれています。 |
YellowfinPatchLog-XXXX.log （XXXXは更新を実行した日付です） | 更新インストールログファイルで、更新情報（データベースの更新、など）や発生したエラーが含まれます。更新を実行する度に、個別のログファイルが生成されます。 | |
| Yellowfin.log | appserver > logs | Yellowfinのアプリケーションログで、開始やレポートの実行、アイテムのエクスポートなど、Yellowfinで実行されるプロセスやタスクを記録します。また、主要なアプリケーションエラーも含みます。 このファイルはデフォルトで、1024KBに達すると繰り返され、最大9ファイルを作成します。例：Yellowfin.log.1、Yellowfin.log.2 etc.. デバッグロギングを有効にすることで、追加情報を取得することもできます。 |
| JDBC.log | appserver > logs | Yellowfinシステム構成データベースログファイルです。これは、リポジトルデータベースの開始や、接続エラーを表示します。 |
source.XXXX.log （XXXXはデータソースのIDです） | appserver > logs | データソースに特異な接続情報を含みます。各データソースには独自のIDがあるため、それぞれにログファイルが存在します。データソースを削除してもログファイルは削除されないため、手動で削除する必要があります。 |
catalina.XXXX.log （XXXXはTomcatが開始された日付です） | appserver > logs | Tomcatの開始ログで、サービス起動中に発生したエラーを含みます。 |
stdout_XXXX.log （XXXXはYellowfinが開始された日付です） | appserver > logs | 注意：このファイルは、YellowfinをWindowsサービスとしてインストールした場合にのみ生成されます。 コンソールログ（Yellowfinを起動すると開く黒いウィンドウ）に表示される情報を含みます。 |
jakarta_service_XXXX.log （XXXXはYellowfinが開始された日付です） | appserver > logs | 注意：このファイルは、YellowfinをWindowsサービスとしてインストールした場合にのみ生成されます。 実際のWindowsサービス起動に関する情報を含みます。 |
| Catalina.out | appserver > logs | 注意：このファイルは、YellowfinをMac (OS X)、またはLinux boxにインストールした場合にのみ生成されますが、「Startup (Terminal)」オプションを開始て実行している場合は、すべての情報がコンソールに記録されるため利用することができません（Windows boxに表示されるように）。 Yellowfinアプリケーションプロセスに関連する情報が含まれ、すべてのエラーやプロセスを記録します。 |
stderr_XXXX.log （XXXXはYellowfinが開始された日付です） | appserver > logs | 注意：このファイルは、YellowfinをWindowsサービスとしてインストールした場合にのみ生成されます。 stdoutファイルと同様のエラーを記録しますが、他のプロセスは一切含みません。 |
ログファイルの編集
Yellowfin/appserver/webapps/ROOT/WEB-INFディレクトリに配置されている、lof4j.propertiesファイルを編集することで、記録するログの種類や長さを変更することができます。
| Tip |
|---|
ファイルを編集する前には、このファイルのバックアップを取得し、別の場所に配置することをお勧めします。 |
ファイルをメール送信する場合は、メール送信が許可されなかったり、空のファイルを送信する恐れがあるため、Yellowfinサービス（特に、Windows上のサービス）を停止しなくてはいけない場合あることに注意してください。