- Table of Contents
-
- H3C S7500 Series Command Manual(Release 3100 Series)-(V1.04)
- 00-1Cover
- 01-CLI Commands
- 02-Login Commands
- 03-Configuration File Management Commands
- 04-VLAN Commands
- 05-Extended VLAN Application Commands
- 06-IP Address-IP Performance-IPX Commands
- 07-GVRP Commands
- 08-QinQ Commands
- 09-Port Basic Configuration Commands
- 10-Link Aggregation Commands
- 11-Port Isolation Commands
- 12-Port Binding Commands
- 13-DLDP Commands
- 14-MAC Address Table Commands
- 15-MSTP Commands
- 16-Routing Protocol Commands
- 17-Multicast Commands
- 18-802.1x Commands
- 19-AAA-RADIUS-HWTACACS-EAD Commands
- 20-Traffic Accounting Commands
- 21-VRRP-HA Commands
- 22-ARP Commands
- 23-DHCP Commands
- 24-ACL Commands
- 25-QoS Commands
- 26-Mirroring Commands
- 27-Cluster Commands
- 28-PoE Commands
- 29-UDP-Helper Commands
- 30-SNMP-RMON Commands
- 31-NTP Commands
- 32-SSH Terminal Service Commands
- 33-File System Management Commands
- 34-FTP and TFTP Commands
- 35-Information Center Commands
- 36-DNS Commands
- 37-System Maintenance and Debugging Commands
- 38-HWPing Commands
- 39-RRPP Commands
- 40-NAT-Netstream-Policy Routing Commands
- 41-Telnet Protection Commands
- 42-Hardware-Dependent Software Configuration Commands
- 43-Appendix
- Related Documents
-
Title | Size | Download |
---|---|---|
27-Cluster Commands | 209 KB |
Chapter 1 Cluster Configuration Commands
1.1 NDP Configuration Commands
1.2 NTDP Configuration Commands
1.2.2 display ntdp device-list
1.3 Cluster Configuration Commands
1.3.10 display cluster candidates
1.3.11 display cluster members
Chapter 1 Cluster Configuration Commands
1.1 NDP Configuration Commands
1.1.1 display ndp
Syntax
display ndp [ interface port-list ]
View
Any view
Parameters
interface port-list: Specifies a list of ports. The list can contain consecutive or separated ports, or the combination of the both. You need to provide the port-list argument in the form of interface-type interface-number [ to interface-type interface-number ] &<1-10>, where interface-type specifies the port type, and interface-number specifies the port number (in the form of slot number/device number/port number). to: Specifies a port range. &<1-10> means that you can provide up to ten port indexes/port index ranges for this argument.
Description
Use the display ndp command to display the global NDP configuration information, including the interval to send NDP packets, the holdtime of NDP information, and the information about the neighbors of all the ports.
Examples
# Display NDP configuration information.
Neighbor Discovery Protocol is enabled.
Neighbor Discovery Protocol Ver: 1, Hello Timer: 10(s), Aging Timer: 10(s)
Interface: GigabitEthernet2/0/1
Status: Enabled, Pkts Snd: 179, Pkts Rvd: 6723, Pkts Err: 0
Neighbor 1: Aging Time: 8(s)
MAC Address : 000f-e200-6502
Host Name : S7506
Port Name : GigabitEthernet2/0/1
Software Ver: 3.10
Device Name : S7506
Port Duplex : AUTO
Product Ver : S7506-3135
BootROM Ver : 520
Interface: GigabitEthernet2/0/2
Status: Enabled, Pkts Snd: 0, Pkts Rvd: 0, Pkts Err: 0
Interface: GigabitEthernet2/0/3
Status: Enabled, Pkts Snd: 0, Pkts Rvd: 0, Pkts Err: 0
# Display the information about Ethernet 2/0/1.
<aaa_0.H3C> display ndp interface GigabitEthernet 2/0/1
Interface: GigabitEthernet2/0/1
Status: Enabled, Pkts Snd: 179, Pkts Rvd: 6723, Pkts Err: 0
Neighbor 1: Aging Time: 8(s)
MAC Address : 000f-e200-6502
Host Name : S7506
Port Name : GigabitEthernet2/0/1
Software Ver: 3.10
Device Name : S7506
Port Duplex : AUTO
Product Ver : S7506-3135
BootROM Ver : 520
Table 1-1 Description on the fields of the display ndp interface command
Field |
Description |
Neighbor Discovery Protocol is enabled |
NDP is enabled globally on the switch |
Neighbor Discovery Protocol Ver: 1 |
NDP version 1 is running |
Hello Timer |
The interval to send NDP packets |
Aging Timer |
The holdtime of the NDP information sent by the local switch |
Interface |
Port index, which is used to specify a specific port |
Status |
NDP is enabled on the port |
Pkts Snd |
Number of the NDP packets transmitted through the port |
Pkts Rvd |
Number of the NDP packets received through the port |
Pkts Err |
Number of the error NDP packets received through the port |
Neighbor 1: Aging Time |
The holdtime of the NDP information received from the neighbors connected to the port |
MAC Address |
MAC address of a neighbor device |
Host Name |
System name of a neighbor device |
Port name |
Name of the port connected to the neighbor device |
Software Ver |
Neighbor device software version |
Device Name |
Device name of a neighbor device |
Port Duplex |
Port duplex mode of a neighbor device |
Product Ver |
Product version of a neighbor device |
BootROM Ver |
Boot ROM version of the neighbor device |
1.1.2 ndp enable
Syntax
ndp enable [ interface port-list ]
undo ndp enable [ interface port-list ]
View
System view, Ethernet port view
Parameters
interface port-list: Specifies a list of ports. The list can contain consecutive or separated ports, or the combination of the both. You need to provide the port-list argument in the form of interface-type interface-number [ to interface-type interface-number ] &<1-10>, where interface-type specifies the port type, and interface-number specifies the port number (in the form of slot number/device number/port number). to: Specifies a port range. &<1-10> means that you can provide up to ten port indexes/port index ranges for this argument.
Description
In system view:
Use the ndp enable command to enable NDP globally.
Use the undo ndp enable command to disable NDP globally.
When the ndp enable command is executed in system view, the NDP feature is enabled globally if the port-list argument is not specified, while the NDP feature is enabled on the specified port if the port-list argument is specified.
In Ethernet port view:
Use the ndp enable command to enable NDP on a port.
Use the undo ndp enable command to disable NDP on a port.
When this command is used in Ethernet port view, the interface keyword cannot be provided and the NDP feature is enabled on the current port only.
By default, NDP is enabled both globally and on a port.
Note that the NDP feature on a port does not take effect until the NDP feature is enabled globally.
Examples
# Enable NDP globally.
<aaa_0.H3C> system-view
System View: return to User View with Ctrl+Z.
[aaa_0.H3C] ndp enable
1.1.3 ndp timer aging
Syntax
ndp timer aging aging-in-seconds
undo ndp timer aging
View
System view
Parameters
aging-in-seconds: Holdtime (in seconds) to be set of the NDP information sent by the local switch. This argument ranges from 5 to 255.
The default holdtime is 180 seconds.
Description
Use the ndp timer aging command to set the holdtime of the NDP information sent by the local switch, that is, to specify how long a device will hold the NDP packets received from the local device. After the aging timer expires, the device removes the received NDP neighbor node information.
Use the undo timer aging command to restore the default NDP information holdtime.
You can specify how long an adjacent device will hold the NDP information sent by the local device. An adjacent device holds the NDP information of the local switch according to the holdtime carried in the NDP packets received from the local switch and removes the NDP information when the aging timer expires.
Note that NDP information holdtime is longer than the interval to send NDP packets normally. Otherwise, the neighbor information table of an NDP port will become unstable.
Examples
# Configure the holdtime of the NDP information sent by the local switch to be 60 seconds.
<aaa_0.H3C> system-view
System View: return to User View with Ctrl+Z.
[aaa_0.H3C] ndp timer aging 60
1.1.4 ndp timer hello
Syntax
ndp timer hello timer-in-seconds
undo ndp timer hello
View
System view
Parameters
timer-in-seconds: Interval (in seconds) to send NDP packets ranging from 5 to 254. By default, the interval to send NDP packets is 60 seconds.
Description
Use the ndp timer hello command to set the interval to send NDP packets.
Use the undo ndp timer hello command to restore the default interval to send NDP packets.
NDP information in a neighbor information table is updated regularly. This enables neighbor information table to contain the actual network topology information. You can use these two commands to adjust the updating frequency of NDP information.
Examples
# Configure the interval to send NDP packets to be 80 seconds.
System View: return to User View with Ctrl+Z.
[H3C] ndp timer hello 80
1.1.5 reset ndp statistics
Syntax
reset ndp statistics [ interface port-list ]
View
User view
Parameters
interface port-list: Specifies a list of ports. The list can contain consecutive or separated ports, or the combination of the both. You need to provide the port-list argument in the form of interface-type interface-number [ to interface-type interface-number ] &<1-10>, where interface-type specifies the port type, and interface-number specifies the port number (in the form of slot number/device number/port number). to: Specifies a port range. &<1-10> means that you can provide up to ten port indexes/port index ranges for this argument.
Description
Use the reset ndp statistics command to clear NDP statistics.
Examples
# Clear NDP statistics.
<H3C> reset ndp statistics
1.2 NTDP Configuration Commands
1.2.1 display ntdp
Syntax
display ntdp
View
Any view
Parameters
None
Description
Use the display ntdp command to display the global NTDP information. The information includes the range (in hop count) within which topology information is collected, the interval to collect topology information (the NTDP timer), the delay time for a device to forward topology-collection requests, the delay time for a topology-collection request to be forwarded through a port, and the time cost during the last topology collection.
Examples
# Display the global NTDP information.
NTDP is running.
Hops : 3
Timer : 0 min
Hop Delay : 200 ms
Port Delay: 20 ms
Last collection total time: 0ms
Table 1-2 Description on the fields of the display ntdp command
Field |
Description |
NTDP is running. |
NTDP is enabled globally on the local device. |
Hops |
Hop count for topology collection |
Timer |
Interval to collect topology information |
Hop Delay |
Delay time for the device to forward topology collection requests |
Port Delay |
Delay time for a topology-collection request to be forwarded through a port |
Last collection total time |
Time cost during the last collection |
1.2.2 display ntdp device-list
Syntax
display ntdp device-list [ verbose ]
View
Any view
Parameters
verbose: Displays the detailed device information.
Description
Use the display ntdp device-list command to display the device information collected through NTDP.
Examples
# Display the device list collected through NTDP.
<aaa_0.H3C> display ntdp device-list
MAC HOP IP PLATFORM
000f-e200-6506 0 100.100.1.1/24 S7506
000f-e201-6506 1 16.1.1.1/24 S7506
Table 1-3 Description on the fields of the display ntdp device-list command
Field |
Description |
MAC |
MAC address of a device |
HOP |
Hops to the collecting device |
IP |
IP address and mask length of the management VLAN interface on the device |
PLATFORM |
Platform information about a device |
# Display the detailed device information collected through NTDP.
<aaa_0.H3C> display ntdp device-list verbose
Hostname : aaa_0.H3C
MAC : 000f-e200-6506
Hop : 0
Platform : S7506
IP : 100.100.1.1/24
Version :
H3C Comware Platform Software.
Comware Software, Version 3.10, Release 3135
Copyright(c) 2004-2007 Hangzhou H3C Technologies Co., Ltd. All rights reserved.
S7506R-3135
Cluster : Candidate switch
Peer MAC Peer Port ID Native Port ID Speed Duplex
000f-e200-3190 Ethernet2/0/22 Ethernet3/0/21 100 FULL
-----------------------------------------------------------------------------
Hostname : aaa_1.H3C
MAC : 000f-e201-6506
Hop : 1
Platform : S7506
IP : 16.1.1.1/24
Version :
H3C Comware Platform Software.
Comware Software, Version 3.10, Release 3135
Copyright(c) 2004-2007 Hangzhou H3C Technologies Co., Ltd. All rights reserved.
S7506R-3135
Peer MAC Peer Port ID Native Port ID Speed Duplex
000f-e200-3900 Ethernet3/0/21 Ethernet1/0/22 100 FULL
5600-0000-3334 GigabitEthernet7/0/32 Ethernet1/0/4 100 FULL
Table 1-4 Description on the fields of the display ntdp device-list verbose command
Field |
Description |
Hostname |
System name of the device collected through NTDP |
MAC |
Mac address of the device |
Hop |
Number of hops from the device to the device which launches the topology collection |
Platform |
Software platform of the device |
IP |
IP address of the cluster management VLAN interface on the device (VLAN 1 is the cluster management VLAN of the S7500 series ) |
Version |
Version of the device |
Cluster |
The role of the device in the cluster |
Peer MAC |
MAC address of a neighbor device |
Peer Port ID |
Name of the peer port connected to the neighbor device |
Native Port ID |
Name of the local port which a neighbor device is connected to |
Speed |
Speed of the neighbor device port |
Duplex |
Duplex mode of the neighbor device port |
1.2.3 ntdp enable
Syntax
ntdp enable
undo ntdp enable
View
System view, Ethernet port view
Parameters
None
Description
In system view:
Use the ntdp enable command to enable NTDP globally.
Use the undo ntdp enable command to disable NTDP globally.
In Ethernet port view:
Use the ntdp enable command to enable NTDP on a port.
Use the undo ntdp enable command to disable NTDP on a port.
By default, NTDP is enabled globally and on ports.
Note that the NTDP cannot operate if it is enabled on a port where NDP is disabled.
& Note:
l On a management device, NTDP must be enabled globally and on all the ports, and the NTDP parameters must be configured. On a member device, NTDP must be enabled globally and on the corresponding port. When NTDP is running on member devices, it adopts the NTDP parameters from the management device.
l NTDP takes effect in the management VLAN only. The S7500 series take VLAN 1 as the default VLAN, that is, the NTDP feature of the S7500 series takes effect in VLAN 1 only.
Examples
# Enable NTDP globally.
System View: return to User View with Ctrl+Z.
1.2.4 ntdp explore
Syntax
ntdp explore
View
User view
Parameters
None
Description
Use the ntdp explore command to start topology information collection manually.
You can use this command to enable the topology information collection manually. NTDP will collect the NDP information of every device and the information about the connections between the local switch and all of its neighbor devices in the specified network scope. The management device or the network administrator uses this information to acquire the network topology to manage and monitor the devices.
Examples
# Start the topology collection.
<aaa_0.H3C> ntdp explore
1.2.5 ntdp hop
Syntax
ntdp hop hop-value
undo ntdp hop
View
System view
Parameters
hop-value: Maximum hops for collecting topology information, ranging from 1 to 128. By default, the value is 3.
Description
Use the ntdp hop command to set a range (in terms of hop count) for topology information collection.
Use the undo ntdp hop command to restore the default range for topology information collection.
With the ntdp hop command, you can specify to collect the topology information of the devices within a specified range to avoid infinitive collection. The limit is performed by controlling the permitted hops from collection origination. For example, if you set the hop number limit to 2, only the switches less than 2 hops away from the switch starting the topology collection are collected.
Note that this command is only applicable to the topology-collecting device. A broader collection scope requires more memory of the topology-collecting device.
Examples
# Set the hop count for topology information collection to 5.
<aaa_0.H3C> system-view
System View: return to User View with Ctrl+Z.
[aaa_0.H3C] ntdp hop 5
1.2.6 ntdp timer
Syntax
ntdp timer interval-in-minutes
undo ntdp timer
View
System view
Parameters
interval-in-minutes: Interval (in minutes) to collect topology information, ranging from 0 to 65,535. This argument defaults to 0, which specifies not to collect topology information.
Description
Use the ntdp timer command to configure the interval to collect topology information.
Use the undo ntdp timer command to restore the default interval.
By default, the interval to collect topology information is 0 minutes, that is, topology information is not collected periodically.
A switch collects topology information once in each period set by the ntdp timer command.
Examples
# Set the interval to collect topology information to 30 minutes.
System View: return to User View with Ctrl+Z.
[aaa_0.H3C] ntdp timer 30
1.2.7 ntdp timer hop-delay
Syntax
ntdp timer hop-delay time
undo ntdp timer hop-delay
View
System view
Parameters
time: Delay time (in milliseconds) for a switch to forward topology-collection request packets. This argument ranges from 1 to 1,000 and defaults to 200.
Description
Use the ntdp timer hop-delay command to set the delay time for a switch to forward topology-collection request packets.
Use the undo ntdp timer hop-delay command to restore the default delay time.
To avoid network congestion caused by a large amount of topology response packets received by the topology collection device in a short period, a switch delays for specific period before it forwards a received topology-collection request packet through its first ports. You can use the ntdp timer hop-delay command to set the delay time.
These two commands are intended for switches that collect topology information. They actually set the hop-delay value for topology-collection request packets sent by these switches. The hop-delay value determines the delay time for a switch receiving topology-collection request packets to forward them through its first port.
Examples
# Set the delay time for the switch to forward topology-collection request packets through the first port to 300 ms.
System View: return to User View with Ctrl+Z.
[aaa_0.H3C] ntdp timer hop-delay 300
1.2.8 ntdp timer port-delay
Syntax
ntdp timer port-delay time
undo ntdp timer port-delay
View
System view
Parameters
time: Delay time (in milliseconds) for a switch to forward a topology-collection request packet through its successive ports. This argument ranges from 1 to 100 and defaults to 20.
Description
Use the ntdp timer port-delay command to set the delay time for a port (on the device whose topology information is collected) to wait to forward topology-collection request packets after the last port (on the device whose topology information is collected) forwards topology-collection request packets.
Use the undo ntdp timer port-delay command to restore the default delay time.
By default, the delay time of a port is 20 ms.
To avoid network congestion caused by a large amount of topology response packets received by the topology collection device in short periods, a switch delays for a specific period before it forwards a received topology-collection request packet through the next port. You can use the ntdp timer port-delay command to set the delay time.
These two commands are intended for switches that collect topology information. They actually set the port-delay value for topology-collection request packets sent by these switches. The port-delay value determines the delay time for a switch receiving topology-collection request packets to forward them through the next port.
Examples
# Set the delay time for the switch to forward topology-collection request packets through the successive ports to 40 ms.
System View: return to User View with Ctrl+Z.
[aaa_0.H3C] ntdp timer port-delay 40
1.3 Cluster Configuration Commands
1.3.1 add-member
Syntax
add-member [ member- number] mac-address H-H-H [ password password ]
View
Cluster view
Parameters
member-number: Member number assigned to the candidate device to be added to a cluster. This argument ranges from 1 to 255.
H-H-H: MAC address of the candidate device (in hexadecimal).
password: Password of the candidate device, a string comprising 1 to 256 characters. The password is required when you add a candidate device to a cluster. However, this argument is not needed if the candidate device is not configured with a password.
Description
Use the add-member command to add a candidate device to a cluster.
You can add a candidate device to a cluster on the management device only.
If you do not specify the member number when adding a cluster member, the management device assigns the next available member number to it.
After a candidate device is added to a cluster, the level-3 password of the device is replaced by the password of the management device automatically.
Examples
# Add a candidate device to the cluster, setting the member number to 6. (Assume that the MAC address and level-3 user password of the candidate device are 00E0-fc00-35e7 and 123456.)
<aaa_0.H3C> system-view
System View: return to User View with Ctrl+Z.
[aaa_0.H3C] cluster
[aaa_0.H3C-cluster] add-member 6 mac-address 000f-e200-35e7 password 123456
1.3.2 administrator-address
Syntax
administrator-address mac-address name name
undo administrator-address
View
Cluster view
Parameters
mac-address: MAC address of the management device.
name name: Name of an existing cluster, a string comprising up to 8 characters, which can only be alphanumeric characters, subtraction sign (-), and underline (_).
Description
Use the administrator-address command to set the MAC address of the management device on a member device.
Use the undo administrator-address command to remove a member device from the cluster.
By default, a switch belongs to no cluster.
In order that the member devices identify the management device correctly after the system is restarted, the administrator-address command is enabled automatically on the switch to specify the MAC address of the management device in the cluster when the switch is added to the cluster as a member device.
Note that the undo administrator-address command is generally used in debugging or restoration. You are recommended to use the delete-member command to remove a cluster member from a cluster on the management device.
Examples
# Remove a member device from the cluster.
System View: return to User View with Ctrl+Z
[aaa_1.H3C] cluster
[aaa_1.H3C-cluster] undo administrator-address
1.3.3 auto-build
Syntax
auto-build [ recover ]
View
Cluster view
Parameters
recover: Establishes communication with all the member devices again.
Description
Use the auto-build command to add the candidate device to the cluster automatically to be a member device.
This command can be executed on a management device or a device to be configured as a management device.
When you use this command on a candidate device, you will be required to enter the cluster name and build a cluster. The system will collect candidate devices automatically and then it is for the user to decide whether to add the collected candidate devices into the cluster.
When you use this command on a management device, the system will collect candidate devices automatically.
The recover keyword is used to recover a cluster. Execute the auto-build recover command to look for the down members in the member list and add them to the cluster again.
Note: Ensure that NTDP is enabled because it is the basis of candidate and member collection. The collection range is also decided through NTDP. You can use the ntdp hop command in system view to modify the collection range.
If a member device is configured with a level-3 user password different from that of the management device, it cannot be added to the cluster automatically.
Examples
# Set up a cluster automatically.
<H3C> system-view
System View: return to User View with Ctrl+Z.
[H3C] cluster
[H3C-cluster] auto-build
Please input cluster name:aaa
Collecting candidate list, please wait...
Candidate list:
Name Hops MAC Address Device
H3C 1 000f-e200-016a H3C 2016-EI
Add all to cluster?(Y/N)y
%May 30 09:07:30 2006 aaa_0.H3C S7506R CLST/5/LOG:
Member 000f-e200-016a is joined in cluster aaa.
Cluster auto-build Finish!
1 member(s) added successfully.
[aaa_0.H3C-cluster]
1.3.4 build
Syntax
build name
undo build
View
Cluster view
Parameters
name: Cluster name, a string comprising up to 8 characters, which can only be alphanumeric characters, subtraction sign (-), and underline (_).
Description
Use the build command to configure or modify the cluster name.
Use the undo build command to remove a cluster.
If the build command is executed on the candidate device, the current switch will be configured as the management device and assigned with a cluster name.
If the build command is executed on the management device, the cluster name will be modified.
The member number of a management device is 0.
& Note:
l After a cluster is built automatically, ACL 3998 and ACL 3999 will be generated automatically.
l After a cluster is built automatically, ACL 3998 and ACL 3999 can neither be configured/modified nor removed.
Examples
# Configure the current switch to be a management device and specify the cluster name as aaa.
System View: return to User View with Ctrl+Z
[H3C] cluster
[H3C-cluster] build aaa
[aaa_0.H3C-cluster]
1.3.5 cluster
Syntax
cluster
View
System view
Parameters
None
Description
Use the cluster command to enter cluster view.
Examples
# Enter cluster view.
System View: return to User View with Ctrl+Z
[H3C] cluster
[H3C-cluster]
1.3.6 cluster enable
Syntax
cluster enable
undo cluster enable
View
System view
Parameters
None
Description
Use the cluster enable command to enable the cluster function on a switch.
Use the undo cluster enable command to disable the cluster function on a switch.
By default, the cluster function is enabled on all the devices supporting cluster.
You need to create a cluster with the build command before using the cluster enable command on the management device.
These two commands can be used on any cluster-capable device. When you execute the undo cluster enable command on a management device, the cluster is removed, and the switch stop operating as a management device. When you execute this command on a member device, the cluster function is disabled on the switch, and the switch quits the cluster. When you execute this command on a switch that belongs to no cluster, the cluster function is disabled on the switch.
Examples
# Enable the cluster function on a switch.
System View: return to User View with Ctrl+Z
[H3C] cluster enable
1.3.7 cluster switch-to
Syntax
cluster switch-to { member-number | mac-address H-H-H | administrator }
View
User view
Parameters
member-number: Member number of a switch in a cluster, ranging from 1 to 255.
H-H-H: Specifies the MAC address of a member device.
administrator: Switches from a member device to the management device.
Description
Use the cluster switch-to command to switch between the management device and member devices for configuration and management.
You can manage member devices in a cluster through the management device, on which you can switch to member view to configure or manage specified member devices, and then use the quit command to return to the management device.
l Once a candidate switch is added to a cluster as a member switch, its level-3 user password will be replaced by the password of the management device. Authentication is not required when you switch from the management device to the member device.
l When you switch from the member device to the management device, you can user the level-1 user authority only. When the super command is used and the level-3 user password is provided, you can use the level-3 user authority.
When you execute this command on the management device with the member-number argument provided, an error occurs if the member device identified by the member-number argument does not exist. You can enter quit to cancel the switchover operation.
Examples
# Switch from the management device to the member device numbered 6 and then switch back to the management device.
<aaa_0.H3C> cluster switch-to 6
<aaa_6.H3C> quit
<aaa_0.H3C>
1.3.8 delete-member
Syntax
delete-member member-number
View
Cluster view
Parameters
member-number: Member number of a switch in a cluster, ranging from 1 to 255.
Description
Use the delete-member command to remove a member device from the cluster.
Remove a member device from a cluster on the management device only. Otherwise, errors occur.
Examples
# Remove the member device numbered 2 from the cluster.
<aaa_0.H3C> system-view
System View: return to User View with Ctrl+Z.
[aaa_0.H3C] cluster
[aaa_0.H3C-cluster] delete-member 2
1.3.9 display cluster
Syntax
display cluster
View
Any view
Parameters
None
Description
Use the display cluster command to display the state and statistics of the cluster to which the current switch belongs.
When being executed on a member device, this command displays the information such as cluster name, member number of the current switch, the MAC address and state of the management device, holdtime, and the interval to send packets.
When being executed on a management device, this command displays the information such as cluster name, the number of member devices in the cluster, cluster state, holdtime, and the interval to send packets.
The system will prompt that the device does not belong to any cluster if you execute this command on a switch that does not belong to any cluster.
Examples
# Display cluster information (assuming that the current switch is a management device).
<aaa_0.H3C> system-view
System View: return to User View with Ctrl+Z
[aaa_0.H3C] display cluster
Cluster name:"aaa"
Role:Administrator
Handshake timer:10 sec
Handshake hold-time:60 sec
IP-Pool:2.2.2.2/24
No logging host configured
No SNMP host configured
FTP server:8.8.8.8
No TFTP server configured
21 member(s) in the cluster, and 1 of them down.
# Display cluster information on the member device.
Cluster name:"aaa"
Role:Member
Member number:2
Handshake timer:10 sec
Handshake hold-time:60 sec
Administrator device mac address:000f-e200-6506
Administrator status:Up
Table 1-5 Description on the fields of the display cluster command
Field |
Description |
Cluster name |
Name of the cluster |
Role |
Cluster role of the switch |
Member number |
Member number of the switch |
Handshake timer |
Value of handshake timer |
Handshake hold-time |
Handshake holdtime |
Administrator device mac address |
MAC address of the management device |
Administrator status |
State of the management device |
1.3.10 display cluster candidates
Syntax
display cluster candidates [ mac-address H-H-H | verbose ]
View
Any view
Parameters
mac-address H-H-H: Specifies the MAC address of a candidate device.
verbose: Displays the detailed information about all the candidate devices.
Description
Use the display cluster candidates command to display the information about the candidate devices of a cluster.
Execute this command on management devices only.
Examples
# Display the information about all the candidate devices.
<aaa_0.H3C> display cluster candidates
MAC HOP IP PLATFORM
0000-0000-004d 3 192.169.121.258/24 S7506R
000f-e200-6502 2 8.8.8.3/24 S7506
000f-e200-1234 1 8.8.8.2/24 S7502
Table 1-6 Description on the fields of the display cluster candidates command
Field |
Description |
MAC |
MAC address of a candidate device |
Hop |
Hops from a candidate device to the management device |
IP |
IP address of a candidate device |
Platform |
Platform of a candidate device |
# Display the information about a specified candidate device.
<aaa_0.H3C-cluster> display cluster candidates mac-address 000f-e200-6502
Hostname : S7506
MAC : 000f-e200-6502
Hop : 1
Platform : S7506
IP : 8.8.8.3
# Display the detailed information about all the candidate devices.
<aaa_0.H3C S7506R>display cluster candidates verbose
Hostname : S7502
MAC : 000f-e201-0110
Hop : 1
Platform : S7502
IP :
Table 1-7 Description on the fields of the display cluster candidates verbose command
Field |
Description |
Hostname |
Name of a candidate device |
MAC |
MAC address of a candidate device |
Hop |
Hops from a candidate device to the management device |
IP |
IP address of a candidate device |
Platform |
Platform of a candidate device |
1.3.11 display cluster members
Syntax
display cluster members [ member-number | verbose ]
View
Any view
Parameters
member-number: Member number of a switch in a cluster, ranging from 0 to 255.
verbose: Displays the detailed information about all the devices in a cluster.
Description
Use the display cluster members command to display the information about cluster members.
Execute this command on management devices only.
Examples
# Display the information about all the devices in the cluster.
<aaa_0.H3C> display cluster members
SN Device MAC Address Status Name
0 S7506R 000f-e200-6506 Admin aaa_0.H3C
1 S7502 000f-e200-1234 Up aaa_1.H3C-1
2 S7506 000f-e200-6502 Up aaa_2.H3C-2
3 S7506R 0000-0000-004d Up aaa_3.H3C-3
Table 1-8 Description on the fields of the display cluster members command
Field |
Description |
SN |
Member number |
Device |
Device type |
MAC Address |
MAC address of a device |
Status |
State of a device |
Name |
Name of a device |
# Display the detailed information about the management device and all member devices.
<aaa_0.H3C> display cluster members verbose
Member number:0
Name: aaa_0.H3C
Device: S7506R
MAC Address:000f-e200-6506
Member status:Admin
Hops to administrator device:0
IP: 8.8.8.1/24
Version:
H3C Comware Platform Software.
Comware Software, Version 3.10, Release 3135
Copyright(c) 2004-2007 Hangzhou H3C Technologies Co., Ltd. All rights reserved.
S7506R-3135
Member number:1
Name:aaa_1.H3C-1
Device: S7502
MAC Address:000f-e200-1234
Member status:Up
Hops to administrator device:
IP: 8.8.8.2/24
Version:
H3C Comware Platform Software.
Comware Software, Version 3.10, Release 3135
Copyright(c) 2004-2007 Hangzhou H3C Technologies Co., Ltd. All rights reserved.
S7506R-3135
Member number:2
Name:aaa_2. H3C-2
Device: S7506
MAC Address:000f-e200-6502
Member status:Up
Hops to administrator device:
IP:8.8.8.3/24
Version:
H3C Comware Platform Software.
Comware Software, Version 3.10, Release 3135
Copyright(c) 2004-2007 Hangzhou H3C Technologies Co., Ltd. All rights reserved.
S7506R-3135
Member number:3
Name: aaa_3.H3C-3
Device: S7506R
MAC Address:0000-0000-004d
Member status:Up
Hops to administrator device:2
IP: 192.168.1.26/24
Version:
H3C Comware Platform Software.
Comware Software, Version 3.10, Release 3135
Copyright(c) 2004-2007 Hangzhou H3C Technologies Co., Ltd. All rights reserved.
S7506R-3135
Table 1-9 Description on the fields of the display cluster members verbose command
Field |
Description |
Member number |
Device member number |
Name |
Name of a device |
Device |
Device type |
MAC Address |
MAC address of a device |
Member status |
State of a device |
Hops to administrator device |
Hops from the current device to the management device |
IP |
IP address of a device |
Version |
Software version of the current device |
1.3.12 ftp cluster
Syntax
ftp cluster
View
User view
Parameters
None
Description
Use the ftp cluster command to establish control connection with the public FTP server of the cluster and enter FTP client view.
Examples
# Connect the FTP clients to the remote FTP server of the cluster.
331 Password required for hello.
1.3.13 ftp-server
Syntax
ftp-server ip-address
undo ftp-server
View
Cluster view
Parameters
ip-address: IP address of the FTP server to be configured for the cluster.
Description
Use the ftp-server command to configure an FTP server on the management device for the member devices in the cluster.
Use the undo ftp-server command to remove the FTP server configured for the member devices in the cluster.
By default, the management device acts as the FTP Server.
You need to configure the IP address of an FTP server first for the member devices in a cluster to access the FTP server through the management device.
Examples
# Configure the IP address of an FTP server on the management device.
<aaa_0.H3C> system-view
System View: return to User View with Ctrl+Z.
[aaa_0.H3C] cluster
[aaa_0.H3C-cluster] ftp-server 1.0.0.9
1.3.14 holdtime
Syntax
holdtime seconds
undo holdtime
View
Cluster view
Parameters
seconds: Holdtime (in seconds), ranging from 1 to 255. The default value is 60.
Description
Use the holdtime command to configure the holdtime of a switch.
Use the undo holdtime command to restore the default holdtime value.
l If a switch does not receive any information of a peer device during the holdtime, it sets the state of the peer device to “down”. When the communication resumes, the corresponding member device is re-added to the cluster (automatically).
l If the downtime does not exceed the holdtime, the member device stays in the normal state and does not need to be added again.
Execute these two commands on management devices only. The member devices in a cluster acquire the holdtime setting from the management device.
Examples
# Set the holdtime to 30 seconds.
<aaa_0.H3C> system-view
System View: return to User View with Ctrl+Z
[aaa_0.H3C] cluster
[aaa_0.H3C-cluster] holdtime 30
1.3.15 ip address
Syntax
ip address ip-address { mask | mask-length }
undo ip address ip-address { mask | mask-length }
View
VLAN interface view
Parameters
ip-address: IP address of the VLAN interface, expressed in dotted decimal.
mask: Subnet mask of the VLAN interface IP address, expressed in dotted decimal.
mask-length: Length of the subnet mask, namely, the number of “1”s in the subnet mask.
Description
Use the ip address command to specify an IP address and subnet mask for the VLAN interface.
Use the undo ip address command to remove the IP address and subnet mask of the VLAN interface.
By default, the IP address of a VLAN interface is null.
Note that:
l The S7500 series use VLAN 1 as the cluster management VLAN to manage the cluster.
l The IP address of the Layer 3 virtual interface of the management VLAN must be configured before a cluster is set up; otherwise, the cluster cannot be set up successfully.
l When a cluster is set up, the IP address of the management VLAN interface cannot be modified any more.
Examples
# Specify the IP address of VLAN interface 1 as 129.12.0.1 and the subnet mask as 255.255.255.0.
System View: return to User View with Ctrl+Z.
[H3C] interface vlan-interface 1
[H3C-Vlan-interface1] ip address 129.12.0.1 255.255.255.0
1.3.16 ip-pool
Syntax
ip-pool administrator-ip-address { ip-mask | ip-mask-length }
undo ip-pool
View
Cluster view
Parameters
administrator-ip-address: IP address of the management device of a cluster.
ip-mask: Mask of the cluster IP address pool.
ip-mask-length: Mask length of the cluster IP address pool.
Description
Use the ip-pool command to configure a private IP address range for cluster members on the switch to be configured as the management device.
Use the undo ip-pool command to cancel the IP address range configuration.
Before establishing a cluster, you need to configure a private IP address pool for the switches to be added to the cluster. When a candidate device is added to a cluster, the management device assigns a private IP address to it for the candidate device to communicate with other devices in the cluster. This enables you to manage and maintain member devices in a cluster through the management device.
Execute these two commands on switches that do not belong to any cluster only. The IP address range of an existing cluster cannot be modified.
Examples
# Configure the IP address range of a cluster.
System View: return to User View with Ctrl+Z
[H3C] cluster
[H3C-cluster] ip-pool 10.200.0.1 20
1.3.17 logging-host
Syntax
logging-host ip-address
undo logging-host
View
Cluster view
Parameters
ip-address: IP address of the logging host configured for the cluster.
Description
Use the logging-host command to configure a logging host on the management device for the member devices in the cluster.
Use the undo logging-host command to remove the public logging host for the member devices in the cluster.
By default, no logging host is configured.
You need to configure the IP address of a logging host first for the member devices in a cluster to send log information to the logging host through the management device.
Examples
# Configure the IP address of the logging host on the management device.
System View: return to User View with Ctrl+Z
[aaa_0.H3C] cluster
[aaa_0.H3C-cluster] logging-host 10.10.10.9
1.3.18 reboot member
Syntax
reboot member { member-number | mac-address H-H-H } [ eraseflash ]
View
Cluster view
Parameters
member-number: Member number of a switch in a cluster, ranging from 1 to 255.
mac-address H-H-H: MAC address of the member device to be rebooted.
eraseflash: Deletes the configuration file when the member device reboots.
Description
Use the reboot member command to reboot a specified member device on the management device.
Communication between the management and member devices may be interrupted due to some configuration errors. Through the remote control function of member devices, you can control them remotely on the management device. For example, you can reboot a member device that operates improperly and specify to delete the booting configuration file when the member device reboots, and thus restore normal communication between the management and member devices.
The eraseflash keyword specifies to delete the booting configuration file when the member device reboots.
Examples
# Reboot the member device numbered 2.
<aaa_0.H3C> system-view
System View: return to User View with Ctrl+Z
[aaa_0.H3C] cluster
[aaa_0.H3C-cluster] reboot member 2
1.3.19 snmp-host
Syntax
snmp-host ip-address
undo snmp-host
View
Cluster view
Parameters
ip-address: IP address of a SNMP host to be configured for a cluster.
Description
Use the snmp-host command to configure an SNMP host for the member devices inside a cluster on the management device.
Use the undo snmp-host command to cancel the SNMP host configuration.
By default, no SNMP host is configured.
You need to configure the IP address of an SNMP host first for the cluster, in order that the member devices in a cluster can send trap messages to the SNMP host through the management device.
Examples
# Configure an SNMP host for the cluster on the management device.
System View: return to User View with Ctrl+Z
[aaa_0.H3C] cluster
[aaa_0.H3C-cluster] snmp-host 1.0.0.9
1.3.20 tftp get
Syntax
tftp { cluster | tftp-server } get source-file [ destination-file ]
View
User view
Parameters
cluster: Specifies the public TFTP server of the cluster.
tftp-server: IP address or host name of the TFTP server.
source-file: Name of the file to be downloaded from the public TFTP server of the cluster.
destination-file: Name of the downloaded file saved in the switch.
Description
Use the tftp { cluster | tftp-server } get command to download files from the specified directory on the public TFTP server of the cluster to the switch.
Related commands: tftp { cluster | tftp-server } put.
& Note:
You need to input the cluster keyword manually.
Examples
# Download the file named LANSwitch.app from the public TFTP server of the cluster to the switch and save it as vs.app.
<123_1.H3C> tftp cluster get LANSwitch.app vs.app
1.3.21 tftp put
Syntax
tftp { cluster | tftp-server } put source-file [ destination-file ]
View
User view
Parameters
cluster: Specifies the public TFTP server of the cluster.
tftp-server: IP address or host name of the TFTP server.
source-file: File to be uploaded to the server.
destination-file: Name of the uploaded file saved in the storage directory of the TFTP server.
Description
Use the tftp { cluster | tftp-server } put command to upload the file in the switch to the specified directory in the TFTP server.
Related commands: tftp { cluster | tftp-server } get.
& Note:
You need to input the cluster keyword manually.
Examples
# Upload the file named vrpcfg.txt in the switch to the public TFTP server of the cluster and save it as temp.txt.
<123_1.H3C> tftp cluster put vrpcfg.txt temp.txt
1.3.22 tftp-server
Syntax
tftp-server ip-address
undo tftp-server
View
Cluster view
Parameters
ip-address: IP address of a TFTP server to be configured for a cluster.
Description
Use the tftp-server command to configure a TFTP server for cluster members on the management device.
Use the undo tftp-server command to cancel the TFTP server of the cluster members.
By default, no TFTP server is configured.
You need to configure the IP address of the TFTP server for the cluster, in order that the member devices in the cluster can access the TFTP server through the management device.
Execute these two commands on management devices only.
Examples
# Configure a TFTP server on the management device.
<aaa_0.H3C> system-view
System View: return to User View with Ctrl+Z
[aaa_0.H3C] cluster
[aaa_0.H3C-cluster] tftp-server 1.0.0.9
1.3.23 timer
Syntax
timer interval
undo timer
View
Cluster view
Parameters
interval: Interval (in seconds) to send handshake packets. This argument ranges from 1 to 255.
Description
Use the timer command to set the interval to send handshake packets.
Use the undo timer command to restore the default value of the interval.
By default, the interval to send handshake packets is 10 seconds.
Inside a cluster, the connections between member devices and the management device are kept through transmitting handshake packets. Handshake packets in a cluster enable the management device to acquire the information about member states and link states.
Execute these two commands on management devices only. All the member devices in a cluster acquire the handshake interval setting from the management device.
Examples
# Configure the interval to send handshake packets to be 3 seconds.
<aaa_0.H3C> system-view
System View: return to User View with Ctrl+Z
[aaa_0.H3C] cluster
[aaa_0.H3C-cluster] timer 3