interface port-list: Specifies a port list. The list can contain consecutive or separated ports, or the combination of the both. You need to provide the port-list argument in the form of interface-type interface-number [ to interface-type interface-number ] &<1-10>, where interface-type specifies the port type, and interface-number specifies the port number (in the form of unit ID/slot number/port number). to is used to specify a port range. &<1-10> means that you can provide up to ten port indexes/port index ranges for this argument.

Description

Use the display ndp command to display all NDP configuration and operating information, including the global NDP status, the interval to send NDP packets, the holdtime of NDP information, and the NDP status and neighbor information on all ports.

Use the display ndp interface command to display NDP configuration and operating information on specified ports.

Example

# Display all NDP configuration and operating information.

<aaa_0.H3C> 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: 15835, Pkts Rvd: 2879, Pkts Err: 0

Interface: Ethernet1/0/2

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

Interface: Ethernet1/0/3

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

Interface: Ethernet1/0/4

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

Interface: Ethernet1/0/5

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

Interface: Ethernet1/0/6

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

Interface: Ethernet1/0/7

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

Interface: Ethernet1/0/8

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

Interface: Ethernet1/0/9

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

Interface: Ethernet1/0/10

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

Interface: Ethernet1/0/11

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

Interface: Ethernet1/0/12

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

Interface: Ethernet1/0/13

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

Interface: Ethernet1/0/14

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

# Display NDP information about Ethernet1/0/1.

<aaa_0.H3C> display ndp interface Ethernet 1/0/1

Interface: Ethernet1/0/1

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

Neighbor 1: Aging Time: 147(s)

MAC Address : 00e0-fc00-3900

Port Name : Ethernet1/0/1

Software Ver: V100R002B01D001

Device Name : H3C S3100-52P

Port Duplex : AUTO

Product Ver : S3100-1510P02

Table 1-1 Description on the fields of the two commands

Field	Description
Neighbor Discovery Protocol is enabled	NDP is enabled globally on this switch.
Neighbor Discovery Protocol Ver: 1	NDP version 1 is running.
Hello Timer	Interval for this switch to send NDP packets
Aging Timer	Holdtime for neighbors to keep the NDP information of this switch
Interface	Port index, used to identify a port
Status	Enable/disable status of NDP on the port
Pkts Snd:	Number of NDP packets sent by the port
Pkts Rvd:	Number of NDP packets received by the port
Pkts Err:	Number of error NDP packets received by the port
Neighbor 1: Aging Time	Holdtime for this switch to keep the NDP information of the neighbor connected to the port
MAC Address	MAC address of the neighbor device
Port name	Port name of the neighbor device
Software Ver	Software version of the neighbor device
Device Name	Device name of the neighbor device
Port Duplex	Port (full/half) duplex mode of the neighbor device
Product Ver	Product version of the neighbor device

1.1.2 ndp enable

Syntax

ndp enable [ interface port-list ]

undo ndp enable [ interface port-list ]

View

System view, Ethernet port view

Parameter

Description

In system view:

Use the ndp enable command to enable NDP globally.

Use the undo ndp enable command to disable NDP globally.

When you execute the ndp enable command in system view without the interface keyword, NDP is enabled globally; when you do this with the interface keyword, NDP is enabled on specified ports.

In Ethernet port view:

Use the ndp enable command to enable NDP on the current port.

Use the undo ndp enable command to disable NDP on the port.

When using this command in Ethernet port view, you are not allowed to input the interface keyword and NDP is enabled on the current port only.

By default, NDP is enabled both globally and on ports.

Note that, unless NDP is enabled globally, it does not take effect on a port even when it is enabled on the port.

Example

# Enable NDP globally.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] ndp enable

1.1.3 ndp timer aging

Syntax

ndp timer aging aging-in-seconds

undo ndp timer aging

View

System view

Parameter

aging-in-seconds: Holdtime of the NDP information sent by this device, ranging from 5 to 255 seconds.

Description

Use the ndp timer aging command to set the holdtime of the NDP information sent by this switch. This command specifies how long receiving devices should hold the NDP neighbor information received from this device before discarding the information.

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

By default, the holdtime of NDP information is 180 seconds.

You can specify how long the adjacent devices should hold the NDP information received from this device. When an adjacent device receives a NDP packet from this device, it learns how long it should keep the NDP information of this device according to the holdtime carried in the NDP packet, and discards the NDP information when the holdtime expires.

Note that NDP information holdtime should be longer than the interval to send NDP packets. Otherwise, NDP port neighbor table will become unstable.

Example

# Set the holdtime of the NDP information sent by this switch to 60 seconds.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] ndp timer aging 60

1.1.4 ndp timer hello

Syntax

ndp timer hello timer-in-seconds

undo ndp timer hello

View

System view

Parameter

timer-in-seconds: Interval to send NDP packets, ranging from 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 interval.

By default, this interval is 60 seconds.

The NDP information hold on neighbors for this device should be updated regularly to reflect this device's changes in real time. You can use the ndp timer hello command to adjust the frequency in which neighbors update the NDP information of this device.

