デプロイメント ガイド

     前  次    新しいウィンドウで目次を開く     
ここから内容の開始

ORACLE TSAM デプロイメント ガイド

ここでは、以下の内容について説明します。

 


Oracle TSAM エージェントのデプロイ

ローカル モニタ サーバ (LMS) は、Oracle TSAM エージェントによって提供された Tuxedo システム サーバです。

Oracle TSAM エージェントを適切にデプロイするには、LMS をすべての Tuxedo マシン セクションの UBBCONFIG ファイルに追加する必要があります。コード リスト 1 は、LMS を UBBCONFIG ファイルに追加する方法の例を示します。

コード リスト 1 UBBCONFIG ファイルに追加された LMS
...
*MACHINES
MACHINEA
...
*GROUPS
...
LMSGRP LMID=MACHINEA
...
*SERVERS
LMS=LMSGRP SRVID=1 MINDISPATCHTHREADS=1 MAXDISPATCHTHREADS=5 CLOPT=”-A -- -l tsamweb.abc.com:8080/tsam/dataserver”
...

LMS はマルチスレッド サーバなので、Tuxedo アプリケーションのワーク ロードに基づいてサービス ディスパッチ スレッド数を設定できます。「-l」を指定すると、Oracle TSAM マネージャに設定されている Oracle TSAM データ サーバのアドレスを示します。LMS の詳細については、『Oracle TSAM リファレンス ガイド』を参照してください。Oracle TSAM データ サーバのポート番号は、Oracle TSAM マネージャ コンソールのポート番号と同じです。

注意 : LMS は、TMIB を使用して実行中の Tuxedo アプリケーションにも追加できます。

 


Oracle TSAM マネージャのデプロイ

概要

Oracle TSAM マネージャは、Servlet/JSP コンテナで Web アプリケーションとして機能します。Oracle TSAM マネージャは、DBMS (データベース管理システム) を使って、Tuxedo の永続性能およびモニタ データを格納します。

Oracle TSAM マネージャを使用する前に Oracle TSAM データベースをデプロイする必要があります。バンドルされている Apache Tomcat Server のインストールを選択すると、Oracle TSAM マネージャが自動的にデプロイされます。デプロイされない場合は、Oracle TSAM マネージャをサポートされている Web コンテナに手動でデプロイする必要があります。

デプロイ手順の一部で、tsam.war パッケージ内の WEB-INF ディレクトリに配置する web.xml ファイルを編集する必要があります。jar ツールを使用して tsam.war を取り出し、WEB-INF/web.xml を編集して、war パッケージを再度パッケージ化した後、サポートされている Web コンテナで war パッケージをデプロイする必要があります。

クイック スタート

バンドルされている Apache Tomcat を使用して Oracle TSAM マネージャを実行すると、以下の手順に従って Oracle TSAM マネージャの起動とシャット ダウンができます。

  1. Oracle TSAM マネージャの起動
  2. UNIX:

    1. cd <TSAMDIR>
    2. . ./tsam.env
    3. cd <TSAMDIR>/bin
    4. ./startup.sh
    5. Windows:

    6. cd <TSAMDIR>\bin
    7. startup.cmd
  3. Oracle TSAM マネージャのシャット ダウン
  4. UNIX:

    1. cd <TSAMDIR>/bin
    2. ./shutdown.sh
    3. Windows:

    4. cd <TSAMDIR>\bin
    5. shutdown.cmd

Oracle TSAM の環境パラメータ

表 1 は、Oracle TSAM の環境パラメータのリストです。

表 1 Oracle TSAM の環境パラメータ
名前
説明
TSAMDIR
Oracle TSAM のインストール ディレクトリ
JAVA_HOME または JRE_HOME
JRE または JDK のインストール ディレクトリ。Oracle TSAM は、デフォルトで JRE をインストールします。
JAVA_OPTS
推奨された JVM メモリを設定します。最小 : 512M; 最大 : 1024M。
CATALINA_HOME
Apache Tomcat のインストール ディレクトリ (省略可能)

Oracle TSAM の環境パラメータは、Oracle TSAM マネージャ インストーラを使用すると、自動的に設定されます。Oracle TSAM の環境パラメータは、UNIX のプラットフォームでは tsam.env ファイルに、Windows のプラットフォームでは startup.cmd ファイルにあります。

Oracle TSAM データベースのデプロイ

Oracle TSAM マネージャでは、次の DBMS に対してデプロイメント スクリプトが提供されています。

