ジョブ・マネージャーを使用した Liberty サーバー用のマージされたプラグイン構成の生成
「Liberty プロファイル・サーバー用のマージされたプラグイン構成の生成」ジョブをサブミットして、Web サーバー・プラグインに対して、複数のホスト上にある複数のアプリケーション・サーバーに要求を転送するように指示をする単一のマージされた plugin-cfg.xml ファイルを作成することができます。 このジョブは、まず、各ターゲット・ホストで、サーバー固有の plugin-cfg.xml ファイルを生成します。 次に、ジョブ・マネージャー・ホストで、それらのサーバー固有の plugin-cfg.xml ファイルを 1 つの plugin-cfg.xml ファイルにマージします。
始める前に
ジョブ・マネージャーと、ターゲット・ホスト上の Liberty・サーバーを 開始します。
Liberty・サーバーの単一インスタンス用の Web サーバー・プラグイン構成を生成する必要がある場合、Web サーバー・プラグインを含む Liberty 構成に関する Liberty 資料を参照してください。
ジョブをサブミットするには、ジョブ・マネージャーで使用する ID に、管理者ロール またはオペレーター・ロールの権限が付与されている必要があります。
ターゲット・ホストをジョブ・マネージャーに登録する際、オペレーティング・システムのセキュリティー情報を保存することができます。 セキュリティー情報を保存していない 1 つ以上のターゲットにジョブをサブミットする場合、許可されたオペレーティング・システム・ユーザー名と、そのユーザー名に対するパスワードまたは公開/秘密鍵情報のいずれかを指定する必要があります。 セキュリティー・クレデンシャルは、すべてのジョブ・ターゲットで有効でなければなりません。
<featureManager>
<feature>localConnector-1.0</feature>
<feature>restConnector-1.0</feature>
...
</featureManager>
HTTP/REST コネクター・フィーチャーしか含まれていない Liberty・サーバーが 1 つ以上ある場合は、ジョブのサブミット時に Liberty・サーバー管理者のユーザー名とパスワードを指定する必要があります。
ジョブ・マネージャーは、サーバーへの JMX 接続を確立する際、これらのクレデンシャルを使用します。
すべてのサーバーでローカル・コネクター・フィーチャーが含まれている場合は、ユーザー名とパスワードを指定する必要はありません。サーバー管理者の定義について詳しくは、『Liberty の管理者ロールのマップ』を参照してください。
- server.env ファイル内で JAVA_HOME プロパティーを JDK または JRE のロケーションに設定します。 ジョブにより JAVA_HOME プロパティーが読み取られ、それがターゲット環境で設定された後、Liberty サーバー用の plugin-cfg.xml ファイルを生成するコマンドが実行されます。
ユーザーの .bashrc ファイル内で JAVA_HOME プロパティー を JDK または JRE のロケーションに設定します。
JDK または JRE のパス を PATH 環境変数に追加します。
JAVA_HOME プロパティーをシステム環境変数として JDK または JRE の ロケーションに設定します。
JDK または JRE のパスを PATH システム変数に追加します。
このタスクについて
ジョブ・マネージャーまたはデプロイメント・マネージャーの管理コンソールを使用して、Web サーバー・プラグインに対して、複数のホスト上にある複数の Liberty・サーバーに要求を転送するように指示をする単一のマージされた plugin-cfg.xml ファイルを生成することができます。 コンソールから「Liberty サーバー用のマージされたプラグイン構成の生成 (Generate merged plugin configuration for Liberty servers)」ジョブを選択し、サーバーおよびジョブ・オプションを指定し、サマリーを確認し、ジョブをサブミットします。
以下のステップでは、ジョブ・マネージャー・コンソールまたはデプロイメント・マネージャー・コンソールを使用して「Liberty プロファイル・サーバー用のマージされたプラグイン構成の生成」ジョブを実行する方法について説明します。 コンソールを使用する代わりに、AdministrativeJobs コマンド・グループ内の generateMergedPluginConfigForLibertyProfileServers ジョブ・スクリプトを実行することもできます。管理ジョブのタイプに関するトピックを参照してください。
手順
タスクの結果
各ターゲット・ホストにサーバー固有の plugin-cfg.xml ファイルが生成されます。 次に、ジョブ・マネージャーは、ジョブ・マネージャー・ホスト上でそれらのファイルを単一のマージされた plugin-cfg.xml ファイルにマージします。
次のタスク
「ジョブ状況」ページで、「Liberty プロファイル・サーバーのマージされたプラグイン構成の生成」ジョブの ID をクリックして、ジョブ状況を表示します。状況のリフレッシュ・アイコン
をクリックして、表示されている状況をリフレッシュします。
ジョブが正常に完了すると、 マージ結果の plugin-cfg.xml ファイルは app_server_root/profiles/job_manager_profile/config/temp/JobManager/job_ID/_mergedPluginDir/ ディレクトリーに書き込まれます。
- ターゲットの Liberty サーバーが稼働していない。
- ターゲットの Liberty・サーバー用に JMX コネクターが構成されていない。
- HTTP/REST (restConnector) フィーチャーしか含んでいない、ターゲットの Liberty・サーバーに JMX 接続を確立する際、ジョブ・プロパティーが、サーバー管理者の有効なクレデンシャルを指定していない。