Page History

web.xml

web.xmlファイルには、Yellowfinアプリケーションの設定および展開に関する情報が含まれています。Yellowfinのweb.xmlファイルは次のディレクトリに格納されています。
Yellowfin\appserver\webapps\ROOT\WEB-INF
Yellowfinのインストール時に、数多くのインストール固有設定がweb.xmlに保存されます。これらの設定は、Yellowfinの正常な起動および実行に際して非常に重要な意味を持ちます。

JSPを含める

ファイル先頭近くの<ENTITY>行では、次のようにYellowfinのパスをURLとして正確に指定する必要があります。
<!ENTITY jsps SYSTEM "file:/C:/Program Files/Yellowfin/appserver/webapps/ROOT/WEB-INF/web-jsps.xml">
または
<!ENTITY jsps SYSTEM "file:/usr/Yellowfin/appserver/webapps/ROOT/WEB-INF/web-jsps.xml">

構成データベースのパラメーター

Yellowfin構成データベースの接続パラメーターは、Yellowfinが動作するためにweb.xml内で正しく設定する必要があります。これらの設定は、InitConnectionPoolという名前の<servlet>セクションに存在します。接続パラメーターは以下のとおりです。

詳細については、Yellowfinフォーラムの次の投稿を参照してください。http://www.yellowfinbi.com/YFForum-Connecting-to-the-Yellowfin-Repository-DB-?thread=105090

全般的なYellowfin起動パラメーター

さまざまなYellowfinの構成要素に影響する数多くの全般的な起動パラメーターがあります。これらの設定は、MIStartupという名前の<servlet>セクションに存在します。パラメーターは以下のとおりです。

クラスタリング

クラスタリングによって、同一のデータベースに対してYellowfinを複数のサーバー上で実行することが可能になります。Yellowfinをクラスタ化するには、以下の内容に各自のWebサービス情報を反映させてweb.xmlファイルに追加する必要があります。

<!-- Cluster Management -->
  <servlet>
    <servlet-name>ClusterManagement</servlet-name>
    <servlet-class>com.hof.mi.servlet.ClusterManagement</servlet-class>
    <init-param>
      <param-name>ServiceUser</param-name>
      <param-value>admin@yellowfin.com.au</param-value>
    </init-param>
    <init-param>
      <param-name>ServicePassword</param-name>
      <param-value>test</param-value>
    </init-param>
     <init-param>
      <param-name>ServiceAddress</param-name>
      <param-value>/services/AdministrationService</param-value>
    </init-param>
    <init-param>
      <param-name>ServicePort</param-name>
      <param-value>80</param-value>
    </init-param>
    <init-param>
      <param-name>ClusterHosts</param-name>
      <param-value>
         192.168.4.196
      </param-value>
    </init-param>
    <load-on-startup>11</load-on-startup>
  </servlet>

クラスタリングにより、以下の動作が確約されます。

1. 1つのサーバー上で参照コードに変更を加えた場合、その他のすべてのサーバーはそれぞれの参照コードを再読み込みします。
2. ビューを変更した場合、古いバージョンはすべてのサーバーのキャッシュから削除されます。
3. 新しいライセンスがアップロードされると、すべてのサーバーが更新されます。
   注意：特別なライセンスも必要となります。これを入手するにはYellowfinに連絡する必要があります (mailto:yellowfin@kmsi.co.jp)。

パフォーマンスの調整

高速なCPUやメモリの割り当てなどのハードウェア性能の強化以外に、Yellowfinのパフォーマンスを調整するためのさまざまな方法があります。性能および構成の設定の詳細については、サーバー性能に関するホワイトペーパーを参照してください。

Webサーバー接続

Tomcat Webサーバーのデフォルト設定では、最大100ユーザーを扱いますが、このデフォルトや最大接続数を調整して、より多くの同時接続を可能にします。

これらのパラメーターは、$INSTALL_DIRECTORY \appserver\webapps\ROOT\WEB-INF\web.xmlファイルで設定できます。

このファイル内での対象コンテキストは、サーブレット「InitConnectionPool」に対するものです。

