01-正文

本章节下载 (9.93 MB)

01-正文

1.4.2 网关列表（LoRa网关/T320系列）

2.2.1 创建IG530/IG580边缘节点

1 配置物联网场景

有关“添加场所和设备”的详细介绍请参见《云简网络部署手册》。

1.1 场所概览

在顶部导航栏选择“网络管理”，在页面左上角选择分支，然后在左侧导航栏点击“网络 > 总览”可以查看当前分支的所有场所，点击场所的<监控>按钮，可以进入场所的物联网场景配置页面。

图1-1 场所概览

1.2 物联网概览

在顶部导航栏选择“网络管理”，在页面左上角选择场所，然后在左侧导航栏点击“网络 > 场所”进入物联网概览页面。

1.2.1 设备概览

点击“设备概览”页签，可以查看网关、终端、插卡和节点的设备在线情况，包括总数、在线和离线数量。

图1-2 设备概览

1.2.2 LoRa概览

点击“LoRa概览”页签，可以查看LoRa网关以及终端数目、网关流量统计、终端类型与流量统计、终端报文信号质量分布、终端报文速率与信道分布、待覆盖优化终端列表和干扰终端列表相关信息。

图1-3 LoRa概览

1.3 物联网监控

1.3.1 网关详情

在顶部导航栏选择“网络管理”，在页面左上角选择场所，然后在左侧导航栏点击“监控 > 物联网 > 网关详情”，可以查看网关的详细信息。

1.3.2 终端详情

在顶部导航栏选择“网络管理”，在页面左上角选择场所，然后在左侧导航栏点击“监控 > 物联网 > 终端详情”，可以查看终端的详细信息。

1.4 物联网配置

1.4.1 网关列表（物联网AP网关）

· 本例以UAP300为例，其它网关与此类似，请以实际情况为准。

· 场所中的无线控制器必须已经在绿洲物联网平台上线，且配置了物联网AP网关。

1. 添加网关

(1) 在顶部导航栏选择“网络管理”，点击页面左侧导航栏的“配置 > AC > 网关列表”进入“网关列表”页面，在页面左上角选择场所，右上角选择设备，然后点击<添加网关>按钮，进入“网关基本参数”页面；

(2) 输入网关的名称、选择型号UAP300、网关序列号，并点击<地图>按钮设置网关位置，然后点击<下一步>按钮完成网关添加。

图1-4 网关基本参数

2. 一键上线

一键上线功能仅支持AC-AP组网模式的网关，同步需要一定的时间，请耐心等待。

在“网关列表”页面，点击<一键上线>按钮，稍等片刻点击<刷新>按钮，即可将页面右上角选择的设备上配置的物联网网关同步到绿洲物联网平台。

图1-5 一键上线

3. 网关详情

(1) 在“网关列表”页面，点击已经添加的网关的名称，进入“网关详情”页面；

(2) 在“网关详情”页面，可以查看网关的基本参数、配置参数和边缘计算规则。

图1-6 网关详情

(3) 在“网关详情”页面，点击右上角的<编辑>按钮，即可对网关的基本参数、配置参数和边缘计算规则进行修改。

图1-7 修改网关详情配置

4. 接口列表

(1) 在“网关列表”页面，点击已经添加的网关的接口列表，进入“接口列表”页面；

图1-8 接口列表

(2) 在“接口列表”页面，点击<添加接口>按钮，进入“接口基本参数”配置页面；

(3) 选择接口类型、配置接口索引和节点序列号，然后点击<下一步>按钮；

图1-9 接口基本参数

(4) 在“接口详细参数”页面，不同接口类型可配置的参数不同，不同参数的详细介绍请参见《H3C无线控制器产品命令参考》和《H3C无线控制器产品配置指导》中的WLAN相关模块，点击<下一步>按钮完成接口添加；（本例以ZigBee终端为例）

图1-10 接口详细参数

(5) 在图1-8页面，点击已经添加的接口索引，进入接口详情页面，可以查看接口配置的详细参数；

图1-11 查看接口详情

(6) 在图1-8页面，点击已经添加的ZigBee类型接口的<允许入网>按钮，进入“允许入网设置”页面，可以配置接口的允许入网时间，点击<确定>按钮完成配置；

图1-12 允许入网设置

(7) 在图1-8页面，点击已经添加的ZigBee类型接口的<更多>按钮，并点击<修改>按钮，可以对接口的基本参数和详细参数配置进行修改，点击<提交>按钮完成修改；

图1-13 修改接口配置

(8) 在图1-8页面，点击已经添加的ZigBee类型接口的<更多>按钮，并点击<删除>按钮，可以删除当前接口。勾选接口前的复选框，并点击<批量删除>按钮，可以批量删除选中的接口；

(9) 在图1-8页面，点击已经添加的ZigBee类型接口的<更多>按钮，并点击<重启>按钮，可以重启当前接口，重启期间业务将无法使用，请谨慎操作。仅可对在线接口进行重启操作。

(10) 在图1-8页面，点击已经添加的ZigBee类型接口的<更多>按钮，并点击<拓扑>按钮，可以查看ZigBee网络的拓扑和设备详细信息；

(11) 在图1-8页面，点击<一键固化>按钮，可以将自动上线的物联网模块固化为手工上线模块。

(12) 在图1-8页面，对于RFID和BLE类型的接口，点击“操作”列的并点击<切换>按钮，可以对接口类型进行切换操作。

图1-14 切换接口类型

5. 修改网关

(1) 在“网关列表”页面，点击已经添加的网关的操作列按钮，并点击<修改>按钮，进入“网关修改”页面；

(2) 在“网关修改”页面，可以对网关的基本参数、网络参数和边缘计算规则进行修改。

图1-15 修改网关

6. 删除网关

在“网关列表”页面，点击已经添加的网关的操作列按钮，并点击<删除>按钮，可以删除当前的网关。

勾选网关列表前面的复选框，然后点击<批量删除>按钮，可以批量删除网关。

7. 批量导出

勾选网关列表前面的复选框，然后点击<批量导出>按钮，可以批量导出网关设备的列表信息。

8. 拓扑

(1) 在“网关列表”页面，点击已经添加的网关的操作列按钮，并点击<拓扑>按钮，进入“拓扑展示”页面；

(2) 在“拓扑展示”页面，可以查看当前网关的拓扑结构图，点击T300/T310系列模块，可以在页面右侧查看到该模块的详细信息；

图1-16 拓扑展示

1.4.2 网关列表（LoRa网关/T320系列）

本例以IG4510-L为例，其它网关与此类似，请以实际情况为准。

在顶部导航栏选择“网络管理”，在页面左上角选择场所，然后在左侧导航栏点击“配置 > 物联网 > 网关列表”进入“网关列表”页面。

1. 添加单个网关

(1) 点击<添加网关>按钮，进入“网关基本参数”页面；

(2) 输入网关名称、选择网关型号IG4510-L、输入网关序列号和位置备注信息，并点击<地图>按钮设置网关位置，然后点击<下一步>按钮；

图1-17 网关基本参数

(3) 在“网关网络参数”页面可以配置网关ID（可以通过display iot lora命令查看）、LoRa数据链路保活间隔和LoRa数据加密等配置信息（虚拟网络ID：在顶部导航栏选择“业务组件 > 物联网漫游管理”，进入“物联网漫游管理”页面，可以创建或者绑定虚拟网络）。

(4) 点击<下一步>按钮，完成网关添加。

图1-18 网关网络参数

2. 批量添加网关

(1) 点击<批量添加>按钮，进入“批量添加网关”页面；

(2) 选择网关型号，然后点击<下载模板>按钮，将下载完毕的模板保存到本地；查看模板中“网关参数说明”页签的说明信息，然后在模板中“网关参数”页签编辑网关的相关信息。

(3) 点击<上传模板>按钮，并选择已经编辑完成的模板，最后点击<下一步>按钮即可完成网关的批量添加。

图1-19 批量添加网关

3. 网关详情

(1) 在“网关列表”页面，点击已经添加的网关的名称，进入“网关详情”页面；

(2) 在“网关详情”页面，可以查看网关的基本参数和配置参数。

图1-20 网关详情

(3) 点击<编辑>按钮，可以对网关的配置信息进行修改。

图1-21 修改网关配置

