物联网平台提供实例迁移功能，可助您将旧版公共实例下产品、设备和规则引擎数据迁移到企业版实例中使用。本文以某共享服务企业为例，介绍实例迁移的业务改造和迁移方案。
背景信息
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，才可通过阿里云网关使用物联网平台服务，控制已迁移设备。 说明 设备全量迁移完成，验证业务结果正确，表示实例迁移完成且成功。 若验证业务有问题，可通过回滚功能，将设备从企业版实例中迁移到公共实例，其他数据保持不变。具体内容，请参见可选：回滚迁移任务。 |