Oracle データベース

Oracle データベースを正常にデプロイするには、以下の手順に従います。

  1. Oracle データベースの作成
  2. Oracle TSAM マネージャの Oracle DBMS への設定
Oracle データベースの作成

Oracle の Oracle TSAM マネージャ データベースを作成するために、SQL スクリプトの sql/createdb_oracle.sql が提供されています。

注意 : スクリプトを使用する前に、Oracle データベースをインストールしておく必要があります。
Oracle TSAM マネージャの Oracle DBMS への設定

表 2 は、Oracle データベースを設定するために編集が必要な Oracle TSAM マネージャの設定ファイル パラメータのリストです。

注意 : Oracle TSAM マネージャの設定ファイルは、以下の場所にあります。
注意 : tsam/WEB-INF/web.xml.
表 2 Oracle TSAM マネージャ データベースの設定パラメータ

パラメータ
説明
tsam.jdbc.url
TSAM マネージャ データベースの JDBC 接続文字列を示します。以下に例を示します。
jdbc:oracle:thin:@localhost:1521:orcl
tsam.jdbc.username
Oracle TSAM マネージャ データベースに接続するユーザ名を示します。
tsam.jdbc.password
Oracle TSAM マネージャ データベースに接続するためのパスワードを示します。
tsam.jdbc.classname
JDBC ドライバのクラス名を示します。

Apache Derby データベース

Apache Derby データベースを正常にデプロイするには、以下の手順に従います。

  1. Oracle TSAM マネージャ データベースの作成
  2. Oracle TSAM マネージャの Apache Derby への設定
Oracle TSAM マネージャ データベースの作成

すでに組み込まれている Apache Derby データベースのインスタンスが提供されています。また、用意されている SQL スクリプトの sql/createdb.sql を使用してインスタンスを作成することもできます。Apache Derby ij ユーティリティを使用した Oracle TSAM マネージャ データベースの作成例を、以下に示します。

ij version 10.2
ij> connect 'jdbc:derby://localhost/tmonitordb;create=true';
ij> run 'createdb.sql';
Oracle TSAM マネージャの Apache Derby への設定

表 3 は、Apache Derby データベースを設定するために編集が必要な Oracle TSAM マネージャの設定ファイルのパラメータのリストです。

注意 : Oracle TSAM マネージャの設定ファイルは、以下の場所にあります。
注意 : tsam/WEB-INF/web.xml.
表 3 Oracle TSAM マネージャ データベースの設定パラメータ

パラメータ
説明
tsam.jdbc.url
Oracle TSAM マネージャ データベースの JDBC 接続文字列を示します。以下に例を示します。
jdbc:derby://localhost:1527/tmonitordb
tsam.jdbc.username
Oracle TSAM マネージャ データベースに接続するユーザ名を示します。
tsam.jdbc.password
Oracle TSAM マネージャ データベースに接続するためのパスワードを示します。
tsam.jdbc.classname
JDBC ドライバのクラス名を示します。

Oracle TSAM の Apache Tomcat Server へのデプロイ

Oracle TSAM マネージャをインストールすると、Apache Tomcat が自動的にインストールされ、設定されます。Apache Tomcat の設定パラメータは、以下のファイルにあります。

Apache Tomcat の設定パラメータを変更せずに、直接 Oracle TSAM マネージャを実行できます。

必要に応じて、次のパラメータのデフォルト値を変更できます。

Apache Tomcat の受信ポートの設定

Apache Tomcat のデフォルト ポート番号は「8080」です。環境に応じてデフォルト値を変更できます。ポートは、<TSAMDIR>/apache-tomcat-5.5.17/conf/server.xml ファイルに定義されます。例えば、ポートを「9090」に変更するには、以下の手順に従います。

<!-- Define a non-SSL HTTP/1.1 Connector on port 8080 -->
    <Connector port=”9090” acceptCount="100" connectionTimeout="20000" disableUploadTimeout="true" enableLookups="false" maxHttpHeaderSize="8192" maxSpareThreads="75" maxThreads="150" minSpareThreads="25" redirectPort="8443"/>

Oracle TSAM マネージャ コンソールおよびデータ サーバの URL は、Apache Tomcat のポートの設定に依存します。次の例では、デフォルト ポートに「8080」が使用されていると仮定しています。

「host」は、Oracle TSAM マネージャがインストールされているドメインのフルネームまたは IP アドレスを示します。Oracle TSAM エージェントの LMS を Oracle TSAM マネージャ データ サーバの URL を使用して正確に設定する必要があります。

