Page Comparison

web.xml

The web.xml file provides configuration and deployment information for the Yellowfin application. The Yellowfin web.xml file is located in the directory:xmlファイルには、Yellowfinアプリケーションの設定および展開に関する情報が含まれています。Yellowfinのweb.xmlファイルは次のディレクトリに格納されています。
Yellowfin\appserver\webapps\ROOT\WEB-INF
A number of installation-specific settings are stored in web.xml when Yellowfin is installed. These settings are critical to Yellowfin starting and running successfully.

Included JSPs

The <ENTITY> line near the top of the file must correctly specify the Yellowfin path as a URL:Yellowfinのインストール時に、インストール固有の設定値がweb.xmlに保存されます。これらの設定は、Yellowfinの正常な起動および実行に際して非常に重要な意味を持ちます。 

JSPを含める

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

Configuration Database parameters

The connection parameters for the Yellowfin configuration database must be set correctly in web.xml for Yellowfin to function. These settings are within the <servlet> section named InitConnectionPool. The connection parameters are:

...

リポジトリデータベースのパラメーター

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

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

General Yellowfin startup parameters

There are a number of general startup parameters that affect various parts of Yellowfin. These settings are within the <servlet> section named MIStartup. The parameters are:

Clustering

...

全般的な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>

Clustering will make sure that:

1. If changes are made to ref codes on one server, all other servers reload their ref codes.
2. If a view is changed, the old version will be removed from the cache of all servers.
3. If a new licence is uploaded, all servers are updated.
   Note: You will also need a special licence (multicast), which you will have to contact Yellowfin for (sales@yellowfin.bi).

Performance Tuning

Other than increasing hardware capacity, e.g. faster CPU and memory allocation, there are a number of ways that Yellowfin can be performance tuned. For more information on capacity and configuration settings please refer to the server capacity white paper.

Web Server connections

The Tomcat WebServer default and maximum connections can be adjusted to enable more concurrent connections although the default settings should handle up to 100 users.

...

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

1. 1つのサーバー上で参照コードに変更を加えた場合、その他のすべてのサーバーはそれぞれの参照コードを再読み込みします。
2. ビューを変更した場合、古いバージョンはすべてのサーバーのキャッシュから削除されます。
3. 新しいライセンスをアップロードすると、すべてのサーバーに更新されます。
   注意：特別なライセンス（マルチキャスト）が必要になります。詳細についてはYellowfin（sales.jp@yellowfin.bi）までご連絡ください。

パフォーマンスチューニング

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

Webサーバー接続

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

これらのパラメーターは、$INSTALL_DIRECTORY \appserver\webapps\ROOT\WEB-INF\web.xml file.

The context in the file is against the servlet 'InitConnectionPool'.

Yellowfin Database connections

The Yellowfin Application server requires a connection to the Yellowfin database server to access the report repository and meta-data. This connection can be tuned to allow more through-put depending on the number of concurrent users expected in your installation.

The database connection default and maximums can be changed in xmlファイルで設定できます。

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

Yellowfinデータベース接続

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

データベース接続数のデフォルトと最大は、$INSTALL_DIRECTORY\appserver\webapps\ROOT\WEB-INF\web.xml file.

The current defaults are 2 (minimum) and 5 (maximum). Amending this connection limit would help performance.

Note: if Yellowfin performance in an issue then changing the connection parameters may assist. However, you will also have to consider your hardware configuration to ensure that it is setup to support the number of concurrent users you have. Please refer to the server capacity white paper for more information.

Java Virtual Machine (JVM) Heap Size

Yellowfin has hard memory limits that are set in configuration files. The application will never allocate more memory once it reaches these limits, even if the server has more free memory. In some cases this can cause errors if Yellowfin needs more memory.
Instructions for increasing the JVM Max Memory depend on how Yellowfin is started.

Windows Service

When the Yellowfin service is first installed, the memory limits are taken from the Yellowfinファイルで変更できます。

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

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

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

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

Windowsサービス

Yellowfinサービスを最初にインストールするとき、メモリの上限はYellowfin\appserver\bin\service.bat file. This file can be modified to provide different defaults, but this will only be read when the service is installed. To modify the memory limits for an existing service, follow this process:

...

batファイルを参照して設定されます。このファイルを編集してデフォルト値の指定を変更することができますが、このファイルはサービスをインストールする時にだけ読み取られます。既存のサービスのメモリ制限を変更するには、以下の手順に従ってください。

1. コマンドプロンプトを開いて、Yellowfinインストールディレクトリ下のappserver\binディレクトリに移動します。
2. 次のコマンドを実行します。tomcat7w.exe //ES//Yellowfin
   
   This will run the service manager for the Yellowfin service. Go to the "Java" tab, and change the "Initial memory pool" and "Maximum memory pool" values:
   Image Removed
3. Restart the Yellowfin service to pick up the changes.

Windows Start Menu

If you start the Yellowfin server from the Windows Start Menu, the memory limits are in the startup batch files.

1. Shut down Yellowfin
2. Edit the file このコマンドはYellowfinサービスのサービスマネージャーを実行します。「Java」タブに移動して、「メモリ初期使用量」および「メモリ最大使用量」の値を変更します。
   Image Added
3. Yellowfinサービスを再起動して変更を反映します。

Windows「スタート」メニュー

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

1. Yellowfinを終了します。
2. Yellowfin\appserver\bin\catalina.batFind the section: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. Remove the 最後の行の先頭にある"rem" from the start of the last line, and change the Xmx option to your desired max memory setting.Restart Yellowfin to pick up the changes.を削除して、Xmxオプションを必要な最大メモリ設定に変更します。
5. Yellowfinを再起動して変更を反映します。

Linux/Unix/Mac OSX

If you run Yellowfin on LinuxYellowfinをLinux/Unix/Mac OSX, the memory limits are in the startup scripts.

...

OSXで実行する場合、メモリ制限は起動スクリプトを参照します。

1. Yellowfinを終了します。
2. <Yellowfinインストールディレクトリ>/appserver/bin/catalina.shFind the section: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. Uncomment the last line, and change the Xmx option to your desired max memory setting.
5. Restart Yellowfin to pick up the changes.

...

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

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

...