1.4. JBoss EAP XP マネージャー 2.0 コマンド
JBoss EAP XP マネージャー 2.0 は、JBoss EAP XP パッチストリームを管理するためのさまざまなコマンドを提供します。
以下のコマンドが提供されます。
patch-apply
このコマンドを使用して JBoss EAP インストールにパッチを適用します。
patch-apply
コマンドは、patch apply
管理 CLI コマンドに似ています。patch-apply
コマンドは、ツールを使用してパッチを適用するために必要な引数のみを受け入れます。他のpatch apply
管理 CLI コマンド引数にデフォルト値を使用します。patch-apply
コマンドを使用して、サーバーで有効なパッチストリームにパッチを適用できます。コマンドを使用して、ベースサーバーのパッチと XP パッチの両方を適用することもできます。patch-apply
コマンドの使用例$ java -jar jboss-eap-xp-manager.jar patch-apply --jboss-home=/PATH/TO/EAP --patch=/PATH/TO/PATCH/jboss-eap-7.3.4-patch.zip
XP パッチを適用するとき、JBoss EAP XP マネージャー 2.0 は検証を実行し、パッチとパッチストリームの不一致を防ぎます。以下の例は、誤った組み合わせを示しています。
XP 2.0 パッチストリームが設定されたサーバーに JBoss EAP XP 1.0 パッチをインストールすると、以下のエラーが発生します。
java.lang.IllegalStateException: The JBoss EAP XP patch stream in the patch 'jboss-eap-xp-1.0' does not match the currently enabled JBoss EAP XP patch stream [jboss-eap-xp-2.0] at org.jboss.eap.util.xp.patch.stream.manager.ManagerPatchApplyAction.doExecute(ManagerPatchApplyAction.java:33) at org.jboss.eap.util.xp.patch.stream.manager.ManagerAction.execute(ManagerAction.java:40) at org.jboss.eap.util.xp.patch.stream.manager.ManagerMain.main(ManagerMain.java:50)
JBoss EAP XP 2.0 パッチストリーム用に設定されていないサーバーに JBoss EAP XP 2.0 パッチをインストールすると、以下のエラーが発生します。
java.lang.IllegalStateException: You are attempting to install a patch for the 'jboss-eap-xp-2.0' JBoss EAP XP Patch Stream. However this patch stream is not yet set up in the JBoss EAP server. Run the 'setup' command to enable the patch stream. at org.jboss.eap.util.xp.patch.stream.manager.ManagerPatchApplyAction.doExecute(ManagerPatchApplyAction.java:29) at org.jboss.eap.util.xp.patch.stream.manager.ManagerAction.execute(ManagerAction.java:40) at org.jboss.eap.util.xp.patch.stream.manager.ManagerMain.main(ManagerMain.java:50)
いずれの場合も、サーバーに変更が加えられません。
remove
このコマンドを使用して、JBoss EAP サーバーから JBoss EAP XP パッチストリーム設定を削除します。
remove
コマンドの使用例$ java -jar jboss-eap-xp-manager.jar remove --jboss-home=/PATH/TO/EAP
setup
このコマンドを使用して、JBoss EAP XP パッチストリームにクリーンな JBoss EAP サーバーを設定します。
setup
コマンドを使用すると、JBoss EAP XP マネージャーは以下の操作を実行します。- JBoss EAP XP 2.0 パッチストリームを有効にします。
-
--base-patch
および--xp-patch
属性を使用して指定されたパッチを適用します。 standalone-microprofile.xml
およびstandalone-microprofile-ha.xml
設定ファイルをサーバー設定ディレクトリーにコピーします。古い設定ファイルが既にインストールされている場合、新しいファイルは
standalone-microprofile-yyyyMMdd-HHmmss.xml
などのターゲット設定ディレクトリーにタイムスタンプ付きコピーとして保存されます。--jboss-config-directory
引数を使用してターゲットディレクトリーを設定できます。
setup
コマンドの使用例$ java -jar jboss-eap-xp-manager.jar setup --jboss-home=/PATH/TO/EAP
status
このコマンドを使用して、JBoss EAP XP サーバーの現在の状態を見つけます。status コマンドは、以下の情報を返します。
- JBoss EAP XP ストリームの状態
- 現在の状態によるサポートポリシーの変更
- JBoss EAP XP のメジャーバージョン。
- パッチストリームと累積パッチ ID を有効にしました。
- 状態を変更するのに利用できる JBoss EAP XP マネージャーコマンド
status
コマンドの使用例$ java -jar jboss-eap-xp-manager.jar status --jboss-home=/PATH/TO/EAP
upgrade
このコマンドを使用して、JBoss EAP サーバーで古い JBoss EAP XP パッチストリームを JBoss EAP サーバーの最新のパッチストリームにアップグレードします。
upgrade
コマンドを使用すると、JBoss EAP XP マネージャーは以下の操作を実行します。- サーバーで古いパッチストリームを有効にするファイルのバックアップを作成します。
- JBoss EAP XP 2.0 パッチストリームを有効にします。
-
--base-patch
および--xp-patch
属性を使用して指定されたパッチを適用します。 -
standalone-microprofile.xml
およびstandalone-microprofile-ha.xml
設定ファイルをサーバー設定ディレクトリーにコピーします。古い設定ファイルがすでにインストールされている場合、新しいファイルはstandalone-microprofile-yyyyMMdd-HHmmss.xml などのターゲット設定ディレクトリーにタイムスタンプ付きコピーとして保存
されます。 問題が発生した場合、JBoss EAP XP マネージャーは作成したバックアップから以前のパッチストリームを復元しようとします。
--jboss-config-directory
引数を使用してターゲットディレクトリーを設定できます。
upgrade
コマンドの使用例:$ java -jar jboss-eap-xp-manager.jar upgrade --jboss-home=/PATH/TO/EAP