Cloud Exchange を VM として移行する｜Netskope技術ドキュメント

次の手順を使用して、VM、スタンドアロン、またはHAとしてCloud Exchangeを最新バージョンに移行します。サポートされている移行パスと他の展開タイプの詳細については、「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
```
  注記
  
  いずれかのチェックが失敗した場合は、次のステップに進む前にそれらに対処してください。
VMが https://cloud-exchange-store.s3.us-east-1.amazonaws.com に接続できることを確認してください。
すべてのモジュールのすべてのソースプラグインを無効にし、キューに入れられたタスクが完了するのを待ちます：
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. 移行が完了したら、無効にしたソースプラグインを有効にします。
メンテナンスパスワードを手元に用意してください。いくつかの手順を完了するために必要です。

重要

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

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スタンドアロン展開

migrate_ce スクリプトは、デプロイメントを最新の Cloud Exchange スタンドアロンデプロイメントに移行します。新しい（宛先）VMでスクリプトを実行します。スクリプトを実行するには、古いVMの cteadmin ユーザーのパスワードが必要です。

新しいマシンで、/opt/cloudexchange/cloudexchangeディレクトリに移動します。設定ファイルの例をコピーして開き、編集します。
```
cd /opt/cloudexchange/cloudexchange
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シークレットを生成します。
新しいマシンで、マイグレーションスクリプトを実行します：
```
sudo ./migrate_ce
```
プロンプトが表示されたら、古いマシンのユーザー名とIPアドレス、およびそのパスワードまたはPEMファイルへのパスを入力します。
スクリプトが完了するまで待機します。古いマシンに接続した後、スクリプトは以下の処理を行います：
- 古いマシンで停止スクリプトを実行します。
- 古いマシンの既存のデータをzip圧縮し、新しいマシンに転送します。
- 新しいマシンのインストールフォルダーにデータを解凍します。
- セットアップスクリプトを実行します。このスクリプトは、最新の Cloud Exchange を起動するために必要な入力を求めます。
- 開始スクリプトを実行します。
コンテナの状態を確認します。Podman を使う場合は、代わりに sudo podman ps を実行してください。
```
sudo docker ps
```
ブラウザで移行された Cloud Exchange の UI を開きます。既存の Cloud Exchange クレデンシャルでログインし、設定とデータが存在し、機能していることを確認します。

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

スタンドアロン展開から VM HA 展開としての最新の Cloud Exchange に移行するには、古いスタンドアロン VM のデータを新しいプライマリノードになるノードにコピーします。

HAパラメータとクラスターのセットアップ方法の詳細については、「Cloud Exchangeの高可用性」を参照してください。クラスターノードが共有するリソースをCloud Exchangeが保存できるように、/opt/shared/dataディレクトリが使用可能であることを確認してください。

古いスタンドアロンVMで

/opt/cloudexchange/cloudexchange ディレクトリに移動します。
```
cd /opt/cloudexchange/cloudexchange
```
Cloud Exchangeを停止：
```
sudo ./stop
```
データディレクトリに移動します：
```
cd data
```

データのzipファイルを作成します。

sudo zip -r ce_backup.zip mongo-data/ repos/ plugins/

カスタムプラグインを使う場合は、zipファイルに追加してください：
```
sudo zip -r ce_backup.zip custom_plugins
```

新しいプライマリノードにzipファイルをコピーします。

sudo scp -i <public_key> ce_backup.zip <username>@<public_ip>:/opt/cloudexchange/cloudexchange/data

新しいプライマリノードで

プライマリノードにするノードでこれらの手順を実行します。

データディレクトリに移動します：
```
cd /opt/cloudexchange/cloudexchange/data
```

データを抽出します：

sudo unzip ce_backup.zip "mongo-data/*" -d .
sudo mkdir /opt/shared/data/ -p
sudo unzip ce_backup.zip "plugins/*" "repos/*" "custom_plugins/*" -d /opt/shared/data/

元の作業ディレクトリに戻ります：
```
cd ..
```

設定ファイルの例をコピーして、編集用に開きます。

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シークレットを生成します。
セットアップスクリプトを実行します。最初にプライマリノードで実行します。
```
sudo python3 ./setup
```
Cloud Exchange開始:
```
sudo ./start
```
ブラウザでhttps://<ip>:<port>からプライマリノードのUIを開き、既存のCloud Exchangeクレデンシャルでログインします。

セカンダリノード上

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

/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
```

設定ファイルの例をコピーして、編集用に開きます。

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に移動し、Enable HAトグルを有効にします。アクションの確認ポップアップで、変更が必要な場合にのみCloud Exchange IPアドレスまたはFQDNを入力し、Enable HAをクリックします。

重要

HAが有効になっている間、Cloud Exchangeは一時的に使用できなくなり、数回再起動する可能性があります。
プライマリノードの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のバックアップを参照してください。

VM HAデプロイメントとしての現在の Cloud Exchange から最新のものに移行するには、現在のプライマリノードから新しいプライマリノードにデータをコピーします。

現在のHA展開について

Cloud Exchangeを適切にシャットダウンするために、最初にセカンダリノードを停止し、次にプライマリノードを停止します。
```
cd /opt/cloudexchange/cloudexchange
sudo ./stop
```
プライマリノードでデータディレクトリに移動し、MongoDB データの zip ファイルを作成します。
```
cd /opt/cloudexchange/cloudexchange/data
sudo zip -r ce_backup.zip mongo-data/
```
共有ドライブに移動し、 repos フォルダーと plugins フォルダーをzipファイルに追加します。v6.0.0以降の場合、共有ドライブのパスは /opt/shared/data/ です。
```
cd <shared_drive>
sudo zip -r <ce_backup_zip_location>/ce_backup.zip repos/ plugins/
```
カスタムプラグインを使う場合は、zipファイルに追加してください：
```
sudo zip -r <ce_backup_zip_location>/ce_backup.zip custom_plugins/
```
現在のプライマリノードから新しいプライマリノードにzipファイルをコピーします。新しいプライマリノードには最新のCloud Exchangeバージョンがあります：
```
sudo scp -i <public_key> <ce_backup_zip_location>/ce_backup.zip <username>@<public_ip>:/opt/cloudexchange/cloudexchange/data
```

新しいプライマリノードで

データディレクトリに移動します：
```
cd /opt/cloudexchange/cloudexchange/data
```

データを抽出します：

sudo unzip ce_backup.zip "mongo-data/*" -d .
sudo mkdir /opt/shared/data/ -p
sudo unzip ce_backup.zip "plugins/*" "repos/*" "custom_plugins/*" -d /opt/shared/data/

元の作業ディレクトリに戻ります：
```
cd ..
```

設定ファイルの例をコピーして、編集用に開きます。

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>
```
セットアップスクリプトを実行します。
```
sudo python3 ./setup
```
MongoDBデータを移行します。このコマンドは1回だけ実行してください。
```
sudo ./restore_ha_backup
```
Cloud Exchange開始:
```
sudo ./start
```

セカンダリノード上

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

/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
```

設定ファイルの例をコピーして、編集用に開きます。

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 からセカンダリノードを追加するときに自動的に実行されます。