Note that NDP information holdtime should be longer than the interval to send NDP packets. Otherwise, NDP port neighbor table will become unstable.

Example

# Set the interval to send NDP packets to 80 seconds.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] ndp timer hello 80

1.1.5 reset ndp statistics

Syntax

reset ndp statistics [ interface port-list ]

View

User view

Parameter

Description

Use the reset ndp statistics command to clear NDP statistics.

Example

# Clear NDP statistics.

<H3C> 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 displayed information includes: topology collection range (hop count), topology collection interval (NTDP timer), device/port forward delay of topology collection requests, and time used by the last topology collection.

Example

# Display the global NTDP information.

<H3C> display ntdp

NTDP is running.

Hops : 4

Timer : 0 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 this device.
Hops	Hop count for topology collection
Timer	Interval to collect topology information "disable" means this switch is not a management device and does not perform periodic topology collection.
Hop Delay	Delay for other devices to forward topology collection requests
Port Delay	Delay for ports on other devices to forward topology collection requests
Last collection total time	Time used by the last topology collection

1.2.2 display ntdp device-list

Syntax

display ntdp device-list [ verbose ]

View

Any view

Parameter

verbose: Displays detailed device information.

Description

Use the display ntdp device-list command to display the device information collected by NTDP.

Example

# Display the list of devices collected by NTDP.

<H3C> display ntdp device-list

MAC HOP IP PLATFORM

00e0-fc00-3901 0 100.100.1.1/24 S3100-52P

00e0-fc00-3190 1 16.1.1.1/24 S3100-52P

Table 1-3 Description on the fields of the display ntdp device-list command

Field	Description
MAC	MAC address of a device collected by NTDP
HOP	Hops from this device to the collected device
IP	IP address and mask length of the management VLAN interface on the collected device
PLATFORM	Platform information about the collected device

# Display detailed device information collected by NTDP.

<H3C> display ntdp device-list verbose

Hostname : H3C

MAC : 00e0-fc00-3900

Hop : 0

Platform : S3100-52P

IP : 100.100.1.1/24

Version :

H3C Comware Platform Software

Comware Software, Version 3.10

S3100-52P

Cluster : Candidate switch

Peer MAC Peer Port ID Native Port ID Speed Duplex

00e0-fc00-3190 Ethernet1/0/22 Ethernet3/0/21 100 FULL

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

Hostname : S3100-3

MAC : 00e0-fc00-3190

Hop : 1

Platform : S3100-52P

IP : 16.1.1.1/24

Version :

H3C Comware Platform Software

Comware Software, Version 3.10

S3100-52P

Cluster : Candidate switch

Peer MAC Peer Port ID Native Port ID Speed Duplex

00e0-fc00-3900 Ethernet3/0/21 Ethernet1/0/22 100 FULL

5600-0000-3334 GigabitEthernet1/0/32 Ethernet1/0/4 100 FULL

Table 1-4 Description on the fields of the display ntdp device-list verbose command

Field	Description
Hostname	System name of a device collected by NTDP
MAC	MAC address of the collected device
Hop	Hops from this device to the collected device
Platform	Software platform of the collected device
IP	IP address and mask length of the cluster management VLAN interface on the collected device
Version	Software version of the collected device
Cluster	The role of the collected device for the cluster
Peer MAC	MAC address of a neighbor device connected to the collected device
Peer Port ID	Index of the port on the neighbor device connected to the collected device
Native Port ID	Index of the port on the collected device connected to the neighbor device
Speed	Speed of the neighbor device port
Duplex	Duplex mode of the neighbor device port

1.2.3 ntdp enable

Syntax

ntdp enable

undo ntdp enable

View

System view, Ethernet port view

Parameter

None

Description

In system view:

Use the ntdp enable command to enable NTDP globally.

Use the undo ntdp enable command to disable NTDP globally.

In Ethernet port view:

Use the ntdp enable command to enable NTDP on the current port.

Use the undo ntdp enable command to disable NTDP on the current port.

By default, NTDP is enabled both globally and on ports.

Note that even when NTDP is enabled on a port, it cannot operate on the port if NDP is disabled on the port.

Example

# Enable NTDP globally.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] ntdp enable

1.2.4 ntdp explore

Syntax

ntdp explore

View

User view

Parameter

None

Description

Use the ntdp explore command to manually start a topology collection process.

NTDP is able to periodically collect topology information. In addition, you can use this command to manually start a topology collection process at any moment. If you do this, NTDP collects NDP information from all devices in a specific network range as well as the connection information of all its neighbors. Through this information, the management device or the network management software knows the topology in the network range, and thus it can manage and monitor the devices in the range.

Example

# Start a topology collection process.

<H3C> ntdp explore

1.2.5 ntdp hop

Syntax

ntdp hop hop-value

undo ntdp hop

View

System view

Parameter

hop-value: Maximum hops to collect topology information, ranging from 1 to 16.

Description

Use the ntdp hop command to set the topology collection range.

Use the undo ntdp hop command to restore the default topology collection range.

By default, the topology collection range is three hops.

