2.3. ブローカーインスタンスの 7.4.0 から 7.4.x へのアップグレード
AMQ Broker 7.4 は、Long Term Support (LTS) リリースバージョンとして指定されています。バグ修正およびセキュリティーアドバイザリーは、少なくとも 12 カ月間、一連のマイクロリリース (7.4.1、7.4.2 など) で AMQ Broker 7.4 で利用可能になります。つまり、新しいマイナーリリースにアップグレードしなくても、AMQ Broker の最新のバグ修正およびセキュリティーアドバイザリーを取得できます。詳細は、Long Term Support for AMQ Brokerを参照してください。
AMQ Broker 7.1.0 以降では、デフォルトでローカルホストからのみ AMQ 管理コンソールにアクセスできます。コンソールにリモートアクセスを設定する方法は、Configuring local and remote access to AMQ Management Console を参照してください。
以下のサブセクションでは、異なるオペレーティングシステムの 7.4.0 ブローカーインスタンスを 7.4.x にアップグレードする方法を説明します。
2.3.1. Linux 上の 7.4.0 から 7.4.x へのアップグレード
ダウンロードするアーカイブの名前は、以下の例で使用されているものとは異なる場合があります。
手順
- Red Hat カスタマーポータルから必要なアーカイブをダウンロードします。AMQ Broker アーカイブのダウンロード に記載されている手順に従います。
アーカイブの所有者を、AMQ Broker インストールが含まれるのと同じユーザーに変更します。以下の例では、
amq-broker
というユーザーを設定しています。sudo chown amq-broker:amq-broker amq-broker-7.4.x.redhat-1.zip
AMQ Broker の元のインストール時に作成されたディレクトリーにアーカイブを移動します。以下の例では、
/opt/redhat
を使用しています。sudo mv amq-broker-7.4.x.redhat-1.zip /opt/redhat
ディレクトリーの所有者は、圧縮アーカイブのコンテンツをデプロイメントします。以下の例では、ユーザー
amq-broker
はunzip
コマンドを使用してアーカイブをデプロイメントします。su - amq-broker cd /opt/redhat unzip amq-broker-7.4.x.redhat-1.zip
ブローカーが実行されている場合は停止します。
<broker_instance_dir>/bin/artemis stop
現在のユーザーのホームディレクトリーにコピーして、ブローカーのインスタンスディレクトリーをバックアップします。
cp -r <broker_instance_dir> ~/
(オプション) ブローカーの現行バージョンをメモします。ブローカーが停止すると、
<broker_instance_dir>/log/artemis.log
ファイルの最後に以下のような行が表示されます。INFO [org.apache.activemq.artemis.core.server] AMQ221001: Apache ActiveMQ Artemis Message Broker version 2.7.0.redhat-00054 [0.0.0.0, nodeID=554cce00-63d9-11e8-9808-54ee759954c4]
<broker_instance_dir>/etc/artemis.profile
設定ファイルを編集してください。アーカイブの抽出時に作成された新しいディレクトリーにARTEMIS_HOME
プロパティーを設定します。ARTEMIS_HOME='/opt/redhat/amq-broker-7.4.x-redhat-1'
アップグレードされたブローカーを起動します。
<broker_instance_dir>/bin/artemis run
(オプション) ブローカーが実行され、バージョンが変更されたことを確認します。ブローカーを起動したら、
<broker_instance_dir>/log/artemis.log
ファイルを開きます。以下のような 2 つの行を見つけます。ブローカーの稼働時にログに表示される新しいバージョン番号に注意してください。INFO [org.apache.activemq.artemis.core.server] AMQ221007: Server is now live ... INFO [org.apache.activemq.artemis.core.server] AMQ221001: Apache ActiveMQ Artemis Message Broker version 2.9.0.redhat-00001 [0.0.0.0, nodeID=554cce00-63d9-11e8-9808-54ee759954c4]
関連情報
- ブローカーのインスタンス作成に関する詳細は、ブローカーインスタンスの作成を参照してください。
-
ブローカーインスタンスの設定ファイルおよびデータを、ブローカーインスタンスのディレクトリー外の場所を含む、カスタムディレクトリーに格納できるようになりました。
<broker_instance_dir>/etc/artemis.profile
ファイルで、ブローカーインスタンスの作成後のカスタムディレクトリーの場所を指定し、ARTEMIS_INSTANCE_ETC_URI
プロパティーを更新します。以前のバージョンでは、これらの設定ファイルとデータは、ブローカーインスタンスのディレクトリー内のetc/
ディレクトリーおよびdata/
ディレクトリーにのみ保存できました。
2.3.2. Windows 上の 7.4.0 から 7.4.x へのアップグレード
手順
- Red Hat カスタマーポータルから必要なアーカイブをダウンロードします。AMQ Broker アーカイブのダウンロード に記載されている手順に従います。
- ファイルマネージャーを使用して、アーカイブを AMQ Broker の最後のインストール時に作成したフォルダーに移動します。
- アーカイブの内容をデプロイメントします。.zip ファイルを右クリックし、Extract All を選択します。
ブローカーが実行されている場合は停止します。
<broker_instance_dir>\bin\artemis-service.exe stop
ファイルマネージャーを使用してブローカーをバックアップします。
-
<broker_instance_dir>
フォルダーを右クリックし、Copy を選択します。 - 同じウィンドウを右クリックし、Paste を選択します。
-
(オプション) ブローカーの現行バージョンをメモします。ブローカーが停止すると、
<broker_instance_dir>\log\artemis.log
の末尾に以下のような行が表示されます。INFO [org.apache.activemq.artemis.core.server] AMQ221002: Apache ActiveMQ Artemis Message Broker version 2.7.0.redhat-00054 [4782d50d-47a2-11e7-a160-9801a793ea45] stopped, uptime 28 minutes
<broker_instance_dir>\etc\artemis.profile.cmd
および<broker_instance_dir>\bin\artemis-service.xml
設定ファイルを編集してください。アーカイブの抽出時に作成された新しいディレクトリーにARTEMIS_HOME
プロパティーを設定します。ARTEMIS_HOME=
<install_dir>
アップグレードされたブローカーを起動します。
<broker_instance_dir>\bin\artemis-service.exe start
(オプション) ブローカーが実行され、バージョンが変更されたことを確認します。ブローカーを起動した後、
<broker_instance_dir>\log\artemis.log
ファイルを開きます。以下のような 2 つの行を見つけます。ブローカーの稼働時にログに表示される新しいバージョン番号に注意してください。INFO [org.apache.activemq.artemis.core.server] AMQ221007: Server is now live ... INFO [org.apache.activemq.artemis.core.server] AMQ221001: Apache ActiveMQ Artemis Message Broker version 2.9.0.redhat-00001 [0.0.0.0, nodeID=554cce00-63d9-11e8-9808-54ee759954c4]
関連情報
- ブローカーのインスタンス作成に関する詳細は、ブローカーインスタンスの作成を参照してください。
-
ブローカーインスタンスの設定ファイルおよびデータを、ブローカーインスタンスのディレクトリー外の場所を含む、カスタムディレクトリーに格納できるようになりました。In the
<broker_instance_dir>\etc\artemis.profile
ファイルで、ブローカーインスタンスの作成後にカスタムディレクトリーの場所を指定し、ARTEMIS_INSTANCE_ETC_URI
プロパティーを更新します。以前のバージョンでは、これらの設定ファイルとデータは、ブローカーインスタンスのディレクトリー内の\etc
ディレクトリーおよび\data
ディレクトリーにのみ保存できました。