セッション タイムアウトの設定

<TSAMDIR>/apache-tomcat-5.5.17/conf/web.xml ファイル内の <session-config> 要素を変更して、セッション タイムアウトを設定できます。例えば、次のように設定すると、非アクティブなセッションが 30 分後に無効なります。

<session-config>
<session-timeout>30</session-timeout>
</session-config>
HTTP KeepAlive の設定

サーバによって接続が切断されるまでにパイプラインを通る可能性のある HTTP 要求の最大数です。Apache Tomcat では、カスタム コントロールのために <TSAMDIR>/apache-tomcat-5.5.17/conf/server.xml ファイルに maxKeepAliveRequests の属性を備えています。この属性を「1」に設定すると、HTTP/1.0 keep-alive、HTTP/1.1 keep-alive および pipelining が無効になります。この属性を「-1」に設定すると、パイプラインの要求数または keep-alive HTTP 要求数への制限がなくなります。指定しない場合、属性には「100」が設定されます。

以下に例を示します。

<Connector port="8080" ...  maxKeepAliveRequests="-1"/>
POST の最大バイト サイズの設定

maxPostSize」を使用して POST の最大サイズ (バイト単位) を設定する必要があります。これは、コンテナ FORM URL のパラメータの解析によって処理されます。この属性に「0 以下」の値を設定すると、上限値が無効になります。指定しない場合、この属性は「2097152 (2 MB)」に設定されます。maxPostSize は、<TSAMDIR>/apache-tomcat-5.5.17/conf/server.xml ファイルで変更されます。

以下に例を示します。

<!-- Define a non-SSL HTTP/1.1 Connector on port 8080 -->
    <Connector maxPostSize="0" acceptCount="100" connectionTimeout="20000" disableUploadTimeout="true" enableLookups="false" maxHttpHeaderSize="8192" maxSpareThreads="75" maxThreads="150" minSpareThreads="25" port="8080" redirectPort="8443"/>

Oracle TSAM のデータベースに大量のモニタ データがあり、maxPostSize が適切に設定されていないと、処理に失敗した場合、例外メッセージ「javax.servlet.ServletException: Post too large」が送出されます。

注意 : maxPostSize を「0」に設定することをお勧めします。
最大同時処理スレッド数の設定

Apache Tomcat によって作成される要求処理スレッドの最大数、maxThreads で、Apache Tomcat が同時に処理できる要求の最大数を決定します。指定しない場合、この属性には「200」が設定されます。maxThreads は、Apache Tomcat の server.xml ファイルで変更されます。Oracle TSAM では、スレッドがデータベースにアクセスできる場合、スレッド レベルの JDBC 接続が使用されます。この属性を設定するときに、DBMS の性能を考慮する必要があります。

最大受信接続要求数の設定

Apache Tomcat 内の使用可能な要求処理スレッドがすべて使用中である場合、受信接続要求に対するキューの最大長、acceptCount を示します。キューがいっぱいのときに受信された要求は拒否されます。デフォルト値は「100」です。acceptCount に大きな値を設定すると、Apache Tomcat がビジー状態の場合、Apache Tomcat のキューにより多くの HTTP 要求を受け付けることができます。acceptCount は、Apache Tomcat の server.xml ファイルで変更されます。

maxPostSizemaxThreadsacceptCount の例を以下に示します。

<!-- Define a non-SSL HTTP/1.1 Connector on port 8080 -->
<Connector maxPostSize="0" acceptCount="1000" connectionTimeout="20000" disableUploadTimeout="true" enableLookups="false" maxHttpHeaderSize="8192" maxSpareThreads="75" maxThreads="130" minSpareThreads="25" port="8080" redirectPort="8443"/>

詳細については、「Apache Tomcat の Web サイト」を参照してください。

Oracle TSAM の Oracle WebLogic Server へのデプロイ