4. 接口列表

(1) 在“网关列表”页面，点击已经添加的网关的接口列表，进入“接口列表”页面；

图1-22 接口列表

(2) 在“接口列表”页面，点击<添加接口>按钮，进入“接口基本参数”配置页面；

(3) 选择接口类型、配置接口索引，然后点击<下一步>按钮；

图1-23 接口基本参数

(4) 在“接口详细参数”页面，配置LoRa射频接口的工作信道组、报文发送功率，点击<下一步>按钮，完成接口添加；

图1-24 接口详细参数

(5) 在图1-22接口列表页面，点击已经添加的接口索引，进入接口详情页面，可以查看接口的基本参数和详细参数；

图1-25 查看接口详情

(6) 在图1-22接口列表页面，点击已经添加的接口的操作按钮，并点击<修改>按钮，进入接口修改页面，可以对接口的详细参数配置进行修改，然后点击<提交>按钮完成修改；

图1-26 修改接口配置

(7) 在图1-22接口列表页面，点击已经添加的接口的操作按钮，并点击<删除>按钮，可以删除当前接口。勾选接口前的复选框，并点击<批量删除>按钮，可以批量删除选中的接口。

5. 修改网关

(1) 在“网关列表”页面，点击已经添加的网关的操作按钮，并点击<修改>按钮，进入“网关修改”页面；

(2) 在“网关修改”页面，可以修改网关的基本参数和网络参数；

(3) 点击<提交>按钮完成网关参数修改。

6. 批量配置

仅支持对T320M、T320MX和T320MX-U网关进行批量配置。

(1) 点击<批量配置>按钮，进入“批量配置”的“配置模板”页面；

(2) 选择网关型号，然后点击<下载模板>按钮，将下载完毕的模板保存到本地，然后在模板中编辑网关的相关配置信息；

(3) 点击<上传模板>按钮，并选择已经编辑完成的模板，点击<下一步>按钮。

图1-27 配置模板

(4) 在“批量配置”页面，勾选需要批量配置的网关，然后点击<开始配置>按钮即可完成网关的批量配置。

图1-28 批量配置

7. 自动上线

目前仅T320M、T320MX和T320MX-U网关支持自动上线功能。

在“网关列表”页面，开启右上角的“自动上线”功能，即可开启T320M、T320MX和T320MX-U网关的自动上线功能，5分钟后该功能会自动关闭。

图1-29 自动上线

8. 删除网关

在“网关列表”页面，点击已经添加的网关的操作按钮，并点击<删除>按钮，可以删除当前的网关。勾选网关前的复选框，并点击<批量删除>按钮，可以批量删除选中的网关。

9. 批量导出

勾选网关列表前面的复选框，然后点击<批量导出>按钮，可以批量导出网关设备的列表信息。

1.4.3 终端列表

此处以添加H3C IN4500-L LoRa终端为例，其它终端的添加与此类似，请以实际情况为准。

在顶部导航栏选择“网络管理”，在页面左上角选择场所，然后在左侧导航栏点击“配置 > 物联网 > 终端列表”进入“终端列表”页面。

1. 单独添加终端

# 在“终端列表”页面，点击<添加终端>按钮。

图1-30 终端列表概览

(1) 终端基本参数

终端标识内容（DevEUI）即终端设备ID，用来唯一标识终端设备。

# 在添加终端的“终端基本参数”页面输入终端名称、选择终端型号、输入终端标识内容等内容，点击<下一步>按钮进入终端协议参数页面。

图1-31 终端基本参数

(2) 终端协议参数

¡ 终端基本配置（必填）

完成“终端基本配置（必填）”页面就可以完成终端的添加，用户可以根据实际情况选择配置“终端高级配置”、“射频基本配置”、“接收窗口配置”、“虚拟网络配置”和“组播配置”。

- 入网模式—动态加入（OTAA）：即无线激活，终端设备在与服务器数据交换之前，必须先通过Join request和Join accept报文的交互加入服务器。

- 应用密钥（AppKey）：AppKey分别存储在服务器和终端设备上，用于数据的加密和解密过程。

# 在第二步“终端协议参数”的“终端基本配置（必填）”页面选择入网模式动态加入，然后输入应用密钥（应用密钥请以终端设备实际情况为准，此处仅为举例），点击<下一步>按钮完成终端添加。

图1-32 终端基本配置（必填）

¡ 终端高级配置

目前仅支持Class A和Class C两种类型的物联网终端：

- Class A：通过在每个上行传输的后面紧跟两个短下行接收时隙的方式来支持双向通信，是最为低功耗的终端系统方式。

- Class C：拥有近乎连续的接收窗口，这些窗口只在需要发送报文的时候会关闭一下，拥有比Class A类型终端更低的下行通讯时延，但是会比Class A类型的终端更加耗能。

ADR（Adaptive Date Rate，速率自适应）是调整数据传输速率来保证可靠数据传输、优化网络性能、扩充网络容量的一种技术并且可以控制每一终端设备的射频输出功率。

# 在第二步“终端协议参数”的“终端高级配置”页面选择终端模式，打开ADR开关，然后选择链路保活报文类型以及链路保活周期等信息，完成终端高级配置。

图1-33 终端高级配置

¡ 射频基本配置

每个信道组至少需要开启一个信道，否则会造成无法正常通信。

# 在第二步“终端协议参数”的“射频基本配置”页面选择LoRa射频的工作频段、发送速率以及发送功率等配置，完成射频基本配置。

图1-34 射频基本配置

¡ 接收窗口配置

每一次上行传输之后，终端都会打开两个短接收窗口RX1和RX2：

- 第一个接收窗口RX1使用的频率、数据速率与上行传输时使用的频率、数据速率存在映射关系，RX1在发送完成后第RECEIVE_DELAY1秒开启。

- 第二个接收窗口RX2使用配置的固定频率和数据速率，RX2在发送完成后第RECEIVE_DELAY2秒开启。

图1-35 接收窗口

# 在第二步“终端协议参数”的“接收窗口配置”页面选择RX1速率偏移、RX1延迟时间、RX2速率、RX2频率，完成接收窗口配置。

图1-36 接收窗口配置

¡ 虚拟网络配置

当需要使用非本场所（或第三方）的网关设备上线时，请配置网关绑定的虚拟网络ID。

在顶部导航栏选择“业务组件 > 物联网漫游管理”，进入“物联网漫游管理”页面，可以创建或者绑定虚拟网络。

图1-37 虚拟网络配置

¡ 组播配置

当需要组播功能时可以配置该选项，支持查询。组播地址的配置请参见1.4.4 LoRaWAN组播。

图1-38 组播配置

2. 批量添加终端

(1) 在“终端列表”页面点击<批量添加>按钮，在弹出的页面选择终端型号并下载模板，将下载的模板保存到本地并批量导入终端信息。

(2) 完成终端协议参数配置后，将本地保存的终端信息模板导入，即可完成终端批量添加。

3. 批量删除/导出

# 在“终端列表”页面勾选需要删除或者导出的终端，然后点击<批量删除>或者<批量导出>按钮，完成终端的批量删除或者批量导出。

图1-39 批量删除或者导出终端

4. 查看/修改终端详情

# 在“终端列表”页面的终端表项处，点击终端的终端名称或者<查看>按钮，可以查看当前终端的详细配置信息；点击<编辑>按钮，可以修改当前终端的配置信息。

5. 删除或者重启终端

# 在“终端列表”页面的终端表项处，将鼠标移动到<更多>按钮，然后点击<删除>按钮，可以删除当前终端，请谨慎操作。

图1-40 删除终端

6. 绑定传感器

· 绑定传感器后，传感器上报的数据可以通过定制应用后在物联网应用平台查看。

· 一个终端最多支持生效8个传感器。

# 在“终端列表”页面的终端表项处，将鼠标移动到<更多>按钮，然后点击<查看绑定传感器>按钮，进入“已绑定传感器”页面：

· 点击<添加传感器>按钮，可以新增传感器。

· 点击<解绑>按钮，可以解除当前终端绑定的传感器。

· 点击<修改>按钮，可以修改当前终端绑定的传感器的配置信息。

图1-41 已绑定传感器

# 在“添加传感器”页面选择传感器型号、配置Modbus协议地址等信息，点击<确定>按钮完成传感器绑定。

