1.4. JBoss EAP XP マネージャー 3.0 コマンド

JBoss EAP XP マネージャー 3.0 は、JBoss EAP XP パッチストリームを管理し JBoss EAP 7.4.x ベースパッチを適用するためのさまざまなコマンドを提供します。

以下のコマンドが提供されます。

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 マネージャー 3.0 は検証を実行し、パッチとパッチストリームの不一致を防ぎます。以下の例は、誤った組み合わせを示しています。

  • XP 3.0 パッチストリームが設定されたサーバーに JBoss EAP XP 2.0 パッチをインストールすると、以下のエラーが発生します。 

    java.lang.IllegalStateException: The JBoss EAP XP patch stream in the patch 'jboss-eap-xp-2.0' does not match the currently enabled JBoss EAP XP patch stream [jboss-eap-xp-3.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 3.0 パッチストリーム用に設定されていないサーバーに JBoss EAP XP 3.0 パッチをインストールすると、以下のエラーが発生します。 

    java.lang.IllegalStateException: You are attempting to install a patch for the 'jboss-eap-xp-3.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 3.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 3.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