注册专业版节点(Docker)
专业版提供物联网行业所需的边缘管理的基本功能。
- 在注册前请检查机器软硬件配置,如磁盘、内存和Docker版本,切换root用户执行安装命令。
- 请充分确认以免安装失败或者安装后服务不可用。
- Docker版本必须高于17.06,推荐使用18.06.3版本。
(请勿使用18.09.0版本Docker,该版本存在严重bug,详见这里;如果已使用此版本,请尽快升级。Atlas 500小站预置的Docker 18.09.0.60软件版本已经修改该问题。)
Docker安装方法请参见这里。
可以选择使用开源的Docker CE或者使用Docker企业版(Docker EE),使用Docker EE时,需要支付Docker额外费用,更多Docker EE相关细节请参考Docker官方文档。
Docker安装完成后,请将Docker进程配置为开机启动,避免系统重启后Docker进程未启动引起的系统异常。
注册专业版节点
- 访问IoT边缘,单击“管理控制台”进入IoT边缘控制台。
- 选择左侧导航栏“边缘节点 > 节点管理”单击右上角“注册节点”。
- 根据页面提示填写参数,勾选右下角“《华为云服务等级协议》”单击“下一步”配置节点数据。
图1 专业版
表1 节点规格参数说明 参数名称
参数说明
节点类型
专业版。
部署类型
Docker。
AI加速卡
- 未搭载:边缘节点未使用AI加速卡时选择。
- 昇腾AI加速卡:支持昇腾AI加速设备,边缘节点的服务器搭载相关昇腾AI加速设备时选择。
昇腾驱动地址
可选,AI加速卡选择昇腾AI加速卡时需要保证安装边缘节点的服务器上已经安装昇腾设备驱动,并根据前端提示填入驱动地址。若该值为空,默认填入Altas300驱动默认安装地址: /usr/local/Ascend/driver/lib64/。
节点名称
自定义节点名称,如“test”。
说明:节点名称可以在:“节点概览”-“基本信息”中编辑修改。
网关类型
other。
节点ID
自定义(可选填写)。只允许中文,英文字母、数字、中划线(-),下划线(_),最小长度1,最大长度64。
说明:边缘节点ID自定义(不输入默认生成)。
验证码
输入自定义验证码(可选填写)。验证码,执行安装边缘软件命令时与云端通讯的凭证。
设备归属实例
选择默认归属实例。
设备归属资源空间
选择默认资源空间,或为本实验单独新建一个资源空间,如edge。
IoTDA南向接入地址
选择网关归属的IoTDA实例的南向设备mqtt接入地址,也可以选择自定义的南向接入地址,支持“ip:端口”或“域名:端口”形式。
鉴权方式
密钥:默认生成。
X.509证书:请参考:基于MQTT.fx的X.509证书接入指导。
警告:鉴权方式为“密钥”的节点,请勿在IoTDA界面重置节点的密钥,重置密钥会导致网关与IoTDA通信异常,且不可恢复。
指纹
证书文件生成的字符串(可选填写)。只能为40位十六进制字符串或64位六进制字符串。
本地路径
输入证书文件和密钥文件在设备上的存储路径,只允许字母、数字、下划线(_)和斜线(/),以/开头并且以.pem或.crt结尾。
自动升级
可选,开启后节点将自动升级系统应用模块。
注意:升级过程中可能导致节点数据上传中断。
- 填写配置节点数据信息后,单击“立即创建”。
图2 配置节点数据
表2 专业版节点信息 参数名称
说明
数据存储路径
默认(允许修改存储路径)。
监控运维
默认勾选“监控运维工具”。
$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_omagent应用,且版本不低于1-1-15-xxx。
- 应用日志需遵循如下规范打印,以便进行过滤:
- 日志级别标识需打印为(大小写均可):trace、debug、info、warn、error、fatal。
- 每条日志消息以YYYY-MM-DD日期格式作为前缀。
说明:专业版(部署类型为Docker)和基础版节点只涉及日志级别这一个参数,其他参数只对专业版(部署类型为KubeEdge)有效 。
离线缓存配置
可对离线节点上报的数据进行缓存,定义缓存周期(可配置为不过期)跟缓存大小、上报的优先级、路由转发是否开启离线缓存。仅当上报优先级为“按时间顺序”时支持路由转发开启离线缓存。
可靠性配置
可靠性级别分为“中”和“高”2种。中级别:当应用上报属性和点位的频率超过流控值时,超过部分会被丢弃;高级别:当应用上报属性和点位的频率超过流控值时,通过控制模块的发送速度,降低上报频率,报文不会被丢弃。(注意:高可靠性级别的配置需要定制应用的配合,同时会造成性能的损失)。
设备数据格式配置
设备的数据格式:即单网关节点中设备的标准数据格式,包含IoTDA1.0物模型格式和属性平铺格式。IoTDA1.0物模型中包含了设备、服务和属性三层结构,具体参考IoTDA网关子设备属性上报报文格式。属性平铺格式,包含设备、属性2层结构,属性结构可以包含自定义结构的拼接,在json中作为一项平铺展开,具体格式请参考步骤6设备数据格式配置。
须知:属性平铺格式功能,需要edge_hub应用1-1-38-××版本及以上支持
- 弹出如下对话框,您可以“返回节点列表”也可以“继续创建”。
图3 注册成功
安装部署节点前,请确认机器的IP转发已开启并且已开启自启动,以及7883和8943端口开放。其中,IP转发规则配置如下:
图4 IP转发规则配置
- 检查机器ip_forward in/proc文件系统的值。
cat /proc/sys/net/ipv4/ip_forward
若值等于0,则需要添加配置IP转发规则。
- 检查配置文件/etc/sysctl.conf是否包含net.ipv4.ip_forward = 1。
如果配置文件中没有net.ipv4.ip_forward参数项,请新增一行net.ipv4.ip_forward = 1。
vim /etc/sysctl.conf
按“i”进入编辑模式,修改完成后按“Esc”退出编辑模式,然后按“Shift”+“;”组合键,输入wq并回车,保存修改并退出。
- 重新加载此文件的值。
sysctl -p
- 检查7883和8943端口是否开放,如果是华为云服务器,请参考:安全组。
- 检查机器ip_forward in/proc文件系统的值。
安装专业版节点
- 在“节点管理”的节点列表选择您需要安装的节点,单击右侧“安装”,获得提示。
图5 安装
- 选择支持架构和安装目录,然后单击复制安装命令,使用SSH工具以root用户登录边缘节点服务器后台系统,执行安装命令。
图6 提示
安装命令的选择需要与购买的ecs的架构保持一致。
图7 执行安装
图8 安装命令执行成功
- 单击“我知道了”,等待边缘节点的状态变为“在线”,表示该节点已安装并连接成功。
- 您可以单击“节点名称”,查看该节点详细信息,关于节点详情描述可参见节点概览。