· 请根据传感器设备的使用指导配置Modbus协议地址。

· 终端类型为IN4500-L时，接口ID为固定值3，请不要修改以免造成传感器采集的数据无法上报。

· 建议传感器属性上报间隔配置不小于当前绑定的传感器个数×30，否则可能导致数据延迟上报。

图1-42 添加传感器

1.4.4 LoRaWAN组播

在顶部导航栏选择“网络管理”，在页面左上角选择场所，然后在左侧导航栏点击“配置 > 物联网 > 协议 > LoRaWAN组播”进入“LoRaWAN组播”配置页面。

1. 添加组播

(1) 点击<添加组播>按钮，进入“组播基本参数”配置页面；

(2) 输入组播组名、选择组播类型和组播速率等信息；

图1-43 组播基本参数

(3) 点击<下一步>按钮，完成组播添加。

图1-44 添加组播成功

2. 查看组播关联信息

点击已添加组播“关联网关”和“关联终端”列的图标，可以查看该组播关联的网关和终端相关信息。

图1-45 查看组播关联信息

3. 绑定/解绑终端

进入“关联终端”页面，在该页面可以将组播地址与终端进行绑定或者解绑。

图1-46 绑定/解绑终端

1.5 维护

1. 版本管理

· 对IG系列物联网网关进行版本升级之前，需要先通过本章节将IG系列物联网网关的版本文件上传到平台。

· 首次登录绿洲管理员系统后，建议及时更改绿洲管理员系统密码，并妥善保管该管理员密码，以提高安全性。

(1) 在浏览器中输入http://ip-address:10081/admin并回车（ip-addres为物联网平台私有云的IP地址），然后输入缺省用户名oasisAdmin_super和密码lvzhou1-super2017登录绿洲管理员系统。

图1-47 绿洲管理员系统

(2) 在“绿洲管理员系统”页面，点击顶部导航栏的“版本管理”页签，即可在“版本管理”页面上传版本、查看已上传版本等相关内容。

图1-48 版本管理

(3) 在“版本管理”页面点击<上传>按钮，然后选择版本文件、版本类型、输入版本号等内容，点击<上传>按钮即可将版本文件上传到平台。

图1-49 上传版本

(4) 上传完毕版本文件后，可在图1-48“版本管理”页面查看已上传的版本、设置默认版本或者删除已上传的版本文件。

2. 软件升级

在页面左上角选择场所后，在左侧导航栏中选择“维护 > 软件升级”进入设备升级页面，支持“按设备升级”和“按型号升级”两种方式，请根据实际情况进行选择。

3. 设备操作

在页面左上角选择场所后，在左侧导航栏中选择“维护 > 设备操作”进入设备操作页面，可以对物联网网关和物联网终端进行设备管理操作。

· 保存配置

点击保存配置图标，将会保存设备配置。

· 保存配置并重启

点击保存配置并重启图标，设备将会保存配置并重新启动，设备重新启动期间相关业务将不可用，请慎重操作。

· 直接重启

点击直接重启图标，设备将会直接重新启动，设备重新启动期间相关业务将不可用且未保存的配置将会丢失，请慎重操作。

· 重置云连接

当设备与云平台连接异常时，点击重置云连接图标，强制断开设备与云平台的连接并重新连接。

4. 命令助手

使用本功能可通过绿洲物联网平台直接对设备下发命令。

在页面左上角选择场所后，在左侧导航栏中选择“维护 > 命令助手”进入命令助手页面，可以对设备进行管理操作。

· 非telnet模式

¡ 不需设备开启telnet服务以及输入用户名、密码就可以登录设备查看显示信息、进行部分配置。

¡ 不能使用Tab键补全命令以及显示日志信息，并且不支持交互式的操作（例如：保存配置、删除文件的交互确认操作）。

¡ 建议点击页面右侧的“常用命令”，查看设备的基础信息、网络信息、监控信息。

¡ 当命令操作界面出现故障（例如：不能正常输入命令行），可以点击页面右下角的“故障恢复”以恢复正常。

· telnet模式

¡ 在页面左上角开启telnet模式，然后点击“连接”并输入用户名和密码登录设备，此模式需要在设备上开启telnet服务。

¡ 点击页面右侧的“常用命令”，查看设备的基础信息、网络信息、监控信息。

¡ 选择页面左上角的“操作记录”，可以设置缓存大小并导出操作记录。

2 边缘计算

2.1 简介

HES（Hive Edge System，蜂巢边缘系统）是H3C为现场级边缘计算场景推出的，满足海量的物联网数据无法上传云端处理并需要在边缘节点上实现业务的快速响应、本地自治、边缘智能、安全与隐私保护等方面需求而提供的边缘计算平台。

HES主要应用于需求多样化的终端接入、复杂的弱网环境、数据传输量大以及需要在边缘侧进行实时处理、本地自治等行业或应用场景，例如：智慧园区、智慧交通、智慧水利、电力能源以及智慧工业等场景。

HES提供的功能主要包括镜像管理、节点管理、容器管理、函数计算、边缘设备接入、智能策略和态势感知。

· 镜像管理

镜像管理是独立的功能模块，提供基于容器的镜像仓库功能，支持管理arm、arm64、amd64架构的容器镜像，并可在不同的用户间进行镜像的共享使用，给边缘节点容器提供应用。

· 节点管理

HES支持H3C自研的边缘网关设备IG530和IG580系列，同时可以通过动态安装或本地离线安装HES Agent软件的方式纳管第三方边缘网关设备。

HES可以对边缘节点的运行资源进行监控，并且支持对边缘网关上HES Agent软件进行远程升级。

· 容器管理

容器是镜像的运行状态，对于边缘网关上各种差异化的接入协议，以及不同的行业应用和智能应用功能都可以通过容器的方式运行在边缘网关上。

HES可以控制容器应用的动态下发，并提供对容器资源和运行环境的配置和管理，同时监控容器的运行情况，并支持对容器进行远程升级等操作。

· 函数计算

函数是一个轻量化的应用，HES支持通过python3函数提供轻量化的函数处理能力，可以使用函数完成消息的转化操作。

· 边缘设备接入

可以在HES上配置边缘节点下的接入设备，支持各种各样的物联网终端通过不同的接口和协议接入，并对接入设备进行监控和管理运维。

· 智能策略

HES支持两种策略：消息路由策略和容器策略。

¡ 消息路由策略：可以灵活控制边缘消息数据的内部流转，实现消息分发的Topic转化，触发函数计算。

¡ 容器策略：通过配置边缘容器的运行环境，控制边缘容器应用CPU、内存的自动扩容和阈值告警监控等功能。

· 态势感知

态势感知是HES提供的针对边缘侧接入设备运行环境的监测和感知，从而评估边缘侧环境的安全状态。

图2-1 蜂巢边缘系统总体架构图

2.1.1 产品优势

边缘计算具有以下优点：

· 终端多样性

支持各种各样的物联网终端通过不同的接口和协议接入。

· 快速响应

对时延敏感的应用场景，能够及时在业务本地进行响应处理。

· 安全与隐私保护

对数据比较敏感的应用场景，能够先在本地去除敏感信息后再进行传输。

· 边缘智能：

在业务本地先进行优化处理，然后再传输处理后的信息，以降低对云端算力的要求。

· 多硬件支持

除了支持H3C边缘计算网关IG530和IG580外，同时还可以支持第三方异构硬件设备接入蜂巢边缘系统，满足不同行业场景应用需求。

· 多应用扩展

边缘网关通过云端统一纳管，对边缘网关部署容器应用，可快速集成第三方应用，实现业务的本地处理和AI推理等应用，同时平台开放接口支持第三方行业应用生态。

2.1.2 支持产品

蜂巢边缘系统支持H3C边缘计算网关IG530和IG580设备，同时支持第三方边缘网关设备通过安装边缘代理软件接入平台，并提供边缘计算的相关功能。

2.1.3 名词解释

表2-1 名词解释

