第2章 JBoss EAP のパッチ適用


JBoss EAP にパッチを適用する方法は、インストールの方法によって異なります。ZIP またはインストーラーで JBoss EAP をインストールした場合は、ZIP ベースのパッチ管理システム を使用する必要があります。RPM を使用して Red Hat Enterprise Linux 上に JBoss EAP をインストールした場合は、RPM パッチ を使用する必要があります。

重要

パッチを適用またはロールバックする前に、すべてのデプロイメントと設定ファイルを含む JBoss EAP サーバーをバックアップしてください。

JBoss EAP Maven リポジトリーをローカルでインストールした場合、JBoss EAP サーバーの累計パッチと同じバージョンを Maven リポジトリーにパッチする必要もあります。

2.1. ZIP/インストーラーインストールのパッチ適用

JBoss EAP の ZIP またはインストーラーインストールの累計パッチは、Red Hat カスタマーポータルからダウンロードできます。

管理対象ドメイン環境の複数の JBoss EAP ホストの場合、各ホストは JBoss EAP ドメインコントローラーからパッチできます。

パッチ適用の他に、パッチの適用をロールバックすることもできます。

2.1.1. ZIP/インストーラーインストールのパッチに関する重要事項

  • モジュールを更新するパッチを適用する場合、新たにパッチが適用され、起動時に使用される JAR は EAP_HOME/modules/system/layers/base/.overlays/PATCH_ID/MODULE に格納されます。パッチが適用されていない元のファイルはこれまでどおり EAP_HOME/modules/system/layers/base/MODULE に格納されますが、これらの JAR はランタイムに使用されません
  • JBoss EAP 7 の累計パッチリリースのサイズを大幅に小さくするため、累計パッチを部分的にロールバックすることはできません。適用済みのパッチはパッチ全体のみをロールバックできます。

    たとえば、CP03 を JBoss EAP 7.0.0 に適用する場合、CP01 や CP02 にロールバックできません。各累計パッチリリースにロールバックできるようにするには、各累計パッチをリリース順に個別に適用する必要があります。

2.1.2. パッチの適用

注記

RPM メソッドを使用してインストールされた JBoss EAP サーバーは前述の手順で更新することはできません。RPM 用のパッチ適用手順を参照してください。

管理 CLI または 管理コンソール のいずれかを使用してダウンロードしたパッチを JBoss EAP に適用できます。

管理 CLI を使用した JBoss EAP へのパッチ適用

  1. Red Hat カスタマーポータルにログインし、JBoss EAP の Software Downloads からパッチファイルをダウンロードします。
  2. パッチファイルへの適切なパスを指定して以下のコマンドを使用し、管理 CLI からパッチを適用します。

    patch apply /path/to/downloaded-patch.zip
    注記

    管理対象ドメインで別の JBoss EAP にパッチを適用するには、--host= 引数を使用して JBoss EAP ホスト名を指定します。例を以下に示します。

    patch apply /path/to/downloaded-patch.zip --host=my-host

    パッチの適用時に競合が存在する場合は、パッチツールによって警告が表示されます。競合が存在する場合は、使用できる引数に patch --help を入力し、競合の解決方法を指定する引数を用いてコマンドを再実行します。

  3. JBoss EAP サーバーを再起動して、パッチを反映します。

    shutdown --restart=true

管理コンソールを使用した JBoss EAP へのパッチ適用

  1. Red Hat カスタマーポータルにログインし、JBoss EAP の Software Downloads からパッチファイルをダウンロードします。
  2. 管理コンソール を開き、Patch Management ビューに移動します。

    1. スタンドアロンサーバーでは、Patching タブをクリックします。

      図2.1 スタンドアロンサーバーの Patch Management 画面

      The Patch Management Screen for a Standalone Server
    2. 管理対象ドメインでは、Patching タブをクリックし、パッチを適用するホストを選択した後、表示をクリックします。

      図2.2 管理対象ドメインの Patch Management 画面

      The Patch Management Screen for a Managed Domain
  3. 新しいパッチの適用 をクリックします。

    1. 管理対象ドメインホストにパッチを適用する場合は、次の画面でホストのサーバーをシャットダウンするかどうかを選択し、次へ をクリックします。
  4. Browse をクリックして適用するダウンロード済みのパッチを選択し、次へ をクリックします。

    図2.3 パッチの適用画面

    Apply Patch Screen
    1. パッチの適用時に競合がある場合は、警告が表示されます。View error details (エラー詳細の表示) をクリックして競合の詳細を表示します。競合がある場合は、操作をキャンセルするか、Override all conflicts (すべての競合のオーバーライド) チェックボックスを選択して Next (次へ) をクリックします。競合をオーバーライドすると、すべてのユーザーの変更がパッチの内容によって上書きされます。
  5. パッチが正常に適用されたら、パッチを反映するために JBoss EAP を再起動するかどうかを選択し、Finish (完了) をクリックします。

