目  录

1 云集群

1.1 云集群配置命令

1.1.1 cloud-cluster auto-merge enable

1.1.2 cloud-cluster auto-update enable

1.1.3 cloud-cluster configuration active

1.1.4 cloud-cluster link-delay

1.1.5 cloud-cluster member

1.1.6 cloud-cluster member renumber

1.1.7 cloud-cluster service-cluster domain

1.1.8 cloud-cluster service-cluster mac-address persistent

1.1.9 cloud-cluster service-cluster mad domain

1.1.10 cluster-link bind interface

1.1.11 cloudcluster-optimize wlan reliable-access

1.1.12 display cloud-cluster

1.1.13 display cloud-cluster configuration

1.1.14 display cloud-cluster service-cluster container

1.1.15 display mad

1.1.16 join-cluster

1.1.17 mad enable

1.1.18 mad exclude interface

1.1.19 mad restore

1.1.20 member-ip

 

1 云集群

1.1  云集群配置命令

1.1.1  cloud-cluster auto-merge enable

cloud-cluster auto-merge enable命令用来开启云集群合并自动重启功能。

undo cloud-cluster auto-merge enable命令用来关闭云集群合并自动重启功能。

【命令】

cloud-cluster auto-merge enable

undo cloud-cluster auto-merge enable

【缺省情况】

云集群合并自动重启功能处于开启状态。即两个云集群合并时，竞选失败方会自动重启加入获胜方云集群。

【视图】

系统视图

【缺省用户角色】

network-admin

【使用指导】

应用场景

云集群合并自动重启功能可以对以下合并方式生效：

·     云集群连接故障恢复后引起的合并。

·     待合并的多个云集群上已经存在合并所需的云集群端口绑定配置，在配置激活时触发的云集群自动重启合并。

工作机制

两个云集群合并时，竞选失败方需要重启才能加入获胜方云集群。

·     如果没有开启云集群合并自动重启功能，则合并过程中，需要网络管理员登录失败方云集群，并根据系统提示手工重启失败方云集群，失败方云集群才能加入获胜方云集群，完成云集群的合并。

·     开启云集群合并自动重启功能后，竞选失败方云集群会自动重启后加入获胜方云集群，完成云集群的合并。

要使云集群合并自动重启功能正常运行，请在待合并的多台云集群上都开启云集群合并自动重启功能。

【举例】

# 开启云集群合并自动重启功能。

<Sysname> system-view

[Sysname] cloud-cluster auto-merge enable

1.1.2  cloud-cluster auto-update enable

cloud-cluster auto-update enable命令用来开启启动文件自动加载功能。

undo cloud-cluster auto-update enable命令用来关闭启动文件自动加载功能。

【命令】

cloud-cluster auto-update enable

undo cloud-cluster auto-update enable

【缺省情况】

启动文件的自动加载功能处于开启状态。

【视图】

系统视图

【缺省用户角色】

network-admin

【使用指导】

工作机制

开启启动文件自动加载功能后，当新加入集群的设备和主设备的软件版本不同时，新加入的设备会自动同步主设备的软件版本，再重新加入集群。

如果未开启启动文件自动加载功能，且新加入集群的设备和主设备的软件版本不同时，新设备可以加入集群。但是因为版本差异，会影响集群中部分功能在新设备上的运行。所以，请保持启动文件自动加载功能处于开启状态。

配置准备

为了能够成功进行自动加载，请确保从设备存储介质上有足够的空闲空间用于存放集群的启动文件。如果从设备存储介质的空闲空间不足，集群将自动删除从设备的当前启动文件并再次尝试加载。如果空闲空间仍然不足，该从设备将无法进行自动加载。此时，需要管理员重启设备，进入从设备的BootWare菜单，删除一些不重要的文件后，再将从设备重新加入集群。

【举例】

# 开启启动文件自动加载功能。

<Sysname> system-view

[Sysname] cloud-cluster auto-update enable

1.1.3  cloud-cluster configuration active

cloud-cluster configuration active命令用来确认激活云集群配置。

【命令】

cloud-cluster configuration active

【视图】

系统视图

【缺省用户角色】

network-admin

【使用指导】

本命令仅在集群运行模式下支持配置。

应用场景

修改云集群的配置后，必须通过该本命令激活配置，新配置才会生效。

配置建议

初始状态建议先做好整个集群的规划，在所有成员设备上完成集群的相关配置（例如成员编号、成员IP、成员角色、要加入的集群成员IP和绑定集群端口），并将集群物理线缆连接好后，再执行本命令，使得设备能够直接组建成集群。

配置注意事项

配置本命令是否会自动重启云集群，请以设备提示信息为准。

【举例】

# 集群成员配置修改后，确认激活云集群配置。（本命令显示信息中的集群配置与当前配置有关，请以设备实际情况为准）

<Sysname> system-view

[Sysname] cloud-cluster member 1 renumber 2

[Sysname] cloud-cluster configuration active

New cluster configuration:

  cloud-cluster service-cluster domain 1

  cloud-cluster hello cloud-timeout 7 service-timeout 10

  cloud-cluster member 2

    role manager-worker

    cluster-link bind interface GigabitEthernet2/0/2

    cluster-link bind interface GigabitEthernet2/0/3

