1.7. ブローカーインスタンスの 7.7.0 から 7.8.x へのアップグレード
以下のサブセクションでは、異なるオペレーティングシステムの 7.7.0 ブローカーインスタンスを 7.8.x にアップグレードする方法を説明します。
AMQ Broker 7.1.0 以降では、デフォルトでローカルホストからのみ AMQ 管理コンソールにアクセスできます。コンソールにリモートアクセスを設定する方法は、「 Configuring local and remote access to AMQ Management Console 」を参照してください。
1.7.1. Linux 上の 7.7.0 から 7.8.x へのアップグレード
ダウンロードするアーカイブの名前は、以下の例で使用されているものとは異なる場合があります。
手順
- Red Hat カスタマーポータルから必要なアーカイブをダウンロードします。AMQ Broker アーカイブのダウンロード に記載されている手順に従います。
アーカイブの所有者を、AMQ Broker インストールが含まれるのと同じユーザーに変更します。以下の例では、
amq-broker
というユーザーを設定しています。sudo chown amq-broker:amq-broker amq-broker-7.8.x.redhat-1.zip
AMQ Broker の元のインストール時に作成されたディレクトリーにアーカイブを移動します。以下の例では、
/opt/redhat
を使用しています。sudo mv amq-broker-7.8.x.redhat-1.zip /opt/redhat
ディレクトリーの所有者は、圧縮アーカイブのコンテンツを展開します。以下の例では、ユーザー
amq-broker
はunzip
コマンドを使用してアーカイブを展開します。su - amq-broker cd /opt/redhat unzip amq-broker-7.8.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.13.0.redhat-00003 [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.8.x-redhat-1'
JAVA_ARGS
プロパティを探します。以下に示すように、ブートストラップクラスパスの引数が、ログマネージャーの依存するファイルに必要なバージョンを参照することを確認します。-Xbootclasspath/a:$ARTEMIS_HOME/lib/wildfly-common-1.5.2.Final-redhat-00002.jar
BROKER_INSTANCE_DIR/etc/bootstrap.xml
設定ファイルを編集します。web
要素で、7.8 の AMQ 管理コンソールに必要な.war
ファイルの名前を更新します。<web bind="http://localhost:8161" path="web"> ... <app url="console" war="hawtio.war"/> ... </web>
アップグレードされたブローカーを起動します。
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.16.0.redhat-00012 [0.0.0.0, nodeID=554cce00-63d9-11e8-9808-54ee759954c4]
関連情報
- ブローカーのインスタンス作成に関する詳細は、「ブローカーインスタンスの作成」を 参照してください。
-
ブローカーインスタンスの設定ファイルおよびデータを、ブローカーインスタンスのディレクトリー外の場所を含む、カスタムディレクトリーに格納できるようになりました。
BROKER_INSTANCE_DIR/etc/artemis.profile
ファイルで、ブローカーインスタンスの作成後にカスタムディレクトリーの場所を指定し、ARTEMIS_INSTANCE_ETC_URI
プロパティーを更新します。以前のバージョンでは、これらの設定ファイルとデータは、ブローカーインスタンスのディレクトリー内のetc/
ディレクトリーおよびdata/
ディレクトリーにのみ保存できました。