# 注册基础版节点（鸿蒙系统） 鸿蒙系统下当前仅支持基础版节点的安装，基础版节点的"系统应用"采用进程包部署方式。适用于Linux Core系统，无Docker环境。以下步骤均使用基于瑞芯微 RK3568 芯片的DAYU200开发板进行节点安装测试。 ![](https://support.huaweicloud.com/usermanual-iotedge/public_sys-resources/note_3.0-zh-cn.png) - 在注册前请检查机器网络是否正常，是否能够连接到公网。 - 在注册之前请检查机器时间是否和北京时间一致，如果偏差过大会导致安装失败。 #### 注册基础版节点 1. 访问[IoT边缘](https://www.huaweicloud.com/product/iotedge.html)，单击**"管理控制台"**进入IoT边缘控制台。 2. 选择左侧导航栏"边缘节点 \> 节点管理"单击右上角"注册节点"。 3. 节点类型选择"基础版"，系统类型选择"openHarmony"。 4. 根据页面提示填写参数，勾选右下角"《华为云服务等级协议》"单击"下一步"配置节点数据。 图1基础版 ![](https://support.huaweicloud.com/usermanual-iotedge/figure/zh-cn_image_0000001937628033.png "点击放大") 表1节点规格参数说明 | 参数名称 | 参数说明 | |:---|:---| | 节点类型 | 这里选择"基础版"。 | | 节点名称 | 自定义节点名称，如"test"。 说明： 节点名称可以在："节点概览"-"基本信息"中编辑修改。 | | 网关类型 | 默认选择 "other"即可（"yuzhen_x86"只在某些特殊网关盒子场景使用）。 | | 系统类型 | 为鸿蒙系统，这里必须选择"openHarmony"系统。 - generalLinux：标识普通Linux系统，如ubuntu、centos、openEuler。 - openHarmony：鸿蒙系统。 | | 节点ID | 自定义（可选填写）。只允许中文、英文字母、数字、中划线（-）、下划线（_），最小长度1，最大长度64。 说明： 边缘节点ID自定义(不输入默认生成)。 | | 验证码 | 输入自定义验证码（可选填写）。验证码，执行安装边缘软件命令时与云端通讯的凭证。 说明： 验证码自定义(不输入默认生成)。 | | 设备归属实例 | 选择默认归属实例。 | | 设备归属资源空间 | 选择默认资源空间，或为本实验单独新建一个资源空间，如edge。 | | IoTDA南向接入地址 | 选择网关归属的IoTDA实例的南向设备mqtt接入地址，也可以选择自定义的南向接入地址，支持"ip:端口"或"域名:端口"形式。 说明： 不输入默认生成。 | | 鉴权方式 | 密钥：默认生成。 X.509证书：请参考：[基于MQTT.fx的X.509证书接入指导](https://support.huaweicloud.com/bestpractice-iothub/iot_bp_0077.html)。 警告： 鉴权方式为"密钥"的节点，请勿在IoTDA界面重置节点的密钥，重置密钥会导致网关与IoTDA通信异常，且不可恢复。 | | 指纹 | 证书文件生成的字符串（可选填写）。只能为40位十六进制字符串或64位六进制字符串。 | | 本地路径 | 输入证书文件和密钥文件在设备上的存储路径，只允许字母、数字、下划线（_）和斜线（/），以/开头并且以.pem或.crt结尾。 | | 自动升级 | 可选，开启后节点将自动升级系统应用模块。 注意： 升级过程中可能导致节点数据上传中断。 | 5. 填写配置节点数据信息后，鸿蒙系统因为默认根目录为只读权限，避免数据读写问题，建议节点的根目录配置在/data目录下，单击"立即创建"。 图2配置节点数据 ![](https://support.huaweicloud.com/usermanual-iotedge/figure/zh-cn_image_0000001937633225.png "点击放大") 表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。边缘节点保存的转储日志数量如果达到限制，则会删除最早的转储文件。 注意： 1. 当前"云端日志级别"对日志等级采取模糊匹配的策略，若日志消息中存在与日志级别标识相同的关键字，则也可能被采集。 2. 若要开启"云端日志级别"中的trace, debug, info, warn, error, fatal选项，则必须满足以下三个前置条件： 1. 目标节点是基础版节点或++部++ ++署类型为Docker++ 的专业版节点。需注意，++部署类型为KubeEdge++的专业版节点不支持此功能。 2. 已安装$edge_omagen应用，且版本不低于1-1-15-xxx。 3. 应用日志需遵循如下规范打印，以便进行过滤： - 日志级别标识需打印为（大小写均可）：trace、debug、info、warn、error、fatal。 - 每条日志消息以YYYY-MM-DD日期格式作为前缀。 3. 专业版（Docker）和基础版节点只支持云端日志级别这一个参数，其他参数仅对专业版（KubeEdge）有效。 | | 离线缓存配置 | 可对离线节点上报的数据进行缓存，定义缓存周期（可配置为不过期）跟缓存大小，上报的优先级，路由转发是否开启离线缓存。 | | 可靠性配置 | 可靠性级别分为"中"和"高"2种。中级别：当应用上报属性和点位的频率超过流控值时，超过部分会被丢弃；高级别：当应用上报属性和点位的频率超过流控值时，通过控制模块的发送速度，降低上报频率，报文不会被丢弃。（注意：高可靠性级别的配置需要定制应用的配合，同时会造成性能的损失）。 | 6. 弹出如下对话框，您可以"返回节点列表"也可以"继续创建"。 图3鸿蒙系统基础版注册成功 ![](https://support.huaweicloud.com/usermanual-iotedge/figure/zh-cn_image_0000001945196984.png "点击放大") ![](https://support.huaweicloud.com/usermanual-iotedge/public_sys-resources/caution_3.0-zh-cn.png) 1. 架构选择时，需要根据硬件架构选择，此处使用基于RK3568的DAYU200开发板选择arm64，其余的架构按照实际选择。 2. 鸿蒙系统安装目录需要修改到/data/目录或者子目录下，避免重启后系统目录变更为只读权限文件系统，影响系统正常运行。 #### 安装节点 ![](https://support.huaweicloud.com/usermanual-iotedge/public_sys-resources/note_3.0-zh-cn.png) - 在安装前请检查机器网络是否正常，是否能够连接到公网。 - 在安装之前请检查机器时间是否和北京时间一致，如果偏差过大会导致安装失败。 1. 选择支持架构和安装目录之后，按照图中框选地方获取。 图4获取安装命令 ![](https://support.huaweicloud.com/usermanual-iotedge/figure/zh-cn_image_0000001945201688.png "点击放大") 2. 鸿蒙操作系统下默认未安装wget以及openssl，因此需要将安装命令拆解为以下几步执行。如图为安装命令的拆分图解 图5命令拆解 ![](https://support.huaweicloud.com/usermanual-iotedge/figure/zh-cn_image_0000001499912429.png "点击放大") 其中第①步为下载安装包，第②步为安装包完整性校验（可以跳过），第③步为执行安装命令。 3. 根据步骤二的说明获取安装包的下载命令并通过浏览器下载。 安装包下载链接：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浏览器下载安装包 ![](https://support.huaweicloud.com/usermanual-iotedge/figure/zh-cn_image_0000001450473668.png "点击放大") 4. 在windows上通过hdc_std工具，将下载的安装包上传到鸿蒙设备的/data/zh下并查看，上传的目录建议在/data/目录或者子目录下。 图7上传文件到鸿蒙设备 ![](https://support.huaweicloud.com/usermanual-iotedge/figure/zh-cn_image_0000001499754837.png "点击放大") 图8登录鸿蒙设备控制台 ![](https://support.huaweicloud.com/usermanual-iotedge/figure/zh-cn_image_0000001449994488.png "点击放大") 图9确定文件成功上传 ![](https://support.huaweicloud.com/usermanual-iotedge/figure/zh-cn_image_0000001500074109.png "点击放大") 注意执行命令：mount -oremount,rw / ， 该命令必须执行，修改鸿蒙文件系统的可读写权限，以防安装失败。 图10解压安装包 ![](https://support.huaweicloud.com/usermanual-iotedge/figure/zh-cn_image_0000001450155656.png "点击放大") 在/data/zh下执行解压命令。至此安装包已经解压在/data/zh。并不一定必须在/data/zh目录下，仅仅因为上传到这个目录下。实际执行时，安装上传的实际目录进行操作。 5. 上述几步执行完成后就可以进行最后的安装操作。 - 因为前面步骤可能会耗费一些时间，所以此时需要确认安装命令是否过期，避免本次安装以为验证码过期而安装失败，安装命令的有效时间为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执行安装命令 ![](https://support.huaweicloud.com/usermanual-iotedge/figure/zh-cn_image_0000001499919269.png "点击放大") 安装成功： 图12安装成功 ![](https://support.huaweicloud.com/usermanual-iotedge/figure/zh-cn_image_0000001937681945.png "点击放大") 6. 查看节点状态以及应用状态 图13节点状态 ![](https://support.huaweicloud.com/usermanual-iotedge/figure/zh-cn_image_0000001945332425.jpg) 图14应用状态 ![](https://support.huaweicloud.com/usermanual-iotedge/figure/zh-cn_image_0000001450319144.png "点击放大") 7. 部署$edge_omagent测试功能 $edge_omagent部署时根据架构选择对应的版本，此处部署$edge_omagent的最新的arm64版本。 图15部署$edge_omagent应用 ![](https://support.huaweicloud.com/usermanual-iotedge/figure/zh-cn_image_0000001912677258.jpg "点击放大") 图16指标采集 ![](https://support.huaweicloud.com/usermanual-iotedge/figure/zh-cn_image_0000001449999416.png "点击放大")