2.1.3. パッチのロールバック

管理 CLI または 管理コンソール を使用して、以前に適用した JBoss EAP パッチをロールバックできます。

重要

パッチ管理システムを使用したパッチのロールバックは、一般的なアンインストール機能として使用するものではありません。不適切な結果をもたらしたパッチ適用の直後に使用することを目的としています。

前提条件

  • 以前に適用されたパッチ。
警告

いずれかの手順に従う場合は、Reset Configuration オプションの値を指定するときに注意してください。

TRUE に設定した場合、パッチロールバックプロセスによって JBoss EAP サーバー設定ファイルもパッチ適用前の状態にロールバックされます。パッチの適用後に JBoss EAP サーバー設定ファイルに追加された変更はすべて失われます。

FALSE に設定した場合、サーバー設定ファイルはロールバックされません。この状況では、ネームスペースなどの設定がパッチにより変更され、設定が有効でなくなる可能性があるため、手動で設定を修正する必要があり、ロールバック後にサーバーを起動できないことがあります。

管理 CLI を使用したパッチのロールバック

  1. 管理 CLI から patch history コマンドを使用して、ロールバックするパッチの ID を見つけます。

    注記

    管理対象ドメインを使用している場合は、JBoss EAP ホストを指定するため、この手順のコマンドに --host=HOSTNAME 引数を追加する必要があります。

  2. 見つけたパッチ ID を使用して、パッチをロールバックします。

    patch rollback --patch-id=PATCH_ID --reset-configuration=TRUE

    パッチのロールバック時に競合が存在する場合は、パッチツールによって警告が表示されます。競合が存在する場合は、使用できる引数に patch --help を入力し、競合の解決方法を指定する引数を用いてコマンドを再実行します。

  3. JBoss EAP サーバーを再起動して、パッチのロールバックを反映します。

    shutdown --restart=true

管理コンソールを使用したパッチのロールバック

  1. 管理コンソールを開き、Patch Management ビューに移動します。

    1. スタンドアロンサーバーでは、Patching タブをクリックします。
    2. 管理対象ドメインでは、Patching タブをクリックし、パッチを適用するホストを選択した後、表示をクリックします。
  2. ロールバックするパッチをリストから選択し、ロールバック をクリックします。

    図2.4 最近のパッチ履歴画面

    Recent Patch History Screen
    1. 管理対象ドメインホストでパッチをロールバックする場合は、次の画面でホストのサーバーをシャットダウンするかどうかを選択し、次へをクリックします。
  3. ロールバックプロセスのオプションを選択し、次へ をクリックします。

    図2.5 パッチのロールバックオプション

    Patch Rollback Options
  4. オプションとロールバックするパッチを確認し、次へ をクリックします。

    1. パッチのロールバック時に競合があり、Override all (すべてのオーバーライド) オプションが選択されていない場合は、警告が表示されます。View error details (エラー詳細の表示) をクリックして競合の詳細を表示します。競合がある場合は、操作をキャンセルするか、Choose Options (オプションの選択) をクリックし、Override all (すべてのオーバーライド) チェックボックスを選択した状態で操作を再試行します。競合をオーバーライドすると、すべてのユーザーの変更がロールバック操作によって上書きされます。
  5. パッチが正常にロールバックされたら、変更を反映するために JBoss EAP サーバーを今すぐ再起動するかどうかを選択し、Finish (完了) をクリックします。

2.1.4. パッチ履歴の消去

パッチが JBoss EAP サーバーに適用されると、ロールバック操作で使用するためのパッチの内容および履歴が保存されます。複数の累計パッチが適用された場合、パッチ履歴の保存に大量のディスク領域が使用されることがあります。