名词	描述
HES	HES（Hive Edge System，蜂巢边缘系统）是H3C为现场级边缘计算场景推出的，满足海量的物联网数据无法上传云端处理并需要在边缘节点上实现业务的快速响应、本地自治、边缘智能、安全与隐私保护等方面需求而提供的边缘计算平台。
HES Agent	HES Agent（Hive Edge System Agent，蜂巢边缘系统代理软件）是配合蜂巢边缘系统提供的边缘侧软件。
开发者中心	开发者中心是绿洲物联网平台提供给合作伙伴进行自定义型号、管理镜像仓库、管理函数和模型管理的页面。
边缘节点	IG530、IG580和第三方边缘网关直接接入蜂巢边缘系统的设备就叫做边缘节点。
镜像	本文的镜像是指容器应用的文件载体，类似于虚机镜像。
容器应用	基于容器运行的应用软件。
函数计算	通过运行函数的方式提供轻量化操作，如运算、消息转换、消息解析和封装等功能。
MQTT	MQTT（Message Queuing Telemetry Transport，消息队列遥测传输）是基于发布/订阅模式的轻量级消息协议。
Modbus	Modbus协议是一项应用层报文传输协议，采用客户端/服务器模式进行通信，包括ASCII、RTU、TCP三种报文类型，可基于串口和以太网传输，广泛应用于工业控制和传感采集。
OPC-UA	OPC-UA是一项开源的、独立于平台的标准协议，以面向服务的架构为基础。
BACNet	BACnet是用于智能建筑的通信协议，广泛应用于智能楼宇相关系统。
Zigbee	Zigbee是基于802.15.4无线标准基础上的网络层及之上的协议，基于开放的2.4G无线网络，广泛应用于智能家居终端的互联互通。
LoRaWAN	LoRaWAN是LoRa联盟推出的，基于开源MAC层协议的低功耗广域网标准，在中国使用开放的470～510MHz频段。相比NB-IoT，LoRa可自建网络提供服务，广泛应用于环境传感采集和表计行业。

2.2 创建边缘节点

2.2.1 创建IG530/IG580边缘节点

创建IG580边缘节点的配置步骤与IG530类似，本配置以IG530为例。

(1) 在绿洲物联网平台顶部导航栏选择“网络管理”，然后在左侧导航栏点击“配置 > 物联网 > 边缘计算 > 边缘节点”，进入“边缘节点”配置页面。

图2-2 边缘节点

(2) 点击<创建边缘节点>按钮，进入“创建边缘节点”页面。

图2-3 创建边缘节点

表2-2 创建边缘节点参数说明

参数名称	说明
节点名称	指定边缘节点的名称
绑定设备型号	选择产品型号，这里选择H3C自研的IG530
接入方式	设备连接蜂巢边缘系统使用的协议
标识类型	设备的ID类型，H3C设备以SN号标识设备
绑定设备标识	设备的ID号，IG530即SN号，可以从设备的标签上获取
描述	设备的额外描述信息

(3) 登录IG530边缘节点的本地Web管理页面，点击页面左侧导航栏的“概览”进入“概览”页面，该页面展示了云平台连接情况。点击云平台图标，在弹出的页面配置蜂巢边缘系统的连接地址，点击<确定>按钮即可。请根据实际组网配置连接地址，支持“IP+端口”和“域名+端口”两种方式。

图2-4 IG530连接蜂巢边缘系统配置页面

(4) 连接成功后，在IG530设备的“概览”页面即可显示“已连接”标识，同时在蜂巢边缘系统上也可以看到IG530已经在线。

2.2.2 创建第三方边缘节点

1. 创建第三方边缘节点型号

型号是一类产品设备的标识，第三方设备接入平台都需要先定义一个型号，绿洲物联网平台支持通过“开发者中心”自定义第三方产品型号。

(1) 在绿洲物联网平台顶部导航栏选择“网络管理”，然后在左侧导航栏点击“设置 > 开发者中心”，然后点击页面中的“开发者中心”即可进入开发者中心页面。

图2-5 开发者中心

(2) 进入开发者中心页面后，在顶部导航栏选择“设备定制”，然后在左侧导航栏点击“设备型号管理”即可进入“设备型号管理”页面。

图2-6 设备型号管理

(3) 点击<创建设备型号>按钮，即可配置第三方边缘节点型号。

图2-7 创建设备型号

表2-3 创建第三方边缘节点型号参数说明

参数名称	说明
设备类型	第三方设备的类型，分为网关和终端，这里选择“网关设备”
设备型号	定义边缘网关的型号名称
型号模板标识	选择一类消息的Topic模板，在设备定制的“基本信息”页面的厂商信息中定义
设备分组	选择设备适用的分类，通用设备可以选择“其它”
接入网关协议	选择网关接入平台使用的协议类型，目前平台开发两种协议，一是基于MQTT协议的通用网关，二是基于MQTT协议的LoRa网关，这里选择“MQTT”
联网方式	非必须，根据实际情况选择
数据格式	定义消息数据内容的格式，这里选择“自定义数据格式”
设备标识类型	定义设备ID的类型，标识设备唯一性，根据实际情况选择
设备标识长度	定义设备ID的长度
边缘规格	定义该型号网关是否支持边缘计算功能，同时边缘计算分基础版和标准版，这里选择“标准版”
系统类型	定义边缘网关的操作系统类型，支持“linux”和“ComwareV9”，这里选择“linux”
系统架构	定义边缘网关设备的硬件架构，支持“amd64”、“arm32”、“arm64”三种，这里按照实际情况选择
认证方式	边缘网关默认使用安全的证书认证方式接入蜂巢边缘系统
认证级别	边缘网关目前支持一型一密的方式接入蜂巢边缘系统

2. 创建第三方边缘节点设备

创建完毕第三方边缘节点型号后，添加第三方边缘节点设备的配置步骤与IG530/IG580类似，详细步骤请参考2.2.1 创建IG530/IG580边缘节点。

3. 安装HES Agent软件

(1) 在“边缘节点”配置页面选择第三方边缘节点操作列表的“下载”进入“软件下载”页面。

图2-8 第三方边缘网关下载HES Agent软件

(2) HES Agent软件安装提供了两种方式：离线安装和在线一键安装。

图2-9 HES Agent软件安装方式

(3) 在线安装：点击“点击复制在线安装指令”，然后在第三方边缘网关上运行即可完成HES Agent软件的安装。安装成功后，在第三方边缘网关上查看HES Agent软件运行情况。

(4) 离线安装：点击“点击下载”，待安装文件edgeNodeSdk.zip下载完成后，将安装文件传输至第三方边缘网关并解压。执行安装脚本命令”sudo ./h3c-iot-edge.sh install”，即可完成HES Agent软件的安装。安装成功后，在第三方边缘网关上查看HES Agent软件运行情况。

图2-10 查看HES Agent运行情况

(5) 同时在蜂巢边缘系统上查看，此时第三方边缘网关已经在线。

2.2.3 查看边缘节点详情

点击已经创建的节点名称或者操作列的“查看”，进入“详情”页面查看节点的详细信息，包括节点画像、节点信息、运行状态、应用信息、智能策略和日志信息等内容，如下图：

· 节点画像：体现该节点上总体的运行情况分析统计，包括节点当前的健康状态、预警信息、接入设备管理、接入设备安全态势感知、应用编排、上下行流量统计等信息。

· 节点信息：展示节点名称、当前连接状态、设备的型号、序列号、产品productKey、上线时间、系统类型、系统架构、内核版本、软件版本和IP地址等信息。

· 运行状态：展示节点CPU、内存和硬盘当前实时的使用情况和历史使用趋势。

· 应用信息：展示该节点下运行的第三方容器应用的运行情况。

· 接入设备：展示该节点下接入的设备列表信息，包括MQTT、ModBus、OPC-UA、BACnet等协议设备。

· 函数计算：展示该节点下已经部署的函数以及函数的运行情况。

· 智能策略：展示该节点下配置的智能策略，包括消息路由和资源策略等。

· 日志信息：记录节点的所有操作日志和系统日志信息。

图2-11 查看边缘节点详细信息

2.2.4 边缘节点管理

平台支持节点的创建、删除、启用、禁用和升级等操作，边缘节点接入平台需要在平台上创建节点，未创建的网关节点无法接入平台。

1. 启用/禁用

平台支持对边缘节点的“启用/禁用”功能，被禁用的节点的连接将被断开，重新启用后才能继续连接。

图2-12 边缘节点启用/禁用

2. 节点升级

