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 to hold NDP information and the information about the neighbors of all ports.

Example

# Display NDP configuration information.

<aa_0.Sysname> display ndp

Neighbor Discovery Protocol is enabled.

Neighbor Discovery Protocol Ver: 1, Hello Timer: 60(s), Aging Timer: 180(s)

Interface: Ethernet1/0/1

Status: Enabled, Pkts Snd: 0, Pkts Rvd: 0, Pkts Err: 0

Interface: Ethernet1/0/2

Status: Enabled, Pkts Snd: 1726, Pkts Rvd: 1741, Pkts Err: 0

Neighbor 1: Aging Time: 141(s)

MAC Address : 000f-e20f-2180

Host Name : H3C

Port Name : GigabitEthernet1/1/3

Software Ver: V500R001B02D005SP01

Device Name : H3C S3610-28F

Port Duplex : AUTO

Product Ver : ESS 0002

BootROM Ver : 123

Interface: Ethernet1/0/3

Status: Enabled, Pkts Snd: 0, Pkts Rvd: 0, Pkts Err: 0

(Omitted)

Interface: Ethernet1/0/48

Status: Enabled, Pkts Snd: 0, Pkts Rvd: 0, Pkts Err: 0

Interface: GigabitEthernet1/1/1

Status: Enabled, Pkts Snd: 0, Pkts Rvd: 0, Pkts Err: 0

Interface: GigabitEthernet1/1/2

Status: Enabled, Pkts Snd: 0, Pkts Rvd: 0, Pkts Err: 0

Interface: GigabitEthernet1/1/3

Status: Enabled, Pkts Snd: 0, Pkts Rvd: 0, Pkts Err: 0

Interface: GigabitEthernet1/1/4

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 on the current device
Neighbor Discovery Protocol Ver	Version of NDP
Hello Timer	Interval to send NDP packets
Aging Timer	Holdtime of the NDP information sent by the current device
Interface	A specified port
Status	NDP state of a specified port
Pkts Snd	Number of the NDP packets sent through the port
Pkts Rvd	Number of the NDP packets received
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	BootROM version of a neighbor device

1.1.2 ndp enable

Syntax

ndp enable [ interface interface-list ]

undo ndp enable [ interface interface-list ]

View

System view, Ethernet interface view

Parameter

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 globally or on a specified port.

Use the undo ndp enable command to disable this feature.

By default, NDP is enabled globally and also on all ports.

Note that:

l The NDP cannot operate if it is enabled on a port where NDP is disabled.

l When being executed in system view, the ndp enable command enables NDP globally if you do not provide the interface interface-list argument. And if you specify the interface interface-list argument, the command enables NDP for the specified Ethernet port(s).

l When being executed in Ethernet interface view, this command enables NDP for the current Ethernet port only. In this case, the interface-list argument is not needed.

Example

# Enable NDP globally.

<Sysname> system-view

[Sysname] ndp enable

1.1.3 ndp timer aging

Syntax

ndp timer aging aging-time

undo ndp timer aging

View

System view

Parameter

aging-time: Time for a device to keep the NDP packets it receives, in the range is 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 device discards the NDP packets it received.

Use the undo timer aging command to restore the default NDP information holdtime.

By default, the NDP information holdtime is 180 seconds.

Note that:

l You can specify how long an adjacent device shall 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.

l The NDP information holdtime is usually longer than the interval to send NDP packets. Otherwise, the neighbor information table of an NDP port will become unstable.

Example

# Configure the holdtime of the NDP information sent by the local switch to be 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

Parameter

hello-time: Interval of sending NDP packets, in the range of 5 seconds 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 interval to send NDP packets.

By default, the interval to send NDP packet is 60 seconds.

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.

Example

# 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

Parameter

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.

Example

# 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

Parameter

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.

Example

# Display the global NTDP information.

<Sysname> display ntdp

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. 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

Parameter

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.

Example

# Display the device list collected through NTDP.

