cluster-create

To create a new cluster for high availability (HA) in a fabric, use the cluster-create command.

 

Informational Note:  You may configure multiple clusters of switches within a single fabric. However, a switch can participate in only one cluster configuration. For example, switch-1 and switch-2 can participate in cluster-1, and switch-3 and switch-4 can participate in cluster-2, but switch-1 and switch-2 cannot participate in cluster-2 or any other cluster.

Syntax   cluster-create name name-string cluster-node-1 cluster-node-1cluster-node-2 cluster-node-2 [validate|no-validate]

cluster-name

Specify the name of the cluster.

cluster-node-1 fabric-node name

Specify the name of the first switch in the cluster.

cluster-node-2 fabric-node name

Specify the name of the second switch in the cluster.

Any of the following options:

validate|no-validate

Validate the inter-switch links and state of the switches in the cluster.

cluster-sync-timeout milliseconds

Specify the amount of time before a cluster times out during synchronization. Specify a time between 500 and 2000 ms.

cluster-sync-offline-count number

Specify the number of missed synchronizations before the cluster goes offline.

Defaults   None

Access   CLI

History   

Version 1.2

Command introduced.

Version 2.1

The parameter, private-link, added.

Version 2.2

The parameter, private-link, deprecated.

Version 3.0.0

The parameters, cluster-sync-timeout and cluster-sync-offline-count added.

Usage   A cluster allows two switches to cooperate in high-availability (HA) deployments. The nodes that form the cluster must be members of the same fabric. Clusters are typically used in conjunction with a virtual link aggregation group (VLAG) that allows links physically connected to two separate switches appear as a single trunk to a third device. The third device can be a switch, server, or any Ethernet device.

Examples  To create a cluster named, cluster_eng, using an interswitch link or trunk between two cluster nodes, switch_a and switch_b, and available to other network traffic, use the following command:

CLI network-admin@switch > cluster-create name cluster_eng cluster-node-1 switch_a cluster-node-2 validate

cluster-delete

To delete a cluster for high availability (HA) in a fabric, use the cluster-delete command.

Syntax   cluster-delete name name-string

name name-string

Specify the name of the cluster.

Defaults   None

Access   CLI

History   

Version 1.2

Command introduced.

Version 2.1

The parameter, private-link, added.

Version 2.2

The parameter, private-link, deprecated.

Usage   A cluster allows two switches to cooperate in high-availability (HA) deployments. The nodes that form the cluster must be members of the same fabric. Clusters are typically used in conjunction with a virtual link aggregation group (VLAG) that allows links physically connected to two separate switches appear as a single trunk to a third device. The third device can be a switch, server, or any Ethernet device.

Examples  To delete a cluster named, cluster_eng, use the following command:

CLI network-admin@switch > cluster-delete name cluster_eng

cluster-info

To view information about clusters in a fabric, use the cluster-info command.

Informational Note:  You may configure multiple clusters of switches within a single fabric. However, a switch can participate in only one cluster configuration. For example, switch-1 and switch-2 can participate in cluster-1, and switch-3 and switch-4 can participate in cluster-2, but switch-1 and switch-2 cannot participate in cluster-2 or any other cluster.

Syntax   cluster-info

cluster-name

Displays the name of the cluster.

cluster-node-1

Displays the name of the first switch in the cluster.

cluster-node-2

Displays the name of the second switch in the cluster.

tid

Displays the transaction ID.

ports

Displays the port used to create the cluster configurarion.

Defaults   None

Access   CLI

History   

Version 1.2

Command introduced.

Version 2.1

The parameter, private-link, added.

Version 2.2

The parameter, private-link, deprecated.


Usage   A cluster allows two switches to cooperate in high-availability (HA) deployments. The nodes that form the cluster must be members of the same fabric. Clusters are typically used in conjunction with a virtual link aggregation group (VLAG) that allows links physically connected to two separate switches appear as a single trunk to a third device. The third device can be a switch, server, or any Ethernet device.

Examples  To display information a cluster named, vlag, use the cluster-info command:

CLI network-admin@switch > cluster-info

name:           vlag

state:          online

cluster-node-1: 167772208

cluster-node-2: 167772196

tid:            1

ports:          26

cluster-modify

