更新时间:2024-07-12 GMT+08:00
分享

注册基础版节点(鸿蒙系统)

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

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

注册基础版节点

  1. 访问IoT边缘,单击“管理控制台”进入IoT边缘控制台。
  2. 选择左侧导航栏“边缘节点 > 节点管理”单击右上角“注册节点”
  3. 节点类型选择“基础版”,系统类型选择“openHarmony”。
  4. 根据页面提示填写参数,勾选右下角“《华为云服务等级协议》”单击“下一步”配置节点数据。

    图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结尾。

    自动升级

    可选,开启后节点将自动升级系统应用模块。

    注意:

    升级过程中可能导致节点数据上传中断。

  5. 填写配置节点数据信息后,鸿蒙系统因为默认根目录为只读权限,避免数据读写问题,建议节点的根目录配置在/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。边缘节点保存的转储日志数量如果达到限制,则会删除最早的转储文件。
      注意:
      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 鸿蒙系统基础版注册成功
    1. 架构选择时,需要根据硬件架构选择,此处使用基于RK3568的DAYU200开发板选择arm64,其余的架构按照实际选择。
    2. 鸿蒙系统安装目录需要修改到/data/目录或者子目录下,避免重启后系统目录变更为只读权限文件系统,影响系统正常运行。

安装节点

  • 在安装前请检查机器网络是否正常,是否能够连接到公网。
  • 在安装之前请检查机器时间是否和北京时间一致,如果偏差过大会导致安装失败。
  1. 选择支持架构和安装目录之后,按照图中框选地方获取。

    图4 获取安装命令

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

    图5 命令拆解

    其中第①步为下载安装包,第②步为安装包完整性校验(可以跳过),第③步为执行安装命令。

  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 浏览器下载安装包

  4. 在windows上通过hdc_std工具,将下载的安装包上传到鸿蒙设备的/data/zh下并查看,上传的目录建议在/data/目录或者子目录下。

    图7 上传文件到鸿蒙设备
    图8 登录鸿蒙设备控制台
    图9 确定文件成功上传

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

    图10 解压安装包

    在/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 执行安装命令

      安装成功:

      图12 安装成功

  6. 查看节点状态以及应用状态

    图13 节点状态
    图14 应用状态

  7. 部署$edge_omagent测试功能

    $edge_omagent部署时根据架构选择对应的版本,此处部署$edge_omagent的最新的arm64版本。
    图15 部署$edge_omagent应用
    图16 指标采集

相关文档