边缘节点支持通过绿洲物联网平台进行远程升级。

(1) 进入开发者中心页面，在顶部导航栏选择“设备定制”，然后在左侧导航栏点击“设备型号管理”即可进入“设备型号管理”页面，选择具体的型号并进入详情页面。

图2-13 设备型号管理

(2) 在设备详情页面选择“版本管理”页签，点击<版本上传>按钮进行版本上传。

图2-14 版本管理

图2-15 上传节点版本

(3) 版本上传成功后，在绿洲物联网平台顶部导航栏选择“网络管理”，然后在左侧导航栏点击“维护 > 软件升级”进行升级操作。

(4) 点击“按型号升级”页签，并选择“物联网网关”，然后选择需要升级的设备进行升级。

图2-16 升级边缘节点

H3C自研的边缘网关设备版本可以从H3C网站（www.h3c.com）下载，第三方边缘网关的HES Agent软件和蜂巢边缘系统一起提供，平台内置了配套版本，如果需要进行版本上传，请联系相关负责人获取对应的版本文件。

3. 删除节点

在“边缘节点”页面，点击操作列的“删除”即可删除当前节点。勾选边缘节点前面的复选框，点击<批量删除>按钮即可批量删除已勾选的节点。

2.2.5 函数计算

函数是一种轻量化的应用，可以通过函数进行消息的解析、处理和封装等二次加工操作。蜂巢边缘系统支持python3函数，可通过在蜂巢边缘系统上创建python3函数并下发到边缘节点上，实现在边缘侧通过消息触发函数计算，并对函数运行进行监控。

1. 创建函数

(1) 进入开发者中心页面后，在顶部导航栏选择“边缘函数”，然后在左侧导航栏点击“函数列表”即可进入“函数列表”页面。

图2-17 函数列表

(2) 点击<添加函数>按钮添加python3函数。

图2-18 创建函数

表2-4 创建函数参数说明

参数名称	说明
函数名称	定义函数的名称
运行环境	选择python3运行函数
函数入口	定义函数的入口，格式为[文件名].[函数名]。例如创建函数时指定的函数入口为index.handler，那么文件名为index.py，入口函数为handler
超时时间	定义函数执行超时时间
执行内存	定义给函数应用运行的内存大小
描述	函数描述信息

(3) 点击<提交>按钮进入函数编辑页面，支持在线编辑和本地上传函数的方式。

(4) 点击<保存>按钮即可完成函数的创建。

图2-19 在线编辑函数

2. 函数部署

(1) 在左侧导航栏点击“函数部署”并进入“函数部署”页面。

(2) 选择需要部署的函数以及边缘节点设备，点击<部署>按钮即可完成函数的部署。

图2-20 部署函数

(3) 部署完成后，点击“部署记录”页签即可查看函数的部署记录。

图2-21 函数部署记录

(4) 可以在“部署记录”页面勾选需要取消部署的函数，点击<取消部署>按钮来取消函数的部署。或者在边缘节点详情页面，直接取消该节点下已经部署的函数。

图2-22 取消部署方式一

图2-23 取消部署方式二

3. 触发函数

函数触发是通过消息进行触发，收到某一个Topic的消息后就会触发函数的调用，通过配置智能策略来完成函数触发配置。

(1) 在绿洲物联网平台顶部导航栏选择“网络管理”，然后在左侧导航栏点击“配置 > 物联网 > 边缘计算 > 边缘节点”，进入“边缘节点”配置页面。

(2) 点击已经创建的节点名称或者操作列的“查看”进入“详情”页面。

图2-24 边缘节点详情

(3) 选择“智能策略”页签，点击<创建策略>按钮创建策略。创建策略的详细参数介绍请参见2.2.6 智能策略。

(4) 点击<确定>按钮即可完成策略的下发配置。

删除对应的智能策略即可取消函数触发。

4. 函数监控

函数在边缘节点上的运行状态会周期同步到蜂巢边缘系统进行呈现，可以在开发者中心的函数部署页面进行查看。

图2-25 函数运行记录

同时，在边缘节点的详情页面，也可以查看该节点下所有已部署函数的运行情况。

图2-26 节点下函数运行情况

2.2.6 智能策略

1. 消息路由策略

在有些场景下，功能模块A会通过固定的Topic A发送消息，而功能模块B会通过固定的Topic B接收消息，功能模块A和功能模块B都不希望为对方做适配Topic修改。同时模块A和模块B对于消息内容都有一定的格式要求，通过路由策略可以在边缘网关上实现Topic转换和消息转换功能，如下图所示：

图2-27 路由策略原理

(1) 在绿洲物联网平台顶部导航栏选择“网络管理”，然后在左侧导航栏点击“配置 > 物联网 > 边缘计算 > 边缘节点”，进入“边缘节点”配置页面。

(2) 点击已经创建的节点名称或者操作列的“查看”，进入“详情”页面选择“智能策略”页签。

图2-28 智能策略

(3) 点击<创建策略>按钮进行策略创建。

图2-29 创建消息路由策略

表2-5 消息路由策略参数说明

参数名称	说明
策略名称	定义策略的名称
策略描述	策略描述信息
策略类型	选择策略类型，支持消息路由和资源策略，选择“消息路由”
消息来源主题	定义消息来源Message A的Topic A主题
消息来源QoS	定义消息来源Message A的QoS,支持QoS0（至多一次）和QoS1（至少一次）
消息路由主题	定义消息处理后分发Message B的Topic B主题
消息路由QoS	定义分发消息Message B的QoS，支持QoS0（至多一次）和QoS1（至少一次）
处理函数	如果需要消息转换等功能，可以选择对应的触发函数做消息转换，如果只要做Topic转换，则不需要选择处理函数。
执行时间段	定义路由策略执行的时间段，只有选择的时间段内才有效
执行周期	定义路由策略执行的周期，只有选择的周期内才有效

(4) 点击<确定>按钮即可完成策略的配置并下发到边缘节点上。

2. 资源策略

资源策略是智能策略对于容器运行资源的策略配置，可以控制容器CPU、内存的告警策略以及动态扩缩容功能。

图2-30 创建资源策略

表2-6 资源策略配置参数说明

参数名称	说明
策略名称	定义策略的名称
策略描述	对策略的描述
策略类型	选择策略类型，支持消息路由和资源策略，选择“资源策略”
应用名称	选择容器应用
CPU使用率告警阈值/%	定义CPU使用率达到多少百分比以上，则触发CPU告警，不配置默认不告警
内存使用率告警阈值/%	定义内存使用率达到多少百分比以上，则触发内存告警，不配置默认不告警
异常重启次数告警阈值	定义异常重启次数达到多少次以上，则触发告警，配置为0或不配置默认不告警
CPU使用率扩容阈值/%	定义CPU使用率达到多少百分比以上，则触发CPU进行动态扩容。 · 若配置为0或容器应用资源限制配置中不包含CPU的使用限制时，则不进行扩缩容。 · 否则当容器应用的CPU使用率超过给定阈值时，将取消原有CPU运行内核的限制，在原有CPU可使用个数的限制条件上每分钟加一，动态增加至无限制的状态。当CPU使用率低于给定阈值时，反向逐步恢复CPU的限制条件。
内存使用率扩容阈值	定义内存使用率达到多少百分比以上，则触发内存进行动态扩容。 · 若配置为0或容器应用资源限制配置中不包含内存的使用限制，则不进行扩缩容。 · 否则当容器应用的内存使用率超过给定阈值时，按照每分钟增加50%的方式动态扩大内存限制条件至无限制的状态。当内存使用率低于给定阈值时，反向逐步恢复内存的限制条件。
执行时间段	定义资源策略执行的时间段，非执行时间段则资源调度功能不生效
执行周期	定义资源策略执行的周期

2.3 部署容器

2.3.1 上传容器镜像

部署容器应用前需要先准备容器镜像，并且在“开发者中心”页面上传镜像。

1. 创建镜像命名空间

(1) 进入开发者中心页面后，在顶部导航栏选择“边缘镜像”，然后在左侧导航栏点击“镜像仓库”即可进入“镜像仓库”页面，并点击“命名空间”页签。

图2-31 命名空间

(2) 在“命名空间”页签点击<新建命名空间>按钮，在弹出的页面输入命名空间名称，点击<确定>按钮完成命名空间创建。