The system will activate and save the configuration, and it might do a restart.Continue? [Y/N]:y

The current configuration will be written to the device. Are you sure? [Y/N]:y

Please input the file name(*.cfg)[flash:/startup.cfg]

(To leave the existing filename unchanged, press the enter key):flash:/startup.cfg exists, overwrite? [Y/N]:y

Validating file. Please wait...

Saved the current configuration to mainboard device successfully.

【相关命令】

·     cloud-cluster member remember

·     cloud-cluster service-cluster domain

·     cluster-link bind interface

·     join cluster

·     member-ip

1.1.4  cloud-cluster link-delay

cloud-cluster link-delay命令用来配置容器集群链路故障的延迟上报时间。

undo cloud-cluster link-delay命令用来恢复缺省情况。

【命令】

cloud-cluster link-delay interval

undo cloud-cluster link-delay

【缺省情况】

容器集群链路故障的延迟上报时间取值为0，代表不延迟。

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

interval：表示容器集群链路故障的延迟上报时间，本参数的取值范围为0~3000，单位为毫秒。取值为0时，表示不延迟。

【使用指导】

本命令只在集群模式下支持配置。

应用场景

该功能用于避免因容器集群链路状态在短时间内频繁改变，导致集群不停的分裂、合并，给系统带来额外的开销。

工作机制

容器集群链路有两种物理连接状态：up和down。如果容器集群链路状态从down变为up，链路层会立即向系统报告，不受本命令的影响。配置本命令后，如果在集群链路故障的延迟上报时间内，集群接口状态从up变成down，则不产生接口状态变化事件，系统将不感知接口状态变化。经过集群链路故障的延迟上报时间后：

·     如果接口状态仍然为down，才产生接口状态变化事件，系统会进行对应的处理。

·     如果接口状态恢复到up，则系统无需处理。设备将不会感知延迟上报时间内集群链路的状态震荡。

注意事项

本命令配置后会立即生效，不需要配置通过cloud-cluster configuration active命令来确认激活。

【举例】

# 配置容器集群链路故障延迟上报时间为300毫秒。

<Sysname> system-view

[Sysname] cloud-cluster link-delay 300

1.1.5  cloud-cluster member

cloud-cluster member命令用来进入cloud-cluster member视图。

undo cloud-cluster member命令用来清除cloud-cluster member视图下的所有配置。

【命令】

cloud-cluster member member-id

undo cloud-cluster member member-id

【缺省情况】

设备的成员编号为1。

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

member-id：表示设备在集群中的成员编号，取值范围为1~2。

【使用指导】

应用场景

集群系统使用成员编号来唯一标识一台成员设备，每台成员设备需要使用不同的成员编号。

工作机制

（集群运行模式）

使用本命令只能进入指定的已存在的cloud-cluster member视图，如需修改设备的成员编号，请使用cloud-cluster member renumber命令。

【举例】

# 进入cloud-cluster member 1配置视图。

<Sysname> system-view

[Sysname] cloud-cluster member 1

[Sysname-ccluster-member-1]

【相关命令】

·     cloud-cluster member renumber

·     cloud-cluster configuration active

1.1.6  cloud-cluster member renumber

cloud-cluster member renumber命令用来修改设备的成员编号。

undo cloud-cluster member renumber命令用来取消设备成员编号的修改。

【命令】

cloud-cluster member member-id renumber new-member-id

undo cloud-cluster member member-id renumber

【缺省情况】

设备的缺省成员编号为1。

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

member-id：表示设备在集群中的成员编号，取值范围为1~2。

new-member-id：表示修改后的成员编号，取值范围为1~2。

【使用指导】

本命令仅在集群运行模式下支持配置。

应用场景

当新加入的设备的编号和集群中已有成员设备的编号相同时，设备不能加入集群。此时，请使用该命令修改设备的成员编号后，重新加入集群。

注意事项

该命令可以将member-id配置视图下的配置继承到new-member-id配置视图下，并且需要执行配置保存并重启member-id标志的设备才能生效。

undo cloud-cluster member renumber命令只能取消本次运行过程中配置的成员编号。设备重启后，设备的成员编号就变为new-member-id，不能再取消，只能重新配置。

使用本命令修改配置后，需要执行cloud-cluster configuration active命令来激活云集群的新配置，本命令才会和其它云集群的新配置一起生效。

【举例】

# 将设备1的成员编号修改为2。

<Sysname> system-view

[Sysname] cloud-cluster member 1 renumber 2

This command will take effect after the cloud cluster configuration is activated. The command might result in configuration change or loss when it takes effect. Continue? [Y/N]:y

[Sysname]

【相关命令】

·     cloud-cluster configuration active

·     cloud-cluster member

1.1.7  cloud-cluster service-cluster domain

cloud-cluster service-cluster domain命令用来配置容器集群的域编号。

undo cloud-cluster service-cluster domain用来恢复缺省情况。

【命令】

cloud-cluster service-cluster domain domain-id

undo cloud-cluster service-cluster domain

【缺省情况】

容器集群的域编号为0。

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

domain-id：容器集群的域编号，取值范围为0～4294967295。

