![]() ![]() ![]() ![]() ![]() ![]() |
この章では、Enterprise Manager for Oracle Tuxedo (EM)を使用してTuxedoターゲットをモニターし、EMの機能を統合し、リソース・ブローカによりTuxedoアプリケーションを別のリモート・マシンに自動的にデプロイする方法について説明します。
ログインすると、Enterprise Manager Cloud Controlのホーム・ページが表示されます。ホーム・ページの各要素の詳細は、ページ右上にある「ヘルプ」をクリックしてください。
「Tuxedoサマリー」ページでは、多数のEnterprise Managerのモニタリング・ターゲットからTuxedoドメイン・ターゲットがすべてフィルタされるため、このページを使用すると、Tuxedoターゲットを一元的に管理し、各ターゲット・ホーム・ページに簡単に移動できます。
「Tuxedoサマリー」ページを開く手順は、次のとおりです。
図2-1に示すように、「Tuxedoサマリー」ページが表示されます
表2-1に、アクション・バー機能を示します。
Tuxedoドメインをモニタリング・ターゲットに追加します。リソース・ブローカのドメインUBBCONFIGエディタで、既存のドメインを検出するのか、新しいTuxedoドメインを作成するのかを選択できます。
|
|
ドメインUBBCONFIGエディタで、強調表示されたTuxedoドメインを編集します。
|
|
「検索」パネルを使用すると、特定のフィールドを使用してターゲットをすばやく検索できます。
ドロップダウン・リストから検索するフィールドを選択し、テキスト・ボックスに適切な検索文字列を入力して標準検索を実行します。拡張検索を使用して、さらに詳細なフィルタリングを行う検索を実行することもできます。
表2-2に、各サマリー列フィールドに関する説明を示します。
TuxedoターゲットをEnterprise Manager Cloud Controlホーム・ページまたは「Tuxedoサマリー」ページから選択すると、そのターゲットのホーム・ページが表示されます。たとえば、Tuxedoドメイン・ターゲットをクリックすると、図2-2に示す画面が表示されます。
図2-2では、左側にターゲット・ナビゲーション・ペインを、右側にコンテンツ・ページを示しています。ターゲット・ナビゲーション・ペインでは、ツリーを開いたり閉じたりできます。ターゲットを選択すると、コンテンツ・ペインにそのターゲットのホーム・ページが表示され、ページの上部にターゲットのメニューが表示されます。また、ターゲットのメニューは、ナビゲーション・ペインでターゲットを右クリックしても表示できます。
一般的なターゲット・ホーム・ページには、次の項目が含まれます。
ナビゲーション・ツリーには、OMSインスタンスでモニターされているTuxedoターゲットがすべて表示されます。Tuxedoドメインに属するすべてのTuxedoターゲットは、リスト2-1に示すようなツリー階層で表示されます。
ツリーには、カテゴリ・ノードとターゲット・ノードという2種類のノードがあります。
カテゴリ・ノードはTuxedoターゲットに対応していません。上位レベルのターゲットの下に同じタイプのすべてのターゲットをグループ化するために使用されます。カテゴリ・ノードをクリックすると、その下にあるすべての子ノードを開いたり閉じたりできます。ツリーでターゲット・ノードをクリックすると、コンテンツ・ペインにそのターゲット・ホーム・ページが表示されます。
選択されているターゲットに対して実行可能な操作のリストを示します。表示されるメニューは、選択したターゲットに応じて異なります。個々のターゲットのメニューには、右クリック・ターゲット・メニューと同じ操作が含まれています。
現在選択されているターゲットに対して実行可能な操作のリストを示します。このメニューは、ターゲット・ナビゲーション・ペインで、ターゲット名を右クリックすると表示されます。
Enterprise Manager for Oracle Tuxedoは、いくつかのターゲットに特別なUBBページを提供し、Enterprise Manager Cloud ControlコンソールからUBB構成を変更できるようになります。「UBBの変更」ページに移動するには、ターゲットのトップ・メニューから「コントロール」→「UBBの変更」をクリックします。
詳細は、Oracle Tuxedoのドキュメントを参照してください。
注意: | UBBの変更機能を正しく機能させるには、UBBCONFIG *RESOURCES セクションでDOMAINID を構成する必要があります。 |
UBBCONFIG
ファイルのSECURITY
パラメータがNONE
ではないセキュリティ・ドメインの場合、ターゲット・ページや基礎となるターゲットのページでドメインの閉鎖/停止、ログ・メッセージの表示、UBB
の変更などのセキュリティ・レベルが高い操作を初めて実行すると、図2-3に示すように「資格証明」ページが表示されます。
図2-3の資格証明を構成する手順は、次のとおりです。
注意: |
APP_PW
の場合、TuxedoがTuxedoユーザー名フィールドおよびTuxedoパスワード・フィールドの値を使用して認証または認可をしなくても、これら2つのフィールドをプレースホルダとして入力する必要があります。Enterprise Manager Cloud ControlからTuxedoターゲットをモニタリングする前に、次の点に注意してください。
SQL> select dbtimezone from dual;
SQL> select sessiontimezone from dual;
SQL> alter database set time_zone='<new time zone>';
SQL> alter session set time_zone='<new time zone>';
表2-3では、Enterprise Manager Cloud Controlからモニター可能なTuxedoターゲット、各ターゲットでサポートされているメトリックに関する参照先、および各ターゲット・ホーム・ページで実行可能な管理操作の概要を説明しています。
注意: |
Enterprise Manager ECMのCCS (カスタム構成の仕様)は、ファイル名、絶対パス名、コンテンツ・サイズおよびコンテンツの詳細などのEnterprise Manager Agent側の構成ファイルの表示に使用されます。
Tuxedoの構成ファイルであるTUXCONFIG
およびBDMCONFIG
は、CCSに表示されます。
TUXCONFIG
またはBDMCONFIG
を表示するには、Tuxedoドメインのターゲット・インスタンスのホーム・メニューから、「構成」→「最新収集」をクリックします。「構成ファイル」ツリー・ノードの下に、TUXCONFIG.cfg /BDMCONFIG.cfg
が表示されます。初めてTuxedoドメインが検出された後に「構成ファイル」ツリー・ノードの下にTUXCONFIG.cfg
またはBDMCONFIG.cfg
が表示されない場合は、左側のパネルのツリー・ルートをクリックします。右側のパネルで「アクション」をクリックして、「リフレッシュ」をクリックします。
「構成ファイル」ツリー・ノードの下のTUXCONFIG.cfg
またはBDMCONFIG.cfg
をクリックして、各ファイルの詳細を表示します。
BDMCONFIG.cfg
は、Tuxedo側で構成された場合にのみ表示されます。
注意: |
TUXCONFIG
およびBDMCONFIG
の詳細は、tmunloadcf
またはdmunloadcf
による逆コンパイルから取得されます。実際には、TUXCONFIG.cfg
やBDMCONFIG.cfg
というディスク・ファイルは、Enterprise Managerエージェント側には通常のCCSモジュールとして存在しません。TUXCONFIG.cfg
またはBDMCONFIG.cfg
のファイル名、完全名およびコンテンツ・サイズは、他のECM CCSモジュールと比較した仮想のものです。tmunloadcf
の実行後、*JDBCCONNPOOLS
セクションが空の場合は*JDBCCONNPOOLS
は無視されます。*JDBCCONNPOOLS
セクションが空ではない場合は、*JDBCCONNPOOLS
は別のセクションとして表示されます。JMXエージェントのターゲットでは、Tuxedo Domainコンテキスト・メニューから「メンバー」→「トポロジ」をクリックして、構成トポロジを表示できます。図3に示すように、「表示」ドロップダウンから「使用」を選択します。
Enterprise Manager for Oracle Tuxedoを使用すると、Tuxedo Job Enqueueing Service (TuxJES)をEnterprise Manager Cloud Controlからモニターできます。
JESターゲット・インスタンスがジョブ統計を受信する前に、次の手順を実行します。
JESMONITOR=yes
を設定します。UBBCONFIG
ファイルのTMSYSEVT
パラメータおよびTMUSREVT
パラメータを構成します。
パラメータおよびTMAGENT
パラメータ
を構成します。詳細は、Oracle SNMPエージェント構成ファイルのbeamgr.confに関する項を参照してください。Enterpriseモニタリングでは、トラップ・ホストはEnterprise Managerエージェント・ホストであり、ポートはEnterprise ManagerエージェントのSNMPリスニング・ポートです。これは、Enterprise Managerエージェント側で構成されます(「メトリックのモニタリング」を参照)。
TRAP_HOST 10.182.54.215 1061 public
SNMP_ENABLE_AUTH_TRAP 1
TMAGENT tuxedo_agent_1 /home/oracle/tuxedo12c /home/oracle/test/jmx/fakemp/master/tuxconfig
BEA_SM_SNMP_MIBFILE
環境変数およびBEA_SM_BEAMGR_CONF
環境変数を設定します。 注意: | Enterprise ManagerエージェントがTuxedoドメインと同じマシンにある場合、末尾に-p オプションが付いているポート番号が、beamgr.conf で構成したトラップ・ポートと同じでないことを確認します。 |
Tuxedoドメインの検出プロセス中にTuxJESモニタリングの検出は実行されます。Tuxedoドメイン検出が実行されると、JESターゲット・インスタンスが作成されます。
TuxJESモニタリング・ホームページにログインするには、次の手順を実行します。
NONE
(PRIVILEGE MODEを参照)ではないTuxedoドメインにある場合、資格証明を使用してログインすることを要求されます。「ログイン」をクリックします。注意: | Enterprise Managerユーザーは、一度ログインすると資格証明の有効期限が切れるかまたはEnterprise Managerコンソールからログアウトするまでバッチ・システムの資格証明を変更できません。 |
バッチ・システム・ターゲットのホーム・ページにログインした後で、Tuxedoドメインの「権限モード」パラメータがNONE
(「PRIVILEGE MODE」を参照)になっている場合は、ページで初めて「発行」をクリックすると、接続文字列の入力を求めるダイアログ・ボックスが表示されます。入力すると、接続文字列は、現在のセッションが期限切れになるまでこのセッションに保存されます。
Tuxedoバッチ・システムは、JESジョブにより生成されたメトリックのモニターに使用されるシステム・ターゲット・タイプです。詳細は、「ARTバッチ・ターゲット」を参照してください。
Tuxedoバッチ・システムでJESジョブ統計を受信する前に、SNMPポートを構成する必要があります。実行する手順は次のとおりです。
Tuxedo JES Adminターゲット・ホームページから「JESジョブ」タグをクリックすることにより、使用可能なすべてのジョブを表示し、一連のジョブ操作を実行できます。詳細は、「JESジョブの操作」を参照してください。
Enterprise Manager Cloud ControlでTuxedoバッチ・プロセス制御ジョブを作成して、バッチ・ジョブの発行、パージ、保留、リリースまたは取消しを行い、その後、Enterprise Managerジョブ・プラットフォームを使用してそのジョブの管理およびスケジュールを行うことができます。
Tuxedoバッチ・プロセス制御タイプでEnterprise Managerジョブを作成するには、次の手順に従います。
Enterprise Managerジョブ・ステータスは、Enterprise Managerジョブ・アクティビティ・ページに表示されます。バッチ・ジョブ・ステータスは、Tuxedoバッチ・システム・ターゲット・ページに表示されます。
Enterprise Manager for Oracle Tuxedoを使用すると、Enterprise Manager Cloud ControlからGeneration Data Group (GDG)ファイルを管理できます。
GDGがデータを受信できるようになる前に、次の手順を実行します。
$ART_HOME /Batch_RT/sample/simpjob
ファイルを使用)。環境変数JESMONITOR=yes
を設定します。$ART_HOME/Batch_RT/ejr/CONF/BatchRT.conf
でDBベースとして設定します。BatchRT.conf
で設定が必要な値は、次のとおりです。$JESDIR/ejr_mf_ora/pp/macro/template/GDG_PREDEFINED_JOB
を、TuxJESがあるディレクトリにコピーします。JOBREPOSITORY
がjesconfig
ファイルに設定されている場合は、これをJOBREPOSITORY
の下に置きます。または、APPDIR
の下に置きます。Tuxedo JES Adminターゲット・ホームページからGDGタグをクリックすると、GDGファイルを管理できます。詳細は、「GDG管理」を参照してください。
ドメイン・ターゲットのすべてのTuxedoイベント・トラップは、Enterprise Manager for Oracle TuxedoのSNMP Receivletによって受信されます。Enterprise Manager for Oracle Tuxedoから、受信したTuxedoイベント・トラップに対して、重大度がクリティカルまたは警告のEnterprise Managerメトリック・アラートが生成されます。クリティカルはTuxedoイベント・トラップの重大度がエラー(1)であり、警告はTuxedoイベント・トラップの重大度が警告(2)であることを意味します。重大度(3)である情報はサポートされていません。SNMPリスニング・ポートが正しく構成されている場合は、Tuxedoイベント・トラップにより生成されたすべてのアラートから、EMのインシデントが自動的に作成されます。
"EventName: <tuxEventsName>. Tuxedo Event LMID: <tuxEventsLmid>. Tuxedo Event Detection Time: <tuxEventsTime>. Tuxedo Event Class: <tuxEventsClass>. Tuxedo Agent Name:<beaLogicalAgentName>. Description: <tuxEventsDescription>"
詳細は、イベント・トラップに関するOracle Tuxedoのドキュメントを参照してください。
EMでTuxedoイベント収集を有効化するには、次の手順を実行します。
UBBCONFIG(5)
ファイルでTMSYSEVT
を構成します。beamgr.conf
で、TRAP_HOST
およびTMAGENT
を構成します。詳細は、Oracle SNMPエージェント構成ファイルのbeamgr.confに関する項を参照してください。トラップ・ホストはEMエージェント・ホストであり、ポートはEnterprise ManagerエージェントのSNMPリスニング・ポートです。これは、手順5のEnterprise Managerエージェントで構成されます。
TRAP_HOST 10.182.54.215 1061 public
SNMP_ENABLE_AUTH_TRAP 1
TMAGENT tuxedo_agent_1 /home/oracle/tuxedo12c /home/oracle/test/jmx/fakemp/master/tuxconfig
BEA_SM_SNMP_MIBFILE
およびBEA_SM_BEAMGR_CONF
を設定します。注意: | Enterprise ManagerエージェントがTuxedoドメインと同じマシンにある場合、末尾に-p オプションが付いているポート番号が、beamgr.conf で構成したトラップ・ポートと同じでないことを確認します。 |
注意: | 1つのEMエージェントで複数のTuxedoドメインをモニターする場合は、各Tuxedoドメイン・ターゲットのSNMPリスニング・ポートは1つのEMエージェント内で一意である必要があります。 |
図4-2に、EMにより作成され、Tuxedoイベント・トラップにより引き起こされるインシデントを示します。
注意: | ポスト・データが表4-1に示すフィールドを含む32ビットのフィールド化バッファである場合に、Tuxedoイベント・モニターでユーザー・イベントをモニターできます。TSAM Plusアラート定義によって生成されたTuxedoユーザー・イベントは、Tuxedo SNMPエージェントでトラップでき、その後Enterprise Manager for Oracle Tuxedoでモニターできます。また、TMUSREVT およびTMSYSEVT を、ユーザー・イベント・コレクションに対して構成する必要があります。 |
リスト4-1に、Enterprise Manager for Oracle Tuxedoによってトラップされるユーザー・イベントの例を示します。
#include <stdio.h>
#include <string.h>
#include <stdlib.h>
#include <errno.h>
#include <time.h>
#ifdef WIN32
#include <sys/types.h>
#endif
#include "atmi.h"
#include "userlog.h"
#include "Uunix.h"
#include <evt_mib.h>
#define NFLOATS 50 /* Number of string fields */
#define LEN (NFLOATS*sizeof(float))
static long long_v;
#define LFADDR(x) ( long_v=(x), (char*)&long_v )
int
main(int argc, char *argv[])
{
long len;
int error;
time_t currtime;
FBFR32 * buf;
char decTime[14];
if (tpinit((TPINIT *)NULL) == -1) {
(void)fprintf(stderr, "Failed to join application -- %s\n",
tpstrerror(tperrno));
(void)userlog("Clientpost failed to join application -- %s\n",
tpstrerror(tperrno));
(void)exit(1);
}
if ((buf = (FBFR32 *)tpalloc("FML32", NULL, Fneeded32(NFLOATS, LEN))) == NULL) {
(void)fprintf(stderr, "Failure to allocate FML32 buffer -- %s\n",
tpstrerror(tperrno));
(void)userlog("Clientpost failure to allocate FML32 buffer -- %s\n",
tpstrerror(tperrno));
(void)tpterm();
(void)exit(1);
}
if(Fadd32(buf, TA_EVENT_NAME, "Test Event", 0) == -1){
(void)fprintf(stderr, "Failed to add TA_EVENT_NAME field -- %s\n", Fstrerror32(Ferror32));
(void)tpfree((char *)buf);
(void)tpterm();
(void)exit(1);
}
if(Fadd32(buf, TA_EVENT_SEVERITY, "ERROR", 0) == -1){
(void)fprintf(stderr, "Failed to add TA_EVENT_SEVERITY field -- %s\n", Fstrerror32(Ferror32));
(void)tpfree((char *)buf);
(void)tpterm();
(void)exit(1);
}
currtime = time(NULL);
if(Fadd32(buf, TA_EVENT_TIME, LFADDR(currtime), 0) == -1){
(void)fprintf(stderr, "Failed to add TA_EVENT_TIME field -- %s\n", Fstrerror32(Ferror32));
(void)tpfree((char *)buf);
(void)tpterm();
(void)exit(1);
}
if(tppost("Test Event", (char *)buf, 0, TPSIGRSTRT) == -1)
{
(void)fprintf(stderr, "Failure to post request -- %s\n",
tpstrerror(tperrno));
(void)userlog("Clientpost failed to post request -- %s\n",
tpstrerror(tperrno));
/* Free any allocated buffers, leave the application, and exit */
(void)tpfree((char *)buf);
(void)tpterm();
(void)exit(1);
}
(void)tpfree((char *)buf);
(void)tpterm();
exit(0);
}
モニター対象のTuxedoターゲットのレポートには、Enterprise Manager GCソリューションが採用されています。BI Publisherは高度なカスタマイズが可能な製品であり、Enterprise Manager GCの推奨レポート・ソリューションの1つです。
BI Publisherインストレーション・ガイドに従って、既存のEnterprise ManagerにBIをインストールします。BIをインストールしたら、Enterprise Managerのホーム・ページで「エンタープライズ」→「レポート」→「BI Publisher Enterpriseレポート」をクリックすると、「BI Publisher Enterpriseレポート」ページに移動できます。
新しいWebappが開きます。新しいWebappへのログインには、Enterprise Manager管理者ユーザーであるsysmanのみ使用できます。
詳細は、Oracle Enterprise Manager 12c: BI Publisherのレポート処理を参照してください。
Enterprise Manager Service Level Agreement (SLA)機能をEnterprise Manager for Oracle Tuxedoで使用するためには、まず、汎用サービス・ターゲットを定義する必要があります。Enterprise Manager for Oracle Tuxedoでは、汎用サービス・ターゲットは、次のEnterprise Manager Systemターゲット上でのみ定義できます。
Enterprise Managerのホームページの上部のアクション・バーで、「ターゲット」→「サービス」をクリックし、「サービス」ダッシュボードを開きます。「サービス」ページの右上隅にある「ヘルプ」をクリックし、詳細を表示します。
Tuxedo SLAは、Enterprise Manager Services SLAによって管理されます。Enterprise Managerサービスを作成するには、次の手順を実行します。
詳細は、Oracle Enterprise Managerのオンライン・ドキュメントを参照してください。
リソース・ブローカは、Enterprise Manager for Oracle Tuxedoの重要な機能であり、定義済のOracle Tuxedoアプリケーションのポリシーに基づいてリソースの調整および割当てを柔軟に行います。リソース・ブローカには、次の主要な機能が含まれます。
TUXCONFIG
(UBBCONFIG
)構成ファイルで定義されているように、Tuxedoアプリケーション(ドメイン)は、マシン、サーバーおよびその他のリソースのセットです。1つのマシンにも、複数のクロス・ネットワーク接続マシンにも実装できます。Tuxedoアプリケーションを自動的にデプロイするには、まず、Enterprise Manager Consoleからアプリケーション・パッケージをアップロードする必要があります。アプリケーションの基本単位であるアプリケーション・パッケージには、複数のTuxedoアプリケーション・サーバーとTuxedoグループのその他のリソースが含まれます。Tuxedoアプリケーションは1つ以上のアプリケーション・パッケージで構成されます。
1つのアプリケーション・パッケージは、複数の異なるドメイン、複数の異なるマシンの1つのドメインまたは同一のマシンの1つのドメインに繰り返し適用できます。
アプリケーション・パッケージはzipファイルで、Tuxedoシステムで必要なTuxedoグループ構成ファイルがすべて含まれています(アプリケーション・サーバー、TMSサーバー、ENVFILE、アプリケーション・レベルの構成ファイルなど)。アプリケーション・パッケージの構造を図4-6に示します。
最初のディレクトリの下にサブディレクトリを作成し、アプリケーションを編成することもできます。上図に示すように、サブディレクトリ・サーバーには、Server1とServer2という2つのアプリケーション・サーバーがあります。
図4-7に、パッケージのマシンへのデプロイ後の、マシンのアプリケーション構造を示します。DOM1下のアプリケーション構造は、元のアプリケーション・パッケージの構造と変わりません。
Properties.xml
ファイルは、グループ・レベルのUBBCONFIG
ファイルです。このファイルには、パッケージのグループ内のすべてのサーバーの関係およびパラメータが記述されています。これには完全なUBBCONFIG
ファイルの*GROUPS
、*RMS
、*SERVERS
および*SERVICES
の各セクションにあるプロパティが含まれ、複数のグループも組み込むことができます。
パッケージをマシンにデプロイする際に、Properties.xml
ファイルが使用されて最終的なUBBCONFIG
ファイルが生成されるため、その時点でそのコンテンツを変更できるようになります。
単純なProperties.xml
ファイルをリスト4-2に示します。
<ApplicationProperties>
<PackageName>APP1.zip</PackageName>
<TuxedoVersion>12.1.3.0.0</TuxedoVersion>
<SupportedOS>Linux</SupportedOS>
<TuxedoWordSize>64<TuxedoWordSize>
<MachineArch>x86_64</MachineArch>
<LibPath>/path/to/libs</LibPath>
<Groups>
<GroupSection GROUPNAME="G1" GRPNO="29999">
<ServerSections>
<ServerSection AOUT="servers/simpserv1" SRVID="20">
</ServerSection>
</ServerSections>
</GroupSection>
</Groups>
</ApplicationProperties>
Groups
要素内のTuxedoグループの関連情報に加え、表2-2に示すように、Properties.xml
ファイルの先頭には、パッケージ・グローバル属性がいくつか定義されています。
UBBCONFIG
ファイルの*GROUPS
、*RMS
、*SERVERS
および*SERVICES
の各セクションのすべてのパラメータは、3つのカテゴリに分けられます。これにより、Propertise.xml
での定義方法が決まります。
表4-3に、*GROUPS
、*RMS
、*SERVERS
および*SERVICES
セクションの各パラメータのカテゴリを示します。
詳細は、Enterprise Manager for Oracle TuxedoリファレンスのProperties.xmlスキーマに関する項を参照してください。
コマンドbuildtms
によって生成されるTMS実行可能ファイルを、tmboot
を実行中にTuxedo Application Runtimeでアクセスできるようにするには、TMS実行可能ファイルをアプリケーション・パッケージのサブディレクトリbin
に置く必要があります。<package_name>/bin
フォルダは、生成されるsetenv
ファイルの環境変数PATH
に付加されます。setenv
ファイルは、Tuxedoアプリケーションを起動する前にソーシングされます。
前述のENVFILE
、RCMD
、およびTMSYSEVT -f
によって指定されたcontrol_file
の場合、この機能では、APPDIR
以外のディレクトリへのデプロイをサポートしていません。たとえば、APPDIR
が/nfs/lcfilerc/vol1/APPDIR
の場合、ENVFILE
が/nfs/lcfilerc/vol1/APPDIR/APP1/…
の下にあるため、UBBCONFIG
でENVFILE=/nfs/lcfilerc/vol2/envfile
を指定できません。
注意: | Databaseクライアント・ライブラリなど、Tuxedoサーバーに依存するサード・パーティ製のライブラリはすべて、この機能のデプロイメント範囲には含まれません。 |
アプリケーション・パッケージを準備したら、Enterprise Managerコンソールを使用してパッケージをアップロードする必要があります。これは、「Tuxedoサマリー」ページで実行できます。詳細は、「Tuxedoサマリーの表示」を参照してください。
注意: | パッケージ名はアップロードされたすべてのパッケージで一意である必要があります。一意でない場合は、アップロード・ページでエラーが報告されます。 |
既存のアプリケーション・パッケージを削除するには、次の手順を実行します。
ドメインUBBCONFIG
エディタは、Oracle Tuxedoドメインの作成や検出されたOracle Tuxedoドメインの編集に使用されます。ドメイン・エディタ・ページを開くには、「Tuxedoサマリー」ページで、「追加」→「Tuxedoドメインの作成」をクリックします。「OK」をクリックします。ドメイン・エディタの最初のページが表示されます。
注意: | ドメイン名は、現在のEM内でグローバルに一意であり、0から256文字である必要があります。 |
ドメイン・エディタの上部にあるエディタのヘッダーには、次の情報が表示されます。
ページの右上隅にリフレッシュ・ボタンが表示されます。ボタンをクリックすると、ドメインのステータスとともに「マシン」/「パッケージ」リストも更新されます。
表4-4に、「コントロール」パネルのコントロール・ボタンを示します。
詳細は、「ポリシー管理」を参照するか、またはページの右上の「ヘルプ」をクリックしてください。
|
|
「セキュリティ管理」を開きます。Tuxedoアプリケーションをアセンブルする際にTuxedo
SECURITY を有効化する場合は、「セキュリティ管理」ページで、特定の認証および認可に関連した情報を構成する必要があります。詳細は、「セキュリティ管理」を参照するか、またはページの右上の「ヘルプ」をクリックしてください。
|
|
TuxedoドメインのARTバッチに固有のTuxedoシステム・サーバーを構成できます。詳細は、「JES構成」を参照するか、またはページの右上の「ヘルプ」をクリックしてください。ARTバッチ・ドメインではない既存のドメインでは、このボタンは無効です。
|
|
TuxedoドメインのART CICSに固有のTuxedoシステム・サーバーを構成できます。詳細は、「ART CICS用リソース・ブローカの使用」を参照してください。ART CICSドメインではない既存のドメインでは、このボタンは無効です。
|
|
「マシン・リスト」パネルには、Tuxedoドメインのデプロイに使用可能な、EMによって管理されるマシンがすべて表示されます。Tuxedoドメインのデプロイメントに使用するマシンは、次の2つの前提条件を満たしている必要があります。
注意: |
マシン・エントリの+ボタンをクリックすることによってマシンが現在のドメインに追加されると、マウス・カーソルをそのマシン・エントリの上に置くと、マシン情報がツールチップとして表示されます。
「パッケージ・リスト」パネル(右下)には、アップロードされたパッケージがすべて表示されます。また、パッケージ名の上にマウス・カーソルを置くと、パッケージの詳細な情報が表示されます。
左側がUBB
セクションのパネルです。UBBCONFIG
ファイルの各セクションは、パネル・ボックスに対応しています。この領域では各セクションの有効なパラメータのみが編集可能です(つまり、マスター・マシンのバージョンに属するパラメータのみが定義できます)。
Oracle Tuxedoドメイン作成の初期段階では、ドメインUBBCONFIG
エディタの*RESOURCES
セクションで、限定されたパラメータ・セットが提供されます。これは、Tuxedoのバージョン間で異なることはありません。
*RESOURCES
セクションの「詳細」…および他のセクションの「追加」…は無効です。これらのパラメータは、マスター・マシンがドメインに追加されるまで表示されます。マスター・マシンがドメインに追加されると、マスター・マシンのTuxedoバージョンに従って、各セクションのすべての無効なパラメータが選別され、非表示になります。
ドメイン・エディタに初めてアクセスしたときには、メトリックを収集する目的で、OPTIONS
パラメータのインジケータEXT_MON
がデフォルトで設定されています。
このパネルには、ドメインを作成するときに、UBBCONFIG
ファイルの*RESOURCES
セクションの生成用に選択可能なUBB_Resource
テンプレートが用意されています。このテンプレートのアイテムを表4-5に示します。
MASTER
を除いてすべての項目を変更できます。MASTER
の項目は、マスター・マシンおよびバックアップ・マシンを指定する際にロックされた変数として生成されます。これらのパラメータに加えて、他のパラメータも追加できます。
固有のUBB_Resource
テンプレートを作成し、これらをソフトウェア・ライブラリに保存することも可能です。すべてのテンプレートで、MASTER
は前述のルールに従って自動的に入力されます。
このパネルには、ドメインを作成してマシンを指定するときに、UBBCONFIG
ファイルのMACHINES
セクションの生成用に選択できるUBB_Machine
テンプレートが用意されています。このテンプレートのアイテムを表4-6に示します。
UBBCONFIG
ファイルの*MACHINES
セクションのその他のパラメータを追加することも可能です。TLOGをロー・ディスクに指定することもできます。このドメインをアンデプロイするとき、システムで削除されます。
固有のUBB_Machine
テンプレートを作成し、これらをソフトウェア・ライブラリに保存できます。パラメータの置換は、表4-6に記載のルールに従います。
アプリケーション・パッケージをドメインに追加すると、表4-7に示すように、Properties.xml
の*GROUPS
セクションのパラメータが一部置き換えられます。
詳細については、表4-3を参照してください。他のパラメータをUBBCONFIG
ファイルに追加することも可能です。
アプリケーション・パッケージをドメインに追加すると、表4-8に示すように、Properties.xml
の*RMS
セクションのパラメータが一部置き換えられます。
詳細については、表4-3を参照してください。他のパラメータをUBBCONFIG
ファイルに追加することも可能です。
このセクションのすべてのパラメータは、必要に応じてユーザーが手動で入力する必要があります。
このセクションはUBB_Machine
テンプレートにも含まれています。ドメインがMPモードである場合は、このセクションは表4-9に示すように、UBBCONFIG
ファイルに自動的に追加されます。
他のパラメータをUBBCONFIG
ファイルに追加することも可能です。
アプリケーション・パッケージをドメインに追加すると、表4-10に示すように、Properties.xml
の*SERVERS
セクションのパラメータが一部置き換えられます。
詳細については、表4-3を参照してください。他のパラメータをUBBCONFIG
ファイルに追加することも可能です。
アプリケーション・パッケージをドメインに追加すると、表4-11に示すように、Properties.xml
の*SERVICES
セクションのパラメータが一部置き換えられます。
詳細については、表4-3を参照してください。他のパラメータをUBBCONFIG
ファイルに追加することも可能です。
アプリケーション・パッケージをドメインに追加すると、Properties.xml
の*ROUTING
セクションのパラメータが一部置き換えられます。
Properties.xml
ファイルの*ROUTING
セクションの他のパラメータの場合、これらの値は保持され、手動で変更できます。他のパラメータをUBBCONFIGfile
に追加することもできます。
通常、アプリケーション・パッケージをTuxedoドメインにデプロイするためには、次の手順を実行する必要があります。
各マシンにはアプリケーション・パッケージが1つ必要です。「アプリケーション・パッケージの構成とコンテンツ」の説明を参照し、2つのアプリケーション・パッケージAPP1.zip
およびAPP2.zip
を準備します。
APP1.zipのコンテンツ構造を図4-8に示します。
APP1.zip Properties.xml
をリスト4-3に示します。
<?xml version="1.0" encoding="ISO-8859-1" ?>
<ApplicationProperties>
<PackageName>APP1.zip</PackageName>
<TuxedoVersion>12.1.3.0.0</TuxedoVersion>
<SupportedOS>Linux</SupportedOS>
<TuxedoWordSize>64</TuxedoWordSize>
<MachineArch>x86_64</MachineArch>
<GroupSection GROUPNAME="GROUP1" GRPNO="29999">
<MRM>N</MRM>
<ServerSections>
<ServerSection AOUT="servers/simpserv1" SRVID="30000">
<CONV>N</CONV>
</ServerSection>
</ServerSections>
</GroupSection>
</ApplicationProperties>
APP2.zip
のコンテンツ構造を図4-9に示します。
APP2.zip Properties.xml
をリスト4-4に示します。
<?xml version="1.0" encoding="ISO-8859-1" ?>
<ApplicationProperties>
<PackageName>APP2.zip</PackageName>
<TuxedoVersion>12.1.3.0.0</TuxedoVersion>
<SupportedOS>Linux</SupportedOS>
<TuxedoWordSize>64</TuxedoWordSize>
<MachineArch>x86_64</MachineArch>
<GroupSection GROUPNAME="GROUP1" GRPNO="29999">
<ServerSections>
<ServerSection AOUT="servers/simpserv2" SRVID="20000" />
<ServerSection AOUT="servers/simpserv3" SRVID="20010" />
</ServerSections>
</GroupSection>
</ApplicationProperties>
アプリケーション・パッケージを準備したら、「パッケージのアップロード」を参照し、「Tuxedoサマリー」ページで「アプリケーション・パッケージの管理」を選択してパッケージをEMにアップロードします。
Tuxedoドメインのデプロイにホストを使用できるようにするには、ホストのEMエージェントによってTuxedo tlisten
とTuxedoホーム・ターゲットを検出しておく必要があります。
Tuxedo tlisten
ターゲットとTuxedoホーム・ターゲットを検出するには、次の手順を実行します。
注意: | 前述の検出プロセスによって、2つのターゲットを検出する必要があります。2つのターゲットをスタンドアロン・ターゲットとして別々に追加しても、リソース・ブローカでは機能しません。 |
デプロイするTuxedoドメインを準備するには、Enterprise Managerによって検出された既存のドメインを編集するか、新しいドメインを作成します。2つのタイプのTuxedoドメイン、SHMドメインとMPドメインを作成できます。
*RESOURCES
セクションに入力します。次の点に注意してください。マシン関連情報を収集するためのポップアップ・ダイアログが表示されます。
初めてマシンを追加する場合は、「アプリケーション・ホーム」オプションを指定する必要があります。アプリケーション・ホームは、すべてのドメインのデプロイ先のルート・ディレクトリです。
マシンを追加する場合は、「環境パス変数」も指定できます。コロン(UNIX/Linux)またはセミコロン(Windows)区切りの文字列で、環境固有のコマンドの検索先のパスを含みます。たとえば、ユーザー・プログラムで使用されるコンパイラやOracle DBクライアントです。
UBBCONFIG
ファイルの*MACHINES
セクションのすべてのパラメータを含む、別のポップアップ・ダイアログが表示されます。
MPドメインの作成手順は、SHMドメインの作成手順と似ています。追加のタスク(デプロイに使用可能な別のマシンの追加)が必要です。
EMエージェントを新しいホストにデプロイする手順は、次のとおりです。
Tuxedoドメインのデプロイに新たに追加したマシンを使用できるようにするには、EMエージェントによってtlisten
プロセスが開始され、「Tuxedoドメイン検出」ページで検出される必要があります。手順説明は、「Tuxedo tlistenおよびTuxedoホームの検出」を参照してください。tlisten
ターゲットおよびTuxedoホーム・ターゲットが検出されたら、ドメインUBBCONFIGエディタ・ページでステータスを確認します。マシン・リストには、新たに追加されたマシンが表示されています。
注意: |
アプリケーション・パッケージをドメインに追加するには、次の手順を実行します。
注意: | パッケージがマシンに適していない場合は、+ボタンは無効になります。 |
パッケージのProperties.xml
に記述されているすべてのエントリが、図4-10に示すように、対応するUBBCONFIG
ファイルのセクションに追加されます。
GROUPS
エントリおよびSERVERS
エントリの前の(*)記号は、デプロイされていない、このドメインに新たに追加されたアイテムを示しています。
GROUPNAME
パラメータおよびGRPNO
パラメータは、パッケージの追加時に自動的に生成されます。Properties.xml
で定義されたすべてのグループおよびそのアセットがドメインに追加されます。マシン・エントリとは異なり、1つのアプリケーション・パッケージを複数回追加できます。
これで、Tuxedoドメインのデプロイとモニターの準備が整いました。
Tuxedoドメインに必要なすべての構成が完了したら、次の手順を実行してドメインをリモート・マシンにデプロイします。
注意: | すべてのデプロイ・プロセスで、このドメインに含まれるすべてのマシンのユーザー資格証明が必要です。ユーザー資格証明を入力しておくと、記憶済のものが表示されます。ターゲット・マシンに対して有効なOSのユーザーであり、アプリケーション・ホーム・ディレクトリに対する書込み権限がある必要があります。ユーザーは、管理エージェントをインストールしたユーザー・グループと同じグループに属している必要があります。 |
図4-11に、ドメイン・デプロイメント・オプション画面を示します。
注意: | 特定の情報は既存のドメインから収集できないため、新しいマシンや特定のサーバーを既存のドメインにデプロイする場合は、デプロイの前に追加のスクリプトを手動で追加する必要があります。 |
すべての手順に成功すると、ドメインがターゲット・マシンのアプリケーション・ホームにデプロイされ、起動されます。デプロイメントの最後のステップはCheckDeployStatusです。ここでは、デプロイメント・ステータスが確認され、ドメイン・エディタの対応するエントリのステータスがそれに応じて変更されます。デプロイメントに成功すると、ドメインの自動検出が実行されます。ドメインに属する、新たに検出されたターゲットは、「Tuxedoサマリー」ページの「すべてのターゲット」に表示されます。
アプリケーション・パッケージを動的にデプロイするには、次の手順を実行します。
ドメインのコンテンツが ドメインUBBCONFIGエディタ・ページにリロードされます。
APP2.zip
のProperties.xml
に記述されているグループの2つのサーバーsimpserv2
とsimpser3
が、*SERVERS
セクションに追加されます。
注意: |
デプロイメントが完了すると、新しいディレクトリAPP2
がドメインAPPDIR
に存在し、GROUP2
およびsimpserv2/simpserv3
が作成された状態になります。
場合によっては、アップロードしたアプリケーション・パッケージの更新が必要なことがあります。現時点では、次の手順に従って手動で更新できます。
パッケージに関連付けられたグループがマシンに追加されると、パッケージ名の横にあるXボタンが使用可能になり、パッケージをマシンから削除できるようになります。
パッケージに関連付けられたグループを削除するには、次の手順を実行します。
動的リソース・ブローカを使用すると、特定のEnterprise Managerターゲットの柔軟なリソース割当てを実現するために、実行中のOracle Tuxedoドメインに、Tuxedoサーバー、グループおよびマシンを手動およびポリシー主導でデプロイできます。
Tuxedoアプリケーション・パッケージおよびTuxedoマシンは両方とも、アクティブ・ドメインに手動で追加できます。
ドメインに新たに追加されたパッケージ(アスタリスクで(*)で表示)がある場合に、パッケージを手動でデプロイするには、「コントロール」パネルで「保存してデプロイ」をクリックします。
「保存してデプロイ」ボタンをクリックすると、現在のドメイン編集ステータスが保存され、ドメインUBBCONFIG
で完全検証が開始されます。検証に失敗すると、デプロイメント・プロセスが停止し、エラー・メッセージが表示されます。
注意: | 「追加…」リンクをクリックして手動で追加されたUBBCONFIG エントリは、動的にデプロイおよびアクティブ化できません。 |
注意: | 動的デプロイメントは、アプリケーション・パッケージからインポートされたUBBCONFIG エントリでのみ機能します。手動で追加したUBBCONFIG エントリを有効にするには、ドメインの完全なデプロイを実行する必要があります。 |
収集済のマシンの資格証明を使用してデプロイメントがただちに実行され、新しいマシンがスレーブ・マシンとしてドメインに追加されます。
注意: | マシン・レベルの動的デプロイメントでは、MPモードのドメインのみをサポートしています。 |
次の3つのレベルの動的デプロイメントは、ユーザー定義のポリシーにより実行されます。
アクティブなTuxedoマシン上での1つ以上のアプリケーション・パッケージの動的なデプロイまたはアンデプロイは、一定の条件(CPU負荷が低く、60%を超えないなど)の下でトリガーされます。パッケージをデプロイするマシンは、事前定義されたフィルタリング・ポリシーに従って候補マシンの中から最終的に選択されます。
パッケージ・レベルのポリシーを作成する前に、候補としてパッケージ・リストからパッケージを追加(「候補として」チェック・ボックスを選択)しておく必要があります。インポートされた各UBBCONFIG
エントリで「編集」をクリックしてそのエントリの詳細構成を変更し、ポリシー管理コンソールで候補パッケージに対してデプロイメント・ポリシーを作成できます。
注意: | パッケージの動的なデプロイの前に、新たに導入されたTMSサーバーを、Tuxedoの起動時にPATH 環境変数で参照されるディレクトリの下に置く必要があります。そうしないと、TMSサーバーがパッケージのbinサブディレクトリにある場合でも、Tuxedo Application Runtimeで検出できません。 |
マシンの動的なデプロイとアンデプロイは、ポリシーで定義されている条件(インシデント・ルール)に一致した場合にトリガーされます。
新たに追加されたマシン・エントリにポリシーを定義し、これらを候補マシンに変換できます。デプロイされるマシンは、事前定義されたフィルタリング・ポリシーに従って候補マシンの中から最終的に選択されます。
動的なマシン・レベル・デプロイメントは、パッケージ・レベル・デプロイメントと併用されることがよくあります。マシンを動的にデプロイすると、マシンに追加されたパッケージが同時にデプロイされます。
実行中のデプロイされたTuxedoサーバーの数は、ポリシーで定義されている条件(インシデント・ルール)に一致すると、自動的に増減します。サーバーの最小数および最大数は、UBBCONFIG
に設定されているMIN
およびMAX
パラメータに応じて異なります。
詳細については、「ポリシー」を参照してください。
リソース・ブローカのデプロイメント・ポリシー(Enterprise Managerのインシデント・ルールに連動)は、リソース・ブローカのデプロイメント・ポリシー評価がトリガーされる条件を定義します。
インシデント・ルールでは、リソース・ブローカ・ポリシーをトリガーする条件を詳細に指定します。条件は複雑で、イベントの特性(イベントの種類、重大度、カテゴリなど)を表す条件の組合せから構成されている可能性があります。インシデント・ルールを定義することによって、次の条件のいずれかが満たされたときにデプロイメント・ポリシーを評価することを指定できます。
インシデント・ルールにはあらゆるモニター対象のターゲットから提供されるメトリックを含めることができます。特定のターゲットについてインシデント・ルールを評価するには、ターゲットにEnterprise Managerグループを作成し、このグループをルール・セットで参照します。
CPUメトリック・イベントのタイプを定義する方法を説明する例として、次の手順を示します。ポリシーを作成する前に、インシデント・ルールを作成する必要があります。
注意: | このステップでは個々のグループの選択が重要です。正しく選択しないと、ターゲットにある同じタイプのすべてのイベントでインシデント・ルールが実装されます。 |
新たに作成されたイベントが「メトリック・アラート」パネルに表示されます。
これはつまり、インシデントが発生した場合、Tuxedoイベント接続が通知されることを意味します。
「すべてのエンタープライズ・ルール」ページでは、インシデント・ルールがアクティブ・ステータスでTuxedoインシデント・ルール・ルール・セットの下に追加されます。
ポリシーは、ポリシー管理コンソールで一元的に定義および管理されます。ポリシー管理コンソールを開くには、ドメイン・エディタの「コントロール」パネルで「ポリシー」をクリックします。
インシデント・ルールを定義したら、ポリシー管理コンソールで「追加」をクリックし、「ポリシー・プロパティ」ページでオプションを指定すると、ポリシーを作成できます。詳細は、「ポリシー管理」を参照するか、またはページの右上の「ヘルプ」をクリックしてください。
「Tuxedoサマリー」ページには、ドメイン・エディタで作成されたTuxedoドメイン・ターゲットのコントロール・セットが組み込まれています。ドメイン・ターゲットを右クリックすると、リソース・ブローカに固有のアクションが「コントロール」メニュー・アイテムに表示されます。
このアクションは、ドメイン・エディタ・ページのものとまったく同じです。ドメインが停止中またはターゲット・マシンにデプロイされていない場合は、完全なデプロイが実行されます。ドメインがアクティブ・ステータスである場合、新たに追加されたパッケージが動的にデプロイされてアクティブ化されます。
ドメインは、デプロイ後に起動できるように構成する必要があります。このアクションは、アクティブ・ステータスでないドメインにのみ適用できます。
デフォルトの構成アクションは、マスター・マシンでUBBCONFIG
のtmloadcf
を実行することです。ドメインの起動前に実行しておく必要がある特定の構成(TLOGデバイスやQUEUEスペースの作成など)がある場合は、スクリプトをカスタマイズできます。
このアクションは、アクティブ・ステータスでないドメインに適用できます。「起動」のデフォルトのアクションは、マスター・マシンでtmboot -y
を実行することです。ブート・スクリプトをカスタマイズすることもできます。
このアクションは、アクティブ・ステータスのドメインにのみ適用できます。「停止」のデフォルトのアクションは、マスター・マシンでtmshutdown -y
を実行することです。停止スクリプトをカスタマイズすることもできます。
このアクションは、アクティブ・ステータスでないドメインにのみ適用できます。「アンデプロイ」のデフォルトのアクションは、ターゲット・マシンでAPPDIR
全体を削除することです。APPDIR
を削除する前に、構成解除スクリプトをカスタマイズしてクリーンアップを実行できます。
TuxedoドメインでARTバッチ用リソース・ブローカを使用するには、サーバー・パラメータとJESパラメータの両方を構成する必要があります。既存のドメインの場合は、これらの情報はランタイム環境から内部参照されます。すべての構成は、リソース・ブローカによって作成されたドメインと同じように調整できます。
ARTバッチを正常に機能させるためには、ARTバッチ固有のいくつかのTuxedoシステム・サーバーをTuxedoドメインで構成する必要があります。たとえば、サーバーARTJESADM
、ARTJESCONV
、ARTJESINITIATOR
およびARTJESPURGE
は、動作中のART JESシステムに必要です。
ARTバッチはOracle Tuxedo Eventコンポーネントを使用するため、Oracle Tuxedoユーザー・イベント・サーバーTMUSREVT
がUBBCONFIG
ファイルに必要です。さらに、JESジョブ情報を格納するために、TMQUEUE
サーバーも必須です。
これらのTuxedoシステム・サーバーを追加するには、次の3つの方法があります。
ドメインUBBCONFIGエディタの「サーバー」セクションで「追加」をクリックすると、サーバーを手動で追加できます。正しいパラメータ(CLOPT
)をサーバーに指定したことを確認します。ドメインに構成を保存すると、ドメイン・エディタにより、システム・サーバーに対してCLOPT
検証が実行されます。
システム・サーバーの関連情報は、Properties.xm
lに記述して、アプリケーション・パッケージにまとめることができます。アプリケーション・パッケージをTuxedoドメインに追加することにより、それに応じて、対応するサーバーが追加されます。
これが、ポリシー主導の動的リソース・ブローカの機能を使用する唯一の方法です。
アプリケーション・パッケージにまとめられた前述のサーバーには、対応するバイナリはありません。これらのシステム・サーバー・バイナリは、ARTバッチ・インストール・ディレクトリに含まれています。
システム・サーバーは、1つのサーバー名を使用してProperties.xml
内で参照されます。
サーバー・テンプレートを使用してARTバッチ関連サーバーを追加できます。実行する手順は次のとおりです。
サーバーTMQUEUE
に使用されるTMS_QM
にはTLOGデバイスが必要であるため、サーバー・テンプレートの適用後にパスが指定されていない場合は、対応するマシンのTLOGDEVICE
およびTLOGSIZE
パラメータが$APPDIR/TLOG
に対して構成されます。
JES構成ファイルは、TuxJES管理サーバーであるARTJESADM
によって使用されます。JES構成ファイルの次のパラメータを構成できます。
JESROOTベース・ディレクトリ。これが設定されていない場合は、ベース・ディレクトリは$APPDIR
になります。
JESROOT
ジョブ情報を格納するルート・リポジトリ。このディレクトリは、JES Base Directoryで設定されたパスの下に作成されます。たとえば、JESROOT
がjesroot
に設定されており、JESベース・ディレクトリが$APPDIR
に設定されている場合、JESROOT
ディレクトリのフルパスは{$APPDIR}/jesroot
です。
注意: | ARTバッチに関連するサーバーが2つのTuxedoマシン上で構成される場合は、同一のJESROOT リポジトリを共有する必要があります。つまり、JESROOT の絶対パスのみが許容されるため、このディレクトリはネットワーク・ファイル・システムに存在する必要があります。 |
DEFAULTJOBCLASS
オプション。JCLでジョブ・クラスが設定されていない場合のデフォルト・ジョブ・クラス。このオプションが設定されていない場合のデフォルト・ジョブ・クラスは、Aです。
DEFAULTJOBPRIORITY
オプション。JCLでジョブ優先度が設定されていない場合のデフォルトのジョブ優先度。このオプションが設定されていない場合のデフォルトのジョブ優先度は、0です。
DUPL_JOB
NODELAY
が選択されていない場合、ジョブ名ごとに1つのジョブのみが実行ステータスであることができます。選択されている場合は、NODELAY
は、依存性チェックを削除します。
EVENTPOST
個別のステージで、ジョブに対してポストされるイベントを指定します。
JOBREPOSITORY
格納されたジョブ・リポジトリのパス。設定された場合、ジョブ送信スクリプト・ファイル・パスに、JOBREPOSITORY
内の相対パスを使用できます。
PRIVILEGE MODE
ユーザー置換を有効化するかどうか、およびその方法を指定します(TuxJESユーザー置換に関する項を参照してください)。
NONE
: デフォルト値。ジョブが、JESシステムを起動するOSユーザーによって実行されることを示します。これは、これまでのJESシステムの実装すべてと互換性があります。 USER_IDENTICAL
: ジョブが、JESシステムに参加するJESクライアントを使用して、Oracle Tuxedoユーザーによって実行されることを示します。このオプションを選択する前に、Oracle Tuxedoの各ユーザーが既存のOSユーザーに対応することを確認します。 USER_MAPPING
: JESシステムはTuxJESユーザー・マッピング・ファイルを参照し、JESシステムに参加するJESクライアントのOracle Tuxedoユーザーに対応するOSユーザーを検出して、このOSユーザーをジョブの実行者として指名します。 USER MAPPING FILE
USER_MAPPING
を権限モードとして選択した場合に、このオプションは有効になります。ユーザー・マッピング・ファイルの名前を指定します。ユーザー・マッピング・ファイルは、デフォルトで$APPDIR
ディレクトリの下にあります。
リソース・ブローカによって作成されたユーザー・マッピング・ファイルの所有者はrootで、そのファイル権限は-rw-------
です。
注意: | ユーザー・マッピング・ファイルに次の名前は指定できません。 |
USER MAPPING Table
ユーザー・マッピング表には、Oracle TuxedoユーザーとOSユーザーの間のマッピング関係が表示されます。権限モードがUSER_MAPPING
に設定されている場合、ユーザー・マッピング表が有効なため、ユーザー・マッピング・エントリの追加、編集または削除が可能です。マッピング表の各行は次の形式です。
tuxedousername OSusername
注意: |
権限モードをUSER_IDENTICAL
またはUSER_MAPPING
のいずれかに設定した場合、リソース・ブローカにより、次の権限設定が自動的に実行されます。
リスト4-5は、UBBCONFIG
ファイルの例を示しています。
*RESOURCES
IPCKEY <IPCKEY> # for example 132770
DOMAINID jessample
MASTER SITE1
MODEL SHM
MAXACCESSERS 200
MAXSERVERS 50
NOTIFY SIGNAL
PERM 0666 #Adding "PERM=0666" in RESOURCES section
SECURITY USER_AUTH
AUTHSVC "AUTHSVC"
*MACHINES
#
<uname -n>
LMID = SITE1
TUXDIR ="<full path of TUXEDO software>"
TUXCONFIG = "<full path of APPDIR>/tuxconfig"
TLOGDEVICE ="<full path of APPDIR>/TLOG"
TLOGSIZE=10
APPDIR = "<full path of APPDIR>"
ULOGPFX = "<full path of APPDIR>/ULOG"
*GROUPS
ARTGRP
LMID = SITE1 GRPNO = 1
QUEGRP
LMID = SITE1 GRPNO = 2
TMSNAME = TMS_QM TMSCOUNT = 2
OPENINFO = "TUXEDO/QM:<full path of APPDIR>/QUE:JES2QSPACE"
EVTGRP
LMID= SITE1 GRPNO=3
#
*SERVERS
# Adding RQPERM=0666 RPPERM=0666 in all JES servers entry in SERVERS section
DEFAULT: CLOPT="-A"
TMUSREVT SRVGRP=EVTGRP SRVID=1 CLOPT="-A"
RQPERM=0666 RPPERM=0666
TMQUEUE
SRVGRP = QUEGRP SRVID = 1
GRACE = 0 RESTART = Y CONV = N MAXGEN=10
CLOPT = "-s JES2QSPACE:TMQUEUE -- -t 5 "
RQPERM=0666 RPPERM=0666
ARTJESADM SRVGRP =ARTGRP SRVID = 1 MIN=1 MAX=1
CLOPT = "-A -- -i jesconfig"
RQPERM=0666 RPPERM=0666
ARTJESCONV SRVGRP =ARTGRP SRVID = 20 MIN=1 MAX=1
CLOPT = "-A --"
RQPERM=0666 RPPERM=0666
ARTJESINITIATOR SRVGRP =ARTGRP SRVID =30
CLOPT = "-A -- -n 20 -d"
RQPERM=0666 RPPERM=0666
ARTJESPURGE SRVGRP =ARTGRP SRVID = 100
CLOPT = "-A --"
AUTHSVR SRVGRP=ARTGRP SRVID=104 CLOPT="-A"
RQPERM=0666 RPPERM=0666
*SERVICES
権限モードをUSER_IDENTICAL
またはUSER_MAPPING
のいずれかに設定する場合は、次の権限の要件を満たす必要があります。
UBBCONFIG
の権限要件Oracle Enterprise Manager Cloud Controlで、「設定」→「セキュリティ」→「権限委任」をクリックします。詳細は、Oracle Enterprise Managerライフサイクル管理者ガイドの権限委任設定の構成に関する項を参照してください。
「その他の構成」フィールドの次のオプションを構成し、ARTバッチ関連情報を指定できます。
JESキュー初期化スクリプト。JESのsimpjobという例で提供されているテンプレートが、デフォルトとして使用されます。テキスト・フィールドをカスタマイズできます。その場合、キュー・ファイル名はQUEにする必要があります。
必須。ページでARTバッチ・インストール・ディレクトリを指定する必要があります。
注意: | MPドメインを構成する場合は、すべてのマシンのARTバッチ・インストール・ディレクトリのパスが同じである必要があります。 |
PDKSH
オプション。ARTバッチの実行に使用される、PDKSH
の実行可能ファイルです。指定されていない場合、実行時にシステムのデフォルトのksh
コマンドが使用されます。
注意: |
静的デプロイメントを使用する場合、すべてのARTバッチ関連のシステム・サーバーが、その他のサーバーとしてUBBCONFIG
ファイルにアセンブルされます。保存済のJES構成ファイルは、デプロイメントのために配布パッケージに組み込まれます。デプロイされたJES構成ファイルの名前は、ARTJESADM
CLOPT
の-i
オプションで指定されます。JESROOT
ディレクトリは、この段階では作成されません。これは、実行時にARTバッチによって自動的に作成されます。
JESが構成される場合は、次の環境変数設定がsetenv.sh
ファイルに追加されます。
JESDIR=<full path of ART JES software>
MT_KSH=<full path of pdksh>
MT_ROOT=$JESDIR/ejr
PATH=$JESDIR/bin:$PATH
QMCONFIG=$APPDIR/QUE
DATA_SOURCE=$APPDIR/data_source
DATA=$APPDIR/data
TMP=$APPDIR/tmp
MT_TMP=$APPDIR/tmp
MT_ACC_FILEPATH=$APPDIR/acc
MT_LOG=$APPDIR/Logs/log
SPOOL=$APPDIR/Logs/sysout
構成中、デフォルトのjesqinit
スクリプトまたはユーザー定義スクリプトによって、JES QUEUE
システムが初期化されます。
パッケージ・レベルの動的デプロイメントは、既存のリソース・ブローカ・フレームワークによって処理されます。
JES関連Tuxedoシステム・サーバーは、様々なアプリケーション・パッケージに組み込まれるProperties.xml
に記述されます。これらのパッケージを候補として既存のドメインに追加し、そのポリシーを定義できます。ポリシーが実行する必要があると評価された場合は、パッケージがデプロイされ、そこに記述されているサーバーがアクティブ化されます。
注意: | 動的デプロイメントは、パッケージ(サーバー)レベルでのみ使用できます。JESCONFIG では、動的デプロイメント(たとえば、ARTバッチが構成されていないTuxedoドメインの実行)をサポートしません。JESCONFIG は動的に実行できません。 |
ART CICS用リソース・ブローカを使用する場合、Tuxedo提供の複数のシステム・サーバーをUBBCONFIG
ファイルで構成し、ART CICSランタイムのリソース・ブローカを有効にする必要があります。既存のドメインの場合は、これらの情報は自動的に内部参照されます。ART CICSおよびCOBOLコンパイラは、ドメイン内に構成された各マシンの同じ場所にインストールする必要があります。
これらのTuxedoシステム・サーバーを追加するには、次の3つの方法があります。
詳細は、「Tuxedoシステム・サーバーの手動追加」を参照してください。
ART CICS固有のシステム・サーバーは次の2つのカテゴリに分類できます。
ART CICS提供のシステム・サーバーの場合は、Properties.xml
でサーバー名のみが参照されます。
ユーザーが構築可能なシステム・サーバーの場合は、Properties.xml
で定義したサーバー名を、表示されたサーバー名の先頭に付ける必要があります。
サーバー・テンプレートを使用してART CICS関連サーバーを追加できます。次の手順を実行します。
CICSアプリケーション・パッケージは、様々なCICSリソースの処理のために特に導入されました。
Tuxedoアプリケーション・パッケージと同様に、CICSアプリケーション・パッケージは、CICSランタイム実行用のアセットを含む.zip
ファイルです。これには、次に記述されるコンポーネントが含まれています。
(zip
ファイルのrootにある) Properties.xml
は、パッケージ全体の一般プロパティの記述に使用されます。Tuxedoアプリケーション・パッケージの次の一般パラメータは、CICSパッケージにも適用できます。
すべての要素は、SupportedOS
を除き、Tuxedoアプリケーション・パッケージの要素と同じ意味を持ちます。Windowsプラットフォームには、ART CICSはありません。Linux、SunOSおよびAIXのみがサポートされます。
新しい要素CICSVersion
がProperties.xml
に追加されます。これは、このパッケージが構築されたART CICSのバージョンを示しています。このフィールドは、今後の拡張に使用されます。これは、正規表現ルール1[1-9](\.[0-9]){3,4}
に一致する任意の値に構成できます。12cR2リリースでは、推奨値は12.1.3.0.0になります。
Tuxedoアプリケーション・パッケージから区別するために、タイプ属性がApplicationProperties
ルート要素に導入されます。パッケージをCICSアプリケーション・パッケージとマークするには、タイプ属性をCICS
に設定します。タイプが設定されていないかTUX
に設定されている場合は、パッケージはTuxedoアプリケーション・パッケージと見なされます。
次のCICSリソース構成ファイルがCICSランタイムでサポートされています。
list_of_groups.desc
)transclasses.desc
ファイル)transactions.desc
ファイル)同一のtransactionsは、異なるCICSグループに含まれる場合でも、2つ定義できません。
programs.desc
ファイル)同一の2つのプログラムを1つのCICSグループに定義できません。異なるグループに同一の2つのプログラムを定義することは可能です。
tsqmodel.desc
ファイル)同一のTSQモデルは、異なるCICSグループに含まれる場合でも、2つ定義できません。
mapsets.desc
ファイル)同一のmapsets2つをファイルに定義できますが、最初に定義したもののみが使用されます。
typeterms.desc
ファイル)同一のtypeterms2つをファイルに定義できますが、最初に定義したもののみが使用されます。
enqmodel.desc
) 同一のenqmodel
は、異なるCICSグループに含まれる場合でも、ファイルに2つ定義できません。
tdqextra.desc
) 同一のtdqueue
は、異なるCICSグループに含まれる場合でも、2つ定義できません。
tdqintra.desc
) 同一のtdqueue
は、異なるCICSグループに含まれる場合でも、2つ定義できません。
各CICSアプリケーション・パッケージには、前述の.desc
ファイルのセットを組み込めます。各.descは1つのパッケージに1つしか存在しません。すべての.desc
ファイルをパッケージのDESC
サブディレクトリに置く必要があります。
すべてのCOBOL .gnt
ファイルは、パッケージのCOBLIB
サブディレクトリにあります。COBOLプログラムは、実行時にprograms.desc
ファイルによって参照されます。
すべての.mpdef
ファイルは、パッケージのMAP
サブディレクトリにあります。これらは、mapsets.desc
ファイルで使用されます。
ARTTDQの/QおよびTSQ DBの作成に使用されるスクリプトは、パッケージに組み込まれる可能性もあります。これらはSCRIPT
サブディレクトリにあり、パッケージがデプロイされると呼び出されます。すべてのシェル・スクリプトは互いに独立しているため、呼出しシーケンスがスクリプトの実行結果に影響を与えません。
CICSアプリケーション・パッケージは、「Tuxedoサマリー」ページで管理されます(Tuxedoアプリケーション・パッケージと同様)。詳細は、「アプリケーション・パッケージの管理」を参照してください。
アップロード中に、各パッケージのProperties .xml
ファイルと.desc
リソース構成ファイルに対して検証が行われます。Properties.xml
ファイルは.xsd
XMLスキーマに対して検証され、一方、リソース構成ファイルは、ファイル形式やコンテンツが適切かどうか(たとえば一意のキー・フィールド制約、列番号および必須列など)について検証されます。
検証に失敗すると、アップロードが失敗してエラー・メッセージが表示されます。パッケージのエラーはすべてポップアップ・ダイアログで報告されます。
既存のドメインでは、デフォルトのパッケージが1つ生成され、現在のART CICSパッケージ・リストに適用されます。この特別なパッケージには、ランタイム環境で使用するリソース・ファイルのみが含まれます。
新しく追加されたマシンを動的にデプロイするには、TLOG,/Qの作成を含む構成シェル・スクリプトや特別な環境変数のエクスポートなどをCICSパッケージに追加する必要があります。
「CICS構成」ページにアクセスする手順は、次のとおりです。
詳細は、「CICS構成の構成」を参照するか、または右上の「ヘルプ」をクリックしてください。
デプロイ中、保存済のCICSリソース・ファイルと追加済のCICSアプリケーション・パッケージすべてがソフトウェア・ライブラリから取得され、他のTuxedoドメイン・アセットと一緒に配布パッケージにまとめられます。
デプロイ済のAPPDIR
では、各CICSアプリケーション・パッケージは、パッケージ名に応じて名付けられたサブディレクトリに対応します。マージされたすべての.desc
リソース・ファイルは、APPDIR/resources
ディレクトリにあり、KIXCONFIG
環境変数で参照されます。
注意: | パッケージ・レベルの動的デプロイメントは、既存のART CICSドメインではサポートされていません。 |
次の環境変数設定がsetenv.sh
ファイルに追加されます。
KIXDIR=<full path of ART CICS software>
KIXCONFIG=<full path of ART CICS resources configuration files, fixed as $APPDIR/resources>
PATH=$KIXDIR/bin:$PATH
COBPATH=APP1/COBLIB:APP2/COBLIB:APP3/COBLIB: ... :$COBPATH
COB_LIBRARY_PATH=$COBPATH:$COB_LIBRARY_PATH
KIX_MAP_PATH=APP1/MAP:APP2/MAP:APP3/MAP: ... :$KIX_MAP_PATH
注意: |
動的リクエスト・ブローカは、Tuxedoロード・バランシング機能の拡張で、リクエスト・コールに対する応答時間を最短にし、(特にマルチプロセッサ(MP)ドメインで)複数のサーバー間により適切なワークロード分散を実現します。具体的には、動的リクエスト・ブローカは、新しいリクエスト・ルーティング・メトリック(サービス実行時間、ネットワーク時間など)を、UBBCONFIG
ファイルに設定されている静的ロード値の代替として導入するメカニズムです。したがって、サービスとネットワークのロード・レベルが動的に反映されます。さらに、MPドメインのすべての分散マシン間でメトリックを同期し、最適なリソース使用率を実現します。
server2
は、異なるマシン上にあるclient1
とclient2
の両方に対応します。UBBCONFIG
ファイルに指定されているロード値は静的なので、状況が変わるとサービスに適用できなくなる可能性があります。UBBCONFIG
ファイルに指定されているロード値は静的なので、状況が変わるとサービスに適用できなくなる可能性があります。注意: | 動的リクエスト・ブローカは、Oracle Tuxedo 12c以降のリリースのみをサポートします。 |
Enterprise Manager ConsoleのTuxedoドメイン・メニューから「制御」→「Request Brokerの有効化/無効化」をクリックして、動的リクエスト・ブローカ機能を有効または無効にできます。
動的リクエスト・ブローカ機能を有効にすると、次のコマンドを使用して動的ロード情報を表示できます。
$ tmadmin
> psc -m all -v
Oracle Virtual Assembly Builder (OVAB)は、管理者がOracle Tuxedoアプリケーションを迅速に構成し、クラウド環境にプロビジョニングすることを可能にします。Enterprise Manager for Oracle Tuxedoを使用することで、特定の条件下でOVABスクリプトを実行するEnterprise Managerのポリシー・メカニズムを利用してTuxedoアプリケーションをデプロイできます。
次に、統合例を示します。この例では、Enterprise Managerを起動してOVABスクリプトを呼び出し、Oracle Tuxedoスレーブ・マシンの台数を増減します。
3つのMPマシン(マスター、バックアップおよびスレーブ)で構成されるゴールデン・システムがあるとします。ここで、スレーブ・マシンの台数を1から10の間で増減するデプロイ・プランを作成する場合は、Tuxedoアプリケーションをデプロイするための次の手順を実行します。
./abctl createDeployerConnection -name WLSADMIN -url http://10.182.73.21:7001 -username ovabAdmin
./abctl createTarget -name myTarget -type ovm -connectionName WLSADMIN -properties ovm.user=admin ovm.pwd=Tuxqa123 ovm.url=http://10.182.73.11:7001 ovm.vmOperationTimeout=3600 ovm.vmmversion=3.0 ovm.poolName=MyServerPool -default
次のコマンドを使用して、接続とターゲットの可用性を確認できます。
./abctl describeDeployerConnections
./abctl describeTargets -connectionName WLSADMIN
./abctl introspectTuxedo -TUXDIR /testarea/tuxreg/tuxedo/tuxedo12c -TUXCONFIG /testarea/tuxreg/workspace/OVAB/tux/work/domain/tuxconfig -environmentScript /testarea/tuxreg/workspace/OVAB/tux/work/domain/setenv_ovab.sh -remoteHost bej301175.cn.oracle.com -remoteUser tuxreg -name master -force
./abctl introspectTuxedo -TUXDIR /testarea/tuxreg/tuxedo/tuxedo12c -TUXCONFIG /testarea/tuxreg/workspace/OVAB/tux/work/domain/tuxconfig -remoteHost bej301165.cn.oracle.com -remoteUser tuxreg -name slave -force
./abctl introspectTuxedo -TUXDIR /testarea/tuxreg/tuxedo/tuxedo12c -TUXCONFIG /testarea/tuxreg/workspace/OVAB/tux/work/domain/tuxconfig -remoteHost bej301168.cn.oracle.com -remoteUser tuxreg -name backup -force
./abctl createAssembly -name testdomain
./abctl addToAssembly -name master -into testdomain
./abctl addToAssembly -name slave -into testdomain
./abctl addToAssembly -name backup -into testdomain
注意: |
./abctl createAssemblyArchive -name testdomain -platform OVM -force
./abctl uploadAssemblyArchive -fileName /u01/slce04cn06/general/testarea/tuxreg/OVABR2/oracle.ovab/ab_instance/archives/testdomain.ova -name testdomain -connectionName WLSADMIN
./abctl downloadAssemblyMetadata -connectionName WLSADMIN -name testdomain -generateplan -version 1
./abctl registerAssemblyArchive -name testdomain -connectionName WLSADMIN -waitforComplete -pollTime 300 -version 1 -target myTarget
./abctl createAssemblyInstance -deploymentPlan /u01/slce04cn06/general/testarea/tuxreg/OVABR2/oracle.ovab/ab_instance/catalog/metadata/testdomain/deploymentPlans/myPlan/deploymentPlan.xml -name testdomain -version 1 -target myTarget -connectionName WLSADMIN
./abctl deployAssemblyInstance -assemblyInstanceId 0V0G_5Yn8_testdomain8_1 -connectionName WLSADMIN -waitForComplete -pollTime 3600
次のように、OVABスクリプトdeploy_ovab.sh
を作成します。
./abctl ./scale -scalingGroupId MpNZ-qhmZ_testdomain_1:testdomain/slave -target 2 -connectionName WLSADMIN
次のコマンドを使用して、scalinggroupID
を検索できます。
./abctl describeScalingGroups -connectionName MasterDeployer
前の手順で作成したOVABスクリプトに関連付けられたEnterprise Manager通知メソッドを作成するには、次の手順を実行します。
上で定義した通知メソッドをトリガーするインシデント・ルールを作成するには、次の手順を実行します。
TSAM Plusは、DM_MIB
クラスの構成をMBean操作にラップします。
JMXConnectorFactory.connect (JMXServiceURL serviceURL, Map<String,?> environment)
は、tlisten JMXサーバーへの接続の作成に使用されます。serviceURL
形式は"service:jmx:rmi:///jndi/rmi://%s:%s/server", host, port
です。host
はtlistenが実行されているホスト名、port
はtlisten -j
ポートの値です。environment
キーはjmx.remote.credentials
です。environment
の値は文字配列です。
表4-13に要素の一覧を示します。
ObjectName domainId + "_" + ipckey + ":type=tuxedo_domain_gateway,group_name=" + groupName + ",SRVID=" + SVRID
はTuxedoDomainGatewayTargetMBean
の作成に使用されます。domainId
はTuxedoドメインDOMAINID
、ipckey
はTuxedoドメインIPCKEY
、groupName
はサーバーGWTDOMAIN
SRVGRP
、SVRID
はサーバーGWTDOMAIN
SVRID
です。
get
操作は、既存のTM MIBエンティティを取得するために使用されます。
get+MIBクラス名
(キャメル・ネーミング形式)+s
(戻り値の型がTabularData
の場合)
すべてのパラメータは入力パラメータです。形式は[keyType keyValue
]*, CompositeData filterです。
戻り値の型は戻されたレコードが1件のみの場合はCompositeData
、それ以外の場合はTabularData
になります。
add
操作は、新しいTM MIBエンティティを追加するために使用されます。
すべてのパラメータは入力パラメータです。形式はCompositeData parameters
で、parameters
にはすべてのフィールドを含みます。
delete
操作は、既存のTM MIBエンティティを削除するために使用されます。
すべてのパラメータは入力パラメータです。形式は[keyType keyValue]+)
で、keyValue
はDM_MIB set
インタフェースの呼出し時に必要なキー・フィールドです。
update
操作は、既存のTM MIBエンティティを更新するために使用されます。
すべてのパラメータは入力パラメータです。形式は [keyType keyValue]+, CompositeData parameters)
です。
注意: | キー・フィールドはCompositeData parametersに含めないでください。例外が発生します。 |
すべてのMBean DM_MIB操作は、javax.management.modelmbean.RequiredModelMBean
を拡張したクラスoracle.tuxedo.jmx.tux.emmodel.TuxedoDomainGatewayTarget
に含まれています。
セキュリティ・レベルは、Oracle Tuxedoによって制御されます。TuxedoのUBBCONFIG
の構成アイテムであるSECURITY
の値がNONE
でない場合は、対応する資格証明が必要です。
JAVAクラスパスに$TUXDIR/jmx/tmjmx_tux.jar
を追加する必要があります。この中にあるoracle.tuxedo.jmx.tux.utility.Encryption.getInstance().encrypt()
は、APPパスワードとユーザー・パスワードを暗号化するために使用されます。
USER_AUTH以上のセキュリティ・レベルが有効な場合、tpusradd
の呼出し時にログインに使用するユーザーのクライアントをtpsysadm
に設定する必要があります。
tlisten -j rmi://<host>:<rmiport> -l //<host>:<tlistenport>
import java.io.Closeable;
import java.io.IOException;
import java.net.MalformedURLException;
import java.util.HashMap;
import java.util.Map;
import javax.management.MBeanServerConnection;
import javax.management.ObjectName;
import javax.management.openmbean.CompositeData;
import javax.management.openmbean.CompositeDataSupport;
import javax.management.openmbean.CompositeType;
import javax.management.openmbean.SimpleType;
import javax.management.openmbean.TabularData;
import javax.management.remote.JMXConnector;
import javax.management.remote.JMXConnectorFactory;
import javax.management.remote.JMXServiceURL;
public class TuxedoDomainGatewayTargetTestCustom implements Closeable {
private JMXConnector jmxc = null;
private MBeanServerConnection mbsc = null;
private ObjectName tuxedoDomainGatewayTargetMBean = null;
private String host = "rno05038.us.oracle.com";
private String port = "5039";
private String userName = "";
private String password = "";
private String appPassword = "";
private String domainId = "DOMAIN1";
private String ipckey = "123468";
private String groupName = "SYSGRP1";
private String SVRID = "3";
TuxedoDomainGatewayTargetTestCustom() throws Exception {
String[] credentials = new String[] { userName, password, appPassword,
domainId, ipckey};
jmxc = createJMXConnector(credentials);
mbsc = jmxc.getMBeanServerConnection();
tuxedoDomainGatewayTargetMBean = new ObjectName(domainId + "_" + ipckey
+ ":type=tuxedo_domain_gateway,group_name=" + groupName
+ ",SRVID=" + SVRID);
}
@Override
public void close() throws IOException {
jmxc.close();
}
/*get all Tdomain items with the filter "TA_DMACCESSPOINT=accessPoint"*/
public void getTDomain(String accessPoint) throws Exception {
String[] itemNames = { "TA_DMACCESSPOINT" };
Object[] itemValues = new Object[] { accessPoint };
javax.management.openmbean.OpenType<?>[] itemTypes = new javax.management.openmbean.OpenType<?>[] { SimpleType.STRING };
CompositeType compositeType = new CompositeType(
"tuxedo_domain_gateway", "tuxedo_domain_gateway", itemNames,
itemNames, itemTypes);
CompositeDataSupport filter = new CompositeDataSupport(compositeType,
itemNames, itemValues);
TabularData result = (TabularData) mbsc.invoke(
tuxedoDomainGatewayTargetMBean, "getTDomain",
new Object[] { filter },
new String[] { CompositeData.class.getName() });
if (result != null)
System.out.println(result.toString());
}
/*add a TDomain item*/
public void addTDomain(String accessPoint, String nwaddr,
String lAccessPoint) throws Exception {
String[] itemNames = { "TA_DMACCESSPOINT", "TA_DMNWADDR",
"TA_DMLACCESSPOINT" };
Object[] itemValues = new Object[] { accessPoint, nwaddr, lAccessPoint };
javax.management.openmbean.OpenType<?>[] itemTypes = new javax.management.openmbean.OpenType<?>[] {
SimpleType.STRING, SimpleType.STRING, SimpleType.STRING };
CompositeType compositeType = new CompositeType(
"tuxedo_domain_gateway", "tuxedo_domain_gateway", itemNames,
itemNames, itemTypes);
CompositeDataSupport compositeDataSupport = new CompositeDataSupport(
compositeType, itemNames, itemValues);
mbsc.invoke(tuxedoDomainGatewayTargetMBean, "addTDomain",
new Object[] { compositeDataSupport },
new String[] { CompositeData.class.getName() });
}
/*delete a TDomain item*/
public void deleteTDomain(String accessPoint, String nwaddr,
String lAccessPoint) throws Exception {
mbsc.invoke(tuxedoDomainGatewayTargetMBean, "deleteTDomain",
new Object[] { accessPoint, nwaddr, lAccessPoint },
new String[] { String.class.getName(), String.class.getName(),
String.class.getName() });
}
private JMXConnector createJMXConnector(String[] credentials)
throws MalformedURLException, IOException {
Map<String, Object> env = new HashMap<String, Object>();
env.put("jmx.remote.credentials", credentials);
// Create an RMI connector client and
// connect it to the RMI connector server
JMXServiceURL url = new JMXServiceURL(String.format(
"service:jmx:rmi:///jndi/rmi://%s:%s/server", host, port));
System.out.print("try to connect " + url + " with the credentials="
+ env + "...");
JMXConnector jmxc = JMXConnectorFactory.connect(url, env);
System.out.println("OK");
return jmxc;
}
/*change the nwaddr of "DOMAIN2_3" from "//localhost:11003"
* to "//localhost:11004"*/
public static void main(String[] args) throws Exception {
String accessPoint = "DOMAIN2_3";
String oldNwaddr = "//localhost:11003";
String newNwaddr = "//localhost:11004";
String lAccessPoint = "DOMAIN1_1";
TuxedoDomainGatewayTargetTestCustom tuxedoDomainGatewayTargetTestCustom = new TuxedoDomainGatewayTargetTestCustom();
tuxedoDomainGatewayTargetTestCustom.deleteTDomain(accessPoint,
oldNwaddr, lAccessPoint);
tuxedoDomainGatewayTargetTestCustom.addTDomain(accessPoint, newNwaddr,
lAccessPoint);
}
注意: | $TUXDIR/udataobj/jmx/tmjmx_exceptions.jar は、実行時にクラスパスに追加する必要があります。 |
tpusradd -g group1 -c tpsysadm user1
Enter password for user1:user123456
Re-enter password for user1:user123456
注意: | クライアント名はtpsysadmにする必要があります。 |
tmloadcf
の実行時のパスワードとしてapp123456を指定します。tpusradd -g group1 -c tpsysadm user1
Enter password for user1:app123456
Re-enter password for user1:app123456
tlisten -j rmi://<host>:<rmiport> -l //<host>:<tlistenport>
import java.io.Closeable;
import java.io.IOException;
import java.net.MalformedURLException;
import java.util.HashMap;
import java.util.Map;
import javax.management.MBeanServerConnection;
import javax.management.ObjectName;
import javax.management.openmbean.CompositeData;
import javax.management.openmbean.CompositeDataSupport;
import javax.management.openmbean.CompositeType;
import javax.management.openmbean.SimpleType;
import javax.management.openmbean.TabularData;
import javax.management.remote.JMXConnector;
import javax.management.remote.JMXConnectorFactory;
import javax.management.remote.JMXServiceURL;
public class TuxedoDomainGatewayTargetTestCustom implements Closeable {
private JMXConnector jmxc = null;
private MBeanServerConnection mbsc = null;
private ObjectName tuxedoDomainGatewayTargetMBean = null;
private String host = "rno05038.us.oracle.com";
private String port = "5039";
private String userName = "user1";
private String password = oracle.tuxedo.jmx.tux.utility.Encryption
.getInstance().encrypt("user123456");
private String appPassword = oracle.tuxedo.jmx.tux.utility.Encryption
.getInstance().encrypt("app123456");
private String domainId = "DOMAIN1";
private String ipckey = "123468";
private String groupName = "SYSGRP1";
private String SVRID = "3";
TuxedoDomainGatewayTargetTestCustom() throws Exception {
String[] credentials = new String[] { userName, password, appPassword,
domainId, ipckey};
jmxc = createJMXConnector(credentials);
mbsc = jmxc.getMBeanServerConnection();
tuxedoDomainGatewayTargetMBean = new ObjectName(domainId + "_" + ipckey
+ ":type=tuxedo_domain_gateway,group_name=" + groupName
+ ",SRVID=" + SVRID);
}
@Override
public void close() throws IOException {
jmxc.close();
}
/*get all Tdomain items with the filter "TA_DMACCESSPOINT=accessPoint"*/
public void getTDomain(String accessPoint) throws Exception {
String[] itemNames = { "TA_DMACCESSPOINT" };
Object[] itemValues = new Object[] { accessPoint };
javax.management.openmbean.OpenType<?>[] itemTypes = new javax.management.openmbean.OpenType<?>[] { SimpleType.STRING };
CompositeType compositeType = new CompositeType(
"tuxedo_domain_gateway", "tuxedo_domain_gateway", itemNames,
itemNames, itemTypes);
CompositeDataSupport filter = new CompositeDataSupport(compositeType,
itemNames, itemValues);
TabularData result = (TabularData) mbsc.invoke(
tuxedoDomainGatewayTargetMBean, "getTDomain",
new Object[] { filter },
new String[] { CompositeData.class.getName() });
if (result != null)
System.out.println(result.toString());
}
/*add a TDomain item*/
public void addTDomain(String accessPoint, String nwaddr,
String lAccessPoint) throws Exception {
String[] itemNames = { "TA_DMACCESSPOINT", "TA_DMNWADDR",
"TA_DMLACCESSPOINT" };
Object[] itemValues = new Object[] { accessPoint, nwaddr, lAccessPoint };
javax.management.openmbean.OpenType<?>[] itemTypes = new javax.management.openmbean.OpenType<?>[] {
SimpleType.STRING, SimpleType.STRING, SimpleType.STRING };
CompositeType compositeType = new CompositeType(
"tuxedo_domain_gateway", "tuxedo_domain_gateway", itemNames,
itemNames, itemTypes);
CompositeDataSupport compositeDataSupport = new CompositeDataSupport(
compositeType, itemNames, itemValues);
mbsc.invoke(tuxedoDomainGatewayTargetMBean, "addTDomain",
new Object[] { compositeDataSupport },
new String[] { CompositeData.class.getName() });
}
/*delete a TDomain item*/
public void deleteTDomain(String accessPoint, String nwaddr,
String lAccessPoint) throws Exception {
mbsc.invoke(tuxedoDomainGatewayTargetMBean, "deleteTDomain",
new Object[] { accessPoint, nwaddr, lAccessPoint },
new String[] { String.class.getName(), String.class.getName(),
String.class.getName() });
}
private JMXConnector createJMXConnector(String[] credentials)
throws MalformedURLException, IOException {
Map<String, Object> env = new HashMap<String, Object>();
env.put("jmx.remote.credentials", credentials);
// Create an RMI connector client and
// connect it to the RMI connector server
JMXServiceURL url = new JMXServiceURL(String.format(
"service:jmx:rmi:///jndi/rmi://%s:%s/server", host, port));
System.out.print("try to connect " + url + " with the credentials="
+ env + "...");
JMXConnector jmxc = JMXConnectorFactory.connect(url, env);
System.out.println("OK");
return jmxc;
}
/*change the nwaddr of "DOMAIN2_3" from "//localhost:11003"
* to "//localhost:11004"*/
public static void main(String[] args) throws Exception {
String accessPoint = "DOMAIN2_3";
String oldNwaddr = "//localhost:11003";
String newNwaddr = "//localhost:11004";
String lAccessPoint = "DOMAIN1_1";
TuxedoDomainGatewayTargetTestCustom tuxedoDomainGatewayTargetTestCustom = new TuxedoDomainGatewayTargetTestCustom();
tuxedoDomainGatewayTargetTestCustom.deleteTDomain(accessPoint,
oldNwaddr, lAccessPoint);
tuxedoDomainGatewayTargetTestCustom.addTDomain(accessPoint, newNwaddr,
lAccessPoint);
}
注意: | $TUXDIR/udataobj/jmx/tmjmx_tux.jar は、コンパイルおよび実行時にクラスパスに追加する必要があります。 |
Exalogic Elastic Cloudのターゲット・ホーム・ページから、Exalogic Elastic CloudホストにデプロイされたOracle Tuxedoドメインの詳細を参照できます。
Exalogic Elastic Cloudのターゲット・ホーム・ページに移動するには、次の手順に従います。
Exalogic Elastic Cloudホーム・ページが表示され、Exalogicターゲットとそのコンポーネントのステータスをモニターできるようになります。
デフォルトでは、Exalogic Elastic Cloudホーム・ページの「ソフトウェア」タブにTuxedoドメインは表示されません。Tuxedoドメインを手動で追加するには、次の手順に従います。
Exalogic Elastic Cloudホーム・ページにTuxedoドメインの「サマリー」パネルが表示されます。
「サマリー」ページでは、Tuxedoドメインのステータスや、ドメインの稼働率と停止率を示すグラフを参照できます。次に示すドメインごとのステータス情報、アラートとポリシー違反およびメトリックのデータも表示できます。
tpcallおよびtpacall/分/ネイティブ・クライアント/ワークステーション・クライアント/Joltクライアントの列は、デフォルトでは非表示です。
「Tuxedoドメイン」パネルの「構成」ボタンをクリックすると、複数のOracle TuxedoドメインをOracle Tuxedo Application Runtime環境に簡単に構成できます。
複数のOracle TuxedoドメインのUBBCONFIG
にあるパラメータを動的に変更するには、次の手順に従います。
「Tuxedoドメイン」パネルの「構成」→「DM構成」をクリックすると、複数のOracle TuxedoドメインのDMCONFIG
にある次のパラメータを動的に変更することもできます。
また、Exalogic RACで実行されている1つ以上のTuxedoドメインを再起動できます。
「Tuxedoドメイン」パネルの「Tuxedoパッチ」をクリックすると、Oracle Tuxedoパッチを集中管理したり、既存のバッチ用Oracle Tuxedoシステムに容易に適用できます。
Linux x86_64およびSolaris SPARC_64プラットフォーム用のOracle tuxedoパッチを集中管理できます。
Tuxedoパッチをアップロードするには、次の手順に従います。
パッチがOMSソフト・ライブラリにアップロードされると、表内に表示されます。パッチを選択して「パッチの削除」をクリックすると、OMSソフト・ライブラリから削除できます。
注意: |
Oracle Tuxedo Exalogic Standardは、Exalogicの下のTuxedoドメインのコンプライアンスを評価するために、Enterprise Managerコンプライアンス・ライブラリに統合されています。
Oracle Tuxedo Exalogic Standardに含まれるルールは、次のとおりです。
Oracle Tuxedo Exalogic Standardのルールの詳細を表示するには、次の手順に従います。
コンプライアンス標準の表示ページが表示されます。すべてのOracle Tuxedo Exalogic Standardルールが右側にリストされます。関連するプロパティを表示するには、各ルール項目をクリックします。
TuxedoドメインのコンプライアンスをチェックするためにOracle Tuxedo Exalogic Standardを使用する前に、次のいずれかの方法を使用して関連付けを行います。
Tuxedoドメインのコンプライアンス評価結果は、「Cloud Control」ホーム・ページおよび個々のターゲット・ホームページに表示されます。
「Cloud Control」ホーム・ページを使用して結果を表示するには、次の手順に従います。
ターゲットのホーム・ページからコンプライアンス評価結果を表示するには、次の手順に従います。
結果ページを使用して、一定期間におけるターゲットのコンプライアンスを概観します。表およびグラフを使用して、現在の傾向および変化を簡単にウォッチできます。
![]() ![]() ![]() |