图2-32 新建命名空间

2. 新建镜像仓库（可选）

设备推送镜像上来或通过页面上传镜像文件时会自动生成镜像仓库，提前创建仓库可以先配置仓库的类型和描述信息，但要求仓库名称和容器的镜像名称一致。

在“仓库信息”页签点击<新建仓库>按钮先创建一个镜像仓库。

图2-33 仓库信息

图2-34 新建镜像仓库

表2-7 新建镜像仓库参数说明

参数名称	说明
命名空间	选择第一步创建的命名空间
仓库名称	定义仓库的名称，一般是一个容器镜像的名称，通过docker images命令看到的镜像名。平台按仓库来管理容器镜像的历史版本
仓库类型	如果选择“私有”只能该账号内部使用，或通过共享的方式给某一个用户共享。选择“公开”可以给所有用户开放镜像使用
描述	对仓库进行描述

3. 上传容器镜像

镜像上传支持两种方式：一是通过页面上传镜像文件，二是通过其他设备推送到镜像仓库。

· 通过页面上传镜像

目前仅支持tar与tar.gz文件格式上传镜像。

单用户最多可添加10个镜像，每个镜像解压后大小不超过2G。

在左侧导航栏点击“我的镜像”，并在“自有镜像”页签点击<上传镜像>按钮进行镜像上传。

图2-35 自有镜像

图2-36 上传镜像

表2-8 上传容器镜像参数说明

参数名称	说明
镜像	选择本地镜像文件，该镜像文件为通过docker save命令保存的镜像文件压缩包
命名空间	选择镜像所属的命名空间
描述	镜像描述信息

· 设备推送镜像

在“镜像仓库”的“仓库信息”页签点击页面上的<操作指南>按钮，查看从设备上推送镜像操作步骤。

图2-37 从客户端上传镜像

2.3.2 配置应用模板

应用模板是一类容器应用的模板配置，可以避免相同容器应用做同样的重复配置，使用模块可以进行模板继承达到快速配置的目的。

在绿洲物联网平台顶部导航栏选择“网络管理”，然后在左侧导航栏点击“配置 > 物联网 > 边缘计算 > 应用模板”，进入“应用模板”配置页面。点击<新建模板>按钮，配置模板的基本信息、镜像选择和应用运行参数。

图2-38 应用模板

1. 基本信息配置

配置应用模板的名称和描述信息。

图2-39 应用模板基本信息配置

2. 镜像选择

选择模板对应的镜像。

图2-40 应用模板镜像选择

3. 应用配置

应用配置即容器应用的运行参数配置，包括启动参数、环境变量、网络配置、数据卷、设备映射、资源限制、资源策略以及网络和重启策略等高级配置。

注意：可以通过容器升级的方式对这些参数项的配置进行修改。

启动参数

启动参数是配置容器内运行的进程名称和进程运行的参数，如果容器镜像制作过程中编写的Dockerfile文件已经使用CMD指令指定运行进程和参数，则无需配置。如果配置了启动参数，优先使用启动参数的配置，忽略CMD指令。启动参数配置如下：

图2-41 应用模板-启动参数

表2-9 应用模板-启动参数说明

参数名称	说明
运行命令	定义容器内运行的命令。支持英文、数字、下划线_、短连接符-、斜线/，长度不超过32个字符
运行参数	定义容器内运行命令的参数，格式同Dockerfile的CMD命令。支持任意字符，每个参数输入后按回车确认输入，各项配置参数字符串总长度不超过256字符
操作	支持“编辑”和“删除”操作

环境变量

环境变量是提供容器应用运行时的环境参数，对于某些固定不变或不经常变化的参数可以通过环境变量的方式提供给容器应用。经常变化的参数不适合使用环境变量，环境变量的指定通过docker run 的“–e”参数来指定。环境变量的配置如下：

图2-42 应用模板-环境变量

网络配置

网络配置主要配置端口的映射关系，可以把容器应用内部端口映射到主机端口提供服务，通过docker run的“-p”参数来指定，网络配置如下：

图2-43 应用模板-网络配置

数据卷

数据卷配置可以把主机的文件或文件夹映射到容器内部供容器应用使用，通过docker run的“-v”参数来指定，数据卷配置如下：

图2-44 应用模板-数据卷

表2-10 应用模板-数据卷参数说明

参数名称	说明
数据卷名称	定义数据卷的名称。支持英文、数字、分隔符（包括-_.），长度不超过32且分隔符不能位于首尾
主机目录	定义主机需要映射到容器内部的文件或文件夹。支持长度不超过128的任意字符串，中文算两个字符
容器目录	定义映射到容器内部的文件或文件夹。支持长度不超过128的任意字符串，中文算两个字符
权限	映射到容器内部的文件或文件夹的权限，支持“只读”和“所有权限”
操作	支持“删除”操作。

设备映射

设备映射配置可以将主机的设备文件映射到容器内部使用，可映射的设备文件包括但不限于RS232/RS485口、设备的GPU、USB等，通过docker run的“--device”参数来指定，设备映射配置如下：

图2-45 应用模板-设备映射

资源限制

资源限制可以配置容器运行的内存、CPU资源等，配置如下：

图2-46 容器模板-资源限制

表2-11 容器模板-资源限制参数说明

参数名称	说明
内存限制	定义容器运行的最大内存，通过docker run的“--memory”参数来指定，如果没有指定，默认不限定内存大小
交换分区限制	定义容器运行的最大交换分区，通过docker run的“--memory-swap”参数来指定，如果没有指定，默认不限定交换分区大小
CPU内核	定义容器运行在主机CPU的哪些核上，通过docker run的“--cpuset-cpus”参数来指定，如果没有指定，则由系统随机调度输入限制：支持单个编号（如: 1）、以英文逗号隔开的多个编号（如：1,3）或者以短连接符链接的数值区间（如：1-3），字符长度不超过64个字符
CPU个数	定义容器运行分配的CPU个数，通过docker run的“--cpus”参数来指定，如果没有指定，则不限定CPU使用个数
进程数	定义容器内进程运行的最大个数，通过docker run的“--pids-limit”参数来指定，如果没有指定，则不限定进程个数

资源策略

资源策略是智能策略对于容器运行资源的策略配置，可以控制容器CPU、内存的告警策略以及动态扩缩容功能，配置如下：

图2-47 资源策略

高级配置

容器模板高级配置如下：

图2-48 容器模板-高级配置

表2-12 容器模板-高级配置参数说明

参数名称	说明
特权选项	定义是否开启容器的特权，开启后，容器将拥有宿主机的root权限，通过docker run的“--privileged”参数来指定
容器网络	定义容器使用的网络，支持三种模式： · 桥接模式：使用容器的默认配置 · 容器模式：使用边缘节点上创建的H3C容器网络 · 主机模式：使用边缘节点的本地网络通过docker run的“--network”参数来指定
重启策略	定义容器的重启策略，支持三种模式： · 总是重启：容器退出时重启，不管容器是否异常退出 · 失败时重启：容器只有在异常退出时重启 · 不重启：容器不管是否异常退出，都不重启通过docker run的“--restart”参数来指定

2.3.3 部署容器应用

容器创建完成后即会立刻部署到边缘节点上并运行，创建容器应用时要求节点在线才能够创建成功。

配置完容器应用模板，可以基于模板创建容器应用。

在绿洲物联网平台顶部导航栏选择“网络管理”，然后在左侧导航栏点击“配置 > 物联网 > 边缘计算 > 容器应用”，进入“容器应用”配置页面。点击<创建容器应用>按钮，配置容器的基本信息、关联边缘节点、对配置进行确认。

图2-49 容器应用

1. 基本信息配置

配置容器的名称和描述信息。

图2-50 容器基本信息

2. 关联对象

配置容器部署的边缘节点，同时选择已经创建的容器应用模板。如果不选择模板，可以自定义配置容器运行参数。

图2-51 容器关联对象

3. 配置确认

配置确认过程，根据继承的模板配置，可以进一步进行差异化修改。确认完后，容器即下发到边缘节点上并运行。

2.3.4 查看容器应用详情

点击已经创建的容器名称或者操作列的“查看”，进入“详情”页面查看容器的详细信息，包括基本信息、配置信息、监控信息、应用信息和日志信息：

