すべてのプロダクト
Search
ドキュメントセンター

IoT Platform:手順

最終更新日:Jan 26, 2024

このトピックでは、以前のバージョンのパブリックインスタンスからEnterprise Editionインスタンスにデータを移行する方法について説明します。 この手順には、移行タスクの作成、段階的移行の実行、および完全移行の実行が含まれます。

前提条件

  • インスタンス間でデータを移行するための全体的なプロセスと注意事項に精通しています。 詳細については、「インスタンス移行プロセス」をご参照ください。

  • ビジネス評価とシステムの再構成が完了しました。 詳細については、「移行前の準備」をご参照ください。

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

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

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

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

    重要

    以前のバージョンのパブリックインスタンスからStandard Enterprise Editionインスタンスにのみデータを移行できます。 詳細については、「IoT Platformインスタンスの概要」をご参照ください。

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

  4. 表示されるダイアログボックスで、[ターゲットインスタンスID] ドロップダウンリストからIDを選択し、[製品] ドロップダウンリストからパブリックインスタンスの製品を選択し、[OK] をクリックします。

    创建迁移任务

    作成されたインスタンスのステータスは移行中です。これは、移行が開始されていないことを示しています。 待迁移

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

  6. オプション: データ同期の有効化: デフォルトでは、Thing Specification Language (TSL) モデルのデータ同期機能は無効になっています。 移行中のビジネスの継続性を確保するために、移行タスクを作成した直後にデータ同期を有効にできます。

    説明

    デバイスデータを同期する必要がない場合は、この手順をスキップしてください。

ステップ2: 段階的移行の実行

一部のデバイスで段階的移行を実行し、移行結果を評価できます。 移行タスクがビジネスに影響を与えないことを確認した後にのみ、特定の製品のすべてのデータの完全移行を開始できます。

重要
  • 段階的移行用のデバイスを作成することを推奨します。 デバイスは、データを移行する製品に属しています。

  • AMQP (Advanced Message Queuing Protocol) サーバー側サブスクリプションが設定されている場合、またはデータがAMQPコンシューマグループに転送される場合は、新しいコンシューマグループIDをコピーし、SDKを使用して新しいAMQPクライアントをIoT Platformに接続し、段階的移行後にデータを受信します。

段階的移行の開始

  1. [移行タスク] タブで、[移行する] 状態のタスクを見つけ、[操作] 列の [移行の開始] をクリックします。

  2. [移行タスクの開始] ダイアログボックスで、[デバイスの選択方法] パラメーターを次のいずれかのオプションに設定し、段階的移行を実行するデバイスを選択します。

    選択

    重要

    このデバイス選択方法を使用する場合、段階的移行のために最大100個のデバイスを選択できます。

    1. [Canary Device] ドロップダウンリストをクリックします。 右側に表示されるデバイスの選択パネルで、デバイスを選択します。

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

    ファイルのアップロード

    重要

    このデバイス選択方法を使用する場合、段階的移行のために最大10,000個のデバイスを選択できます。

    1. [テンプレートのダウンロード] をクリックしてデバイス情報テンプレートをダウンロードし、段階的移行を実行するデバイスの名前を [デバイス名] 列に入力して、テーブルを保存します。

    2. Canary Devicesパラメーターの下にある [ファイルのアップロード] をクリックして、IoT Platformコンソールに保存したテーブルをアップロードします。

    文件上传

  3. すべての準備が完了したことを確認し、チェックボックスを選択して [今すぐ開始] をクリックします。

    立即开始

段階的移行が進行中

[移行タスク] タブで、移行タスクの状態は [カナリアリリースの進行中] です。 灰度中

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

カナリアリリース完了

移行タスクがカナリアリリース完了状態になると、指定されたデバイスが移行されます。 製品データの完全移行を開始できます。 ビジネス要件に基づいて移行タスクをロールバックすることもできます。 詳細は、以下のセクションをご参照ください。

灰度完成

ステップ3: 完全移行の実行

段階的移行が完了したら、製品に属するすべてのデバイスデータの完全移行を開始できます。

重要

システムが変換され、リリースされていることを確認します。 たとえば、Enterprise EditionインスタンスのIDは、呼び出すIoT Platform API操作のリクエストパラメーターの値として指定する必要があり、AMQPクライアントの接続に使用されるSDKのコンシューマーグループIDが更新されます。 詳細については、「移行前の準備」をご参照ください。

完全移行の開始

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

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

    全量迁移

完全移行中

[移行タスク] タブでは、移行タスクが [移行] 状態になっています。 迁移中

移行タスクを一時停止またはロールバックできます。 移行の詳細を表示することもできます。 詳細は、以下のセクションをご参照ください。

移行完了

移行タスクが [移行完了] 状態になると、指定された製品のすべてのデバイスがパブリックインスタンスからEnterprise Editionインスタンスに移行されます。 デバイスによって送信されたデータも移行される場合は、データ同期機能を無効にできます。 詳細については、「オプション: データ同期の無効化」をご参照ください。

オプション: 移行タスクをロールバックする

