第62章 Red Hat Decision Manager へのパッチ更新およびマイナーリリースアップグレードの適用

自動更新ツールは、多くの場合、パッチ更新と Red Hat Decision Manager の新しいマイナーバージョンの両方で提供され、Business Central、KIE Server、ヘッドレス Decision Manager コントローラーなど、Red Hat Decision Manager の特定コンポーネントの更新を容易にします。デシジョンエンジンやスタンドアロンの Business Central など、その他の Red Hat Decision Manager アーティファクトは、各マイナーリリースが含まれる新しいアーティファクトとしてリリースされるため、再インストールして更新を適用する必要があります。

この自動更新ツールを使用してパッチ更新とマイナーリリースアップグレードの両方を Red Hat Decision Manager 7.11 に適用することができます。バージョン 7.11 から 7.11.1 への更新といった Red Hat Decision Manager のパッチ更新には、最新のセキュリティー更新とバグ修正が含まれます。バージョン 7.10.x から 7.11 へのアップグレードといった Red Hat Decision Manager のマイナーリリースアップグレードには、機能強化、セキュリティー更新、バグ修正が含まれます。

注記

Red Hat Decision Manager 更新ツールに含まれるのは、Red Hat Decision Manager の更新のみです。Red Hat JBoss EAP への更新は、Red Hat JBoss EAP パッチ配信を使用して適用する必要があります。詳細は Red Hat JBoss EAP パッチおよびアップグレードガイド を参照してください。

前提条件

  • Red Hat Decision Manager インスタンスおよび KIE Server インスタンスが稼働していない。Red Hat Decision Manager または KIE Server のインスタンスを実行している間は更新を適用しないでください。

手順

  1. Red Hat カスタマーポータルの Software Downloads ページに移動し (ログインが必要)、ドロップダウンオプションから選択およびバージョンを選択します。

    バージョン 7.10.x から 7.11 などのように Red Hat Decision Manager のマイナーリリースにアップグレードする場合は、お使いの Red Hat Decision Manager に最新のパッチ更新を適用してから、以下の手順に従って、新たなマイナーリリースにアップグレードしてください。

  2. Patches をクリックし、Red Hat Decision Manager [VERSION] Update Tool をダウンロードし、ダウンロードした rhdm-$VERSION-update.zip ファイルを一時ディレクトリーに展開します。

    この更新ツールは、Business Central、KIE Server、ヘッドレス Decision Manager コントローラーなど、Red Hat Decision Manager の一定のコンポーネントの更新を自動化します。このツールを使用して最初に更新を適用し、Red Hat Decision Manager ディストリビューションに関連するその他の更新、または新しいリリースアーティファクトをインストールします。

  3. 更新ツールがファイルを更新しないようにするには、展開した rhdm-$VERSION-update ディレクトリーに移動し、blacklist.txt ファイルを開き、更新しないファイルの相対パスを追加します。

    ファイルが blacklist.txt ファイルの一覧に追加されていると、更新スクリプトは、そのファイルを新しいバージョンに置き換えずにそのまま残し、新しいバージョンのファイルに .new 接尾辞を付けて追加します。ブロックファイルが配布されなくなると、更新ツールは、.removed 接尾辞の付いた、空のマーカーファイルを作成します。次に、これらの新しいファイルを手動で保持、マージ、または削除することを選択できます。

    blacklist.txt ファイルで除外されるファイルの例: 

    WEB-INF/web.xml  // Custom file
styles/base.css  // Obsolete custom file kept for record

    更新後の、ブロックされたファイルディレクトリー内のコンテンツ: 

    $ ls WEB-INF
web.xml web.xml.new
    $ ls styles
