Oracle Tuxedo MQ Adapterのビルド

Oracle Tuxedo MQ Adapterのオブジェクト・ファイルは、標準のOracle Tuxedo配布キットの一部として含まれています。Oracle Tuxedo管理者は、使用するMQインストールに固有の値で$TUXDIR/udataobj/RMファイルをカスタマイズした後で、buildmqadapter(1)コマンドを使用してMQ Adapter実行可能ファイルをビルドします。Oracle Tuxedo管理者はbuildtms(1)コマンドを使用して、WebSphere MQリソース・マネージャのTMSをビルドする必要もあります。ここでは、MQ Adapter実行可能ファイルをビルドするプロセスについて説明します。

ビルド前の考慮事項

MQ Adapter for Oracle Tuxedoソフトウェアは、現在、Oracle TuxedoのHP-UX、Solaris、AIX、LinuxおよびWindowsバージョンで使用できます。ターゲット・プラットフォームでIBMがWebSphere MQをサポートしている場合は、Oracle Tuxedoを他のプラットフォームに移植すると、MQ Adapterも一緒に移植されます。

Oracle Tuxedo管理者は、MQ AdapterのTMSおよびアダプタ・サーバーをビルドする前に、次のタスクを完了する必要があります。

ターゲット・プラットフォームにWebSphere MQの正しいメンテナンス・バージョンがインストールされていることを確認します。各サポート対象プラットフォームで必要なWebSphere MQのメンテナンス・バージョンの詳細については、「Oracle Tuxedo 10.0プラットフォーム・データ・シート」を参照してください。
必要なWebSphere MQリソース・マネージャを設定します。

WebSphere MQのXA準拠リソース・マネージャの設定

Oracle Tuxedoをインストールするときに、Oracle Tuxedoインストール・プログラムによって、WebSphere MQ 6.0用の重要なデフォルト行が$TUXDIR/udataobj/RMファイルに追加されます。たとえば、32ビットSolarisの場合、インストール・プログラムによって次の行が追加されます。

MQSeries_XA_RMI:MQRMIXASwitchDynamic: /opt/mqm/lib/libmqmxa.so /opt/mqm/lib/libmqm.so

(他のハードウェア・プラットフォームでは、デフォルト・ライブラリの接尾辞や場所が異なる場合があります。)

Oracle Tuxedo管理者はこの情報を確認して、使用するインストールで適切かどうかを判断してください。場合によっては、RMファイルの情報を変更する必要があります。

WebSphere MQが標準以外の場所にインストールされている場合。
アプリケーションを、WebSphere MQサーバー・ライブラリではなく、WebSphere MQクライアント・ライブラリにリンクさせる場合。
アプリケーションで、動的なXAスイッチMQRMIXASwitchDynamicのかわりに、静的なXAスイッチMQRMIXASwitchを使用する方がよい場合。

Windows NTでは、WebSphere MQの標準のインストール先がないため、%TUXDIR%\udataobj\RMファイルで変数%MQMDIR%が使用されます。MQ Adapterサーバーをビルドする前に、この変数を設定してください。

64ビット・バージョンのOracle Tuxedoを使用する場合は、32ビットのlibディレクトリではなく、WebSphere MQ lib64ディレクトリにあるライブラリにリンクさせ、mqmxaライブラリではなくmqmxa64ライブラリにリンクするようにしてください。

Oracle Tuxedo MQ Adapterサーバーのビルド

MQ Adapterサーバーをビルドするには、$TUXDIR/binディレクトリの書込み許可を持つOracle Tuxedo管理者として、次のコマンドを実行します。

このコマンドでは、TM_MQI、TM_MQO、およびTMQUEUE_MQMサーバーが$TUXDIR/binディレクトリにインストールされます。-vオプションは、buildmqadapterが、3つのサーバーのリンクに使用されたbuildserverおよびコンパイラ・コマンドの行を、出力の一部として書き込むことを指定しています。

かわりに、次のコマンドを使用すると、MQ Adapterサーバーを一度に1つずつビルドできます。

(サーバーを一度に1つずつビルドする場合は、出力ディレクトリとして$TUXDIR/binのかわりに $APPDIRを指定できます。)

WebSphere MQリソース・マネージャのTMSサーバーをビルドする

リソース・マネージャの実行可能ファイルを作成するには、$TUXDIR/bin ディレクトリで次のコマンドを実行します。

(必要に応じて、MQXAのかわりに別のファイル名を指定できます。出力ファイルは$TUXDIR/binまたは$APPDIRに配置できます。)

UBBCONFIGファイルでMQ Adapterサーバー・グループを指定する

MQ Adapter for Oracle Tuxedoサーバーで使用されるグループに関する次の行を、UBBCONFIGファイルの*GROUPSセクションに追加します。

MQ_GROUP_NAME TMSNAME=MQXA TMSCOUNT=3      
	OPENINFO="MQSeries_XA_RMI:BEA.TEST.MANAGER"

上の例で、MQ_GROUP_NAMEはMQ Adapterサーバーが定義されているグループの名前です。アプリケーションでは、このグループに対してどんな名前でも使用できます。このグループのTMSサーバーの数は3です。BEA.TEST.MANAGERは使用されるキュー・マネージャの名前です。キュー・マネージャの名前が異なる場合は、別の名前に置き換えてください。

インストール後の手順

MQ Adapter for Oracle Tuxedoのインストール手順が完了したら、MQ Adapterの構成手順に進む前に、次の項目が完了していることを確認してください。

使用するWebSphere MQプログラムがビルド済みで、アクセスおよび実行可能な状態であり、(必要な場合は)トリガーを定義済みであることが必要です。
使用するすべてのWebSphere MQキューが定義済みで、アクセス可能な状態であることが必要です。これらの手順の詳細については、WebSphere MQのドキュメントを参照してください。

MQ Adapter