これらの手順に従って、VM、スタンドアロン、またはHAとしてCloud Exchangeを最新バージョンにアップグレードします。サポートされているアップグレードパスとその他の展開タイプについては、Cloud Exchangeのアップグレードを参照してください。
前提条件
- Cloud Exchangeのインストールディレクトリにアクセスしてください:
/opt/cloudexchange/cloudexchange - 次のコマンドを実行して、アップグレード/移行チェックスクリプトをダウンロードし、そのスクリプトを実行可能にします。
curl -fsSL -O https://raw.githubusercontent.com/netskopeoss/ta_cloud_exchange/main/ce_healthcheck chmod +x ce_healthcheck
- アップグレード/移行チェックスクリプトを実行します。出力の詳細については、結果の理解を参照してください。
sudo python3 ./ce_healthcheck
- セカンダリノードの場合は、以下のコマンドを実行します。これは HA デプロイメントにのみ適用されます。
sudo python3 ./ce_healthcheck --deployment HA
注記
いずれかのチェックが失敗した場合は、次のステップに進む前にそれらに対処してください。
- セカンダリノードの場合は、以下のコマンドを実行します。これは HA デプロイメントにのみ適用されます。
- Cloud Exchange v5.1.0以前からアップグレードする場合は、まず基盤となるUbuntu OSを20.04から22.04にアップグレードしてください。より前のバージョンの場合は、まず基盤となるUbuntu OSを20.04から22.04にアップグレードしてください。詳細については、Cloud Exchange KB記事を参照してください。
- Cloud Exchangeバージョン5.1.1からアップグレードする場合、5.1.2、6.0.0、6.0.1、または6.1.0VM展開としてCEの新しいバージョンにアップグレードするには、基盤となるUbuntu OSバージョンを24.04にアップグレードしてください。Cloud Exchange KBの記事を参照してください。
- VMが
https://cloud-exchange-store.s3.us-east-1.amazonaws.comに接続できることを確認してください。 - すべてのモジュールのすべてのソースプラグインを無効にし、キューに入れられたタスクが完了するのを待ちます:
- ソースプラグインを無効にした後、20~30分待ちます。
- Settings > Loggingに移動してFilter Queryをクリックし、フィルターフィールドにこのフィルターを入力して、Loadをクリックします。
message Like "Ingested " || message Like "Stored " || message Like "task(s)" || message Like "Completed storing"
- フィルタリングされたログを監視する。新しいログが表示されない場合は、アップグレードを続けてください。
- アップグレードが完了したら、無効にしたソースプラグインを有効にします。
- メンテナンスパスワードを手元に用意してください。いくつかの手順を完了するために必要です。
重要
メンテナンスパスワードを紛失した場合、既存のデータを保持できません。
RabbitMQのデータ移行は、キュータイプがClassicからQuorumに変更されたため、サポートされていません。
v5.1.1より前のバージョンでCloud ExchangeをVM(OVAまたはHyper-V)として実行している場合、VMのルートクレデンシャルが必要です。
ユーザー名:root
パスワード:M5#w6V+.T^8gv?%,
Cloud Exchange を Azure または AWS 上の VM として実行している場合は、以下の手順を自分で完了できます。
スタンドアロン展開
v5.1.1からv7.0.0へ、v5.1.2、v6.0.0、v6.0.1、V6.1.0スタンドアロン展開
始める前に、前提条件を完了し、バックアップを取得してください。詳細は、Cloud Exchangeのバックアップを参照してください。
/opt/cloudexchange/cloudexchangeディレクトリに移動し、Cloud Exchangeを停止します:cd /opt/cloudexchange/cloudexchange sudo ./stop
- Cloud Exchangeの公開鍵を信頼されたGPG鍵として追加します:
curl -fsSL https://cloud-exchange-store.s3.us-east-1.amazonaws.com/cloudexchange/upgrade-packages/cloud-exchange-public.gpg | sudo gpg --dearmor -o /etc/apt/trusted.gpg.d/cloud-exchange.gpg
- Cloud Exchange S3 URLをパッケージソースとして追加します。
echo "deb https://cloud-exchange-store.s3.us-east-1.amazonaws.com/cloudexchange/upgrade-packages stable main" | sudo tee /etc/apt/sources.list.d/cloud-exchange.list
- パッケージソースを更新します:
sudo apt update
- Cloud Exchangeをアップグレードし、アップグレードが完了するのを待ちます:
sudo apt install cloud-exchange=7.0.0-1
このコマンドを実行する前に、v7.0.0のCloud Exchangeシステム要件がすべて満たされていることを確認してください。 - セットアップスクリプトを実行します。
sudo python3 ./setup
- Cloud Exchange開始:
sudo ./start
- Cloud Exchange ブラウザウィンドウをすべて閉じます。ブラウザキャッシュをクリアするか、シークレットウィンドウで再度ログインします。Cloud Exchange UIは
http(s)://<ip>で利用できます。
HA展開
v5.1.1からv7.0.0へ、v5.1.2、v6.0.0、v6.0.1、v6.1.0スタンドアロン展開
始める前に、前提条件を完了し、バックアップを取得してください。詳細は、Cloud Exchangeのバックアップを参照してください。
既存のスタンドアロンノードがHAクラスターのプライマリノードになります。HAパラメータの詳細とクラスターの設定方法については、Cloud Exchangeの高可用性を参照してください。
スタンドアロン・ノード(新しいプライマリ・ノード)上
/opt/cloudexchange/cloudexchangeディレクトリに移動し、スタンドアロン展開を停止します。cd /opt/cloudexchange/cloudexchange sudo ./stop
- Cloud Exchangeの公開鍵を信頼されたGPG鍵として追加します:
curl -fsSL https://cloud-exchange-store.s3.us-east-1.amazonaws.com/cloudexchange/upgrade-packages/cloud-exchange-public.gpg | sudo gpg --dearmor -o /etc/apt/trusted.gpg.d/cloud-exchange.gpg
- Cloud Exchange S3 URLをパッケージソースとして追加します。
echo "deb https://cloud-exchange-store.s3.us-east-1.amazonaws.com/cloudexchange/upgrade-packages stable main" | sudo tee /etc/apt/sources.list.d/cloud-exchange.list
- パッケージソースを更新します:
sudo apt update
- Cloud Exchangeをアップグレードし、アップグレードが完了するのを待ちます:
sudo apt install cloud-exchange=7.0.0-1
このコマンドを実行する前に、v7.0.0のCloud Exchangeシステム要件がすべて満たされていることを確認してください。 - 設定ファイルの例をコピーして、編集用に開きます。
cp cloudexchange.config.example cloudexchange.config vi cloudexchange.config
cloudexchange.configで、これらのフィールドの値を設定します。プロキシ設定やUIポートなど、使うまたはカスタマイズするオプションフィールドも設定します。MAINTENANCE_PASSWORD=<old cloud exchange maintenance password> JWT_SECRET=<old cloud exchange JWT secret>
JWT_SECRETはオプションです。空のままにすると、セットアップスクリプトは新しいJWTシークレットを生成します。.envファイルを削除します:sudo rm -rf .env
- セットアップスクリプトを実行します。
sudo python3 ./setup
- Cloud Exchange開始:
sudo ./start
- ブラウザで
https://<ip>からプライマリノードのUIを開き、既存のCloud Exchangeクレデンシャルでログインします。 - Settings > General Settings > Node Configurations に移動し、Enable HA トグルを有効にします。アクションの確認ポップアップで、変更が必要な場合にのみ Cloud Exchange IP アドレスまたは FQDN を入力し、Enable HA をクリックします。
重要
HAが有効になっている間、Cloud Exchangeは一時的に使用できなくなり、数回再起動する可能性があります。