重要
  • Canary Release in Progress状態の移行タスクはロールバックできません。

  • 移行タスクをロールバックする前に、データを移行する製品がパブリックインスタンスに保持されていることを確認してください。 製品が削除されると、エラーが返されます。

  • ロールバック操作では、移行されたサーバー側サブスクリプションとルールエンジンのデータは、移行先のEnterprise Editionインスタンスから削除されません。

移行ロールバックの開始

ビジネス要件に基づいて移行タスクをロールバックできます。 移行タスクの状態は、Canary Release CompletedmigrationPause MigrationContinue MigrationMigration Completedのいずれかです。

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

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

    特定のデバイスの移行タスクをロールバックする

    次のいずれかのオプションを選択して、移行タスクをロールバックするデバイスを選択し、[今すぐ開始] をクリックします。

    重要

    最大10,000台のデバイスを選択して、移行タスクをロールバックできます。

    選択

    1. [ロールバックデバイス] ドロップダウンリストをクリックします。 右側に表示されるデバイスの選択パネルで、移行タスクをロールバックするデバイスを選択します。

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

    ファイルのアップロード

    1. [テンプレートのダウンロード] をクリックしてデバイス情報テンプレートをダウンロードし、移行タスクをロールバックするデバイスの名前を [デバイス名] 列に入力し、テーブルを保存します。

    2. ロールバックデバイスパラメーターの下にある [ファイルのアップロード] をクリックして、IoT Platformコンソールに保存したテーブルをアップロードします。

    すべてのデバイスの移行タスクをロールバックする

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

ロールバック中

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

  • [移行完了] 状態で移行タスクをロールバックすると、移行タスクは [バッチロールバック] 状態になります。 バッチロールバック状態では、移行タスクを一時停止することはできません。

ロールバック完了

ロールバック操作が完了すると、移行されたすべてのデバイスデータが無効になり、移行タスクは [移行中] 状態になります。

重要

ロールバック操作が成功した場合、次の操作を実行して移行タスクを再開できます。

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

ビジネス要件に基づいて、移行タスクを一時停止できます。 移行タスクのステータスは、[移行] または [ロールバック] です。 移行タスクを一時停止するには、[移行タスク] タブで移行タスクを見つけ、[操作] 列の [一時停止] をクリックし、[OK] をクリックします。

次の表に、可能な結果を示します。

操作前のタスクステータス

結果

移行中

移行タスクが一時停止移行状態になり、指定された製品のデバイスデータが移行先インスタンスへの移行を停止します。

[移行の続行] をクリックすると、完全な移行タスクを再開できます。

ローリングバック

移行タスクが一時停止ロールバック状態になります。

[ロールバックの続行] をクリックすると、ロールバック操作を再開できます。

オプション: 移行タスクの詳細を表示する

  1. [移行タスク] タブで、管理する移行タスクを見つけ、[操作] 列の [表示] をクリックします。

  2. [移行の詳細] ページで、指定された製品のProductKey、移行ステータス、移行するデバイスの総数、移行先インスタンスID、移行タスクの作成時刻、データ同期の開始時刻、移行するすべてのデバイスの詳細など、タスクに関する情報を表示します。

    移行タスクのステータス (未移行、移行、移行失敗など) を指定できます。 デバイス名を入力して、特定のデバイスを検索し、移行タスクに関する情報を表示することもできます。

    デバイス移行タスクが失敗した場合、 Alibaba Cloudにテクニカルサポートをお問い合わせください。

  3. オプション: [インスタンスの移行] ページに移動し、[移行モニタリング] タブをクリックして、移行タスクのリアルタイムモニタリングデータを表示します。 詳細については、「移行メトリックの表示」をご参照ください。

    监控数据

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

デフォルトでは、TSLモデルのデータ同期機能は無効になっています。 移行タスクを作成した後、この機能を有効にしてビジネスの継続性を確保できます。

  1. [移行タスク] タブで、管理する移行タスクを見つけ、[操作] 列の [表示] をクリックします。

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

    数据同步

    データ同期機能を有効にすると、パブリックインスタンス内の指定された製品のデバイスによって送信された新しいデータがEnterprise Editionインスタンスに同期されます。 データ同期操作の開始時刻は、機能が有効になっている時刻よりも最大1分遅れています。

    [移行の詳細] ページで、データ同期の開始時刻を [同期日時] の横に表示し、移行ステータスを [ステータス] の横に表示します。

    数据迁移中

オプション: データ同期を無効にする

IoT Platformは、データ同期を有効にしてから30日後にデータ同期を自動的に無効にします。 次の手順を実行して、データ同期を無効にすることもできます。

説明

データ同期を無効にする前に、ビジネスへの影響を防ぐために移行タスクが完了していることを確認してください。

  1. [移行タスク] タブで、管理する移行タスクを見つけ、[操作] 列の [表示] をクリックします。

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

    关闭数据同步

    重要

    データ同期を無効にすると、完全な移行タスクのデータ同期を再度有効にすることはできません。 移行タスクが進行中の場合は、データ同期を再度有効にできます。

結果

特定のプロダクトの移行タスクが移行完了状態になると、プロダクトのデータが移行先インスタンスに移行されます。迁移完成