主备配置

使用约束

1. 主备配置时，所绑定的硬件网关上的网卡，需要在同一个网络内，保证心跳正常。
2. 主备网关之间需要设置正确的iptables，防止心跳网络异常。
3. 建议排查防火墙设置，如果防火墙没有关闭需要增加vrrp放通策略。
4. 专业版kubeEdge部署类型的节点不支持主备配置。
5. 如果需要删除主备配置，建议先在后安装的备主机上进行卸载操作(执行卸载命令 sh /opt/IoTEdge-Installer/uninstall.sh)，然后删除主备配置，保留第一个安装的主机。如果后安装的备主机如果没有进行卸载操作，删除主备配置默认会将应用停止掉，影响该节点的运行。
6. 设置错误的网卡名称会导致模块edge-keepalive工作在故障状态，导致主备不能够正常工作。
7. 当前edge-keepalive升级会导致主备切换，所以不建议对edge-keepalive进行升级操作。
8. 主备情况下，主节点主机状态必须离线才支持重装，节点不一定离线。
9. 备节点离线才支持重装。备节点重装时，主节点必须在线。
10. 主备情况下，主节点重装不支持修改设备密码以及设置验证码，只能后台随机生成。
11. 主备切换时长（切换成功并且业务恢复）与网关上安装的应用数量、应用启动时间、点位数有关。
12. 在主备切换期间，没有办法处理数据，数据是丢失的。

部署应用

1. 选择您的边缘节点，单击“节点名称”进入节点详情页。
2. 在左侧导航栏选择“应用模块 > 模块管理”页签，单击左上角“部署应用”，部署$edge_keepalive应用：
   图2 部署应用
   
   • 边缘应用：$edge_keepalive
   • 选择版本：1-1-40-standard-x86（根据当前环境中应用版本为准）

3. 选择左侧导航栏“应用模块 > 模块管理”页签，查看已部署边缘应用。
   图3 模块管理
   

添加主备配置

1. 选择您的边缘节点，单击“节点名称”进入节点详情页。
2. 在左侧导航栏选择“主备配置”单击“主备配置”。
   图4 主备配置
   

3. 信息填写后，单击“确认”。
   图5 网络配置
   

   表1 主备配置

   参数名称	描述
   主网卡名称	表示主节点上虚拟IP所绑定使用的网卡名字，如eth0、eth1等，注意名称不要写错，写错会导致vip绑定失败。
   备网卡名称	表示备节点上虚拟IP所绑定使用的网卡名字，如eth0、eth1等。
   浮动虚拟IP	表示对外提供的一个虚拟IP（IPv4），供设备连接使用，具体虚拟IP按照自身业务规划设定。
   IPv6地址	表示对外提供的一个IPv6地址，供设备连接使用，具体按照自身业务规划设定。

4. 查看ip信息。使用ip a查看主节点ip信息，如果当前设置均没有错误的话，在主节点上机器上已经可以查到已绑定的虚拟IP，例如当前设置的vip为172.30.0.201，主节点绑定的网卡为eth0。
   图6 查看IP信息
   
   

   查看网卡名称可以使用ifconfig查看，如下：

   图7 查看网卡名称
   

安装备节点

1. 选择您的边缘节点，单击“节点名称”进入节点详情页。
2. 在左侧导航栏选择“主备配置”页面获取“获取备节点安装命令”。
   

   主节点和备节点设置绑定的网卡之间网络一定需要能够正常访问，否则会出现主备异常。

   登录边缘节点主备用机器，检查主备机时间偏差，保持在30S以内，否则可能会出现备节点安装失败。

   图8 安装备节点
   

3. 登录边缘节点备用机器，执行安装命令。
   图9 执行安装命令
   

   如下表示备节点安装成功。

   图10 安装成功
   

   备节点默认只运行edge_agent以及edge_keepakive模块，其余模块为created状态。

   图11 运行状态
   

确认当前虚拟ip绑定情况

查看主节点机器，当前主节点eth0网卡绑定了vip，为工作节点。

图12 查看IP信息

查看备节点机器的ip列表，eth0网卡没有绑定vip

图13 查看网卡名称

查看console的主备配置节点，可以看到工作节点为机器 ecs-tjj-01(主机信息后的绿色主标签表示工作节点)

图14 查看主备状态

至此，主备配置已结束。

简单测试

模拟当前工作节点发生故障，不再往备节点发送心跳包。

• 停止主节点sys_edge_keepalive来模拟宕机情况
  图15 模拟宕机
  

  停止后查看应用状态，sys_edge_hub已进入created状态。查看浮动ip情况，发现原主节点vip已移除。

  图16 查看IP信息
  

• 查询看备节点浮动ip和模块运行状态。
  图17 查看运行状态
  

  浮动ip已经绑定到备节点eth0网卡上，且业务模块都在原备节点上正常运行。

• 在console查看主备信息，工作节点已经切换到主机名为ecs-8bc3-0003的备用机器上。
  图18 查看主备状态
  

  至此，简单主备切换测试已经完成。

备节点异常重装

当备节点因为一些异常原因不能够继续使用时，需要更换服务器来继续提供备节点的功能支持，需要进行备节点的重新安装动作。

前提条件：

备节点主机状态已经离线且不会继续进行工作，如下图所示。

手动进行原有异常备节点的卸载动作，以防后续恢复正常后影响当前主备的正常工作。

图19 重装备节点

1. 在主备配置页签，单击备节点“重新安装”字样，获取安装命令。
   

   请确定原有备节点主机状态已经离线且不会继续进行工作。

   图20 获取备节点安装命令
   

2. 登录新的备节点机器，执行备节点的重装命令。
   图21 执行安装命令
   

   如下表示备节点安装成功。

   图22 安装成功
   

3. 查看console界面确认备节点已在线。
   图23 查看主备状态
   

   至此备节点重装完成。

主节点异常重装

当主节点因为一些异常原因不能够继续使用时，需要更换服务器来继续提供主节点的功能支持，需要进行主节点的重新安装动作。

主节点主机状态已经离线且不会继续进行工作，如下图所示。

手动进行原有异常主节点的卸载动作，以防后续恢复正常后影响当前主备的正常工作。

图24 重装主节点

1. 在主备配置页签，单击主节点“重新安装”字样，获取安装命令。
   

   请确定原有主节点主机状态已经离线且不会继续进行工作。

   图25 获取主节点安装命令
   

2. 登录新的主节点机器，执行主节点的重装命令。
   图26 执行安装命令
   

   如下表示主节点安装成功。

   图27 安装成功
   

3. 查看console界面确认主节点已在线。
   图28 查看主备状态
   

   至此，主节点重装完成。