base.css base.css.removed

  4. コマンドの端末で、rhdm-$VERSION-update.zip ファイルから展開した一時ファイルに移動し、以下の形式で apply-updates スクリプトを実行します。

    重要

    更新を適用する前に、Red Hat Decision Manager インスタンスおよび KIE Server インスタンスが実行していないことを確認します。Red Hat Decision Manager または KIE Server のインスタンスを実行している間は更新を適用しないでください。

    Linux システムまたは Unix ベースのシステムの場合: 

    $ ./apply-updates.sh $DISTRO_PATH $DISTRO_TYPE

    Windows の場合: 

    $ .\apply-updates.bat $DISTRO_PATH $DISTRO_TYPE

    $DISTRO_PATH の部分は、関連するディストリビューションディレクトリーへのパスで、$DISTRO_TYPE の部分は、更新しているディストリビューションの種類となります。

    Red Hat Decision Manager 更新ツールでは、以下のディストリビューションの種類がサポートされます。

    • rhdm-decision-central-eap7-deployable: Business Central を更新します (decision-central.war)。
    • rhdm-kie-server-ee8: KIE Server を更新します (kie-server.war)。
    • rhdm-kie-server-jws: Red Hat JBoss Web Server で KIE Server を更新します (kie-server.war)。
    • rhdm-controller-ee7: ヘッドレス Decision Manager コントローラー (controller.war) を更新します。

    • rhdm-controller-jws: Red Hat JBoss Web Server でヘッドレスの Decision Manager コントローラーを更新します (controller.war)。

      Red Hat JBoss EAP で、Red Hat Decision Manager の完全ディストリビューションに対する Business Central および KIE Server への更新の例: 

      ./apply-updates.sh ~EAP_HOME/standalone/deployments/decision-central.war rhdm-decision-central-eap7-deployable

./apply-updates.sh ~EAP_HOME/standalone/deployments/kie-server.war rhdm-kie-server-ee8

      ヘッドレス Decision Manager コントローラーへの更新例 (使用している場合): 

      ./apply-updates.sh ~EAP_HOME/standalone/deployments/controller.war rhdm-controller-ee7

      更新スクリプトは、展開した rhdm-$VERSION-update ディレクトリーに、指定したディストリビューションのコピーを含む backup ディレクトリーを作成してから、更新を行います。

  5. 更新ツールが完了したら、Red Hat カスタマーポータルで、更新ツールをダウンロードしたSoftware Downloadsページに戻り、Red Hat Decision Manager ディストリビューションに関するその他の更新または新しいリリースアーティファクトをインストールします。

    デシジョンエンジンまたはその他のアドオンに関する .jar など、Red Hat Decision Manager ディストリビューションにすでに存在しているファイルについては、ファイルの既存のバージョンを、Red Hat カスタマーポータルから取得した新しいバージョンと取り替えます。

  6. エアギャップ環境などで、スタンドアロンの Red Hat Decision Manager 7.11.0 Maven Repository アーティファクト (rhdm-7.11.0-maven-repository.zip) を使用している場合は、Red Hat Decision Manager 7.11.x Maven Repository をダウンロードし、ダウンロードした rhdm-7.11.x-maven-repository.zip ファイルを既存の ~/maven-repository ディレクトリーに展開して、関連するコンテンツを更新します。

    Maven リポジトリーの更新例: 

    $ unzip -o rhdm-7.11.x-maven-repository.zip 'rhba-7.11.1.GA-maven-repository/maven-repository/*' -d /tmp/rhbaMavenRepoUpdate

$ mv /tmp/rhbaMavenRepoUpdate/rhba-7.11.0.GA-maven-repository/maven-repository/ $REPO_PATH/
    注記

    更新が完了したら /tmp/rhbaMavenRepoUpdate ディレクトリーを削除してください。

  7. 関連する更新をすべて適用したら、Red Hat Decision Manager および KIE Server を起動して、Business Central にログインします。

  8. Business Central 内のすべてのプロジェクトデータが存在して正確であることを確認し、Business Central ウィンドウの右上隅でプロファイル名をクリックし、About をクリックして、更新した製品バージョン番号を確認します。

    Business Central でエラーが発生したり、データが不足していることが通知されたら、rhdm-$VERSION-update ディレクトリーの backup ディレクトリーにコンテンツを復元し、更新ツールへの変更を戻します。Red Hat カスタマーポータルで Red Hat Decision Manager の以前のバージョンから、関連するリリースアーティファクトを再インストールできます。以前のディストリビューションを復元したら、更新を再実行してください。