物聯網平臺提供實例遷移功能，可助您將舊版公共實例下產品、設備和規則引擎數據遷移到企業版實例中使用。本文以某共享服務企業為例，介紹實例遷移的業務改造和遷移方案。
背景信息
A公司的用戶共享服務平臺，采用阿里云物聯網提供的設備管理能力，聚焦智慧園區、智慧校園等場景提供共享洗衣機、烘干機、按摩椅等共享服務。
物聯網平臺提供的企業版實例服務，與舊版公共實例服務相比，功能更豐富、擴展性更好、性能更穩定，更適合用戶的業務模式。實例對比詳細說明，請參見公共實例與企業版實例區別。
采用不同類型的企業版實例，可區分不同用戶交付的共享服務平臺項目，實現資源隔離，使共享服務平臺更穩定，同時降低項目評估成本。企業版實例類型的詳細說明，請參見企業版實例類型說明。
由于物聯網平臺是在舊版公共實例之后提供的企業版實例服務，存量設備是在舊版公共實例下運行的。從資源隔離、穩定性和項目成本考慮，可將設備相關數據從公共實例遷移到企業版實例中使用。
業務場景介紹
序號 | 說明 |
|---|---|
1~1.2 | 將共享設備聯網接入阿里云物聯網平臺，然后上報數據。 |
您的應用通過物聯網平臺的AMQP訂閱或數據流轉，接收設備上報的數據、狀態等消息。 | |
您的數據庫實時存儲已訂閱或流轉的設備數據。 | |
2~2.2 | 消費者通過共享服務平臺提供的App掃碼認證授權后，可查看共享設備狀態，然后通過App下發指令，控制共享設備提供服務。 說明 鑒權成功后，App連接到共享服務平臺，開始計費。 |
您的應用接收到消費者下發的指令，調用阿里云物聯網平臺提供的設備控制服務，控制設備開始工作。 | |
設備運行過程中和服務完成后，均上報設備狀態，并通過數據流轉功能同步給您的應用，存儲在數據庫中。服務完成后，共享服務平臺會推送PUSH消息給App，提示消費者服務結束和計費等信息。 |
遷移方案
實例遷移的整體流程說明，請參見使用前必讀。根據遷移流程說明，您需對共享設備相關業務進行評估，然后制定遷移方案。
系統改造
針對業務場景評估后，以下業務場景配置需要改造，以保證設備遷移后正常通信。
業務項 | 改造方案 | 相關文檔 |
|---|---|---|
AMQP服務端訂閱 | 對于AMQP客戶端接入的SDK，需要復制新的企業版實例ID和接入域名，配置新的AMQP客戶端，然后在灰度遷移時，復制更新消費組ID，啟動新的AMQP客戶端。 您需啟動兩個AMQP客戶端，保證公共實例和企業版實例同時存在AMQP客戶端接收數據，防止數據丟失。 | |
云產品流轉 | 在公共實例下，配置流轉數據：
| |
云端API調用 | 您需自行開發應用，在調用云端接口時，先查詢數據庫表中實例ID信息（企業版實例ID），然后設置接口請求參數IotInstanceId為該企業版實例ID，最后發起接口調用。 |
實例遷移
完成系統改造后，應用發布上線，即可通過物聯網平臺的實例遷移功能遷移公共實例下共享設備，如下圖所示。
序號 | 操作 | 說明 |
|---|---|---|
1~1.2 | 調試公共實例下待遷移共享設備。 | 消費者通過App使用共享服務平臺提供的設備共享服務時，應用系統查詢設備信息仍在公共實例中。 此時，調用服務相關接口，無需傳入實例ID，即可通過阿里云網關使用物聯網平臺服務，控制待遷移設備。 |
2~2.5 | 開始實例遷移： | 在物聯網平臺控制臺創建并發起實例遷移任務，進行灰度遷移：
|
3 | 在物聯網平臺控制臺發起全量遷移任務：將公共實例下指定產品下全量設備遷移到企業版實例中。設備遷移流程與灰度設備遷移流程相同。 說明 全量遷移設備不再包含已灰度遷移的設備。 | |
4~4.2 | 驗證企業版實例下已遷移共享設備。 | 消費者對設備所屬實例不感知，仍通過App使用共享服務平臺提供的設備共享服務，應用系統查詢設備信息在企業版實例中。 此時，調用服務相關接口，必須傳入實例ID，才可通過阿里云網關使用物聯網平臺服務，控制已遷移設備。 說明 設備全量遷移完成，驗證業務結果正確，表示實例遷移完成且成功。 若驗證業務有問題，可通過回滾功能，將設備從企業版實例中遷移到公共實例，其他數據保持不變。具體內容，請參見可選：回滾遷移任務。 |