· 基本信息：展示容器应用的名称、当前状态、创建时间、设备类型、系统类型、系统架构，镜像的名称等信息。

· 配置信息：配置信息展示容器的配置参数，包括启动参数、环境变量、网络配置、数据卷配置、设备映射、资源限制、资源策略、网络配置和重启策略等。

· 监控信息：展示容器的CPU、异常重启次数、网络I/O和硬盘I/O等信息。

· 应用信息：展示容器内进程的运行情况，包括进程名称、进程状态、CPU使用率、虚拟内存、常驻内存和物理内存使用率等信息。

· 日志信息：展示容器日志信息，容器应用需要记录日志，要求按照边缘网关上日志记录的规则记录日志。

图2-52 查看容器详细信息

2.3.5 容器应用管理

容器创建成功后，平台支持对容器进行监控、编辑、停止、重启、暂停、恢复、启动、删除和升级等操作，如下图所示：

图2-53 容器操作

1. 编辑容器

编辑容器可以修改运行的资源限制和重启策略。

(1) 资源限制包括内存限制、交换分区限制、CPU内核、CPU个数和进程数等，如下图：

图2-54 资源限制

(2) 重启策略可选总是重启、失败时重启和不重启。

2. 删除容器

删除容器会触发边缘节点上删除容器应用，如果镜像没有被其他容器应用，则同步删除设备上的容器镜像。

3. 容器升级

容器升级可以实现对镜像版本的升级，还可以对容器应用配置升级。重新选择镜像文件，如果当前选择的镜像和边缘节点上运行的镜像不同，则会删除旧镜像，并拉取新的容器镜像运行。

图2-55 重选镜像

如果镜像文件不变，容器应用配置发生变化，则升级过程无需拉取新的镜像文件，只需要删除旧的容器应用，使用新的配置重新创建新的容器应用并运行。

4. 容器控制

· 停止：相当于执行docker stop命令停止容器，处于“运行中”状态的容器才能执行“停止”操作。

· 启动：相当于执行docker start命令启动容器，处于“停止”状态的容器才能执行“启动”操作。

· 暂停：相当于执行docker pause命令暂停容器，处于“运行中”状态的容器才能执行“暂停”操作。

· 恢复：相当于执行docker unpause命令恢复容器，处于“暂停”状态的容器才能执行“恢复”操作。

· 重启：相当于执行docker restart命令重启容器，处于“异常”、“运行中”或“暂停”状态的容器才能执行“重启”操作。

2.3.6 镜像管理

镜像仓库提供对容器应用进行镜像文件和版本的管理功能。

蜂巢边缘系统镜像管理为不同的用户提供容器镜像管理功能，可实现镜像的上传、共享、同步，为边缘节点运行容器应用提供镜像版本文件。

1. 镜像仓库

一个镜像仓库即一个应用镜像，多个同一类功能的镜像仓库可以归类为一个命名空间，用户可以管理多个命名空间。

进入开发者中心页面后，在顶部导航栏选择“边缘镜像”，然后在左侧导航栏点击“镜像仓库”即可进入“镜像仓库”页面，并点击“命名空间”页签即可管理命名空间。

图2-56 命名空间管理

在“仓库信息”页签进行仓库管理。

图2-57 镜像仓库管理

对于不同架构的镜像，例如arm、arm64和amd64，平台无法在一个仓库里进行识别分类，需要创建不同的镜像仓库进行区分。

2. 镜像上传

镜像上传的方式有两种，页面上传或本地设备推送，详细配置步骤请参见2.3.1 3. 上传容器镜像。镜像上传成功后，可以在“我的镜像”页面看到上传的镜像信息，如下图：

图2-58 我的镜像

3. 共享镜像

镜像默认属于用户私有，只能用户自己使用，如果想把镜像共享给其他用户使用，有公开仓库和共享镜像两种方式。

· 公开仓库方式

通过公开仓库方式，将仓库中所有版本的镜像共享给所有的用户使用。

a. 在左侧导航栏点击“镜像仓库”，然后点击“仓库信息”页签，点击已创建仓库操作列的“编辑”，将仓库类型设置为“公开”。

图2-59 公开仓库

b. 设置完仓库类型为“公开”后，其他用户在左侧导航栏点击“镜像资源”，然后通过“镜像资源”页面可以查看设置公开的镜像。

图2-60 镜像资源

可以随时将已经“公开”的仓库设置为“私有”，其他用户将无法继续使用该镜像仓库中的镜像资源。

· 共享镜像方式

通过共享镜像方式，将具体的某一个版本的镜像共享给具体的某一个用户。

a. 在左侧导航栏点击“我的镜像”，然后点击“自有镜像”页签，点击已上传镜像操作列的“共享”，配置共享的用户账号即可完成共享操作。

图2-61 共享镜像

b. 共享完成后，在“共享镜像”页面可以查看具体共享的镜像信息。

图2-62 共享镜像列表

“共享镜像”页面除了可以查看自己共享的镜像，还可以查看他人共享的镜像。可以随时取消已经共享的镜像，取消后其他用户将无法继续使用该镜像资源。

4. 镜像同步

镜像同步可以在不同的镜像命名空间同步镜像文件。

在左侧导航栏点击“镜像同步”进入“镜像同步”页面，点击<创建同步任务>按钮，在弹出的页面进行同步任务创建。

图2-63 创建同步任务

表2-13 创建同步任务参数说明

参数名称	说明
镜像类型	可选“自有镜像”或“共享镜像”，自有镜像即用户自己上传的镜像，共享镜像即他人共享的镜像
镜像	选择具体的镜像版本
命名空间	选择需要同步的目标命名空间
是否覆盖	如果选择“是”，则会覆盖目标命名空间同名同版本的镜像；如果选择“否”，若目标命名空间存在同名同版本的镜像，则不进行同步操作

2.4 部署边缘接入设备

本章节以Modbus终端设备接入边缘节点为例进行介绍，展现通过边缘节点接入第三方协议终端的过程。各协议差异化部分将单独列出。

2.4.1 创建设备型号

添加终端设备之前，需要先创建一个终端的型号，型号是一类产品设备的标识，第三方设备接入平台都需要先定义一个型号，绿洲物联网平台支持通过“开发者中心”自定义第三方产品型号。

图2-64 开发者中心

(2) 进入开发者中心页面后，在顶部导航栏选择“设备定制”，然后在左侧导航栏点击“设备型号管理”即可进入“设备型号管理”页面。

图2-65 设备型号管理

(3) 点击<创建设备型号>按钮，即可配置第三方终端设备型号。

图2-66 创建终端设备型号

表2-14 创建终端设备型号参数说明

参数名称	说明
设备类型	第三方设备的类型，分网关和终端，这里选择“终端设备”
设备型号	定义终端设备的型号名称
型号模板标识	选择一类消息的Topic的模板，在设备定制的“基本信息”页面的厂商信息中定义
设备分组	选择设备适用的分类，通用设备可以选择“其它”
接入MQTT网关	这里选择“否”
终端接入方式	这里选择“边缘接入/ModBus”
数据格式	定义消息数据内容的格式，这里选择“自定义数据格式”
设备标识类型	定义设备ID的类型，标识设备唯一性，这里根据实际情况选择
设备标识长度	定义设备ID的长度

2.4.2 配置接入设备模板

模板代表一类终端的配置，配置模板后，后续添加设备时可以快速继承模板的配置。

1. 基本信息

(1) 在绿洲物联网平台顶部导航栏选择“网络管理”，然后在左侧导航栏点击“配置 > 物联网 > 边缘计算 > 边缘接入”，进入“边缘接入”配置页面。

图2-67 边缘接入

(2) 点击<配置模板>按钮进入“配置模板”页面，然后点击<添加模板>按钮添加设备模板。

图2-68 添加模板

(3) 添加模板的基本信息：包括模板名称、连接协议以及描述信息。

图2-69 添加设备模板基本信息

(4) 点击<下一步>按钮，进入到Modbus协议的配置，协议配置包含三部分：设备配置、连接通道配置和属性定义配置。

2. 设备配置

Modbus设备配置内容如下：

图2-70 Modbus设备-设备配置

表2-15 Modbus设备-设备配置参数说明

