はじめに
JBoss EAP 8 では、パッチ管理方式が EAP 7 以前から大きく変更されています。
EAP 6 および EAP 7 では、管理 CLI(jboss-cli.sh)の patch コマンドを利用してパッチ適用やロールバックを実施していました。一方、JBoss EAP 8 では パッチ管理の仕組みが 管理 CLI から Installation Manager を利用する方式へ移行しています。
そのため、EAP 7 以前の運用経験がある場合でも、従来と同じ手順ではパッチ適用やロールバックを実施できません。本記事は、EAP 7 までの運用経験があり、これから EAP 8 を利用する管理者や運用担当者向けに、EAP 8 におけるパッチ適用およびロールバック手順と、EAP 7 以前との違いをまとめます。
EAP7との違い
JBoss EAP 8 では、パッチ管理の仕組みが大きく変更されています。
| 項目 | EAP 7以前 | EAP 8 |
|---|---|---|
| 管理ツール | jboss-cli.sh | jboss-eap-installation-manager.sh |
| 配布形式 | ZIP形式のパッチ | Maven Repository |
| パッチ適用コマンド | patch apply | update perform |
| ロールバックコマンド | patch rollback | revert perform |
| ロールバック時の指定情報 | パッチID | revision_num |
特に JBoss EAP 8 では、従来の 管理CLI による管理方式から Installation Manager を利用した管理方式へ移行しています。また、Installation Manager では更新履歴ごとに revision_num と呼ばれる一意の識別子が付与されており、ロールバック時には戻し先の状態を revision_num で指定します。
そのため、以下の点に注意が必要です。
- パッチファイルではなく、Maven Repository をダウンロードする
- Maven Repository は展開してから利用する
- ロールバックを実施する場合、戻したいバージョンの Maven Repository をダウンロードする
- ロールバックを実施する場合、戻したいバージョンの revision_num が必要になる
適用方法
作業を実施する場合、事前にJBoss EAPを停止してから行ってください。
また、JBOSS_HOMEのバックアップを取得してください。
JBoss EAP 8 では、パッチの管理に以下のツールを利用します。
$JBOSS_HOME/bin/jboss-eap-installation-manager.sh
本ツールは EAP のインストール時に JBOSS_HOME/bin 配下へ配置されます。
対象環境
JBoss:Red Hat JBoss Enterprise Application Platform 8.1
OS:Red Hat Enterprise Linux 8.1
JDK:Open JDK 17.0.15
1. モジュールの取得
事前に Red Hat Customer Portal から適用したい更新用の Maven Repository をダウンロードします。
今回は JBoss EAP 8.1 に Update 7.1 を適用することを想定し、以下のモジュールを取得します。
Red Hat JBoss Enterprise Application Platform 8.1 Update 07.1 Maven Repository
jboss-eap-8.1.7.1-maven-repository.zip
2. モジュールの展開
ダウンロードしたファイルを任意のディレクトリへ展開します。
今回は /home/jboss/tmp を利用します。
$unzip /home/jboss/jboss-eap-8.1.7.1-maven-repository.zip -d /home/jboss/tmp
展開後のディレクトリ構成例
/home/jboss/tmp/
└── jboss-eap-8.1.7.GA-maven-repository
Update 7.1の場合、モジュール名は「jboss-eap-8.1.7.1-maven-repository.zip」ですが展開後のディレクトリ名は「8.1.7.GA」となります。
3. JBOSS_HOME の確認
JBOSS_HOMEを確認し、意図していないものであれば正しいものへ変更します。
$echo $JBOSS_HOME
$export JBOSS_HOME=/home/jboss/jboss-eap-8.1
4. パッチの適用
jboss-eap-installation-manager.sh の updateコマンドにてパッチを適用します。
引数"--repositories"に2で展開したディレクトリ/maven-repositoryを指定します。
$JBOSS_HOME/bin/jboss-eap-installation-manager.sh \
update perform \
--offline \
--dir $JBOSS_HOME \
--repositories mrrc::file:/home/jboss/tmp/jboss-eap-8.1.7.GA-maven-repository/maven-repository \
--yes
5. 適用結果の確認
jboss-eap-installation-manager.sh の historyコマンドにて、パッチの適用履歴を確認します。
$JBOSS_HOME/bin/jboss-eap-installation-manager.sh \
history \
--dir $JBOSS_HOME
EAP8.1 に初めてパッチ(Update7.1)を適用した場合、以下のような出力になります。
update の履歴が追加されていることを確認します。
[cafb3f99] 2026-09-07T03:08:10Z - update [org.jboss.eap.channels:eap-8.1::1.7.1.GA-redhat-00001]
[c40a432f] 2025-07-29T08:51:32Z - install [org.jboss.eap.channels:eap-8.1::1.0.0.GA-redhat-00012]
ロールバック方法
作業を実施する場合、事前にJBoss EAPを停止してから行ってください。
また、JBOSS_HOMEのバックアップを取得してください。
1. ロールバック用モジュールの取得
ロールバック先に対応する Maven Repository を取得します。今回は Update 07.1 適用後の状態から、EAP 8.1へ戻すことを想定します。取得するモジュールは以下です。
Red Hat JBoss Enterprise Application Platform 8.1 Maven Repository
jboss-eap-8.1.0-maven-repository.zip
2. モジュールの展開
ダウンロードしたファイルを任意のディレクトリへ展開します。
今回は /home/jboss/tmp を利用します。
$unzip /home/jboss/jboss-eap-8.1.0-maven-repository.zip -d /home/jboss/tmp/
3. JBOSS_HOME の確認
JBOSS_HOMEを確認し、意図していないものであれば正しいものへ変更します。
$echo $JBOSS_HOME
$export JBOSS_HOME=/home/jboss/jboss-eap-8.1
4. revision_num の確認
JBoss EAP 8 の Installation Manager では、パッチ適用やロールバックなどの更新履歴ごとに revision_num という一意の識別子が付与されます。ロールバックを実施する際は、戻し先の状態を表す revision_num を指定する必要があります。
jboss-eap-installation-manager.sh の historyコマンドにて、ロールバックしたいバージョンのrevision_numを確認します。
$JBOSS_HOME/bin/jboss-eap-installation-manager.sh \
history \
--dir $JBOSS_HOME
revision_num は、履歴の先頭に表示される [] 内の文字列です。
今回の場合、パッチ未適用の状態へ戻すため、revision_numは"c40a432f"になります。
[cafb3f99] 2026-09-07T03:08:10Z - update [org.jboss.eap.channels:eap-8.1::1.7.1.GA-redhat-00001]
[c40a432f] 2025-07-29T08:51:32Z - install [org.jboss.eap.channels:eap-8.1::1.0.0.GA-redhat-00012]
5. ロールバックの実行
jboss-eap-installation-manager.sh の revertコマンドにてロールバックします。
引数"--revision"に4で調べたrevision_numを指定します。
引数"--repositories"に2で展開したディレクトリ/maven-repositoryを指定します。
$JBOSS_HOME/bin/jboss-eap-installation-manager.sh \
revert perform \
--revision c40a432f \
--offline \
--repositories=file:/home/jboss/tmp/jboss-eap-8.1.0.GA-maven-repository/maven-repository \
--dir $JBOSS_HOME \
--yes
6. ロールバック結果の確認
jboss-eap-installation-manager.sh の historyコマンドにて、パッチの適用履歴を確認します。
$JBOSS_HOME/bin/jboss-eap-installation-manager.sh \
history \
--dir $JBOSS_HOME
今回の場合、以下のような出力になります。rollback の履歴が追加されていることを確認します。
[1023fe40] 2026-09-07T07:44:54Z - rollback [org.jboss.eap.channels:eap-8.1::1.0.0.GA-redhat-00012]
[cafb3f99] 2026-09-07T03:08:10Z - update [org.jboss.eap.channels:eap-8.1::1.7.1.GA-redhat-00001]
[c40a432f] 2025-07-29T08:51:32Z - install [org.jboss.eap.channels:eap-8.1::1.0.0.GA-redhat-00012]
まとめ
JBoss EAP 8 では、パッチ管理方式が大きく変更されているため、EAP 7以前から移行する場合は運用方法の違いを理解しておく必要があります。
主な変更点は以下のとおりです。
- パッチ管理方式が 管理CLI から Installation Manager へ変更された
- パッチ適用時に Maven Repository の取得および展開が必要となる
- ロールバック時に対象バージョンの Maven Repository と revision_num の指定が必要となる
是非 JBoss EAP 8 のパッチ適用をお試しください!
BIPROGYグループの技術への取り組み
We Are Hiring!