With the ntdp hop command, you can specify to collect topology information from the devices within a specified range to avoid infinite collection. That is, you can limit the range of topology collection by setting the maximum hops from the collecting device to the collected devices. For example, if you set the maximum hops to two, the switch initiating the topology collection collects topology information from the switches within two hops.

Note that this command is only applicable to topology-collecting device, and a wider collection range requires more memory of the topology-collecting device.

Example

# Set the topology collection range to 5 hops.

<aaa_0.H3C> system-view

System View: return to User View with Ctrl+Z.

[aaa_0.H3C] ntdp hop 5

1.2.6 ntdp timer

Syntax

ntdp timer interval-in-minutes

undo ntdp timer

View

System view

Parameter

interval-in-minutes: Interval (in minutes) to collect topology information, ranging from 0 to 65,535. Value 0 of this argument specifies not to perform periodic topology collection.

Description

Use the ntdp timer command to configure the interval to collect topology information periodically.

Use the undo ntdp timer command to restore the default interval.

By default, this interval is one minute.

After the interval is set to a non-zero value, the switch will collect topology information periodically at this interval.

Note that:

l If the display ntdp command displays "disable" in the Timer field, it means this device is not a management device and will not perform periodic topology collection.

l After a cluster is set up on an S3100-52P switch, the switch will collect the topology information of the network at the topology collection interval you set and automatically add the candidate devices it discovers into the cluster.

l If you do not want the candidate switches to be automatically added into the cluster, you can set the topology collection interval to zero.

Example

# Set the topology collection interval to 30 minutes.

<aaa_0.H3C> system-view

System View: return to User View with Ctrl+Z.

[aaa_0.H3C] ntdp timer 30

1.2.7 ntdp timer hop-delay

Syntax

ntdp timer hop-delay time

undo ntdp timer hop-delay

View

System view

Parameter

time: Device forward delay in milliseconds. This argument ranges from 1 to 1,000.

Description

Use the ntdp timer hop-delay command to set the delay for collected devices to forward topology collection requests through their first port.

Use the undo ntdp timer hop-delay command to restore the default device forward delay.

By default, the device forward delay is 200 ms.

Network congestion may occur if large amount of topology response packets reach the collecting device in a short period. To avoid this case, each collected switch in the network delays for a period before it forwards a received topology collection request through the first forwarding port. You can use the ntdp timer hop-delay command to set the delay.

You can use the command on a collecting switch. The delay value you set by the ntdp timer hop-delay command is carried in the topology collection requests sent by the collecting switch, and is used by collected devices to determine how long they should wait before they can forward the received topology collection requests through their first port.

Example

# Set the delay for collected switches to forward topology collection requests through their first port to 300 ms.

<aaa_0.H3C> system-view

System View: return to User View with Ctrl+Z.

[aaa_0.H3C] ntdp timer hop-delay 300

1.2.8 ntdp timer port-delay

Syntax

ntdp timer port-delay time

undo ntdp timer port-delay

View

System view

Parameter

time: Port forward delay in milliseconds. This argument ranges from 1 to 100.

Description

Use the ntdp timer port-delay command to set the delay for collected switches to forward topology collection requests through the next port.

Use the undo ntdp timer port-delay command to restore the default port forward delay.

By default, the port forward delay is 20 ms.

Network congestion may occur if large amount of topology response packets reach the collecting device in a short period. To avoid this case, after a collected switch forwards a received topology collection request through a port, it delays for a period before it forwards the request through the next port. You can use the ntdp timer port-delay command to set the delay.

You can use the command on a collecting switch. The delay value you set by the ntdp timer port-delay command is carried in the topology collection requests sent by the collecting switch, and is used by collected devices to determine how long they should wait before they forward the received topology collection requests through the next port.

Example

# Set the delay for collected switches to forward topology collection requests through the next port to 40 ms.

<aaa_0.H3C> system-view

System View: return to User View with Ctrl+Z.

[aaa_0.H3C] ntdp timer port-delay 40

1.3 Cluster Configuration Commands

1.3.1 add-member

Syntax

add-member [ member-number ] mac-address H-H-H [ password password ]

View

Cluster view

Parameter

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

H-H-H: MAC address of the candidate device to be added (in hexadecimal).

password: Password of the candidate device, a string of 1 to 256 characters. Password authentication is required when you add a candidate device to a cluster unless the candidate device is not configured with a password (in this case, you need not input this argument).

Description

Use the add-member command to add a candidate device to the cluster.

You can only use this command on the management device of a cluster.

If you do not specify the member number when adding a new cluster member, the management device assigns the next available member number to the new member.

After you add a candidate device to the cluster, the password of the device automatically changes to the management device password.

Note that, after a cluster is set up on an S3100-52P switch, the switch will collect the topology information of the network at the topology collection interval you set and automatically add the candidate devices it discovers into the cluster. If you do not want the candidate switches to be automatically added into the cluster, you can set the topology collection interval to zero (by the ntdp timer command), which specifies not to perform periodic topology collection.

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

<aaa_0.H3C> system-view

System View: return to User View with Ctrl+Z.

[aaa_0.H3C] cluster