【使用指导】

应用场景

为了适应各种组网应用，同一个云集群网络里可以部署多个容器集群，多个容器集群之间使用不同的域编号以示区别。请按照网络规划来修改容器集群域编号，不要随意修改。同一容器集群中所有成员设备的域编号必须配置为相同值。

注意事项

使用本命令修改配置后，需要执行cloud-cluster configuration active命令来激活云集群的新配置，本命令才会和其它云集群的新配置一起生效。

【举例】

# 配置容器集群的域编号为1。

<Sysname> system-view

[Sysname] cloud-cluster service-cluster domain 1

The configuration will take effect at the next startup.

Operation succeeded.

【相关命令】

·     cloud-cluster configuration active

1.1.8  cloud-cluster service-cluster mac-address persistent

cloud-cluster service-cluster mac-address persistent命令用来配置容器集群的桥MAC地址的保留时间。

undo cloud-cluster service-cluster mac-address persistent命令用来配置容器集群的桥MAC地址不保留，立即变化。

【命令】

cloud-cluster service-cluster mac-address persistent { always | timer }

undo cloud-cluster service-cluster mac-address persistent

【缺省情况】

容器集群的桥MAC地址永久保留。

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

always：用来配置容器集群的桥MAC地址永久保留，不改变。

timer：用来配置容器集群的桥MAC地址保留时间，该保留时间为固定值6分钟。

【使用指导】

本命令只在集群模式下支持配置。

应用场景

容器集群使用Master设备的桥MAC作为容器集群的桥MAC。Master设备变更会导致容器集群的桥MAC的变化。而在一些协议中（例如STP）会用系统的桥MAC来标识一台设备，桥MAC变化可能会导致流量短时间中断。您可以使用本命令配置容器集群桥MAC地址保留不变或者保留指定时间不变。

工作机制

集群桥MAC保留时间是指在桥MAC拥有者离开集群后，集群可以继续使用当前桥MAC的时间：

·     如果配置了桥MAC地址保留时间为固定值6分钟，则当桥MAC拥有者离开集群时，集群桥MAC地址在6分钟内不变化。如果桥MAC拥有者在6分钟内重新又加入集群，则集群桥MAC地址不会变化。如果6分钟后桥MAC拥有者没有回到集群，则会使用集群中当前主设备的桥MAC地址作为集群桥MAC地址。

·     如果配置了桥MAC地址永久保留，则无论桥MAC拥有者是否离开集群，集群桥MAC地址始终保持不变。

·     如果配置了桥MAC地址不保留，立即变化，当桥MAC拥有者离开集群时，系统立即会使用当前集群中主设备的桥MAC地址做集群桥MAC地址。

注意事项

如果两台物理设备的桥MAC相同，则它们不能合并为一个集群。容器集群的桥MAC不受此限制，只要成员设备自身桥MAC唯一即可。

当集群设备上存在跨成员设备的聚合链路时，请不要使用undo cloud-cluster service-cluster mac-address persistent命令配置集群的桥MAC立即变化，否则可能会导致流量中断。

集群模式下配置本命令后会立即生效，不需要配置通过cloud-cluster configuration active命令来确认激活。

【举例】

# 配置容器集群的桥MAC地址永久保留。

<Sysname> system-view

[Sysname] cloud-cluster service-cluster mac-address persistent always

1.1.9  cloud-cluster service-cluster mad domain

cloud-cluster service-cluster mad domain命令用来配置容器集群的MAD检测域编号。

undo cloud-cluster service-cluster mad domain用来恢复缺省情况。

【命令】

cloud-cluster service-cluster mad domain domain-id

undo cloud-cluster service-cluster mad domain

【缺省情况】

容器集群的MAD检测域编号为0。

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

domain-id：容器集群的域编号，取值范围为0～4294967295。

【使用指导】

工作机制

容器集群的MAD检测域编号只用于MAD检测，云集群中的所有成员设备都共用这个域编号。容器在接收到MAD检测报文后，会比较报文中的MAD检测域编号和本机配置的编号，只有当两者相同时，才会进行处理。同一云集群中的容器，MAD检测域编号必须配置为相同值，不同的云集群需要使用不同的MAD检测域编号进行区分，否则会导致MAD检测功能异常。

可以使用cloud-cluster service-cluster mad domain、mad enable命令来修改容器集群的MAD检测域编号，最新的配置将会生效。请按照网络规划配置容器集群的MAD检测域编号，不应随意修改。

注意事项

本命令只在集群模式下支持。

配置cloud-cluster service-cluster mad domain命令并保存配置后，切换到独立模式，该配置将失效。即便之后再切换回集群模式，仍需重新配置。

【举例】

# 配置容器集群的MAD检测域编号为1。

<Sysname> system-view

[Sysname] cloud-cluster service-cluster mad domain 1

【相关命令】

·     cloud-cluster enable

·     cloud-cluster configuration active

1.1.10  cluster-link bind interface

cluster-link bind interface命令用来将容器集群链路和物理接口绑定。

undo cluster-link bind interface命令用来取消容器集群链路和物理接口的绑定。

【命令】

cluster-link [ control | data ] bind interface interface-type interface-number

