Red Hat Summit Red Hat Summitサポートコンソール開発者トライアルの開始お問い合わせ

1.4. JBoss EAP XP manager 4.0 commands

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

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

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

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

Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。 最新の更新を見る.

Legal Notice

Theme

© 2026 Red Hatトップに戻る