IoT Platform:インスタンス移行

ステップ 1：移行タスクの作成

パブリックインスタンス内の特定の製品に対して移行タスクを作成します。タスクの初期ステータスは 移行待ち で、これは移行が開始されておらず、サービスに影響を与えないことを示します。

1. IoT Platform コンソールにログインします。

2. コンソールの左上隅で IoT Platform が有効化されているリージョンを選択し、[インスタンス概要] タブで [パブリックインスタンス] をクリックします。

   重要

   インスタンス移行機能は、レガシーパブリックインスタンスから Standard エンタープライズインスタンスへのデータ移行のみをサポートします。インスタンスの詳細については、「インスタンス概要」をご参照ください。

3. 左側のナビゲーションペインで、[リソース割り当て] > [インスタンス移行] を選択します。 [移行リスト] タブで、[移行タスクの作成] をクリックします。

4. ダイアログボックスで、移行元のパブリックインスタンスから [ターゲットインスタンス ID] と[製品]を選択し、 [OK] をクリックします。

   移行タスクを作成しても移行は開始されません。続行する前に、ターゲットインスタンスに選択した製品向けの十分なデバイスクォータがあることを確認し、移行ドキュメントを確認してください。

   移行タスクが作成されると、ステータスは[移行待ち]となり、移行がまだ開始されていないことを示します。

5. 任意: 移行の詳細の表示: [移行の詳細] ページで、移行タスクに関する情報を表示します。

6. オプション：データ同期の有効化：デバイスの TSL モデルデータ同期は、デフォルトでは無効になっています。移行タスクの作成直後に有効化することで、移行中のサービス中断を防ぐことができます。

   説明

   ビジネスでデバイスデータ同期が不要な場合は、この手順をスキップできます。

ステップ 2：段階的な移行

まず少数のデバイスで段階的な移行を実行します。フル移行を開始する前に、プロセスを監視してサービスに影響がないことを確認してください。

段階的な移行の開始

1. [移行リスト] タブで、ステータスが [移行待ち] のタスクを見つけ、[操作] 列の [移行開始] をクリックします。

2. [移行タスクの開始] ダイアログボックスで、段階的な移行の対象デバイスを指定する方法を選択します。

   重要

   移行するデバイスの数が、ターゲットインスタンスのデバイスの残りクォータを超えると、次のエラーメッセージが表示されます：The total number of devices in the target instance exceeds the maximum limit

   手動選択

   重要

   この方法を使用すると、1 回の段階的な移行タスクで最大 100 台のデバイスを選択できます。

   1. カナリアデバイスのドロップダウンリストをクリックし、右側に表示されるデバイスパネルで、目的のデバイスの横にあるチェックボックスを選択します。

   2. [OK] をクリックします。

   ファイルのアップロード

   重要

   この方法を使用すると、1 回の段階的な移行タスクで最大 10,000 台のデバイスを追加できます。

   1. [テンプレートのダウンロード] をクリックします。ダウンロードしたファイルで、[DeviceNames] 列にデバイス名を入力し、ファイルを保存します。

   2. [ファイルアップロード]をクリックして、保存したファイルを IoT Platform コンソールにアップロードします。

3. すべての移行前の操作が完了したことを確認し、対応するチェックボックスを選択して、[今すぐ開始] をクリックします。

   3 つのチェックボックスは、 移行ドキュメントを読みました、 サーバー側の変更が完了しました、 テストデバイスでプロセスを検証しました です。

カナリアリリース進行中

[移行リスト] タブで、移行タスクのステータスが [カナリアリリース進行中] に変わります。

この段階では、移行の詳細の表示のみ可能です。[操作] 列の [表示] をクリックして [移行の詳細] ページを開き、タスク情報を表示します。詳細については、「オプション: 移行の詳細の表示」をご参照ください。

カナリアリリース完了

移行タスクが [カナリアリリース完了] 状態になると、指定されたデバイスは移行済みです。必要に応じて、完全移行に進むか、移行をロールバックすることができます。詳細については、次のトピックをご参照ください。

• ステップ 3：フル移行の実行

• オプション：移行タスクのロールバック

ステップ 3：フル移行

段階的な移行が完了したら、対象製品のフル移行を開始します。

フル移行の開始

1. [移行リスト] タブで、ステータスが [カナリアリリース完了] のタスクを見つけ、[操作] 列の [移行開始] をクリックします。

2. [移行タスクの開始] ダイアログボックスで、[完全移行] をクリックします。すべての移行前の操作が完了したことを確認し、対応するチェックボックスを選択して、[今すぐ開始] をクリックします。

   重要

   移行するデバイスの数が、ターゲットインスタンスのデバイスの残りクォータを超えると、次のエラーメッセージが表示されます：The total number of devices in the target instance exceeds the maximum limit

   3 つのチェックボックスは、 移行ドキュメントを読みました、 サーバー側の変更が完了しました、 テストデバイスでプロセスを検証しました です。

移行中

[移行リスト] タブで、移行タスクのステータスが [移行中] になります。

この段階では、詳細の表示、タスクの一時停止、またはロールバックを実行できます：

• オプション：移行詳細の表示

• オプション：移行タスクの一時停止

• オプション：移行タスクのロールバック

移行完了

移行タスクのステータスが [移行完了] になると、指定された製品とそのデバイスはパブリックインスタンスから移行されています。デバイスから報告されたデータの移行も完了した場合、手動でデータ同期を無効化できます。詳細については、「オプション: データ同期を無効にする」をご参照ください。