undo cluster-link [ control | data ] bind interface interface-type interface-number

【缺省情况】

容器集群链路和物理接口未绑定。

【视图】

cloud-cluster member视图

【缺省用户角色】

network-admin

【参数】

[ control | data ]：配置容器集群链路。如果不指定该参数，则表示该链路可同时作为控制通道和数据通道

·     control：为容器集群控制通道绑定物理端口，容器集群控制通道用于云集群成员之间的传递集群协议报文。

·     data：为容器集群数据通道绑定物理端口，容器集群数据通道用于云集群成员之间转发业务报文。

interface-type interface-number：表示物理端口的类型和编号。各型号设备上可用作集群物理端口的端口请参见产品的相关手册。

【使用指导】

 

应用场景

物理集群基于成员IP进行三层通信，只要成员设备的成员IP之间路由可达，就能交互物理集群协议报文，维护物理集群的运行。

容器集群需要使用本命令绑定物理接口，一个容器集群链路必须至少有一个控制通道和一个数据通道。容器集群使用本命令绑定的接口交互容器集群控制报文，以及跨设备转发的数据报文。

工作机制

本命令执行时集群模块会自动关闭指定端口（相当于执行shutdown命令），将绑定的物理端口切换成集群物理端口，切换成功后，再自动开启该端口（相当于执行undo shutdown命令），端口下的配置会恢复到缺省情况。

多次执行本命令，可以为控制通道或数据通道绑定多个物理接口，多个物理接口之间会负载分担转发报文。

注意事项

配置本命令后，如果需要修改集群物理端口对应的链路的类型，必须先取消绑定关系，再配置。

使用本命令修改配置后，需要执行cloud-cluster configuration active命令来激活云集群的新配置，本命令才会和其它云集群的新配置一起生效。

【举例】

# 将集群控制通道、数据通道和物理接口GigabitEthernet1/0/1绑定。

<Sysname> system-view

[Sysname] cloud-cluster member 1

[Sysname-ccluster-member-1] cluster-link bind interface gigabitethernet 1/0/1

The system will shut down and then bring up the interface. Continue? [Y/N]: y

# 集群模式下，将集群链路的控制通道和数据通道取消绑定。

<Sysname> system-view

[Sysname] cloud-clustermember 1

[Sysname-ccluster-member-1] undo cluster-link bind interface GigabitEthernet 1/0/1

Be cautious. If this is the only link in the cluster control channel, the unbind operation will cause the cloud cluster to split. Continue anyway? [Y/N]: y

【相关命令】

·     cloud-cluster configuration active

·     cloud-cluster member

1.1.11  cloudcluster-optimize wlan reliable-access

cloudcluster-optimize wlan reliable-access命令用来开启云集群WLAN接入优化功能。

undo cloudcluster-optimize wlan reliable-access命令用来关闭云集群WLAN接入优化功能。

【命令】

cloudcluster-optimize wlan reliable-access

undo cloudcluster-optimize wlan reliable-access

【缺省情况】

云集群WLAN接入优化功能处于开启状态。

【视图】

系统视图

【缺省用户角色】

network-admin

【使用指导】

开启该功能后，在保障AP及客户端接入的同时，设备会加速完成新的成员设备加入云集群和云集群成员角色切换过程。

【举例】

# 开启云集群WLAN接入优化功能。

<Sysname> system-view

[Sysname] cloudcluster-optimize wlan reliable-access

1.1.12  display cloud-cluster

display cloud-cluster命令用来显示物理集群的相关信息。

【命令】

display cloud-cluster [ member member-id ] [ verbose ]

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

member member-id：显示指定成员设备的物理集群相关信息。member-id表示设备在集群中的成员编号，取值范围为1~2。

verbose：显示物理集群的详细信息。不指定该参数，显示物理集群的简要信息。

【使用指导】

本命令仅在集群模式下支持配置。

【举例】

# 显示物理集群的简要信息。

<Sysname> display cloud-cluster

Manager list:

Member ID    Role        Member IP     State       Heartbeat(ms)

1            Leader      1.1.1.1       online      0

2            Follower    1.1.1.2       online      700

 

Worker list:

Member ID    State       Heartbeat(ms)    Joined at

1            online      100              2023/1/2 22:10:34

2            online      200              2023/1/2 22:10:34

# 显示物理集群的详细信息。

<Sysname> display cloud-cluster verbose

Member ID         : 1

  Role            : Manager(Leader)

  Member IP       : 1.1.1.1/24

  Join-cluster IP : 1.1.1.1

  Heartbeat(ms)   : 700

  Listen port     : 3536

  Joined at       : 2023/1/2 22:10:34

  Container ID    : 1

    Container UUID: 0cfadd7138c6

    Created at    : 2023/1/2 22:10:34

    Image         : cd934004f53f

    Name          : cluster1

    Location      : 1

    State         : Normal

Member ID         : 2

  Role            : Manager(Follower)

  Member IP       : 1.1.1.2/24

  Join-cluster IP : 1.1.1.1

  Heartbeat(ms)   : 600

  Listen port     : 3536

  Joined at       : 2023/1/2 22:10:34

  Container ID    : 2

    Container UUID: df687a7d4dfa

    Created at    : 2023/1/2 22:10:34

    Image         : cd934004f53f

    Name          : cluster2

    Location      : 2

    State         ：Normal

