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

    コンテナ化されたCloud Exchangeのアップグレード

    コンテナ化されたCloud Exchangeデプロイメント(スタンドアロンまたはHA)を最新バージョンにアップグレードするには、次の手順を使用します。サポートされているアップグレードパスと他のデプロイメントタイプについては、「Cloud Exchangeのアップグレード」を参照してください。

    重要

    Cloud Exchange のインストール、デプロイ、設定、アップグレードに関してご質問がある場合は、担当の SE/AM までコンタクトしてください。

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

    前提条件

    1. Cloud Exchangeのインストールディレクトリにアクセスしてください: ta_cloud_exchange
    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. すべてのモジュールのすべてのソースプラグインを無効にし、キューに入れられたタスクが完了するのを待ちます:
      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. アップグレードが完了したら、無効にしたソースプラグインを有効にします。
    5. メンテナンスパスワードを手元に用意してください。いくつかの手順を完了するために必要です。

      重要

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

      RabbitMQのデータ移行は、キュータイプがClassicからQuorumに変更されたため、サポートされていません。

    スタンドアロン展開

    v5.1.1からv7.0.0へ、v5.1.2、v6.0.0、v6.0.1、v6.1.0スタンドアロン展開

    始める前に、すべてのデータエクスポートエンドポイントにアクセスできる V2 トークンで、すべての Netskope テナントを更新してください。

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

    1. docker-compose.yml ファイルがある既存の ta_cloud_exchange ディレクトリに移動し、Cloud Exchangeコンテナを停止します:
      sudo ./stop

      出力が ./stop: No such file or directory の場合は、代わりに次のコマンドを実行してください:

      sudo docker compose down -v
    2. docker-compose.yml ファイルにローカルな変更を加えた場合は、それらをリセットしてください。sudo が必要になる場合があります。
      sudo git reset --hard
    3. 最新の変更を取得します:
      sudo git pull
    4. 設定ファイルの例をコピーして、編集用に開きます。
      cp cloudexchange.config.example cloudexchange.config
      vi cloudexchange.config
    5. cloudexchange.config でメンテナンスパスワードの値を設定します。プロキシ設定やUIポートなど、使うまたはカスタマイズする任意のフィールドも設定します。
      MAINTENANCE_PASSWORD=<old maintenance password>
      JWT_SECRET=<old cloud exchange JWT secret>
      
      JWT_SECRET is optional. If you leave it empty, the setup script generates a new JWT secret
    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. スタンドアロン展開を停止します:
      sudo ./stop
    2. データディレクトリに移動し、データのzipファイルを作成します。
      cd ta_cloud_exchange/data
      sudo zip -r ce_backup.zip mongo-data/ repos/ plugins/
    3. カスタムプラグインを使う場合は、zipファイルに追加してください:
      sudo zip -r ce_backup.zip custom_plugins
    4. ta_cloud_exchangeディレクトリに戻り、最新の変更をプルします:
      cd ..
      sudo git pull

      git pull が失敗した場合は、ローカルの変更をリセットして再度プルします。

      sudo git reset --hard
      sudo git pull
    5. 設定ファイルの例をコピーして、編集用に開きます。
      cp cloudexchange.config.example cloudexchange.config
      vi cloudexchange.config
    6. cloudexchange.configで、これらのフィールドの値を設定します。プロキシ設定やUIポートなど、使うまたはカスタマイズするオプションフィールドも設定します。
      MAINTENANCE_PASSWORD=<old cloud exchange maintenance password>
      JWT_SECRET=<old cloud exchange JWT secret>

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

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

      重要

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

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

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

    1. 最新のCloud Exchangeバージョンがある ta_cloud_exchange ディレクトリに移動します:
      cd <ta_cloud_exchange-dir>
    2. プライマリノードで、CAキーファイルの内容をコピーします。
      <ta_cloud_exchange-dir>/data/ssl_certs/mongodb_rabbitmq_certs/tls_cert_ca.key
    3. セカンダリノードで、CAキーファイルを作成し、コピーしたキーを貼り付けて、ファイルを保存します。一致するCAキーにより、セカンダリノードはHAクラスタと通信できます。
      sudo vi data/ssl_certs/mongodb_rabbitmq_certs/tls_cert_ca.key
    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 をご確認ください。

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

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

    すべてのノードで
    1. コンテナが正常にシャットダウンするように、セカンダリノードを最初に停止し、次にプライマリノードを停止します:
      sudo ./stop
    2. 最新の変更を取得します:
      sudo git pull

      git pull が失敗した場合は、ローカルの変更をリセットして再度プルします。

      sudo git reset --hard
      sudo git pull
    プライマリノードで
    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から7を完了します。次に、プライマリノードのUIからセカンダリノードを追加します。

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

      重要

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

      JWT_SECRET=<JWT_SECRET value of the primary node>
      MAINTENANCE_PASSWORD=<old maintenance password>
    7. セットアップスクリプトを実行します。
      sudo python3 ./setup
    8. プライマリノードの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のアップグレード