参数名称	说明
从站编号	定义Modbus终端从站设备的地址值，这里配置完后，后续添加具体设备时可以修改
数据采集周期	Modbus服务是作为Master，会按照固定的周期去设备侧采集数据，这里定义采集的周期
数据解析格式	Modbus服务采集完数据后，是以什么样的格式返回，这里支持“JSON”和”BINARY”。如果选择“BINARY”则不支持设备影子同步功能，数据格式说明参见2.4.2 5. 数据格式，这里选择“JSON”格式
数据解析后发布的MQTT消息Topic	定义Modbus服务数据采集完后发布的MQTT Topic，使用默认Topic会发布给设备影子服务做云边协同发布到蜂巢边缘系统，这里可以通过自定义Topic，结合消息路由策略触发函数计算功能
数据解析后发布的MQTT消息QoS	定义Modbus服务数据采集完后发布消息的MQTT QoS

BACnet设备配置内容如下：

图2-71 BACnet设备-设备配置

表2-16 BACnet设备-设备配置参数说明

参数名称	说明
数据采集周期	BACnet服务是作为Master，会按照固定的周期去设备侧采集数据，这里定义采集的周期
数据解析后发布的MQTT消息Topic	定义BACnet服务数据采集完后发布的MQTT Topci，使用默认Topic会发布给设备影子服务做云边协同发布到蜂巢边缘系统，这里可以通过自定义Topic，结合消息路由策略触发函数计算功能
数据解析后发布的MQTT消息QoS	定义BACnet服务数据采集完后发布消息的MQTT QoS

OPC-UA设备配置内容如下：

图2-72 OPC-UA设备-设备配置

表2-17 OPC-UA设备-设备配置参数说明

参数名称	说明
数据采集周期	OPC-UA服务是作为Master，会按照固定的周期去设备侧采集数据，这里定义采集的周期
数据解析后发布的MQTT消息Topic	定义OPC-UA服务数据采集完后发布的MQTT Topic，使用默认Topic会发布给设备影子服务做云边协同发布到蜂巢边缘系统，这里可以通过自定义Topic，结合消息路由策略触发函数计算功能
数据解析后发布的MQTT消息QoS	定义OPC-UA服务数据采集完后发布消息的MQTT QoS

3. 连接通道配置

连接通道是指设备连接边缘网关的连接方式配置。

Modbus设备配置内容如下：

图2-73 Modbus RTU连接通道配置

图2-74 Modbus TCP连接通道配置

表2-18 Modbus连接通道配置参数说明

参数名称	说明
通道名称	定义连接的名称
传输模式	选择Modbus的协议，支持RTU和TCP
串口地址	使用串口连接Modbus设备时，对应串口的文件名
波特率	定义Modbus-RTU设备的串口波特率
数据位	定义Modbus-RTU设备的串口数据位长度
校验位	定义Modbus-RTU设备的串口校验位
停止位	定义Modbus-RTU设备的串口停止位长度
IP地址	定义Modbus-TCP设备的IP地址
端口	定义Modbus-TCP设备的端口
连接超时时间(s)	定义连接Modbus设备的超时重连时间
空闲关闭时间(m)	定义连接Modbus设备的空闲关闭时间

BACnet设备配置内容如下：

图2-75 BACnet定向连接通道配置

图2-76 BACnet非定向连接通道配置

表2-19 BACnet连接通道配置参数说明

参数名称	说明
通道名称	定义连接的名称
网卡名称	BACnet服务与设备通信所使用的网卡名称
通信方式	定向通信可根据连接地址直接与Bacnet设备通信，非定向通信会根据BACnet设备ID通过对应网卡进行广播查找。
连接地址	定向通信时BACnet设备的IP地址和端口号
设备ID	非定向通信时定义BACnet终端标识ID

OPC-UA设备配置内容如下：

图2-77 OPC-UA连接通道配置

表2-20 OPC-UA连接通道配置参数说明

参数名称	说明
通道名称	定义连接的名称
通道地址	定义OPC-UA设备的连接地址
方法调用超时时间(s)	定义超时时间
身份认证	定义OPC-UA设备的身份认证方式，包括无认证（anoymous）、账号认证（username）、证书认证（certificate）
安全策略	定义连接OPC-UA设备的安全策略，包括None、Basic128Rsa15、Basic256、Basic256Sha256、Aes128Sha256RsaOaep、Aes256Sha256RsaPss
安全模式	定义连接OPC-UA设备的安全模式，包括None、Sign、SignAndEncrypt

4. 属性定义配置

属性配置定义具体的协议，配置数据采集的内容含义、地址、长度和单位等信息。

Modbus属性定义配置如下：

图2-78 Modbus属性定义配置

表2-21 Modbus属性定义配置参数说明

参数名称	说明
属性名称	采集数据的属性名称
属性标识	采集数据的属性标识，该字段会作为json格式的key字段提供
功能码	定义采集数据使用的协议功能码，支持读功能码:0x01、0x02、0x03、0x04和写功能码：0x05、0x06、0x0F、0x10。各个功能码含义如下。比特访问（Bit Access）功能码： · 0x02：读输入离散量（Read Discrete Inputs） · 0x01：读线圈（Read Coils） · 0x05：写单个线圈（Write Single Coil） · 0x0F：写多个线圈（Write Multiple Coils） 16比特访问（16 Bit Access）功能码： · 0x04：读单个寄存器(Read Input Register) · 0x03：读多个寄存器（Read Holding Registers） · 0x06：写单个寄存器（Write Single Register） · 0x10：写多个寄存器（Write Multiple Registers）协议详细介绍请参考相关文献
数据类型	定义采集数据的类型，支持int16、uint16、int32、uint32、int64、uint64、float32、float64、bool，数据采集的最小长度为寄存器地址长度2字节，如果定义数据类型为uint64，则数据长度为8字节，采集4个寄存器地址
单位	定义采集数据的单位
寄存器地址	定义采集数据的协议寄存器地址，填写十六进制，以0x开头。例如，要采集设备的SN号，设备的devSN属性地址为2，则寄存器地址可设置为0x0002
交换寄存器内高低字节顺序	定义是否把寄存器内16位数据的前后8个bits互换
交换寄存器顺序	定义是否把原始数据32位数据的bits互换
缩放因子	定义缩放的系数，如采集的值为100，但真实的值为10，因此需要缩小10倍，故缩放因子填写0.1即可。若放大10倍（即真实的值为1000），则缩放因子为10

BACnet属性定义配置如下：

图2-79 BACnet属性定义配置

表2-22 BACnet属性定义配置参数说明

参数名称	说明
属性名称	采集数据的属性名称
属性标识	采集数据的属性标识，该字段会作为json格式的key字段提供
对象类型	定义采集数据的对象类型，协议详细介绍请参考相关文献。
对象ID	定义采集数据的对象ID，协议详细介绍请参考相关文献。
属性ID	定义采集数据的对象的对应属性ID，协议详细介绍请参考相关文献。
数据类型	定义采集数据的类型，支持string、uint32、float32、float64、bool
单位	定义采集数据的单位

OPC-UA属性定义配置如下：

图2-80 OPC-UA属性定义配置

表2-23 OPC-UA属性定义配置参数说明

参数名称	说明
属性名称	采集数据的属性名称
属性标识	采集数据的属性标识，该字段会作为json格式的key字段提供
节点标识	由命名空间、标识类型、标识内容组成
数据类型	定义采集数据的类型，支持int16、uint16、int32、uint32、int64、uint64、float32、float64、string、bool
单位	定义采集数据的单位

5. 数据格式

Modbus采集到的数据封装支持JSON格式和BINARY格式，在边缘侧可以通过mqtt.fx工具订阅modbus驱动发送给设备影子的MQTT Topic：h3c-modbus/request/h3c-shadow/updateShadow来查看消息内容。

· JSON格式

JSON格式对于采集后的数据封装成JSON格式进行分发，如果是发送给设备影子Topic：，JSON格式如下所示：

{

"productKey" : "TgdyFzfw",

"deviceID" : "585555855854",

"state" : {

"reported" : {

"devSN" : 2102010,

"empty_high" : 2160,

"temperature" : 29,

"water_line" : 47840

}

"metadata" : {

"reported" : {

"devSN" : {