表1-1 display cloud-cluster命令显示信息描述表

字段	描述
Manager list	Manager简要信息列表
Worker list	Worker简要信息列表
Member ID	集群成员编号，用于标识物理节点
Role	该物理设备在集群中的角色，取值为： ·     Manager(Leader)：表示既作为Leader管理者运行，也作为Worker工作者运行 ·     Manager(Follower)：表示既作为Follower管理者运行，也作为Worker工作者运行 ·     Manager(Candidate)：表示设备处于选举状态，角色尚未确定 ·     Worker：表示仅作为工作者运行
Member IP	集群成员IP地址
Join IP	加入集群时指定的某个成员设备的成员IP地址
Heartbeat(ms)	上一次和集群成员心跳交互到现在的时间，单位为毫秒
Listen port	集群协议报文监听端口，用于集群成员之间协议报文的交互
Joined at	成员加入集群的时间，显示格式为： ·     YYYY-MM-DD HH:MM:SS ·     YYYY-MM-DD HH:MM:SS UTC±HH:MM DST ·     YYYY-MM-DD HH:MM:SS UTC±HH:MM ·     YYYY-MM-DD HH:MM:SS DST UTC±HH:MM表示通过clock timezone命令配置了时区，DST表示通过clock summer-time命令配置了夏令时
Container ID	集群成员设备上运行的容器编号
Container UUID	容器创建时Linux系统分配的、供内部使用编号
Created at	容器创建时间，显示格式为： ·     YYYY-MM-DD HH:MM:SS ·     YYYY-MM-DD HH:MM:SS UTC±HH:MM DST ·     YYYY-MM-DD HH:MM:SS UTC±HH:MM ·     YYYY-MM-DD HH:MM:SS DST UTC±HH:MM表示通过clock timezone命令配置了时区，DST表示通过clock summer-time命令配置了夏令时
Image	启动容器的镜像名称
Name	容器的名称
Location	容器所在的位置，当前取值为成员编号
State	容器工作状态，取值包括： ·     Normal：正常工作状态 ·     Mad：双主MAD状态 ·     Isolate：关键指标异常，容器处于隔离状态

 

【相关命令】

·     cloud-cluster member

1.1.13  display cloud-cluster configuration

display cloud-cluster configuration命令用来显示集群的配置信息。

【命令】

display cloud-cluster configuration [ member member-id ]

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

member member-id：集群成员编号，用于标识物理节点，取值范围为1~2。不指定该参数时，则表示显示所有在位的成员信息。

【举例】

# 显示集群的配置信息。

<Sysname> display cloud-cluster configuration

Cloud-cluster: Enable

Service cluster domain ID: 1

Service cluster mad domain ID: 0

MAC persistent for service cluster: Always

Cloud-cluster hello timeout: 7 s

Service-cluster hello timeout: 10 s

Cloud-cluster auto merge: Enable

Cloud-cluster auto update: Enable

Cloud-cluster link-delay: 0 ms

 

Member ID: 1

  Role: Manager,Worker

  Member IP: 1.1.1.1/24

  Join-cluster IP: 1.1.1.1

  Cluster-link interfaces:

    Control links: GigabitEthernet1/0/1

                   GigabitEthernet1/0/2

    Data links   : GigabitEthernet1/0/1

                   GigabitEthernet1/0/2

表1-2 display cloud-cluster configuration命令显示信息描述表

字段	描述
Cloud-cluster	物理集群模式使能情况，取值包括： ·     Enable：集群模式
Member ID	集群成员编号，用于标识物理节点
Role	物理集群角色，取值包括： ·     Manager：物理集群的管理者 ·     Worker：物理集群的工作者
Member IP	集群成员IP地址
Join-cluster IP	预加入的集群内的成员IP地址
Cluster-link interfaces	为成员设备组成集群绑定的物理端口
Control links	作为控制通道的物理端口
Data links	作为数据通道的物理端口
Service cluster domain ID	容器集群域编号，用于区分不同的容器集群。只有容器集群域编号相同的容器才能加入同一个集群
Service cluster mad domain ID	容器集群MAD检测域编号，用于区分不同的MAD检测域。如果设备收到的MAD检测报文中的MAD检测域编号和本地配置的MAD检测域不同，则不会处理该MAD检测报文
MAC persistent for service cluster	容器集群桥MAC地址的保留时间，本字段只在集群模式下支持显示，可能取值为： ·     None：桥MAC地址不保留，立即变化 ·     Always：桥MAC地址永久保留 ·     Timer：桥MAC地址保留时间为6分钟
Cloud-cluster hello timeout	显示物理集群成员之间Hello报文超时时间的值，单位为秒
Service-cluster hello timeout	显示容器集群成员之间Hello报文超时时间的值，单位为秒
Cloud-cluster auto merge	自动合并功能的开启情况，取值包括： ·     Enable：已开启 ·     Disable：未开启
Cloud-cluster auto update	成员容器软件包自动升级功能的开启情况，取值包括： ·     Enable：已开启 ·     Disable：未开启
Cloud-cluster link-delay	容器集群链路故障的延迟上报时间，单位为毫秒

 