以下の管理 CLI コマンドを使用すると、現在使用されていない古いパッチをすべて削除することができます。このコマンドを使用する場合、最新の累積パッチのみが GA リリースとともに保持されます。これは、以前に複数の累積パッチが適用され、ディスク領域を解放する場合のみ便利です。

/core-service=patching:ageout-history
重要

パッチ履歴を消去すると、以前に適用されたパッチにロールバックできなくなります。

2.2. RPM インストールへのパッチ適用

前提条件

  • ベースのオペレーティングシステムが最新の状態で、標準の Red Hat Enterprise Linux リポジトリーにサブスクライブし、更新を取得できるようにしてください。
  • 更新に関連する JBoss EAP リポジトリーにサブスクライブしていることを確認してください。

    警告

    RPM インストールを更新する場合、JBoss EAP はサブスクライブしているリポジトリーの RPM リリースの修正で累積的に更新されます。

    「現行」のリポジトリーにサブスクライブしている場合、インストールが次に利用できるマイナーリリースにアップグレードされる可能性があります。詳細は、『インストールガイド』の「リポジトリーの選択」に記載されている情報を参照してください。

  • 設定ファイル、デプロイメント、およびユーザーデータをすべてバックアップします。
重要

管理対象ドメインでは、JBoss EAP ドメインコントローラーを最初に更新する必要があります。

サブスクライブしているリポジトリーから RPM で JBoss EAP パッチをインストールするには、以下のコマンドを実行して Red Hat Enterprise Linux システムを更新します。

# yum update

2.3. 任意設定: ローカル JBoss EAP Maven リポジトリーへのパッチ適用

インストールした JBoss EAP Maven リポジトリーにもパッチを適用する必要がある場合があります。

JBoss EAP Maven リポジトリーはオンラインで利用でき、ダウンロードした ZIP ファイルとして使用することもできます。公開ホストのオンライン Maven リポジトリーを使用する場合、更新は自動的に適用されるため、更新のためにすることはありません。しかし、ZIP ファイルを使用して Maven リポジトリーをローカルにインストールした場合、ご自分で更新をリポジトリーに適用する必要があります。

JBoss EAP の累積パッチがリリースされると、JBoss EAP Maven リポジトリー用の対応パッチが提供されます。このパッチは、既存のローカルリポジトリーで展開される増分 ZIP ファイルで提供されます。既存のファイルは上書きまたは削除しないため、ロールバックの要件はありません。

以下の手順にしたがって、ローカルインストールされた JBoss EAP Maven リポジトリーに更新を適用します。

前提条件

  • Red Hat カスタマーポータルへの有効なアクセスおよびサブスクリプション。
  • 以前ローカルにダウンロードおよびインストールされた JBoss EAP 7.1 Maven リポジトリー。

ローカルインストールされた JBoss EAP Maven リポジトリーの更新

  1. ブラウザーを開き、Red Hat カスタマーポータル にログインします。
  2. ページの上部にあるメニューから Downloads を選択します。
  3. リストで Red Hat JBoss Enterprise Application Platform を見つけ、クリックします。
  4. Version ドロップダウンメニューから JBoss EAP の正しいバージョンを選択し、Patches タブをクリックします。
  5. Red Hat JBoss Enterprise Application Platform 7.1 Update CP_NUMBER Incremental Maven Repository (CP_NUMBER は更新する累計パッチ番号) を見つけ、Download をクリックします。
  6. JBoss EAP Maven リポジトリーへのパスを見つけます。これは以下のコマンドで EAP_MAVEN_REPOSITORY_PATH と記載されています。
  7. ダウンロードした Maven パッチファイルを直接 JBoss EAP 7.1 Maven リポジトリーのディレクトリーに展開します。

    1. Red Hat Enterprise Linux の場合は、ターミナルを開き、以下のコマンドを実行します。累計パッチ番号と Maven リポジトリーへのパスは実際の値に置き換えます。

      $ unzip -o jboss-eap-7.1.CP_NUMBER-incremental-maven-repository.zip -d EAP_MAVEN_REPOSITORY_PATH
    2. Microsoft Windows の場合は、Windows 展開ユーティリティーを使用して ZIP ファイルを EAP_MAVEN_REPOSITORY_PATH ディレクトリーのルートに展開します。
Red Hat logoGithubRedditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

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

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

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

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

会社概要

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

© 2024 Red Hat, Inc.