迁移后功能使用说明

重要

本文中含有需要您注意的重要提示信息,忽略该信息可能对您的业务造成影响,请务必仔细阅读。

本文介绍旧版公共实例下产品和设备迁移到企业版实例后,各功能使用说明。

背景信息

实例迁移的详细说明,请参见使用前必读

物联网平台产品功能的详细说明,请参见功能特性

设备接入

功能

说明

设备端SDK

设备端自动连接到企业版实例,无需修改。

设备安全认证

支持一机一密和一型一密预注册认证方式。

LoRa设备

LoRaWAN协议设备迁移后,可能无法使用。具体说明,请参见企业版实例类型说明

NB-IoT设备

不支持迁移NB-IoT网络协议的设备。

设备管理

功能

说明

物模型

已迁移的产品数据无需修改。您也可根据业务需要,新增、修改当前配置。

说明

旧版公共实例保留原数据。为防止误操作,实例迁移完成且确认业务正常后,建议您手动删除该数据。

数据解析

标签

需要在企业版实例重新添加标签。

设备分组

需要在企业版实例重新添加分组。

说明

旧版公共实例的原分组中依然显示设备,执行对应操作时,会报异常。建议您删除迁移设备对应的分组。

高级搜索

可检索到已迁移到目标企业版实例中数据。

设备任务

需要在企业版实例重新创建产品相关的任务。

设备影子

可继续使用设备影子缓存机制。

文件管理

您可在目标企业版实例中,查看设备已上传的文件。

NTP服务

可继续在企业版实例下,使用NTP服务解决无法实时地获取服务端时间的问题。

网关子设备

仅当迁移过程中拓扑关系不发生改变,子设备可正常接入物联网平台。否则,子设备连接物联网平台会报错。

设备分发

全球统一接入设备,实例迁移成功后,设备建连会出现异常。

消息通信

功能

说明

服务端订阅

已迁移的订阅设置和流转规则可直接使用。您也可根据业务需要,新增、修改服务端订阅和云产品流转。

警告
  • 若配置了AMQP服务端订阅,需配置新的AMQP客户端接入SDK。

  • 若使用了云端API的服务端订阅或云产品流转相关业务,还需修改相关API的请求参数。例如,GetRule接口的请求参数RuleId

更多详细说明,请参见开发指南

云产品流转

场景联动

需要在企业版实例重新创建场景联动规则。

RRPC通信

调用RRpcPubBroadcast等通信接口,必须传入企业版实例的实例ID。

广播通信

监控运维

功能

说明

实时监控

设备、消息、物模型和规则引擎相关指标数据,会随着迁移进度发生变化。您可实时监控设备接入和消息通信是否正常。

产品数据迁移过程中,业务数据所属实例发生变更,公共实例下迁移相关的指标数据会下降,目标企业版实例下相关的指标数据会增加。如果公共实例配置了阈值降低预警,会触发报警。建议您根据业务需要,关闭或修改报警规则。具体操作,请参见配置报警规则

运维大盘

在线调试

需在企业版实例中下发指令给已迁移设备,调试设备端功能。

设备模拟器

公共实例需关闭待迁移设备的设备模拟器,然后在企业版实例下重新启动设备模拟器。

日志服务

企业版实例的日志服务,无法查询历史数据。

OTA升级

为保证设备正常进行OTA升级,需在企业版实例中重新添加OTA升级任务。

远程配置

需在企业版实例中重新进行远程配置。

告警中心

需在企业版实例中重新配置告警信息。

安全隧道

为保证能远程访问设备,需在企业版实例中重新创建设备安全隧道。

开发指南

  • 云端API调用:

    您需修改相关业务API调用时的请求参数,传入目标企业版实例的ID。

    云端接口PubRRpcInvokeThingServiceSetDeviceProperty,兼容传入企业版实例ID,可以提交工单申请,减少服务端改造。

    警告

    企业版实例下,调用云端SDK时,必须传入企业版实例的ID。否则,调用会失败,影响业务正常运行。改造建议,请参见迁移前的准备

  • AMQP客户端接入:

    若已配置AMQP服务端订阅或规则引擎流转到AMQP,对于AMQP客户端接入的SDK,需要复制新的企业版实例ID和接入域名,配置新的AMQP客户端,然后在灰度迁移后,复制更新消费组ID,启动新的AMQP客户端。

    警告

    对于已配置的AMQP服务端订阅,您需要为公共实例和目标企业版实例,分别启动一个AMQP客户端。保证两个实例同时存在AMQP客户端接收数据,防止数据丢失。