1.1.14  display cloud-cluster service-cluster container

display cloud-cluster service-cluster container命令用来显示容器集群内容器的相关信息。

【命令】

display cloud-cluster service-cluster container [ container-id ] [ verbose ]

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

container-id：显示指定容器的相关信息。container-id表示容器的编号，取值范围为1~2。不指定该参数时，显示容器集群中所有容器的信息。

verbose：显示容器成员的详细信息。不指定该参数，显示容器的简要信息。

【使用指导】

本命令仅在集群模式下使用。

【举例】

# 显示容器集群内所有容器的简要信息。

<Sysname> display cloud-cluster service-cluster container

Container ID     Slot ID       Member ID      Role        Status

*+1              1             1              Master      Online

  2              2             2              Standby     Online

---------------------------------------------------------------

 

 * indicates the device is the master.

 + indicates the device through which the user logs in.

# 显示容器集群内所有容器的详细信息。

<Sysname> display cloud-cluster service-cluster container verbose

Service-cluster name: System

  Domain ID         : 0

  Cluster Bridge MAC: 00e0-fc00-1001

  Container ID   : 1

    Member ID    : 1

    Slot ID      : 1

    Health       : Healthy(100)

    Bridge MAC   : 00e0-fc00-1001

    CPU MAC      : 00f0-fc00-1001

    Control links: GigabitEthernet1/0/1(UP)

                   GigabitEthernet1/0/2(DOWN)

    Data links   : GigabitEthernet1/0/3(UP)

    Cluster connection : Reachable

    Status       : Online

    Self hello timeout (ms)  : N/A

    Master hello timeout (ms): N/A

表1-3 display cloud命令显示信息描述表

字段	描述
Service-cluster name	容器集群名称，目前只支持System
Domain ID	容器集群域编号，用于区分不同的容器集群
Cluster Bridge MAC	集群的桥MAC地址
Container ID	创建容器时，集群分配的容器ID
Member ID	集群成员编号，用于标识物理节点 ·     如果编号前带“*”，表示该设备是主设备 ·     如果编号前带“+”，表示该设备是用户当前登录的、正在操作的设备
Slot ID	全局槽号
Role	容器成员角色。取值为： ·     Master：表示主用主控板 ·     Standby：表示备用主控板 ·     IO：表示接口板
Health	系统的健康状态。取值为： ·     Healthy(100)：表示系统健康 ·     Unhealthy(n)：表示系统不健康，n表示健康值，取值越大越不健康
Bridge MAC	成员的桥MAC地址
CPU MAC	成员的CPU MAC地址
Control links	显示控制通道的物理端口，并提示接口物理层UP/DOWN状态
Data links	显示数据通道的物理端口，并提示接口物理层UP/DOWN状态
Cluster connection	容器内的集群Agent服务与宿主机上集群Manager的链接正常，取值为： ·     Reachable：链接正常 ·     Unreachable：链接异常
Status	容器的运行状态，取值为： ·     Online：表示在线状态 ·     Offline：表示离线状态 ·     MAD down：表示被禁用状态
Self hello timeout (ms)	容器会按周期给Master发送Hello报文，本字段表示容器给Master发送Hello报文的超时剩余时间，单位为毫秒 Master容器下该字段的取值为N/A
Master hello timeout (ms)	Master会按周期给容器发送Hello报文，本字段表示当前容器接收到Master的Hello报文的超时剩余时间，单位为毫秒 Master容器下该字段的取值为N/A
* indicates the device is the master	“*”表示该设备是主设备
+ indicates the device through which the user logs in	“+”表示该设备是用户当前登录的、正在操作的设备

 

【相关命令】

·     cloud-cluster member

1.1.15  display mad

display mad命令用来显示MAD配置信息。

【命令】

display mad [ verbose ]

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

verbose：显示MAD详细配置信息。如果不指定该参数，则显示简要配置信息。

【举例】

# 显示MAD简要配置信息。

<Sysname> display mad

MAD LACP enabled.

# 显示MAD详细配置信息。

<Sysname> display mad verbose

Multi-active recovery state: No

Excluded ports (user-configured):

  Bridge-Aggregation4

  Vlan-interface999

Excluded ports (system-configured):

  Service-cluster physical interfaces:

    Ten-GigabitEthernet1/0/1

    Ten-GigabitEthernet1/0/2

    Ten-GigabitEthernet2/0/1

    Ten-GigabitEthernet2/0/2

  Member interfaces of excluded interface Bridge-Aggregation 4:

    Ten-GigabitEthernet1/0/4

    Ten-GigabitEthernet2/0/4

MAD LACP enabled interface: Bridge-Aggregation 1

  MAD status                 : Normal

  Member ID       Port                       MAD status

  1               Ten-GigabitEthernet1/0/5       Normal

  2               Ten-GigabitEthernet2/0/5       Normal

表1-4 display mad命令显示信息描述表