<Sysname> display ntdp device-list

MAC HOP IP Device

000f-e200-2200 0 192.168.0.36/24 H3C S3610-52P

000f-e200-0000 1 192.168.0.236/24 H3C S3610-28F

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	Platform information about a device

# Display the detailed device information collected through NTDP.

<aabbcc_0.Sysname> display ntdp device-list verbose

Hostname : Sysname

MAC : 000f-e200-2200

Hop : 0

Device : H3C S3610-52P

IP : 192.168.0.36/24

Version :

H3C Comware Platform Software

Comware Software, Version 5.20

ESS 0002

Cluster : Administrator switch of cluster aaa

Peer MAC Peer Port ID Native Port ID Speed Duplex

000f-e200-0000 GigabitEthernet1/1/3 Ethernet1/0/4 100 FULL

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

Hostname : H3C

MAC : 000f-e200-0000

Hop : 1

Device : H3C S3610-28F

IP : 192.168.0.236/24

Version :

H3C Comware Platform Software

Comware Software, Version 5.20

ESS 0002

Cluster : Member switch of cluster aaa , Administrator MAC: 000f-e200-2200

Peer MAC Peer Port ID Native Port ID Speed Duplex

000f-e200-2200 Ethernet1/0/4 GigabitEthernet1/1/3 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 to the devices 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	Cluster information
Administrator MAC	MAC address of the management device
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 ntdp enable

Syntax

ntdp enable

undo ntdp enable

View

System view, Ethernet interface view

Parameter

None

Description

Use the ntdp enable command to enable NTDP globally or on a port.

Use the undo ntdp enable command to disable NTDP globally or on a port.

By default, NTDP is enabled globally and on ports.

Note that:

l You need to enable NTDP both globally and on specific ports for NTDP to operate properly.

l The NTDP function is not compatible with the BPDU TUNNEL function under a port. So, do not enable them at the same time. For information about BPDU Tunnel, refer to QinQ-BPDU TUNNEL Configuration of this manual.

Example

# Enable NTDP globally.

<Sysname> system-view

[Sysname] ntdp enable

# Enable NTDP for port GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] interface GigabitEthernet 1/0/1

[Sysname-GigabitEthernet1/0/1] ntdp enable

1.2.4 ntdp explore

Syntax

ntdp explore

View

User view

Parameter

None

Description

Use the ntdp explore command to start topology information collection manually.

Generally, NTDP collects network topology information periodically. You can also start topology information collection manually whenever needed by executing this command. When you execute this command, NTDP collects the NDP information of every device and the information about the connections between the local device and all of its neighbor devices in the specified network scope. The information is useful for the management device or network management system to acquire the network topology and to manage and monitor the devices.

Example

# Start the topology collection.

<Sysname> ntdp explore

1.2.5 ntdp hop

Syntax

ntdp hop hop-value

undo ntdp hop

View

System view

Parameter

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 range for topology information collection.

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.

Example

# Set the hop count for topology information collection to 5.

<Sysname> system-view

[Sysname] ntdp hop 5

1.2.6 ntdp timer

Syntax

ntdp timer interval-time

undo ntdp timer

View

System view

Parameter

interval-time: Interval (in minutes) to collect topology information, ranging from 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 interval.

B y default, the interval to collect topology information is 1 minute.

Note that:

l The management device starts 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.

l To disable candidate switches from joining a cluster automatically, set the interval to 0.

Example

# Set the interval to collect topology information to 30 minutes.

<Sysname> system-view

[Sysname] ntdp timer 30

1.2.7 ntdp timer hop-delay

Syntax

ntdp timer hop-delay time

undo ntdp timer hop-delay

View

System view

Parameter

time: Delay time (in milliseconds) for a device to forward topology-collection request packets. This argument ranges from 1 to 1,000.

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, which is 200 ms.

Note that:

l 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 packet through its first ports.