[aaa_0.H3C-cluster] add-member 6 mac-address 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 management device to be set.

name: Name of an existing cluster, a string of up to 8 characters, which can only be alphanumeric characters, minus signs (-), and underscores (_).

Description

Use the administrator-address command to add a device to a cluster by setting the management device MAC address and cluster name of a cluster on the device.

Use the undo administrator-address command to remove a member device from the cluster.

The commands here are generally used for debugging and restore purpose.

By default, a switch does not belong to any cluster.

A cluster has one and only one management device. After you set the MAC address of the management device on a member device, the member device is still able to identify the management device after system reboot.

It is recommended to use the delete-member command to remove a member from a cluster on the management device.

Example

# Remove a member device from the cluster.

<aaa_1.H3C> system-view

System View: return to User View with Ctrl+Z

[aaa_1.H3C] cluster

[aaa_1.H3C-cluster] undo administrator-address

1.3.3 auto-build

Syntax

auto-build [ recover ]

View

Cluster view

Parameter

recover: Recovers all member devices automatically.

Description

Use the auto-build command to start an automatic cluster building process.

You can execute this command on a candidate device as well as on a management device.

When you execute this command on a candidate device, you are prompted to enter a cluster name to build a cluster. Then, the system automatically collects candidate devices and adds them to the cluster.

When you execute this command on a management device, the system directly collects candidate devices ant automatically adds them to the cluster.

The recover keyword is used to recover a cluster. After you execute the auto-build recover command, the system looks for the down members in the member list and add them to the cluster again.

Note that, the collection of candidate/member devices are based on NTDP. So you must first enable NTDP. In addition, you can use the ntdp hop command in system view to change the collection range.

When the system automatically adds a device to the cluster, if the user password configured for the device is different from that of the management device, the device will not be successfully added to the cluster.

Example

# Start an automatic cluster building process.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] cluster

[H3C-cluster] auto-build

Please input cluster name:aaa

Collecting candidate list, please wait...

Candidate list:

Name Hops MAC Address Device

Processing...please wait

Cluster auto-build Finish!

0 member(s) added successfully.

[aaa_0.H3C-cluster]

1.3.4 build

Syntax

build name

undo build

View

Cluster view

Parameter

name: Name to be set for the cluster, a string of up to 8 characters, which can only be alphanumeric characters, minus signs (-), and underscores (_).

Description

Use the build command to build a cluster with a cluster name or change the cluster name.

Use the undo build command to remove the cluster.

You can use this command on a candidate device as well as on a management device.

Executing the build command on a candidate device will change the device to a management device and assign a name to the cluster created on the device.

Executing the build command on a management device will change the cluster name of the management device.

The member number of a management device is 0.

Note that, after a cluster is set up on an S3100-52P switch, the switch will collect the topology information of the network at the topology collection interval you set and automatically add the candidate devices it discovers into the cluster. If you do not want the candidate switches to be automatically added into the cluster, you can set the topology collection interval to zero (by the ntdp timer command), which specifies not to perform periodic topology collection.

& Note:

To reduce the risk of being attacked by malicious users against opened socket and enhance switch security, the S3100-52P Ethernet switches provide the following functions, so that a cluster socket is opened only when it is needed:

l Opening UDP port 40000 (used for cluster) only when the cluster function is implemented,

l Closing UDP port 40000 at the same time when the cluster function is closed.

On the management device, the preceding functions are implemented as follows:

l When you create a cluster by using the build or auto-build command, UDP port 40000 is opened at the same time.

l When you remove a cluster by using the undo build or undo cluster enable command, UDP port 40000 is closed at the same time.

On member devices, the preceding functions are implemented as follows:

l When you execute the add-member command on the management device to add a candidate device to a cluster, the candidate device changes to a member device and its UDP port 40000 is opened at the same time.

l When you execute the auto-build command on the management device to have the system automatically add candidate devices to a cluster, the candidate devices change to member devices and their UDP port 40000 is opened at the same time.

l When you execute the administrator-address command on a device, the device's UDP port 40000 is opened at the same time.

l When you execute the delete-member command on the management device to remove a member device from a cluster, the member device's UDP port 40000 is closed at the same time.

l When you execute the undo build command on the management device to remove a cluster, UDP port 40000 of all the member devices in the cluster is closed at the same time.

l When you execute the undo administrator-address command on a member device, UDP port 40000 of the member device is closed at the same time.

Example

# Configure the current switch as a management device and set the cluster name to aaa.

<H3C> system-view

System View: return to User View with Ctrl+Z

[H3C] cluster

[H3C-cluster] build aaa

1.3.5 cluster

Syntax

cluster

View

System view

Parameter

None

Description

Use the cluster command to enter cluster view.

Example

# Enter cluster view.

<H3C> system-view

System View: return to User View with Ctrl+Z

[H3C] cluster

[H3C-cluster]

1.3.6 cluster enable

Syntax

cluster enable

undo cluster enable

View

System view

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.

To create a cluster on a device with the build command, you must first execute the cluster enable command.

You can use the two commands on any devices that support the cluster function.

