非同期イベント伝送用のデフォルト・メッセージング構成では、WebSphere Process Server のデフォルト・メッセージング・フィーチャーを Java Message Service (JMS) プロバイダーとして使用します。
このタスクを使用する理由とその時期
default-event-message.jacl スクリプトを使用すると、WebSphere のデフォルト・メッセージング・フィーチャーを JMS プロバイダーとして使用して、デフォルトのメッセージング構成を素早くセットアップすることができます。このスクリプトは、以下のように非同期イベントの送信に必要なすべての構成オブジェクトをセットアップします。
- デフォルト・メッセージング・フィーチャーを使用して、JMS キューおよびキュー接続ファクトリーを作成します。
- サービス統合バスを作成してそのバスにメンバーを追加し、バスをキュー、トピック、および接続ファクトリーに関連付けます。
- 作成されたキューおよびキュー接続ファクトリーを使用して、JMS 送信プロファイルを作成します。
- 作成された JMS 送信プロファイルを非同期イベント伝送に使用するように、
デフォルト・エミッター・ファクトリー・プロファイルを構成します。
- Common Event Infrastructure が、
イベント・サーバーに非同期で送信されたイベントを受信する際に使用するメッセージ駆動型 Bean をデプロイします。
デフォルトのメッセージングを構成するには、以下の手順を実行します。
このタスクのステップ
- デフォルトのメッセージングを構成する WebSphere Process Server ランタイム環境を定義するプロファイルがある profile_path/event/application ディレクトリーに移動します。 (profile_path は WebSphere Process Server プロファイルが含まれるディレクトリーへのパスに置き換えます。)
- wsadmin コマンドを使用して、default-event-message.jacl スクリプトを実行します。
- Windows システム
profile_path¥bin¥wsadmin [conntype -none] -profile event-profile.jacl
-f default-event-message.jacl -action install -earfile event-message.ear
-node node_name -server server_name
[-cluster cluster_name] [-appname app_name] [-trace]
- Linux および UNIX システム
profile_path/bin/wsadmin.sh [conntype -none] -profile event-profile.jacl
-f default-event-message.jacl -action install -earfile event-message.ear
-node node_name -server server_name
[-cluster cluster_name] [-appname app_name] [-trace]
パラメーターは、以下のとおりです。
- node_name
- メッセージング・アプリケーションがデプロイされる WebSphere Process Server のノード。ノード名を判別するには、以下の処理を行います。
- profile_path/bin/setupCmdLine スクリプトを実行します。
- echo $WAS_NODE コマンド (Linux/UNIX システム) または echo
%WAS_NODE% コマンド (Windows システム) を実行します。
この値は大文字小文字が区別されます。アプリケーションをクラスターにデプロイしている場合、このパラメーターは省略します。
- server_name
- メッセージング・アプリケーションがデプロイされる WebSphere サーバー。
この値は大文字小文字が区別されます。アプリケーションをクラスターにデプロイしている場合、このパラメーターは省略します。
- app_name
- メッセージング・エンタープライズ・アプリケーションに使用する名前。
このパラメーターはオプションです。デフォルト値は、EventServerMdb です。
オプションの -trace パラメーターを使用すると、
標準出力に追加のデバッグ情報が表示されます。
注: - event-message.ear ファイルのロケーションを示す完全修飾パスを指定する場合、Windows システムの場合も、パスにスラッシュ (/) を使用します。
- メッセージング・アプリケーションをスタンドアロン・ノードにデプロイしている場合、オプションの -conntype none パラメーターを指定して、ローカル・モードで wsadmin を実行します。
スクリプトの開始後に、JMS ユーザー ID とパスワードの入力を求めるプロンプトが出されます。