セカンダリノード上
各セカンダリノードでステップ1から8を実行します。次に、プライマリノードのUIからセカンダリノードを追加します。
- 最新のCloud ExchangeをVMイメージ(OVA、AMI、Azure、Hyper-V、またはKVM)としてデプロイします。
/opt/cloudexchange/cloudexchangeディレクトリに移動します。cd /opt/cloudexchange/cloudexchange
- プライマリノードで、CAキーファイルの内容をコピーします。
/opt/cloudexchange/cloudexchange/data/ssl_certs/mongodb_rabbitmq_certs/tls_cert_ca.key
- セカンダリノードで、CAキーファイルを作成し、コピーしたキーを貼り付けて、ファイルを保存します。一致するCAキーにより、セカンダリノードはHAクラスタと通信できます。
sudo vi /opt/cloudexchange/cloudexchange/data/ssl_certs/mongodb_rabbitmq_certs/tls_cert_ca.key
.envファイルを削除します:sudo rm -rf .env
- 設定ファイルの例をコピーして、編集用に開きます。
cp cloudexchange.config.example cloudexchange.config vi cloudexchange.config
cloudexchange.configで、これらのフィールドの値を設定します。重要
セカンダリノードのJWTシークレットとCAキーは、プライマリノードと一致している必要があります。一致していない場合、セカンダリノードをHAクラスターに追加すると認証エラーで失敗します。プライマリノードのJWTシークレットが不明な場合は、新しいシークレットを生成して適用してください。手順については、「Cloud Exchangeのトラブルシューティング」を参照してください。
JWT_SECRET=<JWT_SECRET value of the primary node> MAINTENANCE_PASSWORD=<old maintenance password>
- セットアップスクリプトを実行します。
sudo python3 ./setup
- プライマリノードのUIで、Settings > General Settings > Node Configurationsに移動し、セカンダリノードを1つずつ追加します。
セカンダリノードでスタートスクリプトを実行する必要はありません。これは、プライマリノードの UI からセカンダリノードを追加するときに自動的に実行されます。
v5.1.1からv7.0.0へ、v5.1.2、v6.0.0、v6.0.1、v6.1.0HA展開
始める前に、前提条件を完了し、バックアップを取得してください。詳細は、Cloud Exchangeのバックアップを参照してください。
すべてのノードで
- Cloud Exchangeを適切にシャットダウンするために、最初にセカンダリノードを停止し、次にプライマリノードを停止します。
cd /opt/cloudexchange/cloudexchange sudo ./stop
- Cloud Exchangeの公開鍵を信頼されたGPG鍵として追加します。プライマリノードから始めるし、次にセカンダリノードを続けます。
curl -fsSL https://cloud-exchange-store.s3.us-east-1.amazonaws.com/cloudexchange/upgrade-packages/cloud-exchange-public.gpg | sudo gpg --dearmor -o /etc/apt/trusted.gpg.d/cloud-exchange.gpg
- Cloud Exchange S3 URLをパッケージソースとして追加します。
echo "deb https://cloud-exchange-store.s3.us-east-1.amazonaws.com/cloudexchange/upgrade-packages stable main" | sudo tee /etc/apt/sources.list.d/cloud-exchange.list
- パッケージソースを更新します:
sudo apt update
- Cloud Exchangeをアップグレードし、アップグレードが完了するのを待ちます:
sudo apt install cloud-exchange=7.0.0-1
このコマンドを実行する前に、v7.0.0のCloud Exchangeシステム要件がすべて満たされていることを確認してください。
プライマリノードで
- 設定ファイルの例をコピーして、編集用に開きます。
cp cloudexchange.config.example cloudexchange.config vi cloudexchange.config
cloudexchange.configで、これらのフィールドの値を設定します。プロキシ設定やUIポートなど、使うまたはカスタマイズするオプションフィールドも設定します。HA_ENABLED=True HA_CURRENT_NODE=<current node ip> HA_PRIMARY_NODE_IP=<current node ip> HA_IP_LIST=<current node ip> MAINTENANCE_PASSWORD=<old maintenance password> JWT_SECRET=<old cloud exchange JWT secret>
JWT_SECRETはオプションです。空のままにすると、セットアップスクリプトは新しいJWTシークレットを生成します。.envファイルを削除します:sudo rm -rf .env
- セットアップスクリプトを実行します。
sudo python3 ./setup
- Cloud Exchange開始:
sudo ./start
セカンダリノード上
各セカンダリノードで手順 1 ~ 6 を完了します。次に、プライマリノードの UI からセカンダリノードを追加します。
- プライマリノードで、CAキーファイルの内容をコピーします。
/opt/cloudexchange/cloudexchange/data/ssl_certs/mongodb_rabbitmq_certs/tls_cert_ca.key
- セカンダリノードで、CAキーファイルを作成し、コピーしたキーを貼り付けて、ファイルを保存します。一致するCAキーにより、セカンダリノードはHAクラスタと通信できます。
sudo vi /opt/cloudexchange/cloudexchange/data/ssl_certs/mongodb_rabbitmq_certs/tls_cert_ca.key
.envファイルを削除します:sudo rm -rf .env
- 設定ファイルの例をコピーして、編集用に開きます。
cp cloudexchange.config.example cloudexchange.config vi cloudexchange.config
cloudexchange.configで、これらのフィールドの値を設定します。重要
セカンダリノードのJWTシークレットとCAキーは、プライマリノードと一致している必要があります。一致していない場合、セカンダリノードをHAクラスターに追加すると認証エラーで失敗します。プライマリノードのJWTシークレットが不明な場合は、新しいシークレットを生成して適用してください。手順については、「Cloud Exchangeのトラブルシューティング」を参照してください。
JWT_SECRET=<JWT_SECRET value of the primary node> MAINTENANCE_PASSWORD=<old maintenance password>
- セットアップスクリプトを実行します。
sudo python3 ./setup
- プライマリノードのUIで、Settings > General Settings > Node Configurationsに移動し、セカンダリノードを1つずつ追加します。
セカンダリノードでスタートスクリプトを実行する必要はありません。これは、プライマリノードの UI からセカンダリノードを追加するときに自動的に実行されます。