字段	描述
MAD LACP enabled.	LACP MAD检测功能已开启 如本功能未开启，则显示为MAD LACP disabled.
Multi-active recovery state	当前容器集群是否被MAD功能设置为Recovery状态： ·     Yes：容器集群处于Recovery状态，当一个容器集群分裂为多个容器集群后，将发生多Active冲突，选举失败的容器集群进入Recovery状态，该状态下的容器集群会自动关闭所有非保留的业务接口 ·     No：容器集群没有处于Recovery状态
Excluded ports (user-configured)	用户配置的保留接口
Excluded ports (system-configured)	系统默认保留的接口（不需要用户配置，自动保留） ·     Service-cluster physical interfaces：容器集群物理端口 ·     Member interfaces of excluded interface Bridge-Aggregation interface-number：系统自动保留的二层聚合接口的成员接口。当用户将二层聚合接口配置为保留接口时，其成员接口自动为系统保留接口 ·     Member interfaces of excluded interface Route-Aggregation interface-number：系统自动保留的三层聚合接口的成员接口。当用户将三层聚合接口配置为保留接口时，其成员接口自动为系统保留接口
MAD LACP enabled interface	开启了LACP MAD检测功能的接口 如LACP MAD检测功能未开启，则显示为MAD LACP disabled.
MAD status	LACP MAD的工作状态： ·     Normal：LACP MAD工作状态正常 ·     Faulty：LACP MAD工作状态不正常，需要检查接口状态、中间设备是否支持LACP MAD、以及聚合接口的成员端口是否分布到所有成员设备上
Member ID Port MAD status	LACP MAD详细信息： ·     Member ID：容器集群中的成员设备编号 ·     Port：开启了LACP MAD的聚合组中的成员端口 ·     MAD status：该成员端口的LACP MAD工作状态，Normal表示正常，Faulty表示不正常

 

1.1.16  join-cluster

join-cluster命令用来配置集群IP地址。

undo join-cluster命令用来取消集群IP地址配置，取消集群IP地址配置后，设备将离开云集群。

【命令】

join-cluster ip ipv4-address

undo join-cluster

【缺省情况】

未配置集群IP地址。未配置本命令的设备激活云集群配置后，会选择自己作为Leader。

【视图】

cloud-cluster member视图

【缺省用户角色】

network-admin

【参数】

ip ipv4-address：表示欲加入的集群中任意成员设备的成员IP地址。

【使用指导】

应用场景

您需要在物理集群的所有成员设备上配置本命令，用于搭建物理集群。如果您想让某台设备作为物理集群的Leader，可以不配置本命令，或者将集群IP地址配置为本设备的成员IP地址。该设备会以Leader身份自动加入自己组建的集群，其它Follower设备上均需配置本命令。

工作机制

搭建集群时，请先完成集群规划，哪台设备作为Leader，以及集群内部通信使用的网段。然后将Leader配置完毕后，先启动Leader。其它设备加入集群时：

·     本命令中的IP地址建议指定为Leader的成员IP地址，新设备可直接使用该地址和Leader建立连接，加入集群。

·     如果本命令中的IP地址指定为集群中其它成员设备的成员IP地址，则新设备会将连接建立请求发送给这个IP地址，这个IP地址的成员设备会将请求转发给Leader。新设备和Leader建立连接，加入集群。

如果指定的ip ipv4-address路由不可达，设备将无法加入集群。此时执行display cloud-cluster命令无集群信息显示，本设备上的容器会单机运行，角色为Master。

仅执行undo join cluster命令软件不会进行任何处理，需要继续执行cloud-cluster configuration active命令，设备才会真正离开集群。设备离开集群时，会删除当前集群的配置、数据和拓扑（容器相关配置不会被删除），自己作为Leader，单机组建集群，本设备上的容器会作为Master。

如果用户希望将隔离出来的成员设备重新加入集群，请登录该成员设备，在该设备上执行join cluster，再保存配置并重启该设备后，设备会重新加入集群。

注意事项

使用本命令修改配置后，需要执行cloud-cluster configuration active命令来激活云集群的新配置，本命令才会和其它云集群的新配置一起生效。

【举例】

# 配置加入包含成员IP地址1.1.1.1的云集群。

<Sysname> system-view

[Sysname] cloud-clustermember 1

[Sysname-ccluster-member-1] join-cluster ip 1.1.1.1

# 集群模式下将成员设备2从集群中隔离出来。

<Sysname> system-view

[Sysname] cloud-clustermember 2

[Sysname-ccluster-member-2] undo join-cluster

Member 2 will be isolated from the cluster with its network interfaces disabled. Continue? [Y/N]: y

【相关命令】

·     cloud-cluster member

·     cloud-cluster configuration active

·     member-ip

1.1.17  mad enable

mad enable命令用来开启LACP MAD方式检测功能。

undo mad enable用来关闭LACP MAD方式检测功能。

【命令】

mad enable

undo mad enable

【缺省情况】

LACP MAD检测功能处于关闭状态。

【视图】

聚合接口视图

【缺省用户角色】

network-admin

【使用指导】

LACP MAD检测方式需要使用H3C设备作为中间设备，每个成员设备都需要连接到中间设备。请在动态聚合接口下开启LACP MAD方式检测功能。聚合接口创建后，可使用link-aggregation mode dynamic命令将该接口配置为动态接口。