To modify a cluster for high availability (HA) in a fabric, use the cluster-modify command.

Syntax   cluster-modify

name name-string

Specify the name of the cluster.

cluster-sync-timeout milliseconds

Specify the amount of time before a cluster times out during synchronization. Specify a time between 500 and 2000 ms.

cluster-sync-offline-count number

Specify the number of missed synchronizations before the cluster goes offline.

enable|disable

Enable or disable the cluster configuration.

stp-mode rstp|mstp

Specify the STP mode for the cluster.

bpdus-bridge-ports|bpdus-all-ports

Specify sending BPDU packets to a specific bridge port.

bridge-id mac-address

Specify the MAC address as the bridge ID.

bridge-priority number

Specify the bridge priority as a multiple of 4096 with a default value of 32768.

hello-time seconds

Specify the hello-time in seconds with a default time of 2 seconds.

forwarding-delay seconds

Specify the forwarding-delay between 4 and 30 seconds with a default time of 15 seconds.

max-age seconds

Specify the maximum age time between 6 and 40 seconds with a default time of 20 seconds.

mst-max-hops number

Specify the maximum hop count for MSTP  BPDU packets. The default value is 20 hops.

mst-config-name mst-config-name-string   

Specify the name of the MST configuration instance.

root-guard-wait-time seconds

Specify the root guard wait time between 0 and 300 seconds with a default value of 20 seconds. If you set the time to 0, you disable the parameter.


Defaults   None

Access   CLI

History   

Version 1.2

Command introduced.

Version 2.1

The parameter, private link, was added.

Version 2.2

Command deprecated.

Version 3.0.0

Command reintroduced with new parameters.

Usage   A cluster allows two switches to cooperate in high-availability (HA) deployments. The nodes that form the cluster must be members of the same fabric. Clusters are typically used in conjunction with a virtual link aggregation group (VLAG) that allows links physically connected to two separate switches appear as a single trunk to a third device. The third device can be a switch, server, or any Ethernet device.

Examples  To modify a cluster named, cluster_eng, , use the following command:

CLI network-admin@switch > cluster-modify name cluster_eng cluster-syn-timeout 500ms

cluster-show

To display a cluster configuration in a fabric, use the cluster-show command.

Syntax   cluster-show

name name-string

Specifies the name of the cluster.

cluster-id

Specifies the ID assigned to the cluster configuration.

state

offline

unavailable

online

coming-online

slave-ready

going offline

cluster-node-1

Specifies the name of the first switch in the cluster.

cluster-node-2

Specifies the name of the second switch in the cluster.

tid tid-number

Specifies the transaction ID number.

mode none|master|slave

Specifies the mode assigned to the cluster.

ports port-list

Specifies the list of ports.

remote-ports port-list

Specifies the list of remote ports.

validate|no-validate

Validate the inter-switch links and state of the switches in the cluster.

cluster-sync-timeout milliseconds

Specify the amount of time before a cluster times out during synchronization. Specify a time between 500 and 2000 ms.

cluster-sync-offline-count number

Specify the number of missed synchronizations before the cluster goes offline.

enable|disable

Displays if you enabled or disabled STP.

stp-mode rstp|mstp

Displays the STP mode.

bpdus-bridge-ports|bpdus-all-ports

Displays if the cluster sends BPDU packets to bridge specific ports.

bridge-id mac-address

Displays the MAC address of the bridge.

bridge-priority bridge-priority-number 

Displays the bridge priority with a default value of 32768.

hello-time seconds 

Displays the hello time in seconds

forwarding-delay seconds

Displays the forwarding time delay in seconds.

max-age seconds

Displays the maximum aging time in seconds.

mst-max-hops count

Displays the number of maximum hops for MSTP BPDUs.

mst-config-name mst-config-name-string 

Displays the name of the MST configuration instance.

mst-config-digest mst-config-digest-string

Displays the MST configuration digest.

cluster-mode none|master|slave

Displays the STP cluster mode.

root-guard-wait-time seconds

Displays the root guard wait time.

Defaults   None

Access   CLI

History   

Version 1.2

Command introduced.

Version 2.1

The parameter, private-link, added.

Version 2.2

The parameter, private-link, deprecated.

Version 2.4