Oracle WebLogic Server のインストール後、以下の手順に従って、Oracle TSAM をデプロイします。

  1. WebLogic ドメインを起動し、URL : http://localhost:7001/console を使用して、Oracle WebLogic Server Administration Console を開始します。
  2. Administration Console の Change Center で [Lock & Edit] をクリックします。
  3. Administration Console の左側のペインで [Deployments] を選択します。
  4. 右側のペインで、[Install] をクリックします。
  5. [Install Application Assistant] で、$TSAMDIR ディレクトリにある tsam.war ファイルを探します
  6. [Next] をクリックします。
  7. アプリケーションとして [installation targeting style] を選択します。
  8. [Next] をクリックします。
  9. tsam.war ファイルのデプロイ先のサーバやクラスタを選択します。
  10. [Next] をクリックします。
  11. オプションで、追加デプロイメント設定を更新します。更新する設定は、以下のとおりです。
    • デプロイされたアプリケーション名、またはモジュール名
    • アプリケーションまたはモジュールに適用されるセキュリティ モデル
    • ソース ファイルをすべての対象管理サーバおよびクラスタに対して使用可能にする方法
    • 通常、デフォルト値は適切です。

  12. [Next] をクリックします。
  13. 指定した設定を検証し、[Finish] をクリックしてインストールを終了します。
  14. TSAM ページの設定では、[Configuration|General] を選択して TSAM の特定の設定を変更できます。例えば、セッション タイムアウト (秒単位) が変更できます。

  15. ただちにデプロイメント設定画面に移動する場合、追加 TSAM コンフィギュレーション設定を行うタブをクリックします。この情報の変更を後で行うよう選択すると Deployments 表に戻りますが、ここには新たに TSAM インストールが追加されています。
  16. この変更を有効にするには、Administration Console の Change Center で、[Activate Changes] をクリックします。
注意 : TSAM を起動するには、ドメインを再起動することをお勧めします。

Oracle WebLogic の設定パラメータを変更せずに、直接 Oracle TSAM マネージャを実行できます。

必要に応じて、次のパラメータのデフォルト値を変更できます。

Oracle WebLogic の受信ポートの設定

Oracle WebLogic Server のデフォルト受信ポートの番号は「7001」です。デフォルト受信ポートを変更するには、以下の手順に従います。

  1. URL : http://localhost:7001/console を使用して、Oracle WebLogic Server Administration Console を開始します。
  2. Administration Console の Change Center で [Lock & Edit] をクリックします。
  3. Administration Console の左側のパネルで、[Environment] の下の [Servers] をクリックします。
  4. TSAM がデプロイされたサーバ、例えば、exampleServer をクリックします。
  5. [Configuration|General] タブを選択してデフォルト受信ポートを変更します。
  6. この変更を有効にするには、Administration Console の Change Center で、[Activate Changes] をクリックします。
セッション タイムアウトの設定

セッション タイムアウトを設定するには、以下の手順に従います。

  1. URL : http://localhost:7001/console を使用して、Oracle WebLogic Server Administration Console を開始します。
  2. Administration Console の Change Center で [Lock & Edit] をクリックします。
  3. Administration Console の左側のペインで「Deployments」をクリックします。
  4. デプロイされた TSAM アプリケーションをクリックします。
  5. [Configuration|General] タブを選択してセッション タイムアウトを変更します。
  6. この変更を有効にするには、Administration Console の Change Center で、[Activate Changes] をクリックします。
HTTP KeepAlive の設定

HTTP KeepAlive を有効または無効に設定するには、以下の手順に従います。

  1. URL : http://localhost:7001/console を使用して、Oracle WebLogic Server Administration Console を開始します。
  2. Administration Console の Change Center で [Lock & Edit] をクリックします。
  3. Administration Console の左側のパネルで、[Environment] の下の [Servers] をクリックします。
  4. TSAM がデプロイされたサーバ、例えば、exampleServer をクリックします。
  5. [Protocols|HTTP] を選択して HTTP KeepAlive を有効または無効に設定します。
  6. この変更を有効にするには、Administration Console の Change Center で、[Activate Changes] をクリックします。
POST の最大バイト サイズの設定

POST の最大サイズ (バイト単位) の値を無制限に設定するには、以下の手順に従います。

  1. URL : http://localhost:7001/console を使用して、Oracle WebLogic Server Administration Console を開始します。
  2. Administration Console の Change Center で [Lock & Edit] をクリックします。
  3. Administration Console の左側のパネルで、[Environment] の下の [Servers] をクリックします。
  4. TSAM がデプロイされたサーバ、例えば、exampleServer をクリックします。
  5. [Protocols|HTTP] タブを選択して Max Post Size を変更します。
    注意 : Max Post Size を 0 未満に設定すると、サイズは無制限になります。
  6. この変更を有効にするには、Administration Console の Change Center で、[Activate Changes] をクリックします。
最大同時処理スレッド数の設定