在LACP MAD检测组网中，如果中间设备本身也是一个容器集群系统，则必须通过配置确保其容器集群域编号与被检测的容器集群系统不同，否则可能造成检测异常，甚至导致业务中断。

可以使用cloud-cluster service-cluster mad domain、mad enable命令来修改容器集群的MAD检测域编号，最新的配置将会生效。请按照网络规划配置容器集群的MAD检测域编号，不应随意修改。

【举例】

# 在二层动态聚合接口1下启用LACP MAD方式检测功能。

<Sysname> system-view

[Sysname] interface bridge-aggregation 1

[Sysname-Bridge-Aggregation1] link-aggregation mode dynamic

[Sysname-Bridge-Aggregation1] mad enable

You need to assign a domain ID (range: 0-4294967295)

[Current domain ID is: 0]: 1

The assigned domain ID is: 1

【相关命令】

·     cloud-cluster service-cluster mad domain

1.1.18  mad exclude interface

mad exclude interface命令用来配置保留接口。

undo mad exclude interface命令用来取消保留接口配置。

【命令】

mad exclude interface interface-type interface-number

undo mad exclude interface interface-type interface-number

【缺省情况】

除了系统保留接口外，Recovery状态容器集群上的所有业务接口都被关闭。系统保留接口包括：

·     容器集群物理端口

·     用户配置的保留聚合接口的成员接口

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

interface-type interface-number：表示接口类型和接口编号。

【使用指导】

容器进入Recovery状态时会自动关闭本容器上除系统保留接口外的所有的业务接口。如果希望Recovery状态容器集群上有特殊用途的接口（比如Telnet登录接口）保持UP状态，可以将其配置为保留接口。建议您仅将Telnet登录接口配置为保留接口。

当分裂的容器集群恢复时，处于Recovery状态的设备重启后重新加入容器集群，被MAD关闭的接口会自动恢复到正常状态。

在MAD故障未修复，接口没有自动恢复时，如果需要让Recovery状态容器集群中的成员设备及其接口恢复到正常状态（原因可能是Active状态的容器集群出现故障），可以在Recovery状态容器集群上执行mad restore命令。

【举例】

# 配置GigabitEthernet1/0/1为保留接口，即当设备进入Recovery状态时，该接口不会被关闭。

<Sysname> system-view

[Sysname] mad exclude interface gigabitethernet 1/0/1

【相关命令】

·     mad restore

1.1.19  mad restore

mad restore命令用来将设备从Recovery状态恢复到正常状态。

【命令】

mad restore

【视图】

系统视图

【缺省用户角色】

network-admin

【使用指导】

当容器集群链路故障会导致多Active冲突，原容器集群分裂为多个容器集群，为了防止网络中配置冲突，容器集群系统会通过多Active检测机制，让其中一个容器集群继续正常工作，其它容器集群的状态修改为Recovery（处于该状态的容器集群不能处理业务报文）。如果继续正常工作的容器集群也发生故障不能工作，此时可以通过本命令将处于Recovery状态的容器集群恢复到正常工作状态接替原容器集群工作，以便保证业务尽量少受影响。

【举例】

# 将容器集群从Recovery状态恢复到正常状态。

<Sysname> system-view

[Sysname] mad restore

This command will restore the device from multi-active conflict state. Continue? [Y/N]:Y

Restoring from multi-active conflict state, please wait...

1.1.20  member-ip

member-ip命令用来配置设备的成员IP地址。

undo member-ip命令用来恢复缺省情况。

【命令】

member-ip ipv4-addr mask-length

【缺省情况】

设备未配置成员IP地址。

【视图】

cloud-cluster member视图

【缺省用户角色】

network-admin

【参数】

ipv4-addr：设备的成员IP地址，用于集群内部通信，即交互集群管理报文。不能为环回地址、组播地址、广播地址和0.X.X.X。

mask-length：成员IP地址的网络掩码，取值范围为1～31。

【使用指导】

应用场景

成员IP地址用于物理集群内部通信，即交互物理集群协议报文。物理集群内的所有成员设备必须配置成员IP地址。

注意事项

同一网络内的不同物理集群请使用不同的网段进行集群内部通信。

同一集群内所有成员设备的成员IP地址必须为同一网段。预加入集群的设备必须将成员IP地址与集群当前使用的成员IP地址配置在同一网段，若配在不同网段，该设备将无法加入集群。

在集群模式下，不支持undo member-ip命令，且只能修改为集群成员同网段的其他IP地址。若想修改为不同网段的IP地址，则必须先执行undo join-cluster和cloud-cluster configuration active命令让成员设备先离开集群，再重新使用该命令配置其它网段的成员IP地址。

使用本命令修改配置后，需要执行cloud-cluster configuration active命令来激活云集群的新配置，本命令才会和其它云集群的新配置一起生效。

【举例】

# 配置成员设备1的成员IP地址为1.1.1.1/24。

<Sysname> system-view

[Sysname] cloud-cluste member 1

[Sysname-ccluster-member-1] member-ip 1.1.1.1 24

【相关命令】

·     cloud-cluster configuration active

·     cloud-cluster member

·     join-cluster