l These two commands are intended for devices that collect topology information. They actually set the hop-delay value for topology-collection request packets sent by these devices. The hop-delay value determines the delay time for a device receiving topology-collection request packets to forward them through its first port.

Example

# Set the delay time for the switch to forward topology-collection request packets through the first port to 300 ms.

<Sysname> system-view

[Sysname] 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

Parameter

time: Delay time (in milliseconds) for a device to forward a topology-collection request packet through its successive ports. This argument ranges from 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 packet through its successive ports.

Use the undo ntdp timer port-delay command to restore the default delay time, or 20 ms.

Note that:

l To avoid network congestion caused by large amount of topology response packets received in short periods, a device delays for specific period before it forwards a received topology-collection request packet through the next port.

l These two commands are intended for devices 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 device receiving topology-collection request packets to forward them through the next port.

Example

# Set the delay time for the device to forward topology-collection request packets 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

Parameter

member-number: Member number assigned to the candidate device to be added to a cluster. This argument ranges from 1 to 255.

mac-address: MAC address of the candidate device (in hexadecimal form of H-H-H).

password: Password of the candidate device, a string comprising 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 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; otherwise you will be prompted with an error message.

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 management password in cipher text.

Caution:

If the number of the routing table entries of a candidate device reaches the maximum number allowed when the candidate is added to a cluster, it will be added to and removed from the cluster repeatedly.

Example

# 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.)

<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 name

undo administrator-address

View

Cluster view

Parameter

mac-address: MAC address of the candidate device (in hexadecimal form of H-H-H).

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 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, usually for debugging or restoration.

By default, a device belongs to no cluster.

Note that:

l The administrator-address command is applicable on candidate device only, while the undo administrator-address command is applicable on member device only.

l A cluster contains one (and only one) management device. After rebooting, a member device identifies the management device by the MAC address of the management device.

l You are recommended to use the delete-member command to remove a cluster member from a cluster on the management device.

Example

# 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

Parameter

recover: Establishes communication with all the member devices again.

Description

Use the auto-build command to build 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 a management device.

l When you use this command on a candidate device, you will be required to enter the cluster name and build a cluster. Then the system will collect candidates and add the collected candidates into the cluster automatically.

l When you use this command on a 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 not currently 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 password different from the password of the management device, it cannot be added to the cluster automatically.

Caution:

When you configure a cluster, if the number of routing table entries reaches the maximum number allowed, no more routing table entries can be configured on a management device and candidate devices, which will result in the unreachability of handshake packets and the repeated add and removal of the device to and from the cluster:

l If the routing table entries of the management device reach the maximum number allowed when a cluster is created, all candidate devices will be added to and removed from the cluster repeatedly.

l If the number of the routing table entries of a candidate device reaches the maximum number allowed when the candidate device is added to a cluster, it will be added to and removed from the cluster repeatedly.

Example

# Set up a cluster automatically.

<Sysname> system-view

[Sysname] cluster

[Sysname-cluster] auto-build

Restore topology from local flash file.

(Please confirm in 30 seconds, default No). (Y/N)

Please input cluster name:aa

Collecting candidate list, please wait...

Candidate list:

Name Hops MAC Address Device

Sysname 1 000f-e200-0000 H3C S3610-28F

Sysname 1 00e0-fc02-2180 H3C S3552G

Sysname 2 00e0-fc00-5601 S5600

a 2 0012-a990-2241 S3900

2024C 2 000f-e200-00cc H3C S2024C

Processing...please wait

Cluster auto-build Finish!

2 member(s) added successfully.

[aa_0.Sysname-cluster]

1.3.4 black-list add-mac

Syntax

black-list add-mac mac-address

View

Cluster view

Parameter

mac-address: MAC address of the device to be added into blacklist, in the form of H-H-H.

Description

Use the black-list add-mac command to add a device to the blacklist.

This command must be executed on the management device.

Example

# Add a device to the blacklist.

<aa_0.Sysname> system-view

[aa_0.Sysname] cluster

[aa_0.Sysname-cluster] black-list add-mac 0ec0-fc00-0001