l When you execute the undo cluster enable command on a management device, the cluster and all its members are removed, the device stops operating as a management device, and the cluster function is disabled on the device.

l When you execute the undo cluster enable command on a member device, the device leaves the cluster, and the cluster function is disabled on the device.

l When you execute undo cluster enable command on a device that does not belong to any cluster, the cluster function is disabled on the device.

Example

# Enable the cluster function on a switch.

<H3C> system-view

System View: return to User View with Ctrl+Z

[H3C] cluster enable

1.3.7 cluster switch-to

Syntax

cluster switch-to { member-number | mac-address H-H-H | administrator }

View

User view

Parameter

member-number: Member number of a member device, ranging from 1 to 255.

mac-address H-H-H: Specifies the MAC address of a member device.

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

Description

Use the cluster switch-to command to switch between the management device and a member device for configuration and management.

On the management device, you can switch to the view of a member device to configure and manage the member device, and then switch back to the management device.

Both switching directions (from the management device to a member device, and from a member device to the management device) will use Telnet connection. Switching is performed based on the following rules:

l Both switching directions will perform authentication. In a switching process, the system will authenticate the level-3 super password. If the super password on the device that requests the switching is inconsistent with that on the requested device, the switching fails. When a candidate device joins the cluster, its super password will automatically synchronize to the supper password on the management device. It is recommended not to change the super password of any cluster member or the management device, so as to avoid switching failure resulting from authentication failure.

l After you switch from the management device to a member device, the member device view will inherit the user privilege level of the current management device view.

l After you switch from a member device to the management device, the privilege level on the management device view will be determined by the configuration on the management device.

l If all the Telnet resources on the requested device are used up, the switching to the device will not succeed.

When you execute this command on the management device with an inexistent member number or a MAC address that is not in the member list, an error will occur. In this case, you can enter quit to end the switching.

Example

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

<aaa_0.H3C> cluster switch-to 6

<aaa_6.H3C> quit

<aaa_0.H3C>

1.3.8 cluster-mac

Syntax

cluster-mac H-H-H

undo cluster-mac

View

Cluster view

Parameter

H-H-H: Multicast MAC address to be set for the cluster, in hexadecimal format. This argument can be one of the following addresses: 0180-C200-0000, 0180-C200-000A, 0180-C200-0020 to 0180-C200-002F.

Description

Use the cluster-mac command to configure a multicast MAC address for the cluster.

Use the undo cluster-mac command to restore the default multicast MAC address.

The default multicast MAC address is 0180-C200-000A.

Note that, you can only use this command on a management device.

The management device in a cluster is able to periodically broadcast HGMP V2 multicast MAC synchronization packets. After you configure a multicast MAC address on the management device, all the member/candidate devices of the cluster will synchronize to the same multicast MAC address by receiving multicast MAC synchronization packets. This guarantees that the member/candidate devices of the cluster can receive the multicast packets from the management device.

Example

# Configure multicast MAC address 0180-C200-0028 for the cluster.

<aaa_0.H3C> system-view

System View: return to User View with Ctrl+Z.

[aaa_0.H3C] cluster

[aaa_0.H3C-cluster] cluster-mac 0180-C200-0028

1.3.9 cluster-mac syn-interval

Syntax

cluster-mac syn-interval time-interval

View

Cluster view

Parameter

time-interval: Interval to send HGMP V2 multicast MAC synchronization packets, ranging from 0 to 30 minutes.

Description

Use the cluster-mac syn-interval command to set the interval for the management device to send HGMP V2 multicast MAC synchronization packets periodically. You can only use this command on a management device.

By default, this interval is one minute.

If you set this interval to zero on a management device, the management device will not send HGMP V2 multicast MAC synchronization packets to other devices.

Example

# Set the interval for the management device to send HGMP V2 multicast MAC synchronization packets to one minute.

<aaa_0.H3C> system-view

System View: return to User View with Ctrl+Z.

[aaa_0.H3C] cluster

[aaa_0.H3C-cluster] cluster-mac syn-interval 1

1.3.10 delete-member

Syntax

delete-member member-number

View

Cluster view

Parameter

member-number: Member number of a member device, ranging from 1 to 255.

Description

Use the delete-member command to remove a member device from the cluster.

You can only perform the operation on a management device. Otherwise, error will occur.

Note that, after a cluster is set up on an S3100-52P switch, the switch will collect the topology information of the network at the topology collection interval you set and automatically add the candidate devices it discovers into the cluster. If you do not want the candidate switches to be automatically added into the cluster, you can set the topology collection interval to zero (by the ntdp timer command), which specifies not to perform periodic topology collection.

Example

# Remove number-2 member device from the cluster.

<aaa_0.H3C> system-view

System View: return to User View with Ctrl+Z.

[aaa_0.H3C] cluster

[aaa_0.H3C-cluster] delete-member 2

1.3.11 display cluster

Syntax

display cluster

View

Any view

Parameter

None

Description

Use the display cluster command to display the status and statistics information of the cluster to which the current switch belongs.

Executing this command on a member device will display the following information: cluster name, member number of the current switch, MAC address and status of the management device, holdtime, and interval to send handshake packets.