最大同時処理スレッド数は、WebLogic Server の Maximum Threads Constraint にマッピングされます。Maximum Threads Constraint を設定するには、以下の手順に従います。

  1. URL : http://localhost:7001/console を使用して、Oracle WebLogic Server Administration Console を開始します。
  2. Administration Console の Change Center で [Lock & Edit] をクリックします。
  3. Administration Console の左側のパネルで、[Environment] の下の [Work Managers] をクリックします。
  4. [WebLogic.wsee.mdb.DispatchPolicy] をクリックします。
  5. [Configuration] タブを選択して [Maximum Threads Constraint] をクリックします。
  6. この変更を有効にするには、Administration Console の Change Center で、[Activate Changes] をクリックします。
最大受信接続要求数の設定

最大受信接続要求数は、WebLogic Server の Capacity Constraint にマッピングされます。Maximum Threads Constraint を設定するには、以下の手順に従います。

  1. URL : http://localhost:7001/console を使用して、Oracle WebLogic Server Administration Console を開始します。
  2. Administration Console の Change Center で [Lock & Edit] をクリックします。
  3. Administration Console の左側のパネルで、[Environment] の下の [Work Managers] をクリックします。
  4. [WebLogic.wsee.mdb.DispatchPolicy] をクリックします。
  5. [Configuration] タブを選択して Capacity Constraint を変更します。
  6. この変更を有効にするには、Administration Console の Change Center で、[Activate Changes] をクリックします。
注意 : Administration Console の Change Center で [Lock & Edit] が表示されない場合、WebLogic Server の設定が編集可能であることを示します。その場合は [Preferences] リンクをクリックし、[Automatically Acquire Lock] および [Activate Changes] チェック ボックスのチェックマークを外してから、[save] ボタンをクリックします。そうすると、Administration Console の Change Center で [Lock & Edit] および [Release Configuration] の 2 つのボタンが表示されます。

詳細については、「Oracle WebLogic の Web サイト」を参照してください。

Oracle TSAM の Oracle OC4J へのデプロイ

Oracle OC4J のインストール後、以下の手順に従って Oracle TSAM をデプロイします。

  1. OC4J サーバを起動し、URL : http://localhost:8888/em を使用して OC4J control console を開始します。
  2. [Applications] タブをクリックし、[Deploy] ボタンをクリックします。
  3. [Deploy:Select Archive] ページで、$TSAMDIR ディレクトリの tsam.war ファイルを探します。
  4. [Next] をクリックします。
  5. アプリケーションの Application Name および Context Root の属性を設定します。
  6. [Next] をクリックします。
  7. オプションで、追加デプロイメント設定を更新します。通常、デフォルト値は適切です。
  8. [Deploy] をクリックします。

Oracle OC4J の設定パラメータを変更せずに、直接 Oracle TSAM マネージャを実行できます。

必要に応じて、次のパラメータのデフォルト値を変更できます。

Oracle OC4J の受信ポートの設定

Oracle OC4J のデフォルト受信ポートは、「8888」です。デフォルト受信ポートを変更するには、コンフィギュレーション ファイル <OC4J_HOME>/j2ee/home/config/default-web-site.xml を変更します。

セッション タイムアウトの設定

OC4J のデフォルト サブレット セッション タイムアウトは、20 分です。デフォルト値を変更するには、/WEB-INF/web.xml in tsam.war ファイルを変更します。次の行を探して、存在しない場合は追加します。

<session-config>
	<session-timeout>20</session-timeout>
</session-config>

値を変更します。

HTTP KeepAlive の設定

デフォルト値は、「100」です。Oracle HTTP Server は、値を設定するために httpd.conf 内のディレクティブを使用します。(スタンドアロン OC4J に適用しません)

最大同時処理スレッド数の設定

コンフィグレーション ファイル、<OC4J_HOME>/j2ee/home/config/server.xml を変更します。次の行を探して、存在しない場合は追加します。

<global-thread-pool min="100" max="100" queue="200"
keepAlive="700000" cx-min="100" cx-max="100" cx-queue="200"
cx-keepAlive="700000" debug="true"/>

値を変更します。

最大受信接続要求数の設定

コンフィグレーション ファイル、<OC4J_HOME>/j2ee/home/config/server.xml を変更します。次の行を探して、存在しない場合は追加します。

<max-http-connections max-connections-queue-timeout="120"
socket-backlog="50" value="100"/>

属性を変更します。

詳細については、「Oracle OC4J の Web サイト」を参照してください。


  ページの先頭       前  次