注册基础版节点（鸿蒙系统）

更新时间：2025-02-25 GMT+08:00

查看PDF

鸿蒙系统下当前仅支持基础版节点的安装，基础版节点的“系统应用”采用进程包部署方式。适用于Linux Core系统，无Docker环境。以下步骤均使用基于瑞芯微 RK3568 芯片的DAYU200开发板进行节点安装测试。

说明：

在注册前请检查机器网络是否正常，是否能够连接到公网。
在注册之前请检查机器时间是否和北京时间一致，如果偏差过大会导致安装失败。

注册基础版节点

访问IoT边缘，单击“管理控制台”进入IoT边缘控制台。
选择左侧导航栏“边缘节点 > 节点管理”单击右上角“注册节点”。
节点类型选择“基础版”，系统类型选择“openHarmony”。

根据页面提示填写参数，勾选右下角“《华为云服务等级协议》”单击“下一步”配置节点数据。

图1 基础版

表1 节点规格参数说明
参数名称	参数说明
节点类型	基础版。
节点名称	自定义节点名称，如“test”。说明：节点名称可以在：“节点概览”-“基本信息”中编辑修改。
网关类型	可选。
系统类型	generalLinux（标识普通系统，如ubuntu、centos、openEuler），openHarmony（鸿蒙系统）。如果系统为鸿蒙时必须选择openHarmony。
节点ID	自定义（可选填写）。只允许中文，英文字母、数字、中划线（-），下划线（_），最小长度1，最大长度64。说明：边缘节点ID自定义(不输入默认生成)。
验证码	输入自定义验证码（可选填写）。验证码，执行安装边缘软件命令时与云端通讯的凭证。
设备归属实例	选择默认归属实例。
设备归属资源空间	选择默认资源空间，或为本实验单独新建一个资源空间，如edge。
IoTDA南向接入地址	选择网关归属的IoTDA实例的南向设备mqtt接入地址，也可以选择自定义的南向接入地址，支持“ip:端口”或“域名:端口”形式。
鉴权方式	密钥：默认生成。 X.509证书：请参考：基于MQTT.fx的X.509证书接入指导。警告：鉴权方式为“密钥”的节点，请勿在IoTDA界面重置节点的密钥，重置密钥会导致网关与IoTDA通信异常，且不可恢复。
指纹	证书文件生成的字符串（可选填写）。只能为40位十六进制字符串或64位六进制字符串。
本地路径	输入证书文件和密钥文件在设备上的存储路径，只允许字母、数字、下划线（_）和斜线（/），以/开头并且以.pem或.crt结尾。
自动升级	可选，开启后节点将自动升级系统应用模块。注意：升级过程中可能导致节点数据上传中断。

填写配置节点数据信息后，鸿蒙系统因为默认根目录为只读权限，避免数据读写问题，建议节点的根目录配置在/data目录下，单击“立即创建”。

图2 配置节点数据

表2 专业版节点信息
参数名称	说明
数据存储路径	默认（允许修改存储路径），鸿蒙系统因为默认根目录为只读权限，避免数据读写问题，建议节点的根目录配置在/data/或子目录下。
监控运维	默认勾选“监控运维工具”。
$edge_omagent应用	负责边缘节点远程监控和运维，提供日志上报、远程SSH（鸿蒙下无此功能）、CPU等指标上报、文件上传下载能力。
日志配置	系统日志：边缘节点上已部署的系统应用产生的日志。应用日志：边缘节点上已部署的用户定义应用所产生的日志。云端日志级别：on, off, trace, debug, info, warn, error, fatal。其中，on表示上传所有日志至云端，off表示不上传日志至云端，其余可选项代表按日志级别采集，选择后将只采集目标级别及以上的日志（模糊匹配）。日志级别的严重程度等级由低到高依次为：trace, debug, info, warn, error, fatal。日志文件大小：日志文件大小限制，单位MB，默认50，取值范围10-1000。某个日志文件如果达到大小限制，则会将文件转储保存至日志目录下。滚动日志周期：日志转储周期，可选项：daily，weekly，monthly，yearly。某个日志文件如果达到转储周期，则会将文件转储保存至日志目录下。日志文件大小和滚动日志周期是同时生效的，满足任何一个条件都会进行日志转储。滚动日志数量：日志文件转储个数，默认5，取值范围1-10。边缘节点保存的转储日志数量如果达到限制，则会删除最早的转储文件。注意：当前“云端日志级别”对日志等级采取模糊匹配的策略，若日志消息中存在与日志级别标识相同的关键字，则也可能被采集。若要开启“云端日志级别”中的trace, debug, info, warn, error, fatal选项，则必须满足以下三个前置条件：目标节点是基础版节点或部署类型为Docker的专业版节点。需注意，部署类型为KubeEdge的专业版节点不支持此功能。已安装$edge_omagen应用，且版本不低于1-1-15-xxx。应用日志需遵循如下规范打印，以便进行过滤：日志级别标识需打印为（大小写均可）：trace、debug、info、warn、error、fatal。每条日志消息以YYYY-MM-DD日期格式作为前缀。专业版（Docker）和基础版节点只支持云端日志级别这一个参数，其他参数仅对专业版（KubeEdge）有效。
离线缓存配置	可对离线节点上报的数据进行缓存，定义缓存周期（可配置为不过期）跟缓存大小，上报的优先级，路由转发是否开启离线缓存。
可靠性配置	可靠性级别分为“中”和“高”2种。中级别：当应用上报属性和点位的频率超过流控值时，超过部分会被丢弃；高级别：当应用上报属性和点位的频率超过流控值时，通过控制模块的发送速度，降低上报频率，报文不会被丢弃。（注意：高可靠性级别的配置需要定制应用的配合，同时会造成性能的损失）。

