Oracle TSAM Plusエージェントの構成
Oracle TSAM Plusエージェントの概要
Oracle TSAM Plusエージェントは、Tuxedo側のすべてのバック・エンド論理を処理します。次のサブコンポーネントが含まれます:
•
|
スタンドアロンTSAM Plusエージェント・コンポーネント は、Oracle TSAM Plusマネージャとともに動作します。
|
•
|
Oracle TSAM Plus フレームワーク: このフレームワークはデータ収集エンジンです。Tuxedoインフラストラクチャと他のTSAM Plusコンポーネントの間で機能する独立レイヤーです。このモジュールは、実行時のメトリック収集、アラート評価およびモニタリング・ポリシーの実施を担当します。
|
•
|
Oracle TSAM Plus プラグイン: Oracle TSAM Plusフレームワークによって呼び出される拡張可能なメカニズムです。Oracle TSAM Plusエージェントは、データをLMS (ローカル・モニター・サーバー)に送信してからOracle TSAM Plusマネージャに送信するデフォルト・プラグインを備えています。このプラグインにより、カスタム・プラグインをフックしてメトリックをインターセプトすることが可能になります。デフォルト・プラグインは割当てメモリーを使用してLMSと通信します。アプリケーションは、メトリック収集ポイントでブロックされなくなります。
|
追加データを処理するために、独自のプラグインを開発できます。カスタマイズ・プラグインは、既存のプラグイン・チェーンとリンクすることも、デフォルトのプラグインを置き換えることもできます。
•
|
ローカル・モニター・サーバー(LMS): LMSは、Oracle Tuxedoシステム・サーバーです。Oracle TSAM Plusデフォルト・プラグインがデータをLMSに送信します。続いて、LMSがOracle TSAM PlusマネージャにHTTPプロトコルでデータを渡します。ノードをモニターする必要がある場合、各Tuxedoマシン上にLMSが必要です。
|
•
|
accrpt: servopts(5)の -aオプションで生成されたアカウント作成情報およびチャージバック情報を分析するユーティリティ
|
•
|
JMXエージェント。 Enterprise Manager for Oracle Tuxedoとともに動作し、JMXインタフェース、さらにOracle Enterprise Manger Cloud Controlを介したOracle Tuxedoアプリケーションのモニターおよび管理を実現します。
|
•
|
Oracle Tuxedo Scripting Tool。Tuxedoドメインの管理、およびモニターに使用できるコマンド行スクリプト環境。
|
•
|
BTMオブザーバ。Oracle WebLogic ServerとOracle Tuxedoなどの製品間のエンドツーエンドのビジネス・トランザクションのモニターに使用されます。
|
スタンドアロンTSAM Plusエージェントの構成
Oracle TSAM Plusエージェントを正確かつ効果的に使用するには、次の前提条件に従います。
•
|
モニターされているすべてのTuxedoマシンおよびOracle TSAM Plusマネージャのシステムのクロックは、同期している必要があります。共通の時間を持つサーバーを使用することをお薦めします。
|
•
|
各TuxedoドメインをUBBCONFIGファイル内の一意なDOMAINIDに設定する必要があります。
|
ローカル・モニター・サーバー(LMS)では、次のタスクが実行されます。
•
|
Oracle TSAM Plusエージェント・フレームワークとOracle TSAM Plusマネージャの間のデータ・プロキシ・サーバーとして機能します
|
•
|
Oracle TSAM Plusマネージャからポリシーおよびアラートの構成リクエストを受け取り、Tuxedoドメインに適用します
|
•
|
Tuxedoドメインの構成をOracle TSAM Plusマネージャに送信します
|
詳細は、
Oracle TSAM Plus
リファレンス・ガイドの
LMSに関する項を参照してください。
Oracle TSAM Plusエージェントを適切にデプロイするには、UBBCONFIGファイルの各Oracle Tuxedoマシン・セクションにLMSを追加する必要があります。
リスト1-1に例を示します。
リスト1-1
UBBCONFIGファイルに追加されたLMS
...
*MACHINES
MACHINEA
...
*GROUPS
...
LMSGRP LMID=MACHINEA
...
*SERVERS
LMS SRVGRP=LMSGRP SRVID=1 CLOPT=���-A -- -l tsamweb.abc.com:8080/tsam���
...
「
-l」を指定すると、Oracle TSAM Plusマネージャに構成されているOracle TSAM Plusデータ・サーバーのアドレスを示します。詳細は、
Oracle TSAM Plusリファレンス・ガイドを参照してください。Oracle TSAM Plusデータ・サーバーのポート番号は、Oracle TSAM Plusマネージャ・コンソールのポート番号と同じです。
注意:
|
TMIBを使用して、実行中のOracle TuxedoアプリケーションにLMSを追加することもできます。
|
TSAM Plusエージェントは、LMS構成を
UBBCONFIGファイルに自動的に追加するための管理ツール
tsamadminを提供しています。コマンドの書式は次のとおりです。
tsamadmin
autoconfig(ac){-s|--static} {���H|--hostname} hostname:port
tsamadmin autoconfig -s -H tsamhost.com:7001
次に示すように、新しい
UBBCONFIGファイルが作成され、新しく作成されたグループ(Group1)にLMSが構成されます。
GROUP1 LMID=SITE1 GRPNO=1
LMS SRVGRP=GROUP1 SRVID=90 CLOPT="-A -- -l tsamhost.com:7001/tsam "
Oracle TSAM Plusのオン/オフの切替え
tmadminコマンドを使用してOracle TSAM Plusのオン/オフを切り替えることができます。コマンドの書式は次のとおりです。
changemonitor (chmo) [-m machine] on|off
-mパラメータは、Oracle TSAM Plus収集が無効になっている論理マシンの名前です。このオプションがない場合、すべてのマシン上でモニタリングが無効になります。デフォルトでは、モニタリングはオンです。モニタリングをオフにすると、定義済のモニタリング・ポリシーが存在する場合でも、すべてのデータ収集が停止されます。
Oracle Tuxedo ART for CICS and Batchのモニタリングの構成
注意:
|
KIXCONFIG環境変数が、すべてのARTアプリケーションで必須です。
|
リスト1-2は
Region-Group.mappingファイルの書式例です。
リスト1-2
Region-Group.mappingファイルの書式例
[region]
name= REG1
tuxgroups=APPGRP1,APPGRP2
resources_group=resgroup1,resgroup2
[region]
name= REG2
tuxgroups=APPGRP3,APPGRP4
resources_group=resgroup3,resgroup4
このファイルには、各リージョンに相当するセクションがあります。CICSリージョンは「name」と呼ばれます。
tuxgroupsパラメータの後には、Oracle Tuxedoグループ名を指定します。
resources_groupパラメータは、このリージョン内のCICSリソース・グループです。
注意:
|
Linux上で実行中のOracle Tuxedo Application Runtime for CICSの場合、ARTMONサーバーはTSAM Plusモニタリングを有効化するために構成する必要があります。
|
Oracle Tuxedo Application Runtime for BatchのARTJESコンポーネントをモニターする必要がある場合、
JESMONITOR環境変数を
yesに設定してからLMSサーバーを開始する必要があります。
TSAM PlusをJESセキュリティ・モードと統合するには、
UBBCONFIGファイルを構成し、TuxJESのTSAM構成ファイル(
tsamconfig)およびTSAMユーザー・マッピング・ファイルを作成する必要があります。
Tuxedo
UBBCONFIGファイルで、次のように構成します。
1.
|
LMSサーバー構成を ARTJESADMサーバーの行の後に配置します。
|
2.
|
オプション" -j <TSAM configuration file for TuxJES>"をLMS CLOPTに追加します。
|
ARTJESADM SRVGRP =ARTGRP SRVID = 1 MIN=1 MAX=1
CLOPT = "-A -- -i jesconfig"
ARTJESCONV SRVGRP =ARTGRP SRVID = 20 MIN=1 MAX=1
ARTJESINITIATOR SRVGRP =ARTGRP SRVID =30
ARTJESPURGE SRVGRP =ARTGRP SRVID = 100
AUTHSVR SRVGRP =ARTGRP SRVID = 200
LMS SRVGRP=LMSGRP SRVID=101
CLOPT="-A -- -l bej301712.cn.oracle.com:8080/tsam
-j tsamconfig"
表1‑1は、構成ファイルのキーワードのリストです。
表1‑1
TuxJESのTSAM構成ファイルのキーワード
|
|
|
TSAM PlusマネージャのJES syslogを送信するかどうかを指定します。
•
|
0: syslogを送信しません(デフォルト設定)。0を設定すると、SYSLOGはTSAM Plusマネージャ・コンソールに表示されません。
|
|
|
TSAM PlusユーザーをTuxedoユーザーおよび対応するJESプロファイルにマップするために使用されるTSAMユーザー・マッピング・ファイルのパスを指定します。
|
TSAM_USER_MAPPING_FILE=/home/artbatch/simpjob/tsam_user_profile
このファイルは、TSAM PlusユーザーをTuxedoユーザーおよび対応するJESプロファイルにマップするために使用されます。
<TSAM user> <Tuxedo user> <JES profile pathname>
リスト1‑5に、TSAMユーザー・マッピング・ファイルの例を示します。
リスト1‑5
TSAMユーザー・マッピング・ファイルの例
artbatch tpartbatch /home/artbatch/simpjob/tuxArtProfile
admin tproot /home/artbatch/simpjob/tuxRootProfile
注意:
|
JESプロファイルの所有者は、TSAM PlusユーザーからマップされるOSユーザーである必要があります。
|
tsamadminコマンドを使用してサニティ・チェックを実行し、構成が適切に行われていて、TSAM Plusエージェントがマネージャと通信できることを確認できます。コマンドの書式は次のとおりです。
tsamadmin managercheck(mc)[-s]
•
|
TSAMエージェント・プラグインがTuxedoに正しく登録されている。プラグインがまだ登録されていない場合、ユーザーは tsamadminを使用してプラグインを登録できます。
|
•
|
UBBCONFIGにLMSサーバーが構成されている。
|
•
|
LMS CLOPTに構成されているTSAM Managerのホストおよびポートに到達できる。
|
いずれかのステップでエラーが発生すると、チェックが終了し、エラー・レポートが表示されます。
TSAM Plusを使用してTuxedoドメイン・ターゲットをモニターするには、Tuxedoドメインより前に
tlistenプロセスを起動し、TuxedoドメインのMBeanを
tlistenプロセスに埋め込まれたJMXエージェントに登録できるようにする必要があります。特にMPドメインでは、すべてのマシンに対して
tlistenを起動する必要があります。
注意:
|
埋め込まれたJMXエージェントを起動するために次のJDKバージョンが必要です。
|
•
|
その他のプラットフォームの場合: JDK 7u85以降、または8u60以降
|
tlistenを起動する前に、
tlistenの環境変数
SHLIB_PATH/LIBPATH/LD_LIBRARY_PATHを設定し、
libjvmライブラリ・パスを組み込む必要があります。Windowsプラットフォームでは、
JAVA_HOMEのみを設定する必要があります。HPプラットフォームでは、
LD_PRELOADを設定し、
libjvm.soディレクトリを組み込む必要があります。
リスト1-6に、様々なプラットフォームでの環境変数の設定例を示します。
リスト1-6
様々なプラットフォームでの環境変数設定
LD_LIBRARY_PATH=$TUXDIR/lib:$JAVA_HOME/jre/lib/amd64/server:$LD_LIBRARY_PATH;
LIBPATH=$TUXDIR/lib:$JAVA_HOME/jre/lib/ppc64:${JAVA_HOME}/jre/lib/ppc64/default:$LIBPATH;
LD_LIBRARY_PATH=$TUXDIR/lib:$JAVA_HOME/jre/lib/IA64W/server:$LD_LIBRARY_PATH;
LD_PRELOAD=$JAVA_HOME/jre/lib/IA64W/server/libjvm.so;
注意:
|
LD_PRELOADは、 tlistenで埋込みJMXエージェントを起動するためにのみ使用されます。Tuxedoアプリケーションのビルド時には設定しないでください。
|
tlistenを起動するには、次のコマンドを使用します。
tlisten -j rmi://<host>:<rmiport> -l //<host>:<tlistenport>
注意:
|
-lオプションで指定したホストおよびポートが、 UBBCONFIGファイルで指定されている NLSADDR値と同じであることを確認します。
|
tlistenプロセスが正しく起動すると、メッセージ
RMIコネクタ・サーバーが正しく起動しましたおよび
埋込みJMXエージェントが正しく起動しましたがULOGに表示されます。
tlistenプロセスに次の機能が追加されています。
•
|
JMXエージェントが埋め込まれています。接続されるすべてのTuxedoドメイン(SHMモード)またはTuxedoマシン(MPモード)用にJMXドメインを作成します。JMXドメイン内の各MBeanはTuxedoターゲットに対応します。
|
•
|
tlistenは、Tuxedo側でモニタリングおよび管理エージェントとして作動します。Enterprise Managerからモニタリングと管理のリクエストを受け取り、これらのリクエストを対応するTuxedoサービスにディスパッチします。
|
•
|
tlistenは各JMX接続にTuxedoコンテキストを作成します。モニター対象のTuxedoドメインが認証および認可を有効にしている場合、Tuxedoドメインをアタッチする際に tlistenはEnterprise Repositoryから取得した資格証明を提供します。
|
•
|
EMエージェントのJMX fetchletがメトリック・リクエストを tlistenに送信する場合、 tlistenは次のことを行います。
|
•
|
リクエスト・メッセージをFML32バッファに変換し、対応するTuxedoドメインのMIBサービスにリクエストを転送します。
|
•
|
レスポンス・バッファに転送されたメトリックを受信し、Enterprise Repositoryエージェントにメトリックを返します。JMX fetchletと tlisten Agent間の接続は、同じEnterprise Repositoryユーザーでは複数のメトリックにまたがって流用されます。
|
•
|
tlistenは、また、Enterprise Repositoryエージェントからのジョブ・リクエストをMIBサービスに転送します。Enterprise Repositoryエージェントは各ジョブ・リクエストごとに新規の接続を作成し、ジョブが終了した後に接続を解除します。それに応じて、 tlistenは各ジョブ・リクエストに対してTuxedoコンテキストを作成します。
|
SSLを有効にしてtlistenを起動するには、次のコマンドを使用します。
tlisten -j rmi://<host>:<rmiport> -l //<host>:<tlistenport> -S -C /path/to/keystore.jks -P PASSWD_VAR
Tuxedoドメイン・モニタリング・ターゲットをモニターして管理するには、*
NETWORKセクションを追加し、Tuxedoドメインの
UBBCONFIGファイルにある
NLSADDRパラメータをSHMモードで構成することによって、ターゲットを
tlistenプロセスに登録する必要があります。
特定のメトリック(MIBのサービス・メトリックやIPCキュー・メトリックなど)の収集および計算は、CPU時間を消費し、Oracle Tuxedoのパフォーマンスに影響する可能性があります。Oracle Tuxedoは、
UBBCONFIGファイルの*
RESOURCESセクションで
EXT_MON OPTIONSパラメータを使用して、MIBのパフォーマンスに影響するメトリックの収集を実行できます。
インジケータを指定すると、Tuxedo TargetsセクションでリストされているすべてのメトリックがMIBで収集されます。指定しないと、次のメトリックはOracle Tuxedoによって収集されません。
•
|
Tuxedo ServerのIPCキュー・メトリック
|
このパラメータ設定を変更すると、即座にメトリック収集ポリシーも変更されます。
リスト1-7に、Enterprise ManagerモニタリングをサポートしているSHMモードの
UBBCONFIGファイルの例を示します。
リスト1‑7
Enterprise ManagerモニタリングをサポートしているSHM UBBCONFIGのサンプル
APPDIR = "/testarea/tux/test/jmx/servers"
TUXCONFIG = "/testarea/tux/test/jmx/servers/tuxconfig"
TUXDIR = "/testarea/tux/oracle/tuxedo12c"
SvrUpdate SRVGRP = ATMIGRP1
NLSADDR="<hostname>:16998"
GWTDOMAINに新しいCLOPTオプションが導入されました。
BTMモニターURL。形式は、
http://<HOST>:<PORT>/btmmonitor/agent/agent/です。
GWTDOMAIN SRVGRP="gwgrp" SRVID=1003 CLOPT="-A -- -m http://bej301493.cn.oracle.com:9001/btmmonitor/agent/agent/"
このオプションが指定されると、
GWTDOMIANは組込みJVMを起動してBTM委任オブザーバを実行し、WTCと自身の双方向コールをモニターします。