Executing this command on a management device will display the following information: cluster name, number of the member devices in the cluster, cluster status, holdtime, and interval to send handshake packets.

Executing this command on a device that does not belong to any cluster will display an error.

Example

# Display cluster information on a management device.

<aaa_0.H3C-cluster> display cluster

Cluster name:"aaa"

Role:Administrator

Management-vlan:100

Handshake timer:10 sec

Handshake hold-time:60 sec

IP-Pool:20.1.1.1/24

cluster-mac:0180-c200-000a

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 on a member device.

[aaa_2.S3100-3] display cluster

Cluster name:"aaa"

Role:Member

Member number:2

Management-vlan:100

cluster-mac:0180-c200-000a

Handshake timer:10 sec

Handshake hold-time:60 sec

Administrator device mac address:00e0-fc00-3901

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 this switch
Member number	Member number of this switch
Handshake timer	Interval to send handshake packets
Handshake hold-time	Holdtime
Administrator device mac address	MAC address of the management device
Administrator status	Status of the management device

1.3.12 display cluster candidates

Syntax

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

View

Any view

Parameter

mac-address H-H-H: Specifies the MAC address of a candidate device.

verbose: Displays detailed information about candidate devices.

Description

Use the display cluster candidates command to display information about one specified or all candidate devices of a cluster.

You can only use this command on a management device.

Note that, after a cluster is set up on an S3100-52P switch, the switch will collect the topology information of the network at the topology collection interval you set and automatically add the candidate devices it discovers into the cluster. As a result, if the topology collection interval is too short (the default interval is 1 minute), the switches acting as candidate devices will not keep in candidate state for a long time – they will change to member devices within a short time. If you do not want the candidate switches to be automatically added into the cluster, you can set the topology collection interval to zero (by using the ntdp timer command), which specifies not to perform topology collection periodically.

Example

# Display information about all candidate devices.

<aaa_0.H3C-cluster> display cluster candidates

MAC HOP IP PLATFORM

3900-0000-3334 2 16.1.1.11/24 S3100-52P

00e0-fc00-3190 1 16.1.1.1/24 S3100-52P

Table 1-6 Description on the fields of the display cluster candidates command

Field	Description
MAC	MAC address of a candidate device
Hop	Hops from the management device to the candidate device
IP	IP address of the candidate device
Platform	Platform of the candidate device

# Display information about a specified candidate device.

<aaa_0.H3C-cluster> display cluster candidates mac-address 00e0-fc00-3190

Hostname : S3100-3

MAC : 00e0-fc00-3190

Hop : 1

Platform : S3100-52P

IP : 16.1.1.1/24

# Display detailed information about all candidate devices.

[aaa_0.H3C-cluster] display cluster candidates verbose

Hostname : H3C

MAC : 3900-0000-3334

Hop : 2

Platform : S3100-52P

IP : 16.1.1.11/24

Hostname : S3100-3

MAC : 00e0-fc00-3190

Hop : 1

Platform : S3100-52P

IP : 16.1.1.1/24

Table 1-7 Description on the fields of the display cluster candidates verbose command

Field	Description
Hostname	Name of a candidate device
MAC	MAC address of the candidate device
Hop	Hops from the management device to the candidate device
IP	IP address of the candidate device
Platform	Platform of the candidate device

1.3.13 display cluster members

Syntax

display cluster members [ member-number | verbose ]

View

Any view

Parameter

member-number: Member number of a device, ranging from 0 to 255.

verbose: Displays detailed information about all the devices in a cluster.

Description

Use the display cluster members command to display information about one specific or all devices in a cluster.

You can only use this command on a management device.

Example

# Display information about all devices in a cluster.

<aaa_0.H3C-cluster> display cluster members

SN Device MAC Address Status Name

0 S3100-52P 00e0-fc00-3901 Admin aaa_0.H3C

1 S3100-52P 3900-0000-3334 Up aaa_1.H3C

2 S3100-52P 00e0-fc00-3190 Up aaa_2.S3100-3

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

Field	Description
SN	Member number of a device in the cluster
Device	Device type
MAC Address	Device MAC address
Status	Device status
Name	Device name

# Display detailed information about all devices in a cluster.

<aaa_0.H3C-cluster> display cluster members verbose

Member number:0

Name:aaa_0.H3C

Device:S3100-52P

MAC Address:00e0-fc00-3901

Member status:Admin

Hops to administrator device:0

IP: 100.100.1.1/24

Version:

H3C Comware Platform Software

Comware Software, Version 3.10

S3100-52P

Member number:1

Name:aaa_1.H3C

Device:S3100-52P

MAC Address:3900-0000-3334

Member status:Up

Hops to administrator device:2

IP: 16.1.1.11/24

Version:

H3C Comware Platform Software

Comware Software, Version 3.10

S3100-52P

Member number:2

Name: aaa_2.H3C

Device:S3100-52P

MAC Address:00e0-fc00-3190

Member status:Up

Hops to administrator device:1

IP: 16.1.1.1/24

Version:

H3C Comware Platform Software

