2.2.5. ブローカーインスタンスの 7.3.0 から 7.4.0 へのアップグレード
以下のサブセクションでは、異なるオペレーティングシステムの 7.3.0 ブローカーインスタンスを 7.4.0 にアップグレードする方法を説明します。
AMQ Broker 7.1.0 以降では、デフォルトでローカルホストからのみ AMQ 管理コンソールにアクセスできます。コンソールにリモートアクセスを設定する方法は、「 Configuring local and remote access to AMQ Management Console 」を参照してください。
2.2.5.1. Linux での 7.3.0 から 7.4.0 へのアップグレード
ダウンロードするアーカイブの名前は、以下の例で使用されているものとは異なる場合があります。
手順
- Red Hat カスタマーポータルから必要なアーカイブをダウンロードします。AMQ Broker アーカイブのダウンロード に記載されている手順に従います。
アーカイブの所有者を、AMQ Broker インストールが含まれるのと同じユーザーに変更します。以下の例では、
amq-broker
というユーザーを設定しています。sudo chown amq-broker:amq-broker amq-broker-7.x.x.redhat-1.zip
AMQ Broker の元のインストール時に作成されたディレクトリーにアーカイブを移動します。以下の例では、
/opt/redhat
を使用しています。sudo mv amq-broker-7.x.x.redhat-1.zip /opt/redhat
ディレクトリーの所有者は、圧縮アーカイブのコンテンツを展開します。以下の例では、ユーザー
amq-broker
はunzip
コマンドを使用してアーカイブを展開します。su - amq-broker cd /opt/redhat unzip amq-broker-7.x.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.x.x-redhat-1'
JAVA_ARGS
プロパティを編集します。ログマネージャーに依存するファイルを参照するブートストラップクラスパス引数を追加します。-Xbootclasspath/a:$ARTEMIS_HOME/lib/wildfly-common-1.5.1.Final-redhat-00001.jar
<broker_instance_dir>/etc/bootstrap.xml
設定ファイルを編集します。<web>
設定要素で、AMQ Broker の metrics プラグインファイルへの参照を追加します。<app url="metrics" war="metrics.war"/>
アップグレードされたブローカーを起動します。
<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/
ディレクトリーにのみ保存できました。