3.4.12 Cosminexus RMの運用前の準備(永続版リソースアダプタの場合)
(1) DB Connector for Cosminexus RMとCosminexus RMの接続テスト
DB Connector for Cosminexus RMおよびCosminexus RMに設定した内容が正しいかどうか,接続テストによって検証します。
(a) 接続テストで確認できる項目
接続テストの成功によって,次に示す項目を確認できます。
- 接続先DBの設定(ホスト名,ポート番号,ユーザ名,パスワードなど)が正しいこと。
- 接続先DBが正常に開始していること。
- RMLinkedDBConnectorNameプロパティが正しく設定されていて,かつ指定したCosminexus RMと連携するDB Connector for Cosminexus RMが開始済みであること。
- RMSystemNameプロパティのフォーマットが正しいこと。
(b) 接続テストの手順
- DB Connector for Cosminexus RMを開始します。
DB Connector for Cosminexus RMの開始方法については,「(2) DB Connector for Cosminexus RMとCosminexus RMの開始」を参照してください。
- 次に示すコマンドを実行してCosminexus RMの接続テストを実施します。
- 実行形式
cjtestres [<サーバ名称>] [-nameserver <プロバイダURL>] -type rar -resname <Cosminexus RMの表示名> |
- 実行例
- cjtestres MyServer -type rar -resname Cosminexus_Reliable_Messaging
なお,接続に失敗した場合には,出力されるメッセージを基にエラーに対処し,再度接続テストを実施してください。
cjtestresコマンドの詳細については,マニュアル「Cosminexus リファレンス コマンド編」を参照してください。
- 注意事項
- 一度接続テストをしたDB Connector for Cosminexus RMおよびCosminexus RMは,J2EEサーバを再起動するまで削除できません。DB Connector for Cosminexus RMおよびCosminexus RMを削除する場合は,DB Connector for Cosminexus RMおよびCosminexus RMを停止してから,J2EEサーバを再起動してください。
(c) 接続テストの失敗事例
接続テストに失敗する事例を次に示します。
- DBの管理情報テーブルが正常に作成されていない場合
接続テストではDBへのアクセスを試みます。Cosminexus RMが前提とするDBの管理情報テーブルにアクセスするため,DBの管理情報テーブルが正常に作成されていないときは接続テストに失敗します。
- Cosminexus Component Container側でエラーを検知した場合
接続テストではCosminexus RMとCosminexus Component Containerの両方でチェックを実行します。そのため,Cosminexus Component Container側でエラーを検知すると接続テストに失敗する場合もあります。
接続テストに成功してもCosminexus RMの起動時に接続に失敗する場合があります。事例を次に示します。
- QueueConfigFileNameプロパティを指定した場合のファイルパスが不正のとき,または指定したキュー定義ファイルの内容が不正のとき
- ロガーの初期化に失敗したとき,またはコマンドのネーミングサービスの登録に失敗したとき
(2) DB Connector for Cosminexus RMとCosminexus RMの開始
DB Connector for Cosminexus RMおよびCosminexus RMを開始します。なお,DB Connector for Cosminexus RMおよびCosminexus RMが連携するために,J2EEリソースアダプタは次の順序で開始してください。
- DB Connector for Cosminexus RM
- Cosminexus RM
この順序で開始しないとエラーになります。
なお,Cosminexus RMの接続テストを実施して,すでにDB Connector for Cosminexus RMが開始している場合は,手順1.は不要です。
- 次に示すコマンドを実行してDB Connector for Cosminexus RMを開始します。
- 実行形式
cjstartrar [<サーバ名称>] [-nameserver <プロバイダURL>] -resname <DB Connector for Cosminexus RMの表示名> |
- 実行例
- cjstartrar MyServer -resname DB_Connector_for_HiRDB_Type4_Cosminexus_RM
- 手順1.と同様に,cjstartrarコマンドを実行してCosminexus RMを開始します。
- 実行形式
cjstartrar [<サーバ名称>] [-nameserver <プロバイダURL>] -resname <Cosminexus RMの表示名> |
- 実行例
- cjstartrar MyServer -resname Cosminexus_Reliable_Messaging
cjstartrarコマンドの詳細については,マニュアル「Cosminexus リファレンス コマンド編」を参照してください。
- 注意事項
- J2EEアプリケーション中のJ2EEリソースがDB Connector for Cosminexus RMまたはCosminexus RMを参照している場合は,DB Connector for Cosminexus RMまたはCosminexus RMを開始してから,J2EEアプリケーションを開始してください。
- 一度開始したリソースアダプタは,J2EEサーバを再起動するまで削除できません。リソースアダプタを削除する場合は,リソースアダプタを停止してから,J2EEサーバを再起動してください。
(3) キューの作成
DB Connector for Cosminexus RMおよびCosminexus RMを開始すると,Cosminexus RMが管理状態になります。管理状態になったことを確認したら,hrmmkqueコマンドを入力して,キューを作成してください。そのあと,hrmstartコマンドを入力して,Cosminexus RMを実行状態にします。
詳細については,「4.2 キューの運用(永続版リソースアダプタの場合)」を参照してください。