- Table of Contents
-
- H3C S5500-SI Series Ethernet Switches Command Manual(V1.01)
- 00-1Cover
- 01-Login Commands
- 02-VLAN Commands
- 03-IP Addressing and IP Performance Commands
- 04-QinQ-BPDU TUNNEL Commands
- 05-Port Correlation Commands
- 06-Link Aggregation Commands
- 07-MAC Address Table Management Commands
- 08-Port Security Commands
- 09-MSTP Commands
- 10-IPv6 Commands
- 11-IP Routing Overview Commands
- 12-IPv4 Routing Commands
- 13-IPv6 Routing Commands
- 14-Multicast Commands
- 15-802.1x-HABP-MAC Authentication Commands
- 16-AAA RADIUS HWTACACS Commands
- 17-ARP Commands
- 18-DHCP Commands
- 19-ACL Commands
- 20-QoS Commands
- 21-Port Mirroring Commands
- 22-UDP Helper Commands
- 23-Cluster Management Commands
- 24-SNMP-RMON Commands
- 25-NTP Commands
- 26-DNS Commands
- 27-File System Management Commands
- 28-Information Center Commands
- 29-System Maintaining and Debugging Commands
- 30-NQA Commands
- 31-SSH Commands
- 32-Track Commands
- 33-PoE Commands
- 34-SSL-HTTPS Commands
- 35-PKI Commands
- 36-Stack Management Commands
- 37-Appendix
- Related Documents
-
Title | Size | Download |
---|---|---|
23-Cluster Management Commands | 158 KB |
Chapter 1 Cluster Management Configuration Commands
1.1 NDP Configuration Commands
1.2 NTDP Configuration Commands
1.2.2 display ntdp device-list
1.2.3 display ntdp single-device mac-address
1.3 Cluster Configuration Commands
1.3.12 display cluster base-topology
1.3.13 display cluster black-list
1.3.14 display cluster candidates
1.3.15 display cluster current-topology
1.3.16 display cluster members
1.3.22 nm-interface vlan-interface
Chapter 1 Cluster Management Configuration Commands
1.1 NDP Configuration Commands
1.1.1 display ndp
Syntax
display ndp [ interface interface-list ]
View
Any view
Parameters
interface interface-list: Specifies an Ethernet port list, which can contain multiple Ethernet ports. The interface-list argument is in the format of interface-list = { interface-type interface-number [ to interface-type interface-number ] } & <1-10>,where, interface-type is port type and interface-number is port number, and &<1-10> means that you can provide up to 10 port indexes/port index lists for this argument.
Description
Use the display ndp command to display NDP configuration information, which includes the interval to send NDP packets, the time for the receiving device to hold NDP information and the information about the neighbors of all ports.
Examples
# Display NDP configuration information.
Neighbor Discovery Protocol is enabled.
Neighbor Discovery Protocol Ver: 1, Hello Timer: 60(s), Aging Timer: 180(s)
Interface: GigabitEthernet1/0/1
Status: Enabled, Pkts Snd: 0, Pkts Rvd: 0, Pkts Err: 0
Interface: GigabitEthernet1/0/2
Status: Enabled, Pkts Snd: 0, Pkts Rvd: 0, Pkts Err: 0
Interface: GigabitEthernet1/0/3
Status: Enabled, Pkts Snd: 0, Pkts Rvd: 0, Pkts Err: 0
Interface: GigabitEthernet1/0/4
Status: Enabled, Pkts Snd: 28440, Pkts Rvd: 27347, Pkts Err: 0
Neighbor 1: Aging Time: 122(s)
MAC Address : 00e0-fc00-2579
Host Name : Sysname
Port Name : Ethernet1/0/4
Software Ver: V100R001B01D013
Device Name : S3126C
Port Duplex : AUTO
Product Ver : 005
BootROM Ver : 137
Interface: GigabitEthernet1/0/5
Status: Enabled, Pkts Snd: 0, Pkts Rvd: 0, Pkts Err: 0
Interface: GigabitEthernet1/0/6
Status: Enabled, Pkts Snd: 0, Pkts Rvd: 0, Pkts Err: 0
Interface: GigabitEthernet1/0/7
Status: Enabled, Pkts Snd: 0, Pkts Rvd: 0, Pkts Err: 0
Interface: GigabitEthernet1/0/8
Status: Enabled, Pkts Snd: 0, Pkts Rvd: 0, Pkts Err: 0
Interface: GigabitEthernet1/0/9
Status: Enabled, Pkts Snd: 0, Pkts Rvd: 0, Pkts Err: 0
Interface: GigabitEthernet1/0/10
Status: Enabled, Pkts Snd: 28450, Pkts Rvd: 26520, Pkts Err: 0
Neighbor 1: Aging Time: 134(s)
MAC Address : 00e0-fc00-3133
Host Name : Sysname
Port Name : Ethernet1/0/11
Software Ver: V100R001B01D013
Device Name : S3126T
Port Duplex : AUTO
Product Ver : 005
Interface: GigabitEthernet1/0/11
Status: Enabled, Pkts Snd: 0, Pkts Rvd: 0, Pkts Err: 0
Interface: GigabitEthernet1/0/12
Status: Enabled, Pkts Snd: 0, Pkts Rvd: 0, Pkts Err: 0
Interface: GigabitEthernet1/0/13
Status: Enabled, Pkts Snd: 0, Pkts Rvd: 0, Pkts Err: 0
Interface: GigabitEthernet1/0/14
Status: Enabled, Pkts Snd: 0, Pkts Rvd: 0, Pkts Err: 0
Interface: GigabitEthernet1/0/15
Status: Enabled, Pkts Snd: 0, Pkts Rvd: 0, Pkts Err: 0
Interface: GigabitEthernet1/0/16
Status: Enabled, Pkts Snd: 0, Pkts Rvd: 0, Pkts Err: 0
Interface: GigabitEthernet1/0/17
Status: Enabled, Pkts Snd: 0, Pkts Rvd: 0, Pkts Err: 0
Interface: GigabitEthernet1/0/18
Status: Enabled, Pkts Snd: 0, Pkts Rvd: 0, Pkts Err: 0
Interface: GigabitEthernet1/0/19
Status: Enabled, Pkts Snd: 0, Pkts Rvd: 0, Pkts Err: 0
Interface: GigabitEthernet1/0/20
Status: Enabled, Pkts Snd: 0, Pkts Rvd: 0, Pkts Err: 0
Interface: GigabitEthernet1/0/21
Status: Enabled, Pkts Snd: 0, Pkts Rvd: 0, Pkts Err: 0
Interface: GigabitEthernet1/0/22
Status: Enabled, Pkts Snd: 0, Pkts Rvd: 0, Pkts Err: 0
Interface: GigabitEthernet1/0/23
Status: Enabled, Pkts Snd: 0, Pkts Rvd: 0, Pkts Err: 0
Interface: GigabitEthernet1/0/24
Status: Enabled, Pkts Snd: 0, Pkts Rvd: 0, Pkts Err: 0
Interface: GigabitEthernet1/0/25
Status: Enabled, Pkts Snd: 0, Pkts Rvd: 0, Pkts Err: 0
Interface: GigabitEthernet1/0/26
Status: Enabled, Pkts Snd: 0, Pkts Rvd: 0, Pkts Err: 0
Interface: GigabitEthernet1/0/27
Status: Enabled, Pkts Snd: 0, Pkts Rvd: 0, Pkts Err: 0
Interface: GigabitEthernet1/0/28
Status: Enabled, Pkts Snd: 0, Pkts Rvd: 0, Pkts Err: 0
Table 1-1 Description on the fields of the display ndp command
Field |
Description |
Neighbor Discovery Protocol is enabled |
NDP is enabled globally on the current device. |
Neighbor Discovery Protocol Ver |
Version of NDP |
Hello Timer |
Interval to send NDP packets |
Aging Timer |
The time for the receiving device to hold NDP information |
Interface |
A specified port |
Status |
NDP state of a port |
Pkts Snd |
Number of the NDP packets sent through the port |
Pkts Rvd |
Number of the NDP packets received on the port |
Pkts Err |
Number of the error NDP packets received |
Neighbor 1: Aging Time |
Aging time of the NDP information of a neighbor device |
MAC Address |
MAC address of a neighbor device |
Host Name |
Host name of a neighbor device |
Port Name |
Port name of a neighbor device |
Software Ver |
Software version of the neighbor device |
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 a neighbor device |
1.1.2 ndp enable
Syntax
In Ethernet interface view:
ndp enable
undo ndp enable
In system view:
ndp enable [ interface interface-list ]
undo ndp enable [ interface interface-list ]
View
System view, Ethernet interface view
Parameters
interface interface-list: Specifies an Ethernet port list, which can contain multiple Ethernet ports. The interface-list argument is in the format of interface-list = { interface-type interface-number [ to interface-type interface-number ] } & <1-10>, where interface-type represents the port type, interface-number represents the port number, and & <1-10> means that you can provide up to 10 port indexes/port index lists for this argument.
Description
Use the ndp enable command to enable NDP.
Use the undo ndp enable command to disable this feature.
By default, NDP is enabled globally and also on all ports.
Note that:
When being executed in system view, the ndp enable command enables NDP globally if you do not specify the interface interface-list argument. And if you specify the interface interface-list argument, the command enables NDP for the specified Ethernet port(s).
When being executed in Ethernet interface view, this command enables NDP for the current Ethernet port only.
The NDP cannot operate normally unless it is enabled on a specified port and globally.
l If the port connecting the management device to a member or candidate device is the port of a member in an aggregation group, you must enable NTDP on all ports of the members in the aggregation group; otherwise, NTDP cannot operate normally.
Examples
# Enable NDP globally.
<Sysname> system-view
[Sysname] ndp enable
# Enable NDP for port GigabitEthernet1/0/1
<Sysname> system-view
[Sysname] interface GigabitEthernet1/0/1
[Sysname-GigabitEthernet1/0/1 ndp enable
1.1.3 ndp timer aging
Syntax
ndp timer aging aging-time
undo ndp timer aging
View
System view
Parameters
aging-time: Time for a device to keep the NDP packets it receives, in the range 5 to 255 seconds.
Description
Use the ndp timer aging command to specify the time that a device should keep the NDP packets it received from the adjacent device. After the aging timer expires, the receiving device removes the corresponding entry.
Use the undo timer aging command to restore the default.
By default, the time that a receiving device should keep the NDP packets it received from the local device is 180 seconds.
Note that:
The time for the receiving device to hold NDP packets cannot be shorter than the interval to send NDP packets; otherwise, the NDP table may become instable.
Examples
# Configure the time that a receiving device should keep the NDP packets it received from the local device as 60 seconds.
<Sysname> system-view
[Sysname] ndp timer aging 60
1.1.4 ndp timer hello
Syntax
ndp timer hello hello-time
undo ndp timer hello
View
System view
Parameters
hello-time: Interval to send NDP packets, in the range 5 to 254 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.
By default, the interval to send NDP packets is 60 seconds.
Examples
# Set the interval to send NDP packets to 80 seconds.
<Sysname> system-view
[Sysname] ndp timer hello 80
1.1.5 reset ndp statistics
Syntax
reset ndp statistics [ interface interface-list ]
View
User view
Parameters
interface interface-list: Specifies an Ethernet port list, which can contain multiple Ethernet ports. The interface-list argument is in the format of interface-list = { interface-type interface-number [ to interface-type interface-number ] } & <1-10>, where interface-type represents the port type, interface-number represents the port number, and & <1-10> means that you can provide up to 10 port indexes/port index lists for this argument.
Description
Use the reset ndp statistics command to clear NDP statistics.
If no interface interface-list is specified, NDP statistics of all ports are cleared; otherwise, NDP statistics of a specified port are cleared.
Examples
# Clear NDP statistics of all ports.
<Sysname> 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 NTDP configuration information.
Examples
# Display the global NTDP information.
NTDP is running.
Hops : 4
Timer : 1 min(disable)
Hop Delay : 100 ms
Port Delay: 10 ms
Last collection total time: 92ms
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 (after the cluster is created) |
disable |
Indicates the device is not a management device and unable to perform periodical topology collection |
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.
Note that the information displayed may not be that of the latest device if you do not execute the ntdp explore command before using this command.
Examples
# Display the device list collected through NTDP.
<Sysname> display ntdp device-list
MAC HOP IP Device
00e0-fc00-3133 2 H3C S5500-28C-EI
000f-e20f-c415 2 31.31.31.5/24 H3C S5500-52C-EI
00e0-fc00-2579 1 H3C S5500-52C-PWR-EI
00e0-fc00-1751 0 31.31.31.1/24 H3C S5500-28F-EI
00e0-fc00-3199 3 H3C S5500-28F-EI
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 |
Device |
Device name |
# Display the detailed device information collected through NTDP.
<aabbcc_1.Sysname> display ntdp device-list verbose
Hostname : H3C
MAC : 00e0-fc00-3510
Hop : 1
Device : H3C S5500-28F-EI
IP :
Version :
H3C Versatile Routing Platform Software
Comware Software, Version 5.20
Copyright (c) 2004-2007 By H3C TECH CO., LTD.
H3C S5500-28F-EI V200R001B01D015SP01
Cluster : Member switch of cluster aabbcc , Administrator MAC: 00e0-fc00-600
0
Peer MAC Peer Port ID Native Port ID Speed Duplex
00e0-fc00-6000 GigabitEthernet1/0/9 GigabitEthernet1/0/14 100 FULL
--------------------------------------------------------------------------
Hostname : H3C
MAC : 00e0-fc00-6000
Hop : 0
Device : H3C S5500-52C-PWR-EI
IP :
Version :
H3C Versatile Routing Platform Software
Comware Software, Version 5.20
Copyright (c) 2004-2007 By H3C TECH CO., LTD.
H3C S5500-52C-PWR-EI V200R001B01D015SP01
Cluster : Administrator switch of cluster aabbcc
Peer MAC Peer Port ID Native Port ID Speed Duplex
00e0-fc00-3510 GigabitEthernet1/0/14 GigabitEthernet1/0/9 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 |
MAC |
MAC address of the device |
Hop |
Hops from the current device to the device that collect topology information |
Device |
Device name |
IP |
IP address and subnet mask length of the management VLAN interface on the device |
Version |
Version information |
Cluster |
Role of the device in the cluster |
Cluster : Member switch of cluster aabbcc |
The device is a member device of the cluster aabbcc. |
Administrator MAC |
MAC address of the management device |
Administrator switch of cluster aabbcc |
The device is the management device of the cluster aabbcc. |
Peer MAC |
MAC address of a neighbor device |
Peer Port ID |
Name of the peer port connected to the local port |
Native Port ID |
Name of the local port to which a neighbor device is connected |
Speed |
Speed of the local port to which a neighbor device is connected |
Duplex |
Duplex mode of the local port to which a neighbor device is connected |
1.2.3 display ntdp single-device mac-address
Syntax
display ntdp single-device mac-address mac-address
View
Any view
Parameters
mac-address: MAC address of the device, in the format of H-H-H.
Description
Use the display ntdp single-device mac-address command to view the detailed NTDP information of a specified device.
& Note:
Support for this command varies with devices.
Examples
# Display the detailed NTDP information of the device with a MAC address of 000f-e200-2200.
<Sysname> display ntdp single-device mac-address 000f-e200-2200
Hostname : H3C
MAC : 000f-e200-2200
Hop : 0
Device : H3C S5500-28F-EI
IP : 192.168.0.136/24
Version :
H3C Versatile Routing Platform Software
Comware Software, Version 5.20
Copyright (c) 2004-2007 By H3C TECH CO., LTD.
H3C S5500-28F-EI V200R001B01D015SP01
Cluster : Administrator switch of cluster king
Peer MAC Peer Port ID Native Port ID Speed Duplex
00e0-fc00-2420 GigabitEthernet1/0/1 Ethernet1/0/2 100 FULL
Refer to 0 for the description of the above prompt information.
1.2.4 ntdp enable
Syntax
ntdp enable
undo ntdp enable
View
System view, Ethernet interface view
Parameters
None
Description
Use the ntdp enable command to enable NTDP.
Use the undo ntdp enable command to disable NTDP.
By default, NTDP is enabled globally and on all ports.
Note that:
l Execution of the command in system view enables the global NTDP; execution of the command in Ethernet interface view enables NTDP of the current port.
l The NTDP cannot operate normally unless it is enabled on a specified port and globally.
l The ntdp enable command is contradictory to the bpdu-tunnel dot1q enable command in BPDU tunnel. You cannot configure both commands. For more information about BPDU Tunnel, refer to BPDU Tunnel Configuration in the Access Volume.
l If the port connecting the management device to a member or candidate device is the port of a member in an aggregation group, you must enable NTDP on all ports on the members in the aggregation group; otherwise, NTDP cannot operate normally.
Examples
# Enable NTDP globally.
<Sysname> system-view
[Sysname] ntdp enable
# Enable NTDP for port GigabitEthernet 1/0/1.
[Sysname] interface GigabitEthernet 1/0/1
[Sysname-GigabitEthernet1/0/1] ntdp enable
1.2.5 ntdp explore
Syntax
ntdp explore
View
User view
Parameters
None
Description
Use the ntdp explore command to start topology information collection manually.
Usually, the management device collects topology information periodically. You can also use this command to start topology information collection on the management device or an NTDP-enabled device. NTDP collects the NDP information of each device in a specific network range as well as the connection information of all its neighbors. Based on the collected information, the management device can know the network topology structure, so as to manage and monitor the member devices.
Examples
# Start the topology information collection.
<Sysname> ntdp explore
1.2.6 ntdp hop
Syntax
ntdp hop hop-value
undo ntdp hop
View
System view
Parameters
hop-value: Maximum hops for collecting topology information, in the range 1 to 16.
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.
By default, the value is 3.
Note that:
l 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.
l 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.
<Sysname> system-view
[Sysname] ntdp hop 5
1.2.7 ntdp timer
Syntax
ntdp timer interval-time
undo ntdp timer
View
System view
Parameters
interval-time: Interval (in minutes) to collect topology information, in the range 0 to 65,535. The value 0 means 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.
By default, the interval to collect topology information is 1 minute.
Note that:
l The management device can start to collect the topology information only after the cluster is set up.
l If you set a new interval, the topology information will be collected at this new interval.
Examples
# Set the interval to collect the topology information to 30 minutes.
<Sysname> system-view
[Sysname] ntdp timer 30
1.2.8 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 device receiving topology-collection requests to forward them through its first port. This argument ranges from 1 to 1,000.
Description
Use the ntdp timer hop-delay command to set the delay time for a device receiving topology-collection requests to forward them through its first port.
Use the undo ntdp timer hop-delay command to restore the default delay time, which is 200 ms.
To avoid network congestion caused by large amount of topology response packets received in short periods, a device waits for some time before it forwards a received topology-collection request through its first port.
Note that:
These two commands are intended for devices that collect topology information. They actually set the hop-delay value for topology-collection requests sent by these devices. The hop-delay value determines the delay time for a device receiving topology-collection requests to forward them through its first port.
Examples
# Set the delay time for the device to forward topology-collection requests through the first port to 300 ms.
<Sysname> system-view
[Sysname] ntdp timer hop-delay 300
1.2.9 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 device to forward a topology-collection request through its successive ports, in the range 1 to 100.
Description
Use the ntdp timer port-delay command to set the delay time for a device to forward a received topology-collection request through its successive ports.
Use the undo ntdp timer port-delay command to restore the default delay time, or 20 ms.
To avoid network congestion caused by large amount of topology responses received in short periods, a device waits for a specific period before it forwards a received topology-collection request through the next port.
Note that:
These two commands are intended for devices that collect topology information. They actually set the port-delay value for topology-collection requests sent by these switches. The port-delay value determines the delay time for a device receiving topology-collection requests to forward them through the next port.
Examples
# Set the delay time for the device to forward topology-collection requests through the successive ports to 40 ms.
<Sysname> system-view
[Sysname] ntdp timer port-delay 40
1.3 Cluster Configuration Commands
1.3.1 add-member
Syntax
add-member [ member-number ] mac-address mac-address [ password password ]
View
Cluster view
Parameters
member-number: Member number assigned to the candidate device to be added to a cluster. This argument varies with devices.
mac-address: MAC address of the candidate device (in hexadecimal form of H-H-H).
password: Password of the candidate device, a string of 1 to 16 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 super password.
Description
Use the add-member command to add a candidate device to a cluster.
Note that:
l You must add a cluster member through the management device.
l When adding a member device to a cluster, you need not assign a number to the device. The management device will automatically assign a usable number to the newly added member device.
l After a candidate device joins the cluster, its level 3 password is replaced by the super password of the management device in cipher text.
Caution:
If the routing table of a candidate device is full when the candidate device is added to a cluster, the candidate device will be added to and removed from the cluster repeatedly.
Examples
# Add a candidate device to the cluster, setting the member number to 6. (Assume that the MAC address and user password of the candidate device are 00E0-FC00-35E7 and 123456 respectively.)
<aabbcc_0.Sysname> system-view
[aabbcc_0.Sysname] cluster
[aabbcc_0.Sysname-cluster] add-member 6 mac-address 00e0-fc00-35e7 password 123456
1.3.2 administrator-address
Syntax
administrator-address mac-address name cluster-name
undo administrator-address
View
Cluster view
Parameters
mac-address: MAC address of the management device (in hexadecimal form of H-H-H).
cluster-name: Name of an existing cluster, a string of 1 to 8 characters, which can only be letters, numbers, subtraction sign (-), and underline (_).
Description
Use the administrator-address command to add a candidate device to a cluster.
Use the undo administrator-address command to remove a member device from the cluster.
By default, a device belongs to no cluster.
Note that:
l The administrator-address command is applicable on candidate devices only, while the undo administrator-address command is applicable on member devices only.
l You are recommended to use the delete-member command on the management device to remove a cluster member from a cluster.
Examples
# Remove a member device from the cluster.
<aabbcc_1.Sysname> system-view
[aabbcc_1.Sysname] cluster
[aabbcc_1.Sysname-cluster] undo administrator-address
1.3.3 auto-build
Syntax
auto-build [ recover ]
View
Cluster view
Parameters
recover: Automatically reestablishes communication with all the member devices.
Description
Use the auto-build command to establish a cluster automatically. When executing this command, you will be asked if you want to create a standard topology map.
Note that:
l This command can be executed on a candidate device or the management device.
l If you execute this command on a candidate device, you will be required to enter the cluster name to build a cluster. Then the system will collect candidates and add the collected candidates into the cluster automatically.
l If you execute this command on the management device, the system will collect candidates directly and add them into the cluster automatically.
l The recover keyword is used to recover a cluster. Using the auto-build recover command, you can find the members that are currently not in the member list and add them to the cluster again.
l 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.
l If a member is configured with a super password different from the super password of the management device, it cannot be added to the cluster automatically.
Caution:
l If the routing table of the management device is full when a cluster is created, meaning entries with the destination address as a candidate device cannot be added to the routing table, all candidate devices will be added to and removed from the cluster repeatedly.
l If the routing table of a candidate device is full when a candidate device is added to the cluster, meaning entries with the destination address as the management device cannot be added to the routing table, the candidate device will be added to and removed from the cluster repeatedly.
Examples
# Establish a cluster automatically.
[Sysname] cluster
[Sysname-cluster] auto-build
1.3.4 black-list add-mac
Syntax
black-list add-mac mac-address
View
Cluster view
Parameters
mac-address: MAC address of the device to be added into the blacklist, in the form of H-H-H.
Description
Use the black-list add-mac command to add a device to the blacklist.
Note that this command can be executed on the management device only.
Examples
# Add a device with the MAC address of 0EC0-FC00-0001 to the blacklist.
<aabbcc_0.Sysname> system-view
[aabbcc_0.Sysname] cluster
[aabbcc_0.Sysname-cluster] black-list add-mac 0ec0-fc00-0001
1.3.5 black-list delete-mac
Syntax
black-list delete-mac { all | mac-address }
View
Cluster view
Parameters
all: Deletes all devices from the blacklist.
mac-address: MAC address of the device to be deleted from the blacklist, in the form of H-H-H.
Description
Use the black-list delete-mac command to delete a device from the blacklist.
Note that this command can be executed on the management device only.
Examples
# Delete a device with the MAC address of 0EC0-FC00-0001 from the blacklist.
<aabbcc_0.Sysname> system-view
[aabbcc_0.Sysname] cluster
[aabbcc_0.Sysname-cluster] black-list delete-mac 0ec0-fc00-0001
# Delete all devices in the blacklist.
[aabbcc_0.Sysname-cluster] black-list delete-mac all
1.3.6 build
Syntax
build name
undo build
View
Cluster view
Parameters
name: Cluster name, a string of 1 to 8 characters, which can only be letters, numbers, subtraction sign (-), and underline (_).
Description
Use the build command to configure the current device as the management device and specify a name for it. When executing this command, you will be asked whether you want to create a standard topology map or not.
Use the undo build command to configure the current management device as a candidate device.
By default, the device is not a management device.
Note that:
l This command can only be applied to devices that are capable of being a management device and are not members of other clusters. The command takes no effect if you execute the command on a device which is already a member of another cluster. If you execute this command on a management device, you will replace the cluster name with the one you specify.
l The member number of the management device is 0.
Examples
# Configure the current device as a management device and specify the cluster name as aabbcc.
[Sysname] cluster
[Sysname-cluster] ip-pool 172.16.0.1 255.255.255.248
[Sysname-cluster] build aabbcc
1.3.7 cluster
Syntax
cluster
View
System view
Parameters
None
Description
Use the cluster command to enter cluster view.
Examples
# Enter cluster view
<Sysname> system-view
[Sysname] cluster
[Sysname-cluster]
1.3.8 cluster enable
Syntax
cluster enable
undo cluster enable
View
System view
Parameters
None
Description
Use the cluster enable command to enable the cluster function.
Use the undo cluster enable command to disable the cluster function.
By default, the cluster function is enabled.
Note that:
l When you execute the undo cluster enable command on a management device, you remove the cluster and its members, and the device stops operating as a management device.
l When you execute the undo cluster enable command on a member device, you disable the cluster function on the device, and the device leaves the cluster.
l When you execute the undo cluster enable command on a device that belongs to no cluster, you disable the cluster function on the device.
Examples
# Enable the cluster function.
<Sysname> system-view
[Sysname] cluster enable
1.3.9 cluster switch-to
Syntax
cluster switch-to { member-number | mac-address mac-address | administrator}
View
User view
Parameters
member-number: Number of a member device in a cluster, in the range 1 to 255.
mac-address mac-address: MAC address of a member device, in the format of H-H-H.
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.
Note that Telnet connection is used on the switch between the management device and member devices. Note the following when switching between them:
l Before the switch, use the telnet server enable command to enable Telnet; otherwise, the switch fails.
l Authentication is required when you switch a member device to the management device. The switch fails if authentication is not passed. Your user level is allocated according to the level predefined by the management device if authentication is passed.
l When a candidate device is added to a cluster, its super password will be automatically synchronized to the management device. Therefore, after a cluster is established, you are not recommended to modify the super password of any members (including the management device and member devices) of the cluster; otherwise, the switch may fail because of authentication failure.
l If member n does not exist when you execute this command on the management device, the system prompts error; if the switch succeeds, the user level of member n on the management device is retained.
l If the Telnet users on the device to be logged in reach the maximum number, the switch fails.
l To prevent resource waste, avoid recycling switch when configuring access between the management device and the member devices. For example, if you switch from the operation interface of the management device to that of a member device and then need to switch back to that of the management device, use the quit command to end the switch, but not the cluster switch-to administrator command to switch to the operation interface of the management device.
Examples
# Switch from the operation interface of the management device to that of the member device numbered 6 and then switch back to the operation interface of the management device.
<aaa_0.Sysname> cluster switch-to 6
<aaa_6.Sysname> quit
<aaa_0.Sysname>
1.3.10 delete-member
Syntax
delete-member member-number [ to-black-list ]
View
Cluster view
Parameters
member-number: Number of a member device in a cluster, in the range 1 to 255.
to-black-list: Adds the device removed from a cluster to the blacklist to prevent it from being added to the cluster.
Description
Use the delete-member command to remove a member device from the cluster.
Note that you should perform the operation to remove a member device from a cluster on the management device only.
Examples
# Remove the member device numbered 2 from the cluster.
<Sysname> system-view
[Sysname] cluster
[Sysname-cluster] ip-pool 10.1.1.1 24
[Sysname-cluster] build aaa
[aaa_0.Sysname-cluster] delete-member 2
# Remove the member device numbered 3 from the cluster, and add it to the blacklist.
[aaa_0.Sysname-cluster] delete-member 3 to-black-list
1.3.11 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 device belongs.
Note that this command can be executed on the management device and member devices only.
Examples
# Display cluster information on the management device.
<aaa_0.Sysname> display cluster
Cluster name:"aaa"
Role:Administrator
Management-vlan:100
Handshake timer:10 sec
Handshake hold-time:60 sec
IP-Pool:1.1.1.1/16
cluster-mac:0180-c200-000a
No logging host configured
No SNMP host configured
No FTP server configured
No TFTP server configured
2 member(s) in the cluster, and 0 of them down.
# Display cluster information on a member device.
<aaa_1.Sysname> display cluster
Cluster name:"aaa"
Role:Member
Member number:1
Management-vlan:100
cluster-mac:0180-c200-000a
Handshake timer:10 sec
Handshake hold-time:60 sec
Administrator device IP address:1.1.1.1
Administrator device mac address:00e0-fc00-1d00
Administrator status:Up
Table 1-5 Description on the fields of the display cluster command
Field |
Description |
Cluster name |
Name of the cluster |
Role |
Role of the switch in the cluster, Administrator means the current device is a management device and Member means the current device is a member device. |
Member number |
Member number of the switch in the cluster |
Management-vlan |
Management VLAN of the cluster |
Handshake timer |
Value of handshake timer |
Handshake hold-time |
Interval to send handshake packets |
IP-Pool |
Private IP addresses of the member devices in the cluster |
cluster-mac |
Multicast MAC address of cluster management packets |
Administrator device IP address |
IP address of the management device |
Administrator device mac address |
MAC address of the management device |
Administrator status |
State of the management device |
1.3.12 display cluster base-topology
Syntax
display cluster base-topology [ mac-address mac-address | member-id member-number ]
View
Any view
Parameters
mac-address: Specifies a device by its MAC address. The system will display the standard topology with the device as the root.
member-number: Specifies a device by its number. The system will display the standard topology with the device as the root.
Description
Use the display cluster topology command to display the standard topology of a cluster.
You can create a standard topology map when executing the build or auto-build command, or you can use the topology accept command to save the current topology map as the standard topology map.
Note that this command can be executed on the management device only.
Examples
# Display the standard topology of a cluster.
<aaa_0.Sysname> display cluster base-topology
--------------------------------------------------------------------
(PeerPort) ConnectFlag (NativePort) [SysName:DeviceMac]
--------------------------------------------------------------------
[aaa_0.Sysname:00e0-fc50-5500]
|
|--(P_1/0/6)<-->(P_1/0/6)[00e0-fc00-5700]
|
|--(P_1/0/8)<-->(P_1/0/8)[00e0-fc00-5150]
Table 1-6 Description on the fields of the display cluster base-topology command
Field |
Description |
PeerPort |
Peer port |
ConnectFlag |
Connection flag: <--> |
NativePort |
Local port |
SysName |
System name of the peer device |
DeviceMac |
MAC address of the peer device |
1.3.13 display cluster black-list
Syntax
display cluster black-list
View
Any view
Parameters
None
Description
Use the display cluster black-list command to display the current blacklist of a cluster.
Note that this command can be executed on the management device only.
Examples
# View the current blacklist of the cluster.
<aaa_0.Sysname> display cluster black-list
Device ID Access Device ID Access port
00e0-fc00-0010 00e0-fc00-3550 GigabitEthernet1/0/1
Table 1-7 Description on the fields of the display cluster black-list command
Field |
Description |
Device ID |
ID of the blacklist device, indicated by its MAC address. |
Access Device ID |
ID of the device connected to the blacklist device, indicated by its MAC address. |
Access port |
Port connected to the blacklist device. |
1.3.14 display cluster candidates
Syntax
display cluster candidates [ mac-address mac-address | verbose ]
View
Any view
Parameters
mac-address mac-address: Specifies the MAC address of a candidate device, in the format of H-H-H.
verbose: Displays the detailed information about a candidate device.
Description
Use the display cluster candidates command to display the information about the candidate devices of a cluster.
Note that the command can be executed on the management device only.
Examples
# Display the information about all the candidate devices.
<aaa_0.Sysname> display cluster candidates
MAC HOP IP Device
00e0-fc00-3199 3 S5500-SI
000f-cbb8-9528 1 31.31.31.56/24 S5500-SI
Table 1-8 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 |
Device |
Platform information of a device |
# Display the information about a specified candidate device.
<aaa_0.Sysname> display cluster candidates mac-address 00e0-fc61-c4c0
Hostname : LSW1
MAC : 00e0-fc61-c4c0
Hop : 1
Device : Sysname S5500-SI
IP : 1.5.6.9/16
# Display the detailed information about all the candidate devices.
<aaa_0.Sysname> display cluster candidates verbose
Hostname : 3100_4
MAC : 00e0-fc00-3199
Hop : 3
Device : S3100
IP :
Hostname : Sysname
MAC : 000f-cbb8-9528
Hop : 1
Device : S3100
IP : 31.31.31.56/24
Table 1-9 Description on the fields of display cluster candidates verbose
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 |
Device |
Platform information of a candidate device |
1.3.15 display cluster current-topology
Syntax
display cluster current-topology [ mac-address mac-address [ to-mac-address mac-address ] | member-id member-number [ to-member-id member-number ] ]
View
Any view
Parameters
member-number: Number of the devices in a cluster (including the management device and member devices).
mac-address: MAC addresses of the devices in a cluster (including the management device and member devices).
Description
Use the display cluster current-topology command to display the current topology information of the cluster.
l If you specify both the mac-address mac-address and to-mac-address mac-address arguments, the topology information of the devices that are in a cluster and form the connection between two specified devices is displayed.
l If you specify both the member-id member-number and to-member-id member-number arguments, the topology information of the devices that are in a cluster and form the connection between two specified devices is displayed.
l If you specify only the mac-address mac-address or member-id member-number argument, the topology information of all the devices in a cluster is displayed, with a specified device as the root node.
Note that this command can be executed on the management device only.
Examples
# Display the information of the current topology of a cluster.
<aaa_0.Sysname> display cluster current-topology
--------------------------------------------------------------------
(PeerPort) ConnectFlag (NativePort) [SysName:DeviceMac]
--------------------------------------------------------------------
ConnectFlag:
<--> normal connect ---> odd connect **** in blacklist
???? lost device ++++ new device -||- STP discarding
--------------------------------------------------------------------
[aaa_0.Sysname:00e0-fc50-5500]
|
|--(P_1/0/8)????(P_1/0/8)[00e0-fc00-5150]
|
| |--(P_1/0/6)????(P_1/0/6)[00e0-fc00-5700]
Table 1-10 Description on the fields of display cluster current-topology
Field |
Description |
PeerPort |
Peer port |
ConnectFlag |
Connection flag |
NativePort |
Local port |
SysName:DeviceMac |
System name of the device |
<--> normal connect |
Indicates a normal connection between the device and the management device |
---> odd connect |
Indicates a unidirectional connection between the device and the management device |
**** in blacklist |
Indicates the device is in the blacklist |
???? lost device |
Indicates a lost connection between the device and the management device |
++++ new device |
Indicates this is a new device, whose identity is to be recognized by the administrator |
-||- STP discarding |
STP is blocked |
& Note:
A new device in the topology information is identified based on the standard topology. After you add a device into a cluster, if you do not use the topology accept command to confirm the current topology and save it as the standard topology, this device is still regarded as a new device.
1.3.16 display cluster members
Syntax
display cluster members [ member-number | verbose ]
View
Any view
Parameters
member-number: Number of the member device, in the range 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.
Note that this command can be executed on the management device only.
Examples
# Display the information about all the devices in a cluster.
<aaa_0.Sysname> display cluster members
SN Device MAC Address Status Name
0 S5500-28C-EI 00e0-fc00-1751 Admin 123_0.5500-SI_1
2 S5500-28C-EI 00e0-fc00-3199 Up 123_2.5500-SI_4
4 S5500-28C-EI 00e0-fc00-2579 Up 123_4.5500-SI_2
5 S5500-28C-EI 000f-e20f-c415 Up 123_5.5500-SI_5
Table 1-11 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: l up: The member device which is up l down: The member which is down l deleting: The member which is being deleted l admin: The management device |
Name |
Name of a device |
# Display the detailed information about the management device and all member devices.
<aaa_0.Sysname> display cluster members verbose
Member number:0
Name:H3C_0.H3C
Device:H3C S5500-28C-EI
MAC Address:000f-e200-2200
Member status:Admin
Hops to administrator device:0
IP: 192.168.0.136/24
Version:
H3C Versatile Routing Platform Software
Comware Software, Version 5.20
Copyright (c) 2004-2007 By H3C TECH CO., LTD.
H3C S5500-28C-EI V200R001B01D015SP01
Member number:1
Name:H3C_1.H3C
Device:H3C S5510-24P
MAC Address:00e0-fc00-2420
Member status:Up
Hops to administrator device:1
IP: 192.168.0.156/24
Version:
H3C Versatile Routing Platform Software
Comware Software, Version 5.20
Copyright (c) 2004-2007 By H3C TECH CO., LTD.
H3C S5510-24P V500R003B03D008
Table 1-12 Description on the fields of display cluster members verbose
Field |
Description |
Member number |
Device member number |
Name |
Name of a member device, composed of the cluster name and the host name of the member device, in the format of cluster name.hostname When the management device type is not consistent with the member device type, if a user modifies the cluster name on the management device continuously, the cluster name may appear twice in the cluster member name, for example, “clustername.clustername.hostname”. This abnormal case can restore in a period of time. |
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.17 ftp-server
Syntax
ftp-server ip-address [ user-name username password { simple | cipher } password ]
undo ftp-server
View
Cluster view
Parameters
ip-address: IP address of the FTP server to be configured for the cluster.
username: Username used to log onto the FTP server, a string of 1 to 32 characters.
simple: Indicates that the password is in plain text.
cipher: Indicates that the password is in cipher text.
password: Password used to log onto the FTP server. This password must be in plain text when the simple keyword is specified, and can be in either plain text or cipher text when the cipher keyword is specified. A plain text password must be a string of no more than 16 characters, such as “aabbcc”. The cipher text password must have a fixed length of 24 characters, such as _(TT8F]Y\5SQ=^Q`MAF4<1!!.
Description
Use the ftp-server command to configure a public FTP server (by setting its IP address, username, and password) 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, a cluster is not configured with a public FTP server.
Note that the command can be executed on the management device only.
Examples
# Set the IP address, username and password of an FTP server on the management device to be 1.0.0.9, ftp, and in plain text respectively.
[Sysname] cluster
[Sysname-cluster] ip-pool 10.1.1.1 24
[Sysname-cluster] build aaa
[aaa_0.Sysname-cluster] ftp-server 1.0.0.9 user-name ftp password simple ftp
1.3.18 holdtime
Syntax
holdtime seconds
undo holdtime
View
Cluster view
Parameters
seconds: Holdtime in seconds, in the range 1 to 255.
Description
Use the holdtime command to configure the holdtime of a device.
Use the undo holdtime command to restore the default.
By default, the holdtime of a device is 60 seconds.
Note that:
l If the management does not receive any information of a member device during the holdtime, it sets the state of the member device to “Disconnect”. When the communication between the two resumes, the corresponding member device is re-added to the cluster (automatically). If the management device receives the information of a member device during the holdtime, the member device stays in the normal state and needs not to be added again.
l This command can be executed on the management device only. The configuration is valid on all member devices in a cluster.
Examples
# Set the holdtime to 30 seconds.
[Sysname] cluster
[Sysname-cluster] ip-pool 10.1.1.1 24
[Sysname-cluster] build aaa
[aaa_0.Sysname-cluster] holdtime 30
1.3.19 ip-pool
Syntax
ip-pool administrator-ip-address { mask | mask-length }
undo ip-pool
View
Cluster view
Parameters
administrator-ip-address: Private IP address of the management device in a cluster.
mask | mask-length: Mask of the IP address pool of a cluster. It is an integer or in dotted decimal notation. When it is an integer, it ranges from 1 to 30. A network address can be obtained by ANDing this mask with administrator-ip-address. The private IP addresses of all member devices in a cluster belong to this network segment.
Description
Use the ip-pool command to configure a private IP address range for cluster members on the device to be configured as the management device.
Use the undo ip-pool command to remove the IP address range configuration.
Note that:
l You must configure the IP address range on the management device only and before establishing a cluster. If a cluster has already been established, you are not allowed to change the IP address range.
l For a cluster to work normally, the IP addresses of the VLAN interfaces of the management device and member devices must not be in the same network segment as that of the cluster address pool.
Examples
# Configure the IP address range of a cluster.
[Sysname] cluster
[Sysname-cluster] ip-pool 10.200.0.1 20
1.3.20 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 for the member devices in a cluster.
Use the undo logging-host command to remove the logging host configuration.
By default, no logging host is configured.
Note that:
l This command can be executed on the management device only.
l You have to execute the info-center loghost command in system view first for the logging host you configured to take effect. For more information about the info-center loghost command, refer to Information Center Commands in the System Volume.
Examples
# Configure the IP address of the logging host on the management device.
[Sysname] cluster
[Sysname-cluster] ip-pool 10.1.1.1 24
[Sysname-cluster] build aaa
[aaa_0.Sysname-cluster] logging-host 10.10.10.9
1.3.21 management-vlan
Syntax
management-vlan vlan-id
undo management-vlan
View
System view
Parameters
vlan-id: ID of the management VLAN, in the range 1 to 4094.
Description
Use the management-vlan command to specify the management VLAN on a device.
Use the undo management-vlan command to restore the default.
By default, VLAN 1 is the management VLAN.
Note the following when configuring the management VLAN:
l The management VLAN must be specified before a cluster is created. Once a member device is added to a cluster, the management VLAN configuration cannot be modified. To modify the management VLAN for a device belonging to a cluster, you need to cancel the cluster-related configurations on the device, specify the desired VLAN to be the management VLAN, and then re-create the cluster.
l For the purpose of security, you are not recommended to configure the management VLAN as the default VLAN ID of the port connecting the management device and the member devices.
l Only when the default VLAN ID of all subtending ports and the port connecting the management device and the member device is the management VLAN, can the packets in the management VLAN packets be passed without a tag. Otherwise, you must configure the packets from a management VLAN to pass these ports. For the configuration procedure, refer to VLAN Configuration in the Access Volume.
Examples
# Specify VLAN 2 as the management VLAN.
<Sysname> system-view
[Sysname] management-vlan 2
1.3.22 nm-interface vlan-interface
Syntax
nm-interface vlan-interface vlan-interface-id
View
Cluster view
Parameters
vlan-interface-id: ID of the VLAN interface. The value range is the same as that of the existing VLAN interface ID.
Description
Use the nm-interface vlan-interface command to configure the VLAN interface of the access management device (including FTP/TFTP server, management host and log host) as the network management interface of the management device.
Examples
# Configure VLAN-interface 2 as the network management interface.
<aaa_0.Sysname> system-view
[aaa_0.Sysname] cluster
[aaa_0.Sysname-cluster] nm-interface vlan-interface 2
1.3.23 reboot member
Syntax
reboot member { member-number | mac-address mac-address } [ eraseflash ]
View
Cluster view
Parameters
member-number: Number of the member device, in the range 1 to 255.
mac-address mac-address: MAC address of the member device to be rebooted, in the format of H-H-H.
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.
Note that:
l Communication between the management and member devices may be interrupted due to some configuration errors. You can control the member devices remotely on the management device in this case. 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 achieve normal communication between the management and member devices.
l The eraseflash keyword specifies to delete the booting configuration file when the member device reboots.
Examples
# Reboot the member device numbered 2.
[Sysname] cluster
[Sysname-cluster] ip-pool 10.1.1.1 24
[Sysname-cluster] build aaa
[aaa_0.Sysname-cluster] reboot member 2
1.3.24 snmp-host
Syntax
snmp-host ip-address [ community-string read string1 write string2 ]
undo snmp-host
View
Cluster view
Parameters
ip-address: IP address of an SNMP host to be configured for a cluster.
string1: Community name of read-only access, a string of 1 to 26 characters.
string2: Community name of read-write access, a string of 1 to 26 characters.
Description
Use the snmp-host command to configure an SNMP host for the member devices inside a cluster.
Use the undo snmp-host command to cancel the SNMP host configuration.
By default, no SNMP host is configured.
Note that this command can be executed on the management device only.
Examples
# Configure an SNMP host for the cluster on the management device.
[Sysname] cluster
[Sysname-cluster] ip-pool 10.1.1.1 24
[Sysname-cluster] build aaa
[aaa_0.Sysname-cluster] snmp-host 1.0.0.9 community-string read 123 write 456
1.3.25 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.
Note that this command can be executed on the management device only.
Examples
# Configure a TFTP server on the management device.
[Sysname] cluster
[Sysname-cluster] ip-pool 10.1.1.1 24
[Sysname-cluster] build aaa
[aaa_0.Sysname-cluster] tftp-server 1.0.0.9
1.3.26 timer
Syntax
timer interval-time
undo timer
View
Cluster view
Parameters
interval-time: 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.
By default, the interval to send handshake packets is 10 seconds.
Note that this command can be executed on the management device only and is valid for all member devices in a cluster.
Examples
# Configure the interval to send handshake packets as 3 seconds.
[Sysname] cluster
[Sysname-cluster] ip-pool 10.1.1.1 24
[Sysname-cluster] build aaa
[aaa_0.Sysname-cluster] timer 3
1.3.27 topology accept
Syntax
topology accept { all [ save-to { ftp-server | local-flash } ] | mac-address mac-address | member-id member-number }
undo topology accept { all | mac-address mac-address | member-id member-number }
View
Cluster view
Parameters
all: Accepts the current cluster topology information as the standard topology information.
mac-address mac-address: Specifies a device by its MAC address. The device will be accepted to join the standard topology of the cluster.
member-id member-number: Specifies a device by its member number. The device will be accepted to join the standard topology of the cluster. The member-number argument is in the range 0 to 255.
save-to: Confirms the current topology as the standard topology, and backs up the standard topology on the FTP server or local flash in a file named “topology.top”.
Description
Use the topology accept command to confirm the current topology information and save it as the standard topology.
Use the undo topology accept to delete the standard topology information.
Note that:
l This command can be executed on the management device only.
l The file used to save standard topology on the FTP server or the local flash is named “topology.top”, which includes both the information of blacklist and whitelist. A blacklist contains the devices that are prohibited to be added to a cluster. A whitelist contains devices that can be added to a cluster.
Examples
# Take the current topology as the standard topology.
[Sysname] cluster
[Sysname-cluster] ip-pool 10.1.1.1 24
[Sysname-cluster] build aaa
[aaa_0.Sysname-cluster] topology accept all
1.3.28 topology restore-from
Syntax
topology restore-from { ftp-server | local-flash }
View
Cluster view
Parameters
ftp-server: Restores the standard topology information from the FTP server.
local-flash: Restores the standard topology information from the local flash.
Description
Use the topology restore-from command to restore the standard topology information from the FTP server or the local flash in case the cluster topology information is incorrect.
Note that this command can be executed on the management device only.
Examples
# Restore the standard topology.
[Sysname] cluster
[Sysname-cluster] ip-pool 10.1.1.1 24
[Sysname-cluster] build aaa
[aaa_0.Sysname-cluster] topology restore-from local-flash
1.3.29 topology save-to
Syntax
topology save-to { ftp-server | local-flash }
View
Cluster view
Parameters
ftp-server: Saves the standard topology information to the FTP server.
local-flash: Saves the standard topology information to the local flash.
Description
Use the topology save-to command to save the standard topology information to the FTP server or the local flash.
Note that:
l The file used to save standard topology on the FTP server or the local flash is named “topology.top”, which includes both the information of blacklist and whitelist. A blacklist contains the devices that are prohibited to be added to a cluster. A whitelist contains devices that can be added to a cluster.
l This command can be executed on the management device only.
Examples
# Save the standard topology information to the local flash.
<Sysname> system-view
[Sysname] cluster
[Sysname-cluster] ip-pool 10.1.1.1 24
[Sysname-cluster] build aaa
[aaa_0.Sysname-cluster] topology save-to local-flash