The parameters, mode and remote-ports, added. The option, synching, deprecated. The option, slave-ready, and going-offline added.

Version 2.4.1

The parameters, online, and unavailable added.

Version 3.0.0

The parameters, cluster-sync-timeout and cluster-sync-offline-count added.

Usage   Displays information about cluster configurations on the network.

Examples  To show information about a cluster configuration, use the following command:

CLI network-admin@switch > cluster-show format all layout vertical

name:           vlag

id:             a000030:1

state:          online

cluster-node-1: pubdev01

cluster-node-2: pubdev02

tid:            0

mode:           master

remote-port:    33,34

ports:          26,128


cluster-membership-modify

To modify a cluster membership for high availability (HA) in a fabric, use the cluster-membership-modify command.


Syntax   cluster-membership-modify

name name-string

Specify the name of the cluster membership.

cluster-node-1 fabric-node name

Specify the name of the first fabric node in the cluster.

cluster-node-2 fabric-node name

Specify the name of the second fabric node in the cluster.

Defaults   None

Access   CLI

History   

Version 2.5.0

Command introduced.

Version 3.0.0

The parameter validate|no-validate deprecated.

Usage   A cluster allows two switches to cooperate in high-availability (HA) deployments. The nodes that form the cluster must be members of the same fabric. Clusters are typically used in conjunction with a virtual link aggregation group (VLAG) that allows links physically connected to two separate switches appear as a single trunk to a third device. The third device can be a switch, server, or any Ethernet device.

Examples  To modify a cluster membership, cluster_eng, using an interswitch link or trunk between two cluster nodes, fabric_a and fabric_b, and is available to other network traffic, use the following command:

CLI network-admin@switch > cluster-create name cluster_eng cluster-node-1 fabric_a cluster-node-2 fabric_b

cluster-membership-show

To display a cluster membership for high availability (HA) in a fabric, use the cluster-membership-show command.

Syntax   cluster-membership-show

switch fabric-node name

Displays the switch name.  

name name-string

Displays the name of the cluster membership.

id

Displays the ID assigned to the cluster.

state offline|online|unavailable|coming-online|slave-ready|going-offline

Displays the state of the cluster.

cluster-node-1

fabric-node name

Displays the name of the first fabric node in the cluster.

cluster-node-2

fabric-node name

Displays the name of the second fabric node in the cluster.

tid tid-number

Displays the transaction ID assigned to the cluster.

mode none|master|slave

Displays the cluster mode.

ports port-list 

Displays the list of ports.

remote-ports port-list

Displays the list of remote ports.

validate|no-validate

Displays if the cluster link validated.

cluster-sync-timeout mseconds

Displays the cluster synchronization timeout in ms.

cluster-sync-offline-count number

Displays the number of missed timeouts before the cluster goes offline.

enable|disable

Displays if you enabled or disabled STP.

stp-mode rstp|mstp

Displays the STP mode.

bpdus-bridge-ports|bpdus-all-ports

Displays if the cluster sends BPDU packets to bridge specific ports.

bridge-id mac-address

Displays the MAC address of the bridge.

bridge-priority bridge-priority-number 

Displays the bridge priority with a default value of 32768.

hello-time seconds 

Displays the hello time in seconds

forwarding-delay seconds

Displays the forwarding time delay in seconds.

max-age seconds

Displays the maximum aging time in seconds.

mst-max-hops count

Displays the number of maximum hops for MSTP BPDUs.

mst-config-name mst-config-name-string 

Displays the name of the MST configuration instance.

mst-config-digest mst-config-digest-string

Displays the MST configuration digest.

cluster-mode none|master|slave

Displays the STP cluster mode.

root-guard-wait-time seconds

Displays the root guard wait time.

Defaults   None

Access   CLI

History   

Version 2.5.0

Command introduced.

Version 3.0.0

The parameter validate|no-validate deprecated.

Usage   A cluster allows two switches to cooperate in high-availability (HA) deployments. The nodes forming the cluster must be members of the same fabric. Clusters are typically used in conjunction with a virtual link aggregation group (VLAG) allowing links physically connected to two separate switches to appear as a single trunk to a third device. The third device can be a switch, server, or any Ethernet device.

Examples  To display a cluster membership, use the following command:

CLI network-admin@switch > cluster-membership-show