オプション：移行タスクのロールバック

ロールバックの開始

ビジネス要件に基づいて、[カナリアリリース完了]、[移行中]、[移行一時停止]、[移行続行]、または [移行完了] の状態にある移行タスクをロールバックできます:

1. [移行リスト] タブで、移行タスクの [操作] 列にある [ロールバック] をクリックします。

2. [ロールバックタスクの開始] ダイアログボックスで、ロールバックタイプを選択してデバイスの移行を元に戻します。

   特定のデバイス

   次のいずれかの方法でロールバックするデバイスを選択し、[今すぐ開始] をクリックします。

   重要

   この方法を使用すると、1 回のロールバックタスクで最大 10,000 台のデバイスを選択できます。

   手動選択

   1. ロールバックデバイスのドロップダウンリストをクリックし、右側に表示されるデバイスパネルで、目的のデバイスの横にあるチェックボックスを選択します。

   2. [OK] をクリックします。

   [ロールバックタスクを開始] ダイアログボックスで、 [ロールバックタイプ] を [特定のデバイス] に、 [デバイス選択方法] を [手動選択] に設定します。デバイスを選択したら、 [今すぐ開始] をクリックします。

   ファイルのアップロード

   1. [テンプレートのダウンロード] をクリックします。ダウンロードしたファイルで、[DeviceNames] 列にデバイス名を入力し、ファイルを保存します。

   2. [ファイルをアップロード] をクリックして、保存したファイルを IoT Platform コンソールにアップロードします。

   [ロールバックタスクを開始] ダイアログボックスで、 [ロールバックタイプ] を [特定のデバイス] に、 [デバイス選択方法] を [ファイルのアップロード] に設定し、 [今すぐ開始] をクリックします。

ロールバック中

• [カナリアリリース完了]、[移行中]、[移行の一時停止]、または [移行の続行] 状態のタスクは、ロールバックを開始すると、ステータスが [ロールバック中] に変わります。この状態のタスクは一時停止できます。詳細については、「オプション： 移行タスクを一時停止する」をご参照ください。

• [移行完了] 状態のタスクでロールバックを開始すると、そのステータスは [一括ロールバック] に変わります。この状態ではタスクを一時停止することはできません。

ロールバック完了

オプション：移行タスクの一時停止

[移行中] または [ロールバック中] 状態の移行タスクは一時停止できます。 [移行リスト] タブで、移行タスクの [アクション] 列にある [一時停止] をクリックし、次に [確認] をクリックします。

この操作の結果は、前のタスクステータスによって異なります：

[今すぐ開始] をクリックします。

[ロールバックタスクの開始] ダイアログボックスで、[ロールバックタイプ] を [特定のデバイス] または [すべてのデバイス] に設定します。完全なロールバックでは、タスクで移行されたすべてのデバイスがパブリックインスタンスに復元されます。

オプション：移行詳細の表示

1. [移行リスト] タブで、移行タスクの [アクション] 列にある [表示] をクリックします。

2. [移行の詳細] ページで、ProductKey、移行ステータス、デバイスの総数、ターゲットインスタンス ID、作成時刻、データ同期開始時刻、および移行用に選択されたデバイスのリストを含むタスク情報を確認できます。

   移行ステータス (未移行、移行済み、移行失敗) でデバイスをフィルタリングするか、特定のデバイスを検索して移行の進行状況を確認できます。

   デバイスの移行に失敗した場合は、 してください。

   [移行詳細] ページの上部には、タスクのステータス (例：カナリアリリース進行中) が表示されます。

3. 任意:[インスタンスの移行] ページに戻り、[移行モニタリング] をクリックすると、移行データメトリックのリアルタイム統計が表示されます。 詳細については、「移行データメトリックの表示」をご参照ください。

   移行の監視メトリクスには、 オンラインデバイス数 および プラットフォームに送信されたメッセージ量 が含まれます。 [時間] ドロップダウンリストを使用して、期間で統計をフィルタリングできます。

オプション：データ同期の有効化

デバイスの TSL モデルデータ同期は、デフォルトでは無効になっています。移行タスクの作成後に有効化することで、移行中のサービス中断を防ぐことができます。

1. [移行リスト] タブで、移行タスクの [操作] 列にある [表示] をクリックします。

2. [移行詳細] ページの右上隅で、[データ同期の有効化] をクリックします。

   この時点で、ページには [データ移行ステータス] と [データ同期開始時刻] の両方に「-」が表示されます。これは、データ同期が有効になっていないことを示します。

   データ同期が有効になると、パブリックインスタンス内の対象製品のデバイスから報告されたデータが、ターゲットの Enterprise Edition インスタンスに同期されます。同期は、有効化後 1 分以内に開始されます。

   [移行の詳細] ページで、[データ同期開始時刻] と [データ移行ステータス] を確認できます。

オプション：データ同期の無効化

システムは、データ同期が有効になってから 30 日後に自動的に無効にします。手動で無効にすることもできます：

1. [移行リスト] タブで、移行タスクの [操作] 列の [表示] をクリックします。

2. [移行の詳細] ページの右上隅で、[データ同期を無効にする] をクリックします。

   重要

   データ同期を手動で無効にした後、移行タスクが完了している場合は再度有効にできません。タスクが完了していない場合は、データ同期を再度有効にできます。