Insert the MAC to the black-list successfully!

1.3.5 black-list delete-mac

Syntax

black-list delete-mac { all | mac-address }

View

Cluster view

Parameter

mac-address: MAC address of the device to be deleted from the blacklist, in the form of H-H-H. This command must be executed on the management device.

Description

Use the black-list delete-mac command to delete a device from the blacklist.

Example

# Remove a device from the blacklist.

<aa_0.Sysname> system-view

[aa_0.Sysname] cluster

[aa_0.Sysname-cluster] black-list delete-mac 0ec0-fc00-0001

Delete MAC from the black-list successfully!

# Remove all the devices in the blacklist.

<aa_0.Sysname> system-view

[aa_0.Sysname] cluster

[aa_0.Sysname-cluster] black-list delete-mac all

The black-list is cleared!

1.3.6 build

Syntax

build name

undo build

View

Cluster view

Parameter

name: Name of the cluster to be created, a string of 1 to 8 characters, which can only be letters, numbers, subtraction sign (-), and underline (_).

Description

Use the build command to create a cluster with the current device as the management device and specify a name for the cluster. 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 to be 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 a management device is 0.

Note that after you create a cluster by executing the build command on a H3C S3610/S5510 switch, the switch collects network topology information according to the specified interval and add the candidate switches discovered to the cluster automatically. To disable candidate switches from being added to the cluster, you can set the NTDP timer to 0, which disables topology information collecting.

Example

# Create a cluster named “aabbcc” with the current device as the management device.

<Sysname> system-view

[Sysname] cluster

[Sysname-cluster] build aabbcc

Restore topology from local flash file,for there is no base topology.

(Please confirm in 30 seconds, default No). (Y/N)

[aabbcc_0.Sysname-cluster]

1.3.7 cluster

Syntax

cluster

View

System view

Parameter

None

Description

Use the cluster command to enter cluster view.

Example

# Enter cluster view

<Sysname> system-view

[Sysname] cluster

[Sysname-cluster]

1.3.8 cluster enable

Syntax

cluster enable

undo cluster enable

View

System view

Parameter

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 switch, 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.

Example

# 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

Parameter

member-number: Number of a member device in a cluster. This argument ranges from 1 to 255.

mac-address mac-address: MAC address of the member device, in the format of H-H-H.

administrator: Switches from a member device to the management device.

sysname member-sysname: System name of a member device, a string of 1 to 32 characters.

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 To switch to another device, make sure Telnet server is enabled on the peer device.

l Authentication is performed when you switch between management device and a member device. The system checks the super passwords of user level 3 of both sides and cancel the switching operation if they are not the same. After a candidate device joins a cluster, its super password is synchronized to that of the management device automatically. After the cluster is created, you are recommended not to modify the super passwords of both the cluster members and the management device for fear of switching failures.

l After you switch from the management device to a member device, the user level on the member device inherits that of the management device.

l When you switch from a member device to the management device, the user level is determined by the predefined setting on the management device.

l You will fail to switch to a device if the number of Telnet users on the device to be accessed reaches the upper limit.

l When being executed on the management device, this command generates an error message if the member device identified by the member-number argument does not exist or the device with the specified MAC address is not in the member list.

l Use the quit command to terminate switching.

l Avoid ring switching to prevent performance degrading. For example, if you switch from the management device to a member device and then want to switch back to the management device, execute the quit command instead of the cluster switch-to administrator command.

Example

# Switch from the management device to the member device numbered 6 and then switch back to the management device.

<aa_0.Sysname> cluster switch-to 6

Trying ...

Press CTRL+K to abort

Connected ...

* Without the owner's prior written consent, *

* no decompiling or reverse-engineering shall be allowed. *

**************************************************************************

<aa_6.Sysname> quit

The connection was closed by the remote host!

<aa_0.Sysname>

1.3.10 delete-member

Syntax

delete-member member-number [ to-black-list ]

View

Cluster view

Parameter

member-number: Number of a member device in a cluster. This argument ranges from 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.

Perform the operation to remove a member device from a cluster on the management device only. Otherwise, errors occur.

Example

# Remove the member device numbered 2 from the cluster.

<aaa_0.Sysname> system-view

[aaa_0.Sysname] cluster

[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> system-view

[aaa_0.Sysname] cluster

[aaa_0.Sysname-cluster] delete-member 2 to-black-list

1.3.11 display cluster

Syntax

display cluster

View

Any view

Parameter

None

Description

Use the display cluster command to display the state and statistics of the cluster to which the current device belongs.

Note that:

l When being executed on a member device, this command displays the information such as cluster name, member number of the current device, the MAC address and state of the management device, holdtime, and the interval to send packets.

l When being executed on a management device, this command displays the information such as cluster name, the number of the member devices in the cluster, cluster state, holdtime and the interval to send packets.

l Errors occur if you execute this command on a device that does not belong to any cluster.

Example

# Display cluster information about the management device.

<aa_0.Sysname> display cluster

Cluster name:"aa"

Role:Administrator

Management-vlan:1(default vlan)

Handshake timer:10 sec

Handshake hold-time:60 sec

IP-Pool: 11.1.1.1/24

No logging host configured

No SNMP host configured

No FTP server configured

No TFTP server configured

3 member(s) in the cluster, and 0 of them down.

# Display cluster information about the member devices.

<aa_2.Sysname> display cluster

Cluster name:"aa"

Role:Member

Member number:2

Management-vlan:1(default vlan)

Handshake timer:10 sec

Handshake hold-time:60 sec

Administrator device IP address:11.1.1.1

Administrator device mac address:000f-e20f-2200

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	Setting of the handshake timer
Handshake hold-time	Handshake holdtime
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

Parameter

mac-address: Specifies a node by its MAC address.

member-number: Number of the member device that serves as the base of the topology to be displayed.

Description

Use the display cluster topology command to display the standard topology map 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. This command must be executed on the management device only.

Example

# Display the standard topology of a cluster.

<aa_0.Sysname> display cluster base-topology

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

(PeerPort) ConnectFlag (NativePort) [SysName:DeviceMac]

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

[aa_0.Sysname:00e0-fc00-5502]

└-(P_1/0/6)<-->(P_0/2)[Sysname:00e0-fc02-2180]

└-(P_0/22)<-->(P_1/0/4)[Sysname:00e0-fc00-5111]

└-(P_0/16)<-->(P_1/0/4)[aa_3.a:0012-a990-2241]

└-(P_0/14)<-->(P_1/0/2)[aa_2.Sysname:00e0-fc00-5601]

└-(P_0/4)<-->(P_0/15)[2024C:000f-e200-00cc]

└-(P_0/1)<-->(P_3/0/33)[Sysname:00e0-fc00-1774]

└-(P_0/10)<-->(P_1/0/2)[aa_1.Sysname:000f-e200-2200]

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 device

1.3.13 display cluster black-list

Syntax

display cluster black-list

View

Any view

Parameter

None

Description

Use the display cluster black-list command to display the current blacklist of a cluster.

This command must be executed on the management device only.

Example

# View the current blacklist of the cluster.

<aa_0.Sysname> display cluster black-list

Device ID Access Device ID Access port

0022-3263-4460 000f-e20f-5500 Ethernet1/0/12

Table 1-7 Description on the fields of the display cluster black-list command

Field	Description
Device ID	ID of the device
Access Device ID	ID of the access device
Access port	Access port

1.3.14 display cluster candidates

Syntax

display cluster candidates [ mac-address mac-address | verbose ]

View

Any view

Parameter

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.

The command is applicable to the management devices only.

Example

# Display the information about all the candidate devices.

<Sysname> display cluster candidates

MAC HOP IP Device

00e0-fc00-3199 3 H3C S3610-52P

000f-cbb8-9528 1 31.31.31.56/24 H3C S3610-28F

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
Device	Platform information of a candidate device
IP	IP address of a candidate device

# Display the information about a specified candidate device.

<Sysname> display cluster candidates mac-address 000f-cbb8-9528

Hostname : LSW1

MAC : 000f-cbb8-9528

Hop : 1

Device : H3C S3610-28F

IP: 1.5.6.9/16

# Display the detailed information about all the candidate devices.

<Sysname> display cluster candidates verbose

Hostname : 3100_4

MAC : 00e0-fc00-3199

Hop : 3

Device : H3C S3610-52P

IP :

Hostname : Sysname

MAC : 000f-cbb8-9528

Hop : 1

Device : H3C S3610-28F

IP : 31.31.31.56/24

Table 1-9 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
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

Parameter

member-number: Number of the member device that serves as the base for the topology to be displayed, or number of the starting member and the ending number in a specific path.

mac-address: Specifies a node by its MAC address.

Description

Use the display cluster current-topology command to display the current topology map or the topology path between two devices.

This command is applicable to the management device only.

Example

# Display the information about the current topology of a cluster.

<aa_0.Sysname> display cluster current-topology

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

(PeerPort) ConnectFlag (NativePort) [SysName:DeviceMac]

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

ConnectFlag:

<--> normal connect ---> odd connect **** in blacklist

???? lost device ++++ new device -┤├- STP discarding

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

[aa_0.Sysname:00e0-fc00-5502]

└-(P_1/0/6)++++(P_0/2)[Sysname:00e0-fc02-2180]

├-(P_0/22)++++(P_1/0/4)[Sysname:00e0-fc00-5111]

├-(P_0/16)++++(P_1/0/4)[aa_5.a:0012-a990-2241]

├-(P_0/14)++++(P_1/0/2)[aa_4.Sysname:00e0-fc00-5601]

├-(P_0/10)++++(P_1/0/2)[aa_1.Sysname:000f-e200-2200]

├-(P_0/4)++++(P_0/15)[2024C:000f-e200-00cc]

└-(P_0/1)++++(P_3/0/33)[Sysname:00e0-fc00-1774]

Table 1-10 Description on the fields of the display cluster current-topology command

Field	Description
PeerPort	Peer port
ConnectFlag	Connection flag
NativePort	Local port
SysName	System name of the device
<--> normal connect	Normal connected
---> odd connect	Unidirectionally connected
**** in blacklist	The device is in the blacklist
???? lost device	Indicates a lost device
++++ new device	Indicates a new device
-\|\|- STP discarding	STP is blocked

& Note:

A new device in the topology information is identified based on the standard topology. After adding 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

Parameter

member-number: Number of the member device, in the range of 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.

This command is applicable to management devices only.

Example

# Display the information about all the devices in a cluster.

<aa_0.Sysname> display cluster members

SN Device MAC Address Status Name

0 H3C S3610-52P 000f-e20f-1751 Admin aa_0.Sysname

1 H3C S3610-28F 000f-e20f-0043 Up aa_1.Sysname

4 S3100 000f-e20f-2579 Up aa_4.3100_2

5 S3100 000f-e20f-c415 Up aa_5.3100_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, which can be: l Up, which indicates the device is up. l Down, which indicates the device is down. l Deleting, which indicates the device is deleted. l Admin, which indicates the device is the management device.
Name	Name of a device

# Display the detailed information about the management device and all member devices.

<aa_0.Sysname> display cluster members verbose

Member number:0

Name:aa_0.Sysname

Device: H3C S3610-52P

MAC Address:000f-e20f-1751

Member status:Admin

Hops to administrator device:0

IP: 31.31.31.1/24

Version:

H3C Comware Platform Software

Comware Software, Version 5.20

ESS 0002

Member number:1

Name:aa_1.Sysname

Device:H3C S3610-28F

MAC Address:000f-e200-0000

Member status:Up

Hops to administrator device:1

IP: 192.168.0.236/24

Version:

H3C Comware Platform Software

Comware Software, Version 5.20

ESS 0002

Table 1-12 Description on the fields of the display cluster members verbose command

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

Parameter

ip-address: IP address of the FTP server to be configured for the cluster.

username: Username used to log onto 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 ciphertext.

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 ciphertext when the cipher keyword is specified. A plain text password must a string of not more than 16 characters, such as “aabbcc”. The ciphertext 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, 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.

Example

# Configure the IP address, username and password of an FTP server on the management device.

<aa_0.Sysname> system-view

[aa_0.Sysname] cluster

[aa_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

Parameter

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 holdtime value.

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 downtime does not exceed the holdtime, the member device stays in the normal state and needs not to be added again.

l Execute these two commands on management devices only. The member devices in a cluster acquire the holdtime setting from the management device.

Example

# Set the holdtime to 30 seconds.

<aa_0.Sysname> system-view

[aa_0.Sysname] cluster

[aa_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

Parameter

administrator-ip-address: IP address of the management device of a cluster.

mask: Mask of the IP address pool of a cluster.

mask-length: Mask length of the cluster IP address pool, in the range 1 to 30.

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 cancel the IP address range configuration.

Note that:

l Before establishing a cluster, you need to configure a private IP address range for the devices 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.

l You must configure the IP address range on the management device only and configure 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 the cluster address pool.

Example

# Configure the IP address range of a cluster.

<Sysname> system-view

[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

Parameter

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 cancel the logging host configuration.

By default, no logging host is configured.

Note that:

l 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.

l This command must 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.

Example

# Configure the IP address of the logging host on the management device.

<aa_0.Sysname> system-view

[aa_0.Sysname] cluster

[aa_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

Parameter

vlan-id: ID of the VLAN to be specified as the management VLAN.

Description

Use the management-vlan command to specify the management VLAN on a device.

Use the undo management-vlan command to restore the default management VLAN.

By default, VLAN 1 is the management VLAN.

Note the following when configuring the management VLAN:

l The management VLANs specified on different devices in the same cluster must be the same VLAN.

l The management VLAN must be specified before the cluster is created. Once a 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.

Example

# 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-id

View

Cluster view

Parameter

vlan-id: ID of the VLAN. The value range is the same as that of the VLAN virtual interface ID.

Description

Use the nm-interface vlan-interface command to configure the network management interface of the management device.

Note that:

l For a cluster implemented with NAT protocol, the management VLAN interface of the management device serves as the default interface to configure NAT server. A NAT server provides conversion between internal IP address and public IP address. The NAT protocol enables devices from outside the cluster network to manage the devices in the cluster through SNMP, FTP and HTTP.

l If the VLAN to which the port of the access management device belongs is not the management VLAN where the NAT server is configured by default, IP address conversion is then impossible and an administrator from the external network is unable to log onto the management device to manage the member devices in the cluster.

l However, you can specify the network management interface for the management device to let NAT server functions on that interface instead of on the management VLAN. In this way, an administrator can access the management device through the network management interface to manage the devices in the cluster.

Example

# Configure VLAN-interface 2 as the network management interface.

<Sysname> system-view

[Sysname] cluster

[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

Parameter

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. 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 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.

Example

# Reboot the member device numbered 2.

<aa_0.Sysname> system-view

[aa_0.Sysname] cluster

[aa_0.Sysname-cluster] reboot member 2

This member will be rebooted. Continue?[Y/N]y

1.3.24 snmp-host

Syntax

snmp-host ip-address [ community-string read string1 write string2 ]

undo snmp-host

View

Cluster view

Parameter

ip-address: IP address of a SNMP host to be configured for a cluster.

string1: A string of 1-26 characters with read only access.

string2: A string of 1-26 characters with read and write access.

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.

Note that:

l You need to configure the IP address of an SNMP host first for the cluster, so that the member devices in a cluster can send trap messages to the SNMP host through the management device.

l This command must be executed on the management device only.

Example

# Configure an SNMP host for the cluster on the management device.

<aa_0.Sysname> system-view

[aa_0.Sysname] cluster

[aa_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

Parameter

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.

For member devices in a cluster to access the TFTP server through the management device, you need to configure the IP address of the TFTP server for the cluster.

Execute these two commands on management devices only.

Example

# Configure a TFTP server on the management device.

<aa_0.Sysname> system-view

[aa_0.Sysname] cluster

[aa_0.Sysname-cluster] tftp-server 1.0.0.9

1.3.26 timer

Syntax

timer interval-time

undo timer

View

Cluster view

Parameter

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 value of the interval.

By default, the interval to send handshake packets is 10 seconds.

Note that:

l Inside a cluster, the communication 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 link states.

l Execute these two commands on management devices only. The member devices in a cluster acquire the holdtime setting from the management device.

Example

# Configure the interval to send handshake packets to be 3 seconds.

<aa_0.Sysname> system-view

[aa_0.Sysname] cluster

[aa_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

Parameter

all: All devices.

mac-address: MAC address of the device bridge in topology authentication, in the format of H-H-H.

member-number: Number of the member device that serves as base for the topology to be displayed, or number of the starting member and the ending number in a specific path, in the range 0 to 255.

save-to: Saves the standard topology information, and backs it up 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 current topology information.

This command is applicable to the management device only.

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.

Example

# Take the current topology as the standard topology.

<aa_0.Sysname> system-view

[aa_0.Sysname] cluster

[aa_0.Sysname-cluster] topology accept all

1.3.28 topology restore-from

Syntax

topology restore-from { ftp-server | local-flash }

View

Cluster view

Parameter

None

Description

Use the topology restore-from command to restore the standard topology information from the FTP server or the local flash.

This command is applicable to the management device only.

Example

# Restore the standard topology.

<aa_0.Sysname> system-view

[aa_0.Sysname] cluster

[aa_0.Sysname-cluster] topology restore-from local-flash

Begin get base topology file from local flash......

Get file OK

Begin build base topology from file......

Finish building base topology from file

Begin build blacklist from file......

Finish building blacklist from file

1.3.29 topology save-to

Syntax

topology save-to { ftp-server | local-flash }

View

Cluster view

Parameter

None

Description

Use the topology save-to command to save the standard topology information to the FTP server or the local flash.

The information is saved in a file named “topology.top”, which includes both whitelist and blacklist devices.

This command is applicable to the management device only.

Example

# Save the standard topology information to the local flash.

<aa_0.Sysname> system-view

[aa_0.Sysname]cluster

[aa_0.Sysname-cluster] topology save-to local-flash

Base topology backup to file OK

Caution:

The topology save-to ftp-server command needs to be coupled with the FTP server software. However, some FTP server software (such as 3CDAEMON) cannot save topology information properly.

H3C S3610[S5510] Series Ethernet Switches Command Manual-Release 0001-(V1.02)

1.1 NDP Configuration Commands

1.1.2 ndp enable

1.1.3 ndp timer aging

1.2.3 ntdp enable

1.2.4 ntdp explore

1.3.4 black-list add-mac

1.3.5 black-list delete-mac

1.3.6 build

1.3.7 cluster

1.3.8 cluster enable

1.3.10 delete-member

1.3.11 display cluster

1.3.18 holdtime

1.3.19 ip-pool

1.3.20 logging-host

1.3.21 management-vlan

1.3.22 nm-interface vlan-interface

1.3.23 reboot member

1.3.24 snmp-host

1.3.25 tftp-server

1.3.26 timer

1.3.27 topology accept

1.3.28 topology restore-from

1.3.29 topology save-to

Intelligent Terminal Products

Product Support Services

Technical Service Solutions

Resource Center

Policy

Online Help

Become a Partner

Partner Policy & Program

Global Learning

Partner Sales Resources

Service Business

News & Events

Contact Us