EMQX Enterprise

日本語

简体中文
English

日本語

简体中文
English

Appearance

お問い合わせ
お問い合わせ

EMQX クラスターを 4.4 から 5.x にアップグレードする方法 ​

このページでは、EMQX クラスターを最新バージョンにアップグレードする手順を説明します。

EMQX 5.x は設定、管理 API、およびクラスタリング API の互換性が 4.x とは後方互換性がないため、初期バージョンからのローリングアップグレードはサポートされていません。アップグレードを成功させるために、アップグレード手順を開始する前に必ず開始前の注意事項をよくお読みください。

アップグレード中に問題が発生した場合は、EMQX サポートにお問い合わせください。

TIP

現在のバージョンを新規インストールした場合、既存のクラスター設定は保持されません。新規インストールについてはインストールを参照してください。

対象読者 ​

本手順は、EMQX の旧バージョンからアップグレードが必要な方、およびデータセンター運用に精通した Linux システム管理者を対象としています。

開始前の注意事項 ​

アップグレードを開始する前に、本節で説明する要件、非互換変更点、および潜在的な落とし穴を理解しておいてください。

アップグレードのバージョンパス ​

既存の EMQX クラスターをバージョン 5.1 以降にアップグレードするには、現在 4.4.x リリースを実行している必要があります。

もし 4.4.x より前のバージョンを実行している場合は、段階的にメジャーリリースをアップグレードし、4.4.x に到達してから 5.x へのアップグレードを行ってください。例えば、現在 4.3.x を使用している場合は、まず 4.4 にアップグレードしてから 5.x に進む必要があります。詳細は4.4 アップグレードガイドを参照してください。

非互換変更点 ​

アップグレード開始前に、現在のデプロイメントとの非互換性や競合をすべて解決する必要があります。アプリケーションやデプロイメントに影響を与える可能性のある互換性問題や破壊的変更点については、以下を参照してください。

また、本番環境に適用する前にステージング環境で十分にアプリケーションをテストすることを強く推奨します。これによりスムーズな移行と潜在的な障害の最小化が図れます。

クライアントアプリケーションおよびデータブリッジの互換性 ​

アップグレードされたデプロイメントを非互換なクライアントやデータブリッジのバージョンと共に使用すると、予期しない動作や未定義の挙動が発生する可能性があります。そのため、クライアントアプリケーションおよびデータブリッジのバックエンドサービスが最新の EMQX バージョンと互換性があることを必ず確認してください。互換性の確認には、EMQX 5.1 と EMQX 4.4 間のデータ統合の非互換性およびクライアント SDKを参照してください。

潜在的な落とし穴 ​

アップグレードプロセス中に注意すべき一般的な落とし穴には以下があります。

  • アップグレード後の EMQX バージョンとクライアントアプリケーション間の非互換性
  • 新バージョンに適応するために必要な設定変更
  • 更新や再設定が必要な外部システムやサービスへの依存関係

これらの落とし穴を回避するために、最新の EMQX ドキュメントをよく読み、ステージング環境で十分なテストを行ってから本番環境に適用してください。さらに、スムーズで確実なアップグレードのために EMQX のサポートサービスの利用も検討してください。

EMQX クラスターのアップグレード ​

前提条件

  • EMQX クラスターのリリースが 4.4.x であることを確認してください。
  • リリースノートを読んでいること。
  • デプロイ環境が EMQX のサポート対象 OS上の VM または Docker コンテナを実行可能であること。
  • アップグレードに十分なディスク容量とメモリがあること。
  • パフォーマンスチューニング（Linux）に記載された特定の前提条件を確認済みであること。

  1. EMQX 6.3.1 パッケージをダウンロードします。

    • パッケージマネージャーを使用する: お使いの OS のパッケージマネージャーに EMQX 6.3.1 バイナリが提供されているか確認し、あればそれを使ってダウンロードおよびインストールしてください。
    • 手動でバイナリをダウンロードする: パッケージマネージャーで提供されていない場合やサーバーのネットワークが制限されている場合は、公式 EMQX ウェブサイトから手動でダウンロードしてください。

  2. バイナリを使って新しい EMQX クラスターをデプロイします。詳細なインストール手順はインストールを参照してください。これにより最新バージョンのクリーンインストールが行えます。

  3. EMQX クラスターのマイグレーションを行います。

    • API またはダッシュボードを使用して、EMQX 4.4 クラスターの設定およびデータをバックアップします。

    • 設定ファイルのフォーマットを 4.4 から EMQX 6.3.1 に対応した新フォーマットに変換します。

    • 変換済みの設定ファイルをコマンド emqx ctl data import <File> を使って EMQX 6.3.1 クラスターに復元します。

      TIP

      既存の EMQX 4.4 クラスターから新しい EMQX 6.3.1 クラスターへの設定マイグレーションを支援するツールがこちらで提供されています。このツールはマイグレーション手順を自動化し、スムーズな移行を目指しています。生成された設定が期待通りか必ず確認してください。

  4. 新しい EMQX クラスターが期待通りに動作するかを十分に検証します。接続性、メッセージング機能、その他関連機能をテストし、アップグレードが成功したことを確認してください。

    注意

    以前のバージョンへのダウングレードはサポートされていません。古いクラスターを破棄する前に新しいクラスターを十分に検証してください。

  5. 本番環境をアップグレード済みクラスターに切り替えます。DNS レコード、ロードバランサー、その他関連設定を更新してトラフィックを新クラスターに誘導してください。切り替え後はシステムを綿密に監視し、安定稼働を確認してください。