Netskope LogoNetskope Logo
  • セキュリティサービス
  • AIサービス
  • ネットワークサービス
  • 分析サービス
  • 統合
  • getting-started.svg始める
    • サポート
    • コミュニティ
    • Netskope.com
    © 2026 無断転載を禁じます。Netskope 株式会社
    トップページ
    Netskope Cloud Exchange
    Cloud Exchange をアップグレードする
    仮想マシンとしてCloud Exchangeをアップグレードする

    仮想マシンとしてCloud Exchangeをアップグレードする

    これらの手順に従って、VM、スタンドアロン、またはHAとしてCloud Exchangeを最新バージョンにアップグレードします。サポートされているアップグレードパスとその他の展開タイプについては、Cloud Exchangeのアップグレードを参照してください。

    アップグレードを始める前に、インスタンスがCloud Exchange システム要件を満たしていることを確認してください。

    前提条件

    1. Cloud Exchangeのインストールディレクトリにアクセスしてください: /opt/cloudexchange/cloudexchange
    2. 次のコマンドを実行して、アップグレード/移行チェックスクリプトをダウンロードし、そのスクリプトを実行可能にします。
      curl -fsSL -O https://raw.githubusercontent.com/netskopeoss/ta_cloud_exchange/main/ce_healthcheck
      chmod +x ce_healthcheck
    3. アップグレード/移行チェックスクリプトを実行します。出力の詳細については、結果の理解を参照してください。
      sudo python3 ./ce_healthcheck
      • セカンダリノードの場合は、以下のコマンドを実行します。これは HA デプロイメントにのみ適用されます。
        sudo python3 ./ce_healthcheck --deployment HA

        注記

        いずれかのチェックが失敗した場合は、次のステップに進む前にそれらに対処してください。

    4. Cloud Exchange v5.1.0以前からアップグレードする場合は、まず基盤となるUbuntu OSを20.04から22.04にアップグレードしてください。より前のバージョンの場合は、まず基盤となるUbuntu OSを20.04から22.04にアップグレードしてください。詳細については、Cloud Exchange KB記事を参照してください。
    5. 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の記事を参照してください。
    6. VMが https://cloud-exchange-store.s3.us-east-1.amazonaws.com に接続できることを確認してください。
    7. すべてのモジュールのすべてのソースプラグインを無効にし、キューに入れられたタスクが完了するのを待ちます:
      1. ソースプラグインを無効にした後、20~30分待ちます。
      2. Settings > Loggingに移動してFilter Queryをクリックし、フィルターフィールドにこのフィルターを入力して、Loadをクリックします。
        message Like "Ingested " || message Like "Stored " || message Like "task(s)" || message Like "Completed storing"
      3. フィルタリングされたログを監視する。新しいログが表示されない場合は、アップグレードを続けてください。
      4. アップグレードが完了したら、無効にしたソースプラグインを有効にします。
    8. メンテナンスパスワードを手元に用意してください。いくつかの手順を完了するために必要です。

      重要

      メンテナンスパスワードを紛失した場合、既存のデータを保持できません。

      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のバックアップを参照してください。

    1. /opt/cloudexchange/cloudexchangeディレクトリに移動し、Cloud Exchangeを停止します:
      cd /opt/cloudexchange/cloudexchange
      sudo ./stop
    2. 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
    3. 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
    4. パッケージソースを更新します:
      sudo apt update
    5. Cloud Exchangeをアップグレードし、アップグレードが完了するのを待ちます:
      sudo apt install cloud-exchange=7.0.0-1
      このコマンドを実行する前に、v7.0.0のCloud Exchangeシステム要件がすべて満たされていることを確認してください。
    6. セットアップスクリプトを実行します。
      sudo python3 ./setup
    7. Cloud Exchange開始:
      sudo ./start
    8. Cloud Exchange ブラウザウィンドウをすべて閉じます。ブラウザキャッシュをクリアするか、シークレットウィンドウで再度ログインします。Cloud Exchange UIは http(s)://<ip> で利用できます。
    TLS認証を使うCLSプラグインは、CE 7.0.0互換のバージョンに更新しなければ、CE 7.0.0で構成したり使用したりすることができません。バージョンに更新しなければ、CE 7.0.0で構成したり使うことができません。影響を受けるプラグインについてはKB をご確認ください。

    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の高可用性を参照してください。

    HAに移行した後、データがすべてのノードにレプリケートされるまでの数分間、Cloud Exchangeの応答が遅くなることがあります。
    スタンドアロン・ノード(新しいプライマリ・ノード)上
    1. /opt/cloudexchange/cloudexchange ディレクトリに移動し、スタンドアロン展開を停止します。
      cd /opt/cloudexchange/cloudexchange
      sudo ./stop
    2. 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
    3. 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
    4. パッケージソースを更新します:
      sudo apt update
    5. Cloud Exchangeをアップグレードし、アップグレードが完了するのを待ちます:
      sudo apt install cloud-exchange=7.0.0-1
      このコマンドを実行する前に、v7.0.0のCloud Exchangeシステム要件がすべて満たされていることを確認してください。
    6. 設定ファイルの例をコピーして、編集用に開きます。
      cp cloudexchange.config.example cloudexchange.config
      vi cloudexchange.config
    7. cloudexchange.configで、これらのフィールドの値を設定します。プロキシ設定やUIポートなど、使うまたはカスタマイズするオプションフィールドも設定します。
      MAINTENANCE_PASSWORD=<old cloud exchange maintenance password>
      JWT_SECRET=<old cloud exchange JWT secret>

      JWT_SECRET はオプションです。空のままにすると、セットアップスクリプトは新しいJWTシークレットを生成します。

    8. .env ファイルを削除します:
      sudo rm -rf .env
    9. セットアップスクリプトを実行します。
      sudo python3 ./setup
    10. Cloud Exchange開始:
      sudo ./start
    11. ブラウザでhttps://<ip>からプライマリノードのUIを開き、既存のCloud Exchangeクレデンシャルでログインします。
    12. Settings > General Settings > Node Configurations に移動し、Enable HA トグルを有効にします。アクションの確認ポップアップで、変更が必要な場合にのみ Cloud Exchange IP アドレスまたは FQDN を入力し、Enable HA をクリックします。

      重要

      HAが有効になっている間、Cloud Exchangeは一時的に使用できなくなり、数回再起動する可能性があります。

      ノード設定タブでHAトグルを有効にする
    セカンダリノード上

    各セカンダリノードでステップ1から8を実行します。次に、プライマリノードのUIからセカンダリノードを追加します。

    1. 最新のCloud ExchangeをVMイメージ(OVA、AMI、Azure、Hyper-V、またはKVM)としてデプロイします。
    2. /opt/cloudexchange/cloudexchange ディレクトリに移動します。
      cd /opt/cloudexchange/cloudexchange
    3. プライマリノードで、CAキーファイルの内容をコピーします。
      /opt/cloudexchange/cloudexchange/data/ssl_certs/mongodb_rabbitmq_certs/tls_cert_ca.key
    4. セカンダリノードで、CAキーファイルを作成し、コピーしたキーを貼り付けて、ファイルを保存します。一致するCAキーにより、セカンダリノードはHAクラスタと通信できます。
      sudo vi /opt/cloudexchange/cloudexchange/data/ssl_certs/mongodb_rabbitmq_certs/tls_cert_ca.key
    5. .env ファイルを削除します:
      sudo rm -rf .env
    6. 設定ファイルの例をコピーして、編集用に開きます。
      cp cloudexchange.config.example cloudexchange.config
      vi cloudexchange.config
    7. cloudexchange.config で、これらのフィールドの値を設定します。

      重要

      セカンダリノードのJWTシークレットとCAキーは、プライマリノードと一致している必要があります。一致していない場合、セカンダリノードをHAクラスターに追加すると認証エラーで失敗します。プライマリノードのJWTシークレットが不明な場合は、新しいシークレットを生成して適用してください。手順については、「Cloud Exchangeのトラブルシューティング」を参照してください。

      JWT_SECRET=<JWT_SECRET value of the primary node>
      MAINTENANCE_PASSWORD=<old maintenance password>
    8. セットアップスクリプトを実行します。
      sudo python3 ./setup
    9. プライマリノードのUIで、Settings > General Settings > Node Configurationsに移動し、セカンダリノードを1つずつ追加します。
      ノード構成タブにセカンダリノードを追加する
      セカンダリノードでスタートスクリプトを実行する必要はありません。これは、プライマリノードの UI からセカンダリノードを追加するときに自動的に実行されます。
    TLS認証を使うCLSプラグインは、CE 7.0.0互換のバージョンに更新しなければ、CE 7.0.0で構成したり使用したりすることができません。バージョンに更新しなければ、CE 7.0.0で構成したり使うことができません。影響を受けるプラグインについてはKB をご確認ください。

    v5.1.1からv7.0.0へ、v5.1.2、v6.0.0、v6.0.1、v6.1.0HA展開

    始める前に、前提条件を完了し、バックアップを取得してください。詳細は、Cloud Exchangeのバックアップを参照してください。

    すべてのノードで
    1. Cloud Exchangeを適切にシャットダウンするために、最初にセカンダリノードを停止し、次にプライマリノードを停止します。
      cd /opt/cloudexchange/cloudexchange
      sudo ./stop
    2. 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
    3. 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
    4. パッケージソースを更新します:
      sudo apt update
    5. Cloud Exchangeをアップグレードし、アップグレードが完了するのを待ちます:
      sudo apt install cloud-exchange=7.0.0-1
      このコマンドを実行する前に、v7.0.0のCloud Exchangeシステム要件がすべて満たされていることを確認してください。
    プライマリノードで
    1. 設定ファイルの例をコピーして、編集用に開きます。
      cp cloudexchange.config.example cloudexchange.config
      vi cloudexchange.config
    2. 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シークレットを生成します。

    3. .env ファイルを削除します:
      sudo rm -rf .env
    4. セットアップスクリプトを実行します。
      sudo python3 ./setup
    5. Cloud Exchange開始:
      sudo ./start
    セカンダリノード上

    各セカンダリノードで手順 1 ~ 6 を完了します。次に、プライマリノードの UI からセカンダリノードを追加します。

    1. プライマリノードで、CAキーファイルの内容をコピーします。
      /opt/cloudexchange/cloudexchange/data/ssl_certs/mongodb_rabbitmq_certs/tls_cert_ca.key
    2. セカンダリノードで、CAキーファイルを作成し、コピーしたキーを貼り付けて、ファイルを保存します。一致するCAキーにより、セカンダリノードはHAクラスタと通信できます。
      sudo vi /opt/cloudexchange/cloudexchange/data/ssl_certs/mongodb_rabbitmq_certs/tls_cert_ca.key
    3. .env ファイルを削除します:
      sudo rm -rf .env
    4. 設定ファイルの例をコピーして、編集用に開きます。
      cp cloudexchange.config.example cloudexchange.config
      vi cloudexchange.config
    5. cloudexchange.config で、これらのフィールドの値を設定します。

      重要

      セカンダリノードのJWTシークレットとCAキーは、プライマリノードと一致している必要があります。一致していない場合、セカンダリノードをHAクラスターに追加すると認証エラーで失敗します。プライマリノードのJWTシークレットが不明な場合は、新しいシークレットを生成して適用してください。手順については、「Cloud Exchangeのトラブルシューティング」を参照してください。

      JWT_SECRET=<JWT_SECRET value of the primary node>
      MAINTENANCE_PASSWORD=<old maintenance password>
    6. セットアップスクリプトを実行します。
      sudo python3 ./setup
    7. プライマリノードのUIで、Settings > General Settings > Node Configurationsに移動し、セカンダリノードを1つずつ追加します。
      ノード構成タブにセカンダリノードを追加する
      セカンダリノードでスタートスクリプトを実行する必要はありません。これは、プライマリノードの UI からセカンダリノードを追加するときに自動的に実行されます。
    TLS認証を使うCLSプラグインは、CE 7.0.0互換のバージョンに更新しなければ、CE 7.0.0で構成したり使用したりすることができません。バージョンに更新しなければ、CE 7.0.0で構成したり使うことができません。影響を受けるプラグインについてはKB をご確認ください。
    このトピックでは
    • 仮想マシンとしてCloud Exchangeをアップグレードする