Yellowfinデータベース接続

Yellowfinアプリケーションサーバーは、レポートリポジトリおよびメタデータにアクセスするためにYellowfinデータベースサーバーへの接続が必要です。この接続数を調整して、それぞれのインストールで予想される同時ユーザー数に応じたより高いスループットを得ることができます。

データベース接続数のデフォルトと最大は、$INSTALL_DIRECTORY\appserver\webapps\ROOT\WEB-INF\web.xmlファイルで変更できます。

現在のデフォルトは、2（最少）および5（最大）です。この接続制限を変更すると、パフォーマンスが向上する可能性があります。

注意：Yellowfinのパフォーマンスに問題がある場合、接続パラメーターの変更が解決に役立つ場合があります。ただし、ハードウェア構成を検討して、それぞれの環境で必要な同時ユーザー数をサポートするように設定する必要があります。詳細については、サーバー性能に関するホワイトペーパーを参照してください。

Java仮想マシン（JVM）ヒープサイズ

Yellowfinには、構成ファイルで設定される絶対的なメモリ制限があります。サーバーに空きメモリがある場合でも、アプリケーションはこの制限を超えてメモリを割り当てることはありません。この制限によって、Yellowfinがより多くのメモリを必要とする場合にエラーが発生する可能性があります。
JVM最大メモリを増加する方法は、Yellowfinの起動方法によって異なります。

Windowsサービス

Yellowfinサービスを初めてインストールするとき、メモリ制限がYellowfin\appserver\bin\service.batファイルから参照されます。このファイルを変更して異なるデフォルト値を指定できますが、このファイルはサービスのインストール時のみに読み取られます。既存のサービスのメモリ制限を変更するには、以下の手順に従います。

1. コマンドプロンプトを開いて、Yellowfinインストールディレクトリ下のappserver\binディレクトリに移動します。
2. 次のコマンドを実行します。tomcat5w.exe //ES//Yellowfin
   
   このコマンドはYellowfinサービスのサービスマネージャーを実行します。「Java」タブに移動して、「Initial memory pool」（メモリ初期使用量）および「Maximum memory pool」（メモリ最大使用量）の値を変更します。
   
3. Yellowfinサービスを再起動して変更を反映します。

Windows「スタート」メニュー

YellowfinサーバーをWindows「スタート」メニューから起動する場合、メモリ制限は起動バッチファイルで参照されます。

1. Yellowfinを終了します。
2. Yellowfin\appserver\bin\catalina.batファイルを編集します。
3. 次のセクションを見つけます。

   Code Block
   none none
   rem Memory limits. rem Use these options to set the Java memory limits. rem -Xms128m sets the initial Java heap size to 128Mb rem -Xmx512m sets the maximum Java heap size to 512Mb rem To set memory limits uncomment the following line: rem set JAVA_OPTS=%JAVA_OPTS% -Xms128m -Xmx512m

4. 最後の行の先頭にある「rem」を削除して、Xmxオプションを必要な最大メモリ設定に変更します。
5. Yellowfinを再起動して変更を反映します。

Linux/Unix/Mac OSX

YellowfinをLinux/Unix/Mac OSXで実行する場合、メモリ制限は起動スクリプトで参照されます。

1. Yellowfinを終了します。
2. Yellowfin/appserver/bin/catalina.shファイルを編集します。
3. 次のセクションを見つけます。

   Code Block
   none none
   # Memory limits. # Use these options to set the Java memory limits. # -Xms64m sets the initial Java heap size to 64Mb # -Xmx256m sets the maximum Java heap size to 256Mb #JAVA_OPTS="$JAVA_OPTS -Xms64m -Xmx256m"

4. 最後の行のコメントを無効にし、Xmxオプションを必要な最大メモリ設定に変更します。
5. Yellowfinを再起動して変更を反映します。

パフォーマンスの詳細については、Yellowfinフォーラムの次の投稿を参照してください。http://www.yellowfinbi.com/YFForum-General-questions-on-performance-?thread=104626