弹出如下对话框，您可以“返回节点列表”也可以“继续创建”。

图3 鸿蒙系统基础版注册成功
注意：
1. 架构选择时，需要根据硬件架构选择，此处使用基于RK3568的DAYU200开发板选择arm64，其余的架构按照实际选择。
2. 鸿蒙系统安装目录需要修改到/data/目录或者子目录下，避免重启后系统目录变更为只读权限文件系统，影响系统正常运行。

安装节点

说明：

在安装前请检查机器网络是否正常，是否能够连接到公网。
在安装之前请检查机器时间是否和北京时间一致，如果偏差过大会导致安装失败。

选择支持架构和安装目录之后，按照图中框选地方获取。

图4 获取安装命令
鸿蒙操作系统下默认未安装wget以及openssl，因此需要将安装命令拆解为以下几步执行。如图为安装命令的拆分图解

图5 命令拆解

其中第①步为下载安装包，第②步为安装包完整性校验（可以跳过），第③步为执行安装命令。
根据步骤二的说明获取安装包的下载命令并通过浏览器下载。

安装包下载链接：https://ioe-installer-cn-north-4.obs.cn-north-4.myhuaweicloud.com:443/edgeRuntime-2022.1222.1216.38-openharmony.tar.gz/1671689782293/edgeRuntime-2022.1222.1216.38-openharmony.tar.gz?AccessKeyId=VGC*****CE&Expires=1673949121&Signature=pwx******3D

浏览器下载：

图6 浏览器下载安装包
在windows上通过hdc_std工具，将下载的安装包上传到鸿蒙设备的/data/zh下并查看，上传的目录建议在/data/目录或者子目录下。

图7 上传文件到鸿蒙设备

图8 登录鸿蒙设备控制台

图9 确定文件成功上传

注意执行命令：mount -oremount,rw / ，该命令必须执行，修改鸿蒙文件系统的可读写权限，以防安装失败。

图10 解压安装包

在/data/zh下执行解压命令。至此安装包已经解压在/data/zh。并不一定必须在/data/zh目录下，仅仅因为上传到这个目录下。实际执行时，安装上传的实际目录进行操作。
上述几步执行完成后就可以进行最后的安装操作。
- 因为前面步骤可能会耗费一些时间，所以此时需要确认安装命令是否过期，避免本次安装以为验证码过期而安装失败，安装命令的有效时间为30min。
- 如果是公网安装，可以提前测试网络是否正常，ping www.baidu.com.
  命令拆分步骤中的第三步标识了安装命令的获取，安装命令示例：
  
  INSTALL_IOTEDGE_BIN_DIR=/data/zh/IoTEdge sh edge_install.sh 100.94.60.201 8943 795632095371472896 sys_edge_daemon 02******1a cloud false lite DEFAULT && cd –
  
  执行安装命令：
  
  图11 执行安装命令
  
  安装成功：
  
  图12 安装成功
查看节点状态以及应用状态

图13 节点状态

图14 应用状态
部署$edge_omagent测试功能

$edge_omagent部署时根据架构选择对应的版本，此处部署$edge_omagent的最新的arm64版本。
图15 部署$edge_omagent应用

图16 指标采集