存量设备迁移最佳实践

场景说明

设备迁移整体流程

通过设备发放服务将基础版的设备数据迁移到企业版，设备数据迁移完成后，应用侧和设备侧访问新实例的地址，往新实例上注册设备、下发命令和上报数据等，在新实例上操作设备和管理设备。

图1 设备迁移整体流程

迁移前提

1、已开通IoTDA基础版，并购买了IoTDA企业版/标准版。

2、用户的应用平台访问IoTDA的地址可以修改，应用平台访问IoTDA从基础版地址改成企业版实例的地址。

3、用户的设备访问IoTDA的地址可以修改，设备访问IoTDA从基础版地址改成企业版实例的地址。如果设备访问IoTDA的地址不能修改(例如设备不支持固件升级)，可以提交工单说明您的诉求。

设备数据迁移时，如果是指定资源空间和设备迁移，迁移数据仅包括设备连接新实例认证需要的身份信息，包括资源空间、产品、证书、设备基本信息和设备状态；暂不包括基础版中的设备分组、服务端订阅、规则引擎和运行日志配置。

操作步骤：

以设备数据从基础版迁移到企业版为例，流程如下：

图2 用户设备迁移操作流程

1. 购买企业版或标准版
   1. 访问设备接入服务，单击“立即使用”进入设备接入控制台。
   2. 在左侧导航栏 ，单击"IoTDA实例"，查看是否购买了IoTDA企业版或者标准版，如果您未开通新实例，参考实例开通管理

2. 设备数据从基础版迁移到企业版
   1. 访问设备接入服务，单击“立即使用”进入设备接入控制台。
   2. 在左侧导航栏，单击"设备发放"，如果您是首次进入设备发放页面，单击右上角“授权开通”对服务进行授权。
      图3 设备发放总览
      
   3. 单击"设备数据迁移" 进入界面，再单击右上角的“创建迁移任务”。
      图4 数据同步页面
      
   4. 迁移方式选择“按资源空间整体迁移”，迁移源实例选择北京四基础版，目标实例选择步骤1中购买的企业版实例，单击“确认创建”即可，设备发放会自动把对应资源空间的产品、证书和设备数据迁移过去。
      图5 创建迁移任务页面
      
      

      如果您的设备量较小，可以选择"指定设备迁移"。

   5. 迁移任务创建完成后，你可以在"设备数据迁移"页面单击“任务ID”或者“详情”，查看迁移任务详情，并且可以使用“高级搜索”对迁移设备进行过滤查询操作。
      图6 迁移任务详情页面
      
      

      当迁移任务类型为“指定设备迁移”时，此类任务下所有迁移设备均属于同一应用、同一产品。因此在进行迁移设备列表的“高级搜索”时，搜索项“所属产品”和“所属资源空间”均为空。

   6. 在设备迁移详情页，可以查看单个设备的信息和设备的发放记录。
      图7 设备迁移详情页面
      

3. 企业版配置检查
   由于设备迁移任务不会迁移规则引擎和服务端订阅证书，如果你在基础版使用了"规则"和"服务端证书"，需要在企业版再配置一遍。

   1. 访问设备接入服务，单击“立即使用”进入设备接入控制台。
   2. 在左侧导航栏 ，单击"IoTDA实例"，在企业版实例里单击"切换"，切换到企业版实例。
      图8 切换企业版实例
      
   3. 访问设备接入服务，单击“立即使用”进入设备接入控制台，在左侧导航栏选择“规则 > 数据转发”，单击左侧“创建规则”配置您需要用到的数据转发规则，详情请参考数据转发。
      图9 规则配置页面
      
   4. 访问设备接入服务，单击“立即使用”进入设备接入控制台，在左侧导航栏选择“规则 > 服务端证书”，单击右上角“上传证书”，详情请参考加载推送证书。
      图10 上传服务端证书
      

4. 应用侧和设备侧修改访问IoTDA平台的地址，对接到新实例
   1. 访问设备接入服务，单击“立即使用”进入设备接入控制台。
   2. 单击设备接入服务左侧导航栏"IoTDA实例"，单击实例详情，获取应用和设备的接入地址。
      图11 实例详情页面
      
   3. 修改应用侧和设备侧访问IoTDA的地址。

5. 业务拨测和观察。应用侧和设备侧对接到企业版后，可以结合你的业务做一些基本功能验证。例如
   1. 通过应用侧注册设备，注册设备接口参考注册设备
   2. 通过设备侧属性上报，设备属性上报参考设备属性上报
   3. 通过应用侧下发命令，下发命令接口参考平台命令下发

6. 增量设备迁移。设备迁移过程中基础版新增的设备不会迁移到企业版，需要对这部分设备做增量迁移，可以参考步骤2，选择"增量设备迁移"迁移指定的设备