|
|
ローカル・モニター・サーバー(LMS)は、Oracle TSAMエージェントによって提供されたOracle Tuxedoシステム・サーバーです。
Oracle TSAMエージェントを適切にデプロイするには、LMSをすべてのOracle Tuxedoマシン・セクションのUBBCONFIGファイルに追加する必要があります。リスト1は、LMSをUBBCONFIGファイルに追加する方法の例を示します。
...
*MACHINES
MACHINEA
...
*GROUPS
...
LMSGRP LMID=MACHINEA
...
*SERVERS
LMS SRVGRP=LMSGRP SRVID=1 MINDISPATCHTHREADS=1 MAXDISPATCHTHREADS=5 CLOPT=”-A -- -l tsamweb.abc.com:8080/tsam”
...
LMSはマルチ・スレッド・サーバーなので、Oracle Tuxedoアプリケーションのワーク・ロードに基づいてサービス・ディスパッチ・スレッド数を設定できます。「-l」を指定すると、Oracle TSAMマネージャに設定されているOracle TSAMデータ・サーバーのアドレスを示します。詳細は、Oracle TSAMリファレンス・ガイドを参照してください。Oracle TSAMデータ・サーバーのポート番号は、Oracle TSAMマネージャ・コンソールのポート番号と同じです。
| 注意: | TMIBを使用して、実行中のOracle TuxedoアプリケーションにLMSを追加することもできます。 |
Oracle TSAMマネージャは、Servlet/JSPコンテナでWebアプリケーションとして機能します。それは、DBMS (データベース管理システム)を使って、Oracle Tuxedoの永続性能およびモニタリング・データを格納します。Oracle TSAMマネージャは、データベース・サーバーおよびWebアプリケーション・コンテナにデプロイしてから使用する必要があります。
インストール時にLDAP構成ファイルを入力すると、LDAPデプロイメントは自動的に実行されます。実行されない場合、LDAP認証を有効化するには、LDAPデプロイメント・ユーティリティを使用してLDAPデプロイメントを実行する必要があります。
インストール時に、バンドルされているDerbyデータベース、既存のDerbyデータベース、既存のOracleデータベースのいずれかを選択すると、指定したデータベース・サーバー上に自動的にOracle TSAMマネージャがデプロイされます。自動的にデプロイされない場合はデータベース・デプロイメント・ユーティリティを使用してOracle TSAMマネージャをデータベース・サーバーにデプロイする必要があります。
インストール時に、バンドルされているTomcatサーバー、既存のTomcatサーバー、既存のWebLogicサーバーのいずれかを選択すると、指定したアプリケーション・サーバー上にOracle TSAMマネージャが自動的にデプロイされます。自動的にデプロイされない場合は、アプリケーション・サーバー・デプロイメント・ユーティリティを使用するか、手動で、アプリケーション・サーバーにOracle TSAMマネージャをデプロイする必要があります。
LDAPデプロイメントでは、< TSAM_DIR >/deployにあるtsam.earファイル内の、LDAP構成情報が更新されます。
Oracle TSAMには、次のLDAPデプロイメント・ユーティリティが用意されています。
リスト2およびリスト3に、それぞれUNIXおよびWindowsのLDAPデプロイメント・ユーティリティの例を示します。
| 注意: | LDAPデプロイメント・ユーティリティを実行すると、tsam.earファイルのLDAP情報は上書きされます。tsam.earファイルをアプリケーション・サーバーに再デプロイする必要があります。 |
LDAP構成ファイルの詳細については、 Oracle TSAMインストレーション・ガイドを参照してください。
cd < TSAM_DIR >/deploy
./LDAPDeployer.sh tpgauth
cd < TSAM_DIR >\deploy
LDAPDeployer.cmd c:\tpgauth
インストール後、既存のデータベース・サーバーにOracle TSAM 11gR1をデプロイすることを選択する場合、インストール後にデータベース・デプロイメント・ユーティリティを使用してOracle TSAMデータベースを追加する必要があります。
Oracle TSAMには、次のデータベース・デプロイメント・ユーティリティが用意されています。
データベース・デプロイメント・ユーティリティは、次の作業を実行します。
リスト4およびリスト5に、それぞれUNIXおよびWindowsのデータベース・デプロイメント・ユーティリティの例を示します。
| 注意: | データベース・ユーティリティには、次の制約があります。 |
tsam」である必要があり、このユーザーを作成してからこのユーティリティを使用する必要があります。-overwrite yesを選択すると、既存のTSAMデータベースは常に上書きされ、tsam.earファイルのデータベース接続URLが更新されます。パラメータ-overwrite noを選択すると、データベース接続URLは更新されますが、既存のTSAMデータベースは上書きされません。tsam.earファイルのデータベース接続URLは上書きされます。tsam.earファイルをアプリケーション上に再デプロイする必要があります。詳細については、 Oracle TSAMインストレーション・ガイドを参照してください。
./ DatabaseDeployer.sh -type derby -hostname localhost -port 1527 -dbname TSAM -user app -password app -overwrite no -admingid 0 -viewergid 1 -adminpassword admin1
./ DatabaseDeployer.sh -type oracle -hostname localhost -port 1521 -dbname TSAM -user tsam -password tsam -overwrite no -admingid 0 -viewergid 1 -adminpassword admin1
DatabaseDeployer.cmd -type derby -hostname localhost -port 1527 -dbname TSAM -user app -password app -overwrite no -admingid 0 -viewergid 1 -adminpassword admin1
DatabaseDeployer.cmd -type oracle -hostname localhost -port 1521 -dbname TSAM -user tsam -password tsam -overwrite no -admingid 0 -viewergid 1 -adminpassword admin1
インストール後、既存のアプリケーション・サーバーにOracle TSAM 11gR1をデプロイすることを選択する場合、インストール後に、アプリケーション・サーバー・ユーティリティを使用するか、手動で、既存のアプリケーション・サーバー(WebLogicまたはTomcat)にデプロイする必要があります。
| 注意: | WebLogicサーバーには、次の制約があります。 |
| 注意: | 詳細は、 http://www.oracle.com/tools/toplink_adf.htmlを参照してください。 |
Oracle TSAMには、次のアプリケーション・サーバー・デプロイメント・ユーティリティが用意されています。
UNIXアプリケーション・サーバー・デプロイメント: AppServerDeployer.sh
Windowsアプリケーション・サーバー・デプロイメント: AppServerDeployer.cmd
UNIXおよびWindowsのアプリケーション・デプロイメント・ユーティリティ例を、それぞれリスト6およびリスト7に示します。
cd < TSAM_DIR >/deploy
./AppServerDeployer.sh -type weblogic -adminurl localhost:7001 -directory /home/oracle/wlserver_10.3 -user weblogic -password weblogic1
cd < TSAM_DIR >/deploy
./AppServerDeployer.sh -type tomcat -directory /home/oracle/apache-tomcat-6.0.24
cd < TSAM_DIR >\deploy
AppServerDeployer.cmd -type weblogic -adminurl localhost:7001 -directory C:\oracle\wlserver_10.3 -user weblogic -password weblogic1
cd < TSAM_DIR >/deploy
AppServerDeployer.sh -type tomcat -directory C:\oracle\apache-tomcat-6.0.24
Oracle TSAMマネージャには、次のアプリケーション・サーバーのためのデプロイメント・スクリプトが用意されています。
リスト8およびリスト9(それぞれUnixおよびWindowsの場合)に示したコマンドを実行して、Apache TomcatサーバーにOracle TSAMをデプロイします。
| 注意: | < TSAM_DIR >および< TOMCAT_DIR >を、使用するディスクの実際のTSAMパスとTOMCATパスに置き換えます。 |
TSAMDIR=< TSAM_DIR >; export TSAMDIR
TOMCATDIR=< TOMCAT_DIR >; export TOMCATDIR
JAVA_HOME=$TSAMDIR/jdk; export JAVA_HOME
PATH=$TSAMDIR/jdk/bin:$PATH; export PATH
cd $TSAMDIR/deploy
mkdir tsam
cd tsam
jar xf ../tsam.ear
mkdir tsam
cd tsam
jar xf ../tsam.war
cp ../../adflib/* WEB-INF/lib/
jar cf ../tsam.war *
cd ..
rm -rf $TOMCATDIR/webapps/tsam
rm -rf $TOMCATDIR/webapps/tsamhelp
cp tsam.war $TOMCATDIR/webapps/
cp tsamhelp.war $TOMCATDIR/webapps/
cd ..
cp adflib/* $TOMCATDIR/lib/
rm -rf tsam
set TSAMDIR=< TSAM_DIR >
set TOMCATDIR=< TOMCAT_DIR >
set JAVA_HOME=%TSAMDIR%\jdk
set PATH=%JAVA_HOME%\bin;%PATH%
cd /d %TSAMDIR%\deploy
mkdir tsam
cd tsam
jar xf ..\tsam.ear
mkdir tsam
cd tsam
jar xf ..\tsam.war
copy ..\..\adflib\* WEB-INF\lib\
jar cf ..\tsam.war *
cd ..
rd %TOMCATDIR%\webapps\tsam /s/q
rd %TOMCATDIR%\webapps\tsamhelp /s/q
copy tsam.war %TOMCATDIR%\webapps\
copy tsamhelp.war %TOMCATDIR%\webapps\
cd ..
copy adflib\* %TOMCATDIR%\lib\
rd tsam /s/q
Oracle WebLogic Serverのインストール後、次の手順に従って、Oracle TSAMをデプロイします。
http://localhost:7001/consoleを使用して、Oracle WebLogic Server管理コンソールを開始します。$TSAMDIR/deployディレクトリにあるtsam.earファイルを探します。tsam.earファイルのデプロイ先のサーバーやクラスタを選択します。TSAMページの設定では、「構成」>「全般」を選択してTSAMの特定の設定を変更できます。例えば、セッション・タイムアウト(秒単位)が変更できます。
Apache Tomcatの設定パラメータを変更せずに、直接Oracle TSAMマネージャを実行できます。
Apache Tomcatサーバーの構成パラメータは、次のファイルにあります。
既存のTomcatサーバーを使用してOracle TSAMをインストールするとき、デフォルトのJVMメモリー・サイズではOracle TSAMの実行には十分ではありません。JAVA_OPTS環境変数値を指定することで、メモリーを拡張できます。
たとえば、値を-Xms256mに設定するには、 -Xmx1024m -XX:PermSize=64M -XX:MaxPermSize=256mを入力します。
Apache Tomcatのデフォルト・ポート番号は「8080」です。環境に応じてデフォルトを変更できます。ポートは、<TSAM_DIR>/apache-tomcat-6.0.24/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を使用して正確に設定する必要があります。
セッション・タイムアウトを設定するには、次のステップを実行します:
サーバーによって接続が切断されるまでにパイプラインを通る可能性のあるHTTPリクエストの最大数です。Apache Tomcatでは、カスタム・コントロールのために<TSAM_DIR>/apache-tomcat-6.0.24/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"/>
「maxPostSize」を使用してPOSTの最大サイズ(バイト単位)を設定する必要があります。これは、コンテナFORM URLのパラメータの解析によって処理されます。この属性に0以下の値を設定すると、上限値が無効になります。指定しない場合、この属性は「2097152(2 MB)」に設定されます。maxPostSizeは、<TSAM_DIR>/apache-tomcat-6.0.24/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ファイルで変更されます。
maxPostSize、maxThreads、acceptCountの例を次に示します。
<!-- 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 WebLogicの設定パラメータを変更せずに、直接Oracle TSAMマネージャを実行できます。
Oracle WebLogic Serverのデフォルト・リスニング・ポートの番号は「7001」です。デフォルト・リスニング・ポートを変更するには、次のステップを実行します:
http://localhost:port/consoleを使用してOracle WebLogic Serverの管理コンソールを起動します。ここでlocalhostはWebLogic Serverを実行しているマシンのホスト名で、portは、WebLogic Serverがリクエストをリスニングするポートの番号です。exampleServer)をクリックします。WebLogicセッション・タイムアウト構成は、Tomcatサーバーの構成と同一です。詳細は、Tomcatのセッション・タイムアウトの構成に関する項を参照してください。
HTTPキープアライブを有効または無効に設定するには、次のステップを実行します:
http://localhost:port/consoleを使用してOracle WebLogic Serverの管理コンソールを起動します。ここでlocalhostはWebLogic Serverを実行しているマシンのホスト名で、portは、WebLogic Serverがリクエストをリスニングするポートの番号です(デフォルトは7001)。exampleServerをクリックします。POSTの最大サイズ(バイト単位)の値を無制限に設定するには、次のステップを実行します:
http://localhost:7001/consoleを使用して、Oracle WebLogic Server管理コンソールを開始します。exampleServerをクリックします。最大同時処理スレッド数は、WebLogic Serverの最大スレッド数制約にマッピングされます。最大スレッド数制約を設定するには、次のステップを実行します:
http://localhost:port/consoleを使用してOracle WebLogic Serverの管理コンソールを起動します。ここでlocalhostはWebLogic Serverを実行しているマシンのホスト名で、portは、WebLogic Serverがリクエストをリスニングするポートの番号です(デフォルトは7001)。最大受信接続リクエスト数は、WebLogic Serverの容量制約にマッピングされます。最大スレッド数制約を設定するには、次のステップを実行します:
http://localhost:port/consoleを使用してOracle WebLogic Serverの管理コンソールを起動します。ここでlocalhostはWebLogic Serverを実行しているマシンのホスト名で、portは、WebLogic Serverがリクエストをリスニングするポートの番号です(デフォルトは7001)。| 注意: | 管理コンソールの「チェンジ・センター」に「ロックして編集」が表示されていない場合は、WebLogic Serverの構成の編集が有効になっています。 |
| 注意: | 「プリファレンス」をクリックします。「ロックを自動取得して変更をアクティブ化」チェックボックスの選択を解除して、「保存」をクリックします。 |
詳細については、Oracle WebLogicのWebサイトを参照してください。
インストール時に、バンドルされているApache TomcatサーバーおよびバンドルされているDerbyデータベースを選択すると、対応する起動/停止スクリプト・ファイルが、Oracle TSAM binフォルダにインストールされます。
バンドルされているApache Tomcatサーバーのみを選択すると、インストールされる起動/停止スクリプトはApache Tomcatサーバーのみを対象にします。バンドルされているDerbyデータベースのみを選択すると、startup derby/shutdown derbyスクリプト・ファイルがOracle TSAM binフォルダにインストールされます。
バンドルされているApache Tomcatサーバー(バンドルされているDerbyデータベースがある場合もない場合も)とともにOracle TSAMマネージャを実行する場合、Oracle TSAMマネージャを起動および停止するには、次の手順を使用します。
バンドルされているDerbyデータベース(バンドルされているApache Tomcatサーバーがある場合もない場合も)とともにOracle TSAMマネージャを実行する場合、Derbyを起動および停止するには、次の手順を使用します。
| 注意: | バンドルされているApache Tomcatサーバーを選択しない場合、JAVA環境(JDK 1.6以上)をセットアップして、手動で既存のアプリケーション・サーバーを起動する必要があります。 |
Oracle TSAMマネージャ11gR1は、Oracle TSAM 1.1/10gR3のアラート定義項目またはイベント・トリガー・ルール・ファイルをインポートし、Oracle TSAM 11gの書式に変換することができます。この変換を実行するには、次の手順を実行する必要があります。
cd <TSAM11g_DIR >/deploy-srcdbtype SRCDBTYPE -srcdbhostname SRCDBHOSTNAME -srcdbport SRCDBPORT -srcdbdbname SRCDBNAME -srcdbuser SRCDBUSER -srcdbpassword SRCDBPASSWORD -dstdbtype DSTDBTYPE -dstdbhostname DSTDBHOSTNAME -dstdbport DSTDBPORT -dstdbdbname DSTDBNAME -dstdbuser DSTDBUSER -dstdbpassword DSTDBPASSWORD.
1.Oracle TSAM 11gデータベース・サーバーが実行されていることを確認します。
3.リスト11に示したコマンドを実行します。
-srcfile SRCFILE -dstdbtype DSTDBTYPE -dstdbhostname DSTDBHOSTNAME -dstdbport DSTDBPORT -dstdbdbname DSTDBNAME -dstdbuser DSTDBUSER -dstdbpassword DSTDBPASSWORD.
表1に、AlertMigration.sh/cmdのパラメータを示します。
| 注意: | 指定されたデータベースでOS認証が使用されている場合、ユーザー名(パラメータsrcdbuserまたはdstdbuser)およびパスワード(パラメータsrcdbpasswordまたはdstdbpassword)はNULLである必要があります。 |
TSAM 1.1/10gR3のポリシー・ファイルは、Oracle TSAM 11gのポリシー管理のページでインポートできます。詳細は、Oracle TSAM 11gのユーザーズ・ガイドで、Tuxedoのモニタリング・ポリシーに関する箇所を参照してください。
Oracle TSAM 11gR1(11.1.1.1.0)データベースは、Oracle TSAM 11gR1(11.1.1.2.0)データベースとは異なります。データベースを再利用する前に、データベース移行スクリプトを実行する必要があります。
cd <TSAM11g_DIR>
JAVA_HOME=<TSAM11g_DIR>/jdk; export JAVA_HOME
DERBY_HOME=<TSAM11g_DIR>/db-derby-10.5.3.0-bin; export DERBY_HOME
$DERBY_HOME/bin/ij
  
|