18.4. AMQ Streams 1.7 へのアップグレード
このセクションでは、AMQ Streams 1.7 を使用するようにデプロイメントをアップグレードする手順について説明します。
AMQ Streams によって管理される Kafka クラスターの可用性は、アップグレード操作による影響を受けません。
特定バージョンの AMQ Streams へのアップグレード方法については、そのバージョンをサポートするドキュメントを参照してください。
18.4.1. Kafka ブローカーおよび ZooKeeper のアップグレード
この手順では、ホストマシンで Kafka ブローカーおよび ZooKeeper をアップグレードし、最新バージョンの AMQ Streams を使用する方法について説明します。
前提条件
-
kafka
ユーザーとして Red Hat Enterprise Linux にログインしている。
手順
AMQ Streams クラスターの各 Kafka ブローカーと 1 つずつ、以下の 1 つに対して以下を行います。
カスタマーポータルから AMQ Streams アーカイブを ダウンロード します。
注記要求されたら、Red Hat アカウントにログインします。
コマンドラインで一時ディレクトリーを作成し、
amq-streams-x.y.z-bin.zip
ファイルの内容を展開します。mkdir /tmp/kafka unzip amq-streams-x.y.z-bin.zip -d /tmp/kafka
実行している場合は、ZooKeeper およびホストで実行されている Kafka ブローカーを停止します。
/opt/kafka/bin/zookeeper-server-stop.sh /opt/kafka/bin/kafka-server-stop.sh jcmd | grep zookeeper jcmd | grep kafka
既存のインストールから
libs
、bin
、およびdocs
ディレクトリーを削除します。rm -rf /opt/kafka/libs /opt/kafka/bin /opt/kafka/docs
一時ディレクトリーから
libs
、bin
、およびdocs
ディレクトリーをコピーします。cp -r /tmp/kafka/kafka_y.y-x.x.x/libs /opt/kafka/ cp -r /tmp/kafka/kafka_y.y-x.x.x/bin /opt/kafka/ cp -r /tmp/kafka/kafka_y.y-x.x.x/docs /opt/kafka/
一時ディレクトリーを削除します。
rm -r /tmp/kafka
-
テキストエディターで、一般的に
/opt/kafka/config/
ディレクトリーに保存されているブローカープロパティーファイルを開きます。 inter.broker.protocol.version
およびlog.message.format.version
プロパティーが 現行 バージョンに設定されていることを確認します。inter.broker.protocol.version=2.6 log.message.format.version=2.6
inter.broker.protocol.version
を変更しないと、ブローカーはアップグレード中も相互に通信を継続できます。プロパティーが設定されていない場合は、現行バージョンで追加します。
更新された ZooKeeper および Kafka ブローカーを再起動します。
/opt/kafka/bin/zookeeper-server-start.sh -daemon /opt/kafka/config/zookeeper.properties /opt/kafka/bin/kafka-server-start.sh -daemon /opt/kafka/config/server.properties
Kafka ブローカーおよび Zookeeper は、最新の Kafka バージョンのバイナリーの使用を開始します。
-
再起動した Kafka ブローカーが、以下になっているパーティションレプリカでキャッチされたことを確認します。
kafka-topics.sh
ツールを使用して、ブローカーに含まれるすべてのレプリカを同期していることを確認します。手順は「 トピックの一覧表示および説明 」を参照してください。 - 「Kafka のアップグレード」 の説明通りに、Kafka をアップグレードする手順を実行します。