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