安装专业版节点异常如何处理？

2.2.1 执行安装命令下载obs包失败

1. 域名解析失败，无法建立连接。请确认自己的主机的网络是否能够访问一些特定域名，检查域名服务器地址是否正确；若自身没有配置域名解析，或者不知道域名服务器地址，需要将下列用到的域名配置对应的hosts解析。

   北京四需要验证的域名：

   ioe-installer.obs.cn-north-4.myhwclouds.com;

   swr.cn-north-4.myhuaweicloud.com;

   iot-mqtts.cn-north-4.myhuaweicloud.com;

   iotedge-south.cn-north-4.myhuaweicloud.com

2. 出现connected 说明网络没有问题，请求资源出现403错误，请确认当前执行的命令是否过期，在节点列表->选择安装，重新获取安装命令。
3. 出现404 说明资源不存在，需确认下载的安装包是否在对应的OBS中存在，请联系华为工程师。

2.2.2 执行安装脚本阶段，执行edgeInstaller失败。

1. 现象一：机器之前安装过边缘节点。

   

   解决办法：执行卸载命令（sh /opt/IoTEdge-Installer/uninstall.sh），卸载之前安装过的节点后，再次执行安装命令。

2. 现象二：cannot execute binary file, 安装进程和机器架构不匹配，导致二进制进程包不能运行。

   

   导致此问题原因可能是：在创建节点后获取安装命令选择的架构与机器本身不匹配。

   解决办法：

   • 1. 执行：sh /opt/IoTEdge-Installer/uninstall.sh
   • 2. 在节点列表->安装->选择和机器匹配的架构，重新获取安装命令，在机器上执行安装命令。

2.2.3 执行安装脚本阶段，注册节点失败， registerNode ERROR。

1. 现象一：注册节点时调用接口 connection time out.

   

   访问南向域名（iotedge-south.cn-north-4.myhuaweicloud.com）连接超时，可能原因：

   • 安装边缘节点机器DNS服务器配置错误，域名解析失败，解决方案参照：2.2.1小节第一点。
   • 边缘节点机器所在环境为内网环境无法访问公网ip，解决方法：在北京四购买ECS安装边缘节点。
2. 现象二：调用接口注册节点失败。

   

   根据error_code和error_msg确定失败原因：

   • 节点不存在("error_code":"IoTEdge.02100305","error_msg":"The edge node does not existed.")

     可能原因：复制了错误的安装命令，确认安装命令中的节点id是否在节点列表中存在。

   • 验证码不正确("error_code":"IoTEdge.02100206","error_msg":"The verifyCode is not right.")

     可能原因：

     • 安装命令过期（返回console节点列表，节点状态为未安装）

       解决方法：

       1. 执行：sh /opt/IoTEdge-Installer/uninstall.sh
       2. 在节点列表->安装->重新获取安装命令，在机器上执行安装命令。
     • 安装命令中验证码已经使用过了（返回console节点列表，节点状态为已安装/在线）

       解决方法：

       1. 机器执行：sh /opt/IoTEdge-Installer/uninstall.sh
       2. console上删除原节点。
       3. console上新建一个边缘节点->获取安装命令，在机器上执行安装命令。

2.2.4 拉取镜像失败。

现象：pullImage 失败，解决办法：

1. 执行命令`docker images`查看是否有成功拉取镜像。
2. 若未拉取镜像，请尝试手动拉取一个公开镜像，例如拉取系统应用$edge-agent的镜像。

   应用管理->搜索应用名称(edge_agent)->查看应用

   

   选择应用版本->获取镜像地址。

   

   在边缘节点机器上执行 docker pull [imageurl] ;

   例如：docker pull swr.cn-north-4.myhuaweicloud.com/huawei-iot-edge/edgeagent_x86_64:0.3.072.20220901191300

3. 若拉取连接失败，请自行检查网络是否正常，域名(swr.cn-north-4.myhuaweicloud.com)是否可以解析成功。
4. 若拉取失败并提示异常如`x509: certificate has expired or is not yet valid`，可能是边缘节点机器的本地系统时间错误导致。输入`date`命令确定机器本地时间是否正确；若本地时间错误，可尝试使用ntp同步系统时间（输入命令`ntp date cn.pool.ntp.org`）。

2.2.5 创建容器失败，connect default network error.

可能原因：机器不支持ipv6，创建网桥失败。

解决方法：手动创建ipv4网桥

1. docker network create iot-edge-bridge --subnet=172.20.0.0/24 --gateway=172.20.0.1
2. 机器执行：sh /opt/IoTEdge-Installer/uninstall.sh
3. console上删除原节点。
4. console上新建一个边缘节点->获取安装命令，在机器上执行安装命令。