Comware Software, Version 3.10

S3100-52P

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

Field	Description
Member number	Member number of a device in the cluster
Name	Device name
Device	Device type
MAC Address	Device MAC address
Member status	Device status
Hops to administrator device	Hops from the device to the management device
IP	Device IP address
Version	Software version of the device

1.3.14 ftp cluster

Syntax

ftp cluster

View

User view

Parameter

None

Description

Use the ftp cluster command to connect to the shared FTP server of the cluster and enter FTP Client view.

Example

# Connect to the remote FTP server shared by the cluster.

<123_1.H3C> ftp cluster

Trying ...

Press CTRL+K to abort

Connected.

220 FTP service ready.

User(none):hello

331 Password required for hello.

Password:

230 User logged in.

1.3.15 ftp-server

Syntax

ftp-server ip-address

undo ftp-server

View

Cluster view

Parameter

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

Description

Use the ftp-server command to configure a shared FTP server for the cluster on the management device.

Use the undo ftp-server command to remove the shared FTP server setting.

By default, the management device acts as the shared FTP server.

After setting the IP address of an FTP server for the cluster, the member devices in the cluster can access the FTP server through the management device.

Example

# Configure FTP server 1.0.0.9 on the management device of a cluster.

<aaa_0.H3C> system-view

System View: return to User View with Ctrl+Z.

[aaa_0.H3C] cluster

[aaa_0.H3C-cluster] ftp-server 1.0.0.9

1.3.16 holdtime

Syntax

holdtime seconds

undo holdtime

View

Cluster view

Parameter

seconds: Holdtime in seconds, ranging from 1 to 255.

Description

Use the holdtime command to configure the holdtime of member switches.

Use the undo holdtime command to restore the default holdtime value.

By default, the holdtime is 60 seconds.

l If the management switch does not receive any information from a member device within the holdtime, it sets the status of the member device to “down”. When the communication between the two devices resumes, the member device will be re-added to the cluster automatically.

l If the downtime of a member device does not exceed the holdtime, the member device stays in the normal state and does not need to be added again.

Note that, you need only execute the command on a management device, which will advertise the holdtime value to all member devices in the cluster.

Example

# Set the holdtime to 30 seconds on a management device.

<aaa_0.H3C> system-view

System View: return to User View with Ctrl+Z.

[aaa_0.H3C] cluster

[aaa_0.H3C-cluster] holdtime 30

1.3.17 ip-pool

Syntax

ip-pool administrator-ip-address { ip-mask | ip-mask-length }

undo ip-pool

View

Cluster view

Parameter

administrator-ip-address: IP address for the device to be set as the management device of a cluster.

ip-mask: Mask of the cluster IP address pool.

ip-mask-length: Mask length of the cluster IP address pool.

Description

Use the ip-pool command to configure a private IP address pool on the switch to be set as the management device. After the switch becomes a management device, it can assign the IP addresses in this pool to its member devices.

Use the undo ip-pool command to cancel the IP address pool configuration.

Before creating a cluster on a device, you must first configure a private IP address pool on the device. When a candidate device joins a cluster, the management device dynamically assigns a private IP address in the pool to it, so that the candidate device can communicate with other devices in the cluster. This enables the management device to manage and maintain member devices in the cluster.

Note that, you can only execute the command on a device that does not belong to any cluster. After a cluster is created on a device, you will not be able to change the IP address pool on it.

Example

# Configure a private IP address pool for a cluster.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] cluster

[H3C-cluster] ip-pool 10.200.0.1 20

1.3.18 logging-host

Syntax

logging-host ip-address

undo logging-host

View

Cluster view

Parameter

ip-address: IP address of the logging host to be configured for the cluster.

Description

Use the logging-host command to configure a shared logging host for the cluster on the management device.

Use the undo logging-host command to remove the shared logging host setting.

By default, no shared logging host is configured.

After setting the IP address of a logging host for the cluster, the member devices in the cluster can send logs to the logging host through the management device.

Example

# Configure logging host 10.10.10.9 on the management device of a cluster.

<aaa_0.H3C> system-view

System View: return to User View with Ctrl+Z.

[aaa_0.H3C] cluster

[aaa_0.H3C-cluster] logging-host 10.10.10.9

1.3.19 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 the switch.

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

By default, VLAN 1 is used as the management VLAN.

When specifying the management VLAN, note that:

l The management VLANs on all the devices in a cluster must be the same.

l You can specify the management VLAN on a device only when no cluster is created on the device. You cannot change the management VLAN on a device that already joins a cluster. If you want to change the management VLAN on a device where a cluster has already been created, you must first remove the cluster configuration on the device, then re-specify a VLAN as the management VLAN, and finally re-created the cluster.

Example

# Specify VLAN 2 as the management VLAN of the current switch.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] management-vlan 2

1.3.20 nm-interface Vlan-interface

Syntax

nm-interface Vlan-interface vlan-id

View

Cluster view

Parameter

vlan-id: VLAN ID.

Description

Use the nm-interface Vlan-interface command to configure a network management (NM) interface on a management device.

After an NM interface is specified on the management device of a cluster, the network administrator can log onto the management device through the NM interface to manage the devices in the cluster.

& Note:

l By default, the management VLAN interface is used as the NM interface.

l There is only one NM interface on a management device; any newly configured NM interface will overwrite the old one.

Example

# Configure VLAN-interface 2 as the NM interface.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] cluster

[H3C-cluster] nm-interface Vlan-interface 2

1.3.21 reboot member

Syntax

reboot member { member-number | mac-address H-H-H } [ eraseflash ]

View

Cluster view

Parameter

member-number: Member number of a member device, ranging from 1 to 255.

mac-address H-H-H: Specifies the MAC address of the member device to be rebooted.

eraseflash: Deletes the configuration file when the member device reboots.

Description

Use the reboot member command to reboot a specified member device on the management device.

When a member device is in trouble due to some configuration errors, you can use the remote control function on the management device to control the member device remotely on the management device. For example, from the management device, you can delete the configuration file on a member device and reboot the member device to recover it to the normal state.

The eraseflash keyword specifies to delete the startup configuration file when the member device reboots.

Example

# Reboot number-2 member device.

<aaa_0.H3C> system-view

System View: return to User View with Ctrl+Z.

[aaa_0.H3C] cluster

[aaa_0.H3C-cluster] reboot member 2

1.3.22 snmp-host

Syntax

snmp-host ip-address

undo snmp-host

View

Cluster view

Parameter

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

Description

Use the snmp-host command to configure a shared SNMP host for the cluster on the management device.

Use the undo snmp-host command to remove the shared SNMP host setting.

By default, no shared SNMP host is configured.

After setting the IP address of an SNMP host for the cluster, the member devices in the cluster can send trap messages to the SNMP host through the management device.

Note that, you can only use the commands on a management device.

Example

# Configure SNMP host 1.0.0.9 on the management device of a cluster.

<aaa_0.H3C> system-view

System View: return to User View with Ctrl+Z.

[aaa_0.H3C] cluster

[aaa_0.H3C-cluster] snmp-host 1.0.0.9

1.3.23 tftp cluster get

Syntax

tftp cluster get source-file [ destination-file ]

View

User view

Parameter

source-file: Name of the file to be downloaded from the shared TFTP server of the cluster.

destination-file: Name of the file to which the downloaded file will be saved on the switch.

Description

Use the tftp cluster get command to download a file from a specific directory on the shared TFTP server to the switch.

Related command: tftp cluster put.

Example

# Download file LANSwitch.app from the shared TFTP server of the cluster to the switch and save it to file vs.app.

<123_1.H3C> tftp cluster get LANSwitch.app vs.app

1.3.24 tftp cluster put

Syntax

tftp cluster put source-file [ destination-file ]

View

User view

Parameter

source-file: File to be uploaded to the shared TFTP server.

destination-file: Name of the file to which the uploaded file will be saved in the storage directory of the TFTP server.

Description

Use the tftp put command to upload a file from the switch to a specified directory on the TFTP server.

Related command: tftp cluster get.

Example

# Upload file vrpcfg.txt on the switch to the shared TFTP server of the cluster and save it to file temp.txt.

<123_1.H3C> tftp cluster put vrpcfg.txt temp.txt

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

Description

Use the tftp-server command to configure a shared TFTP server for the cluster on the management device.

Use the undo tftp-server command to remove the shared TFTP server setting.

By default, no shared TFTP server is configured.

After setting the IP address of a TFTP server for the cluster, the member devices in the cluster can access the TFTP server through the management device.

Note that, you can only use the commands on a management device.

Example

# Configure TFTP server 1.0.0.9 on the management device of a cluster.

<aaa_0.H3C> system-view

System View: return to User View with Ctrl+Z.

[aaa_0.H3C] cluster

[aaa_0.H3C-cluster] tftp-server 1.0.0.9

1.3.26 timer

Syntax

timer interval

undo timer

View

Cluster view

Parameter

interval: Interval (in seconds) to send handshake packets. This argument ranges from 1 to 255.

Description

Use the timer command to set the interval to send handshake packets.

Use the undo timer command to restore the default value of the interval.

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

In a cluster, the management device keeps connections with the member devices through handshake packets. Through the periodic handshaking between the management and member devices, the management device monitors the member status and link status.

Note that, you need only execute the command on a management device, which will advertise the handshake interval setting to all member devices in the cluster.

Example

# Set the interval to send handshake packets to 3 seconds.

<aaa_0.H3C> system-view

System View: return to User View with Ctrl+Z.

[aaa_0.H3C] cluster

[aaa_0.H3C-cluster] timer 3

H3C S3100-52P Ethernet Switch Command Manual-Release 1500(V1.01)

1.1.2 ndp enable

1.3.6 cluster enable

1.3.10 delete-member

1.3.17 ip-pool

1.3.21 reboot member

Cloud & AI

InterConnect

Intelligent Terminal Products

Product Support Services

Technical Service Solutions

Resource Center

Policy

Online Help

Become a Partner

Partner Resources

Partner Business Management

Company Information

News & Events

Contact Us