プロファイルが Common Event Infrastructure を使用するように拡張されている各 WebSphere ランタイム環境に、イベント・サーバー・エンタープライズ・アプリケーションをデプロイする必要があります。
このタスクを使用する理由とその時期
イベント・サーバー・エンタープライズ・アプリケーションは event-application.ear EAR
ファイルにパッケージされます。event-application.jacl スクリプトにより、このアプリケーションは WebSphere Process Server にインストールされます。
このタスクのステップ
- アプリケーションをデプロイする WebSphere Process Server ランタイム環境を定義するプロファイルがある profile_path/event/application ディレクトリーに移動します。 (profile_path は WebSphere Process Server プロファイルが含まれるディレクトリーへのパスに置き換えます。)
- wsadmin コマンドを使用して、event-application.jacl スクリプトを実行します。
- Windows システム
profile_path¥bin¥wsadmin [-conntype none] -profile event-profile.jacl
-f event-application.jacl -action action -earfile event-application.ear
-backendid backend_id -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 event-application.jacl -action action -earfile event-application.ear
-backendid backend_id -node node_name -server server_name
[-cluster cluster_name] [-appname app_name] [-trace]
パラメーターは、以下のとおりです。
- action
- 実行するアクション。
エンタープライズ・アプリケーションをインストールする場合は、install を指定します。
既にインストール済みであるイベント・サーバー・アプリケーションをアップデートする場合は、update を指定します。アップデートの実行中に、
スクリプトは既存のアプリケーション EAR ファイルのバックアップ・コピーを
現行ディレクトリーに作成します。必要な場合、後でこのバックアップ・コピーを使用して前のバージョンのアプリケーションをリストアできます。
- backend_id
- エンタープライズ・アプリケーションが使用するデータベースのバックエンドのタイプ。
これは、必ず次の値のいずれかになります。
- CLOUDSCAPE_V51_1
- DB2UDBNT_V82_1
- DB2UDBNT_V8_1
- ORACLE_V10_1
- ORACLE_V9_1
- DB2UDBOS390_V8_1
- DB2UDBOS390_V7_1
- node_name
- イベント・サーバーがデプロイされる WebSphere Process Server のノード。ノード名を検索するには、以下のステップを実行します。
- profile_path/bin/setupCmdLine スクリプトを実行します。
- echo $WAS_NODE コマンド (Linux/UNIX システム) または echo
%WAS_NODE% コマンド (Windows システム) を実行します。
この値は大文字小文字が区別されます。エンタープライズ・アプリケーションをクラスターにデプロイしている場合、このパラメーターは省略します。
- server_name
- イベント・サーバー・エンタープライズ・アプリケーションをデプロイする WebSphere サーバー。この値は大文字小文字が区別されます。エンタープライズ・アプリケーションをクラスターにデプロイしている場合、このパラメーターは省略します。
- app_name
- Common Event Infrastructure エンタープライズ・アプリケーションに使用する名前。
このパラメーターはオプションです。デフォルト値は、CommonEventInfrastructureServer です。
オプションの -trace パラメーターを使用すると、
標準出力に追加のデバッグ情報が表示されます。
注: - event-application.ear ファイルのロケーションを示す完全修飾パスを指定する場合、Windows システムの場合も、パスにスラッシュ (/) を使用します。
- アプリケーションをスタンドアロン・ノードにデプロイしている場合、オプションの -conntype none パラメーターを指定して、ローカル・モードで wsadmin を実行します。
wsadmin ユーティリティーについての詳細は、WebSphere Application Server 資料を参照してください。
結果
event-application.jacl スクリプトが完了した後、Common Event Infrastructure エンタープライズ・アプリケーションが、指定されたサーバーまたはクラスターにデプロイされます。
WebSphere Process Server Network Deployment 環境でアプリケーションが既にインストールされている場合、スクリプトは指定されたノードおよびサーバーのデプロイメント情報の追加のみを行います。