非同期イベント伝送用のデフォルト・メッセージング構成では、
Java Messaging Service (JMS) プロバイダーとして WebSphere ESB のデフォルト・メッセージング機能を使用します。
このタスクを実行する理由および時期
default-event-message.jacl スクリプトにより、JMS プロバイダーとして WebSphere のデフォルト・メッセージング機能を使用し、デフォルト・メッセージング構成を簡単にセットアップする方法が提供されます。
このスクリプトでは、非同期イベント伝送に必要なすべての構成オブジェクトがセットアップされます。
- デフォルト・メッセージング機能を使用し、JMS キューおよびキュー接続ファクトリーを作成します。
- サービス統合バスを作成し、キュー、トピック、および接続ファクトリーにそのバスを関連付けして、メンバーをバスに追加します。
- 作成されたキューおよび接続ファクトリーを使用し、JMS 伝送プロファイルを作成します。
- 非同期イベント伝送用に作成された JMS 伝送プロファイルを使用するよう、デフォルトのエミッター・ファクトリー・プロファイルを構成します。
- 共通イベント・インフラストラクチャーにより使用されるメッセージ駆動型 Bean をデプロイし、イベント・サーバーに非同期に送信されたイベントを受信するようにします。
デフォルト・メッセージングを構成するには、以下を実行します。
このタスクの手順
- デフォルト・メッセージングを構成する WebSphere ESB ランタイム環境を定義するプロファイルがある profile_path/event/application ディレクトリーに移動します。 (profile_path は、WebSphere ESB プロファイルが含まれるディレクトリーへのパスに置き換えてください。)
- wsadmin コマンドを使用し、以下のように default-event-message.jacl スクリプトを実行します。
Windows システムの場合
profile_path¥bin¥wsadmin [conntype -none] -profile event-profile.jacl
-f default-event-message.jacl -action action -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 ESB ノード。
ノード名を判別するには、以下を実行します。
- profile_path/bin/setupCmdLine スクリプトを実行します。
- コマンド echo $WAS_NODE (Linux/UNIX システムの場合) または echo
%WAS_NODE% (Windows システムの場合) を実行します。
この値は大/小文字が区別されます。
クラスターにアプリケーションをデプロイする場合は、このパラメーターを省略してください。
- server_name
- メッセージング・アプリケーションのデプロイ先の WebSphere サーバー。
この値は大/小文字が区別されます。
クラスターにアプリケーションをデプロイする場合は、このパラメーターを省略してください。
- cluster_name
- メッセージング・アプリケーションのデプロイ先の WebSphere クラスター。
このパラメーターは、クラスターにメッセージングを構成し、ノードおよびサーバーを指定しない場合にのみ指定してください。
注: デフォルトのメッセージング構成では、Cloudscape イベント・データベースが使用されます。
Cloudscape データベースでは、実稼働環境でのクラスタリングがサポートされません。
WebSphere Process Server の管理コンソールを使用し、複数接続をサポートするイベント・データベースに接続するデータ・ソースを指定して、別のメッセージング・エンジンを指定できます。
- app_name
- メッセージング・エンタープライズ・アプリケーションに使用する名前。
このパラメーターはオプションであり、デフォルト値は EventServerMdb です。
オプションの -trace パラメーターを使用すると、標準出力に追加のデバッグ情報が表示されます。
注: - event-message.ear ファイルの場所に対して完全修飾パスを指定する場合は、Windows システムであっても、必ずパスにスラッシュ (/) を使用してください。
- スタンドアロン・ノードにメッセージング・アプリケーションをデプロイする場合は、オプションの -conntype none パラメーターを使用して、wsadmin をローカル・モードで実行してください。
スクリプトを開始すると、JMS ユーザー ID およびパスワードのプロンプトが出されます。