l If the members keyword is not specified, the output information indicates that the local switch is the main switch. Besides, the number of the switches contained in the stack is also displayed.

l If the members keyword is specified, the information about the members of the stack is displayed, including the stack numbers of the main/slave switches, stack name, stack device name, MAC address and status.

When you execute this command on a slave switch, the information displayed indicates that the local switch is a slave switch. Besides, the information such as the stack number of the local switch, and the MAC address of the main switch in the stack is also displayed.

Example

# Display the information about a stack on the main switch.

<stack_0.Sysname>display stacking

Main device for stack.

Total members:3

Management-vlan:1(default vlan)

# Display the information about the stack members on the main switch.

<stack_0.Sysname> display stacking members

Member number: 0

Name:stack_0.Sysname

Device: S3100

MAC Address:000f-e20f-3124

Member status:Admin

IP: 129.10.1.15 /16

Member number: 1

Name:stack_1.Sysname

Device: S3100

MAC Address: 000f-e20f-3130

Member status:Up

IP: 129.10.1.16/16

Member number: 2

Name:stack_2.Sysname

Device: S3100

MAC Address: 000f-e20f-3135

Member status:Up

IP: 129.10.1.17/16

Table 1-1 Description on the fields of the display stacking command

Field	Description
Member number	Numbers of the switches in the stack The main switch is numbered 0.
Name	Switch name
Device	Device type
MAC Address	Mac address of a switch in the stack
Member status	Status of a switch in the stack “Admin” indicates the switch is the main switch; “UP” indicates the switch is on.
IP: 129.10.1.15/16	IP address of a switch in the stack

stack-port enable

Syntax

stack-port enable

undo stack-port enable

View

Ethernet port view

Parameters

None

Description

Use the stack-port enable command to allow the stack port to send/forward stack join-in requests to/from its connected switch.

Use the undo stack-port enable command to prohibit the stack port from sending/forwarding stack join-in requests to/from its connected switch.

By default, the stack-port function on a stack port is enabled, indicating that a switch can send/forward the stack join-in requests through the port.

Examples

# Enable the stack-port function on a stack port.

<stack_1.Sysname> system-view

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

[stack_1.Sysname] interface GigabitEthernet 1/1/2

[stack_1.Sysname-GigabitEthernet1/1/2] stack-port enable

stacking

Syntax

stacking number

View

User view

Parameter

number: Number of the slave switch to switch.

Description

Use the stacking command to switch to a slave switch to configure it.

You can use this command to switch from user view of the main switch to user view of a slave switch. To switch from a slave switch back to the main switch, execute the quit command in user view.

Example

# Switch from the main switch Sysname to the slave switch numbered 1 and then switch back to the main switch.

<stack_0.Sysname> stacking 1

<stack_1.Sysname>

<stack_1.Sysname> quit

<stack_0.Sysname>

stacking enable

Syntax

stacking enable

undo stacking enable

View

System view

Parameter

None

Description

Use the stacking enable command to create a stack.

Use the undo stacking enable command to remove a stack.

The stacking enable command triggers a main switch to add the switches connected to its stack ports to the stack.

The undo stacking enable command can only be executed on a main switch.

A slave switch quits the stack automatically when it is disconnected from the stack.

Remove the IP address configured for the existing Layer 3 interface first if you want to cancel the stack-related configuration, otherwise, IP address conflicts may occur.

Example

# Create a stack.

<Sysname> system-view

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

[Sysname] stacking enable

[stack_0.Sysname] quit

<stack_0.Sysname>

stacking ip-pool

Syntax

stacking ip-pool from-ip-address ip-address-number [ ip-mask ]

undo stacking ip-pool

View

System view

Parameter

from-ip-address: Start address of the stack IP address pool.

ip-address-number: Number of the IP addresses in the stack IP address pool. A stack IP address pool contains 16 addresses by default.

ip-mask: Mask of the stack IP address.

Description

Use the stacking ip-pool command to create a stack IP address pool.

Use the undo stacking ip-pool command to restore the default stack IP address pool.

You need to create an IP address pool for a stack before creating the stack. When adding a switch to a stack, the main switch picks an IP address from the IP address pool and assigns the IP address to it.

The stacking ip-pool command can only be executed on switches that do not belong to any stack. That is, the IP address pool of an existing stack cannot be modified.

To add a switch to a stack successfully, make sure the value of the ip-address-number argument is larger than the number of switches currently contained in the stack.

Make sure the IP addresses in the IP address pool of a stack are successive so that they can be assigned successively. For example, the IP addresses in an IP address pool with its start IP address something like 223.255.255.254 are not successive. In this case, errors may occur when adding a switch to the stack.

IP addresses in the IP address pool of a stack must be of the same network segment. For example, the 1.1.255.254 is not a qualified start address for a stack IP address pool.

Note the following when performing stack-related configurations on the main switch of a stack:

l After a stack is created, the main switch automatically adds the switches connected to its stack ports to the stack.

l A slave switch quits the stack automatically when it is disconnected from the stack.

l If the IP address of the management VLAN interface of the main switch (or a slave switch) is not of the same network segment as that of the stack address pool, the main switch (or the slave switch) automatically removes the existing IP address and picks a new one from the stack address pool as its IP address.

l Since both stack and cluster use the management VLAN and only one VLAN interface is available on the S3100 switch, stack and cluster must share the same management VLAN if you want to configure stack within a cluster.

Example

# Configure the IP address pool for the stack.

<Sysname> system-view

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

[Sysname] stacking ip-pool 129.10.1.1 5

2 HGMP V2 Configuration Commands

NDP Configuration Commands

display ndp

Syntax

display ndp [ interface interface-list ]

View

Any view

Parameters

interface interface-list: Specifies a port list. You need to provide the interface-list argument in the form of { interface-type interface-number [ to interface-type interface-number ] } &<1-10>, where to is used to specify a port range, and &<1-10> means that you can provide up to ten port indexes/port index ranges for this argument. The interface-number argument is in the format of unit ID/slot number/port number.

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.

If executed with the interface keyword, the display ndp command will display the NDP status of the specified interfaces and the related information of the peer device. If executed without the interface keyword, the command will display the global NDP configuration information and the statistics on NDP packets received on and sent by each port.

Examples

# Display all NDP configuration and operating information.

<aaa_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: 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

……(Omitted)

# Display NDP information about Ethernet 1/0/1.

<aaa_0.Sysname> 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 : 000f-e20f-1234

Host Name : 1234_2.Sysname

Port Name : Ethernet1/0/1

Software Ver: V100R002B01D001

Device Name : H3C S3100

Port Duplex : AUTO

Product Ver : 3100

BootROM Ver : 506

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

Field	Description
Neighbor Discovery Protocol is enabled	NDP is enabled globally on the switch.
Neighbor Discovery Protocol Ver: 1	NDP version 1 is running.
Hello Timer	Interval for the switch to send NDP packets, which is configured through the ndp timer hello command
Aging Timer	Holdtime for neighbors to keep the NDP information of the switch, which is configured through the ndp timer aging command
Interface	Port index, used to identify a port
Status	NDP state on the port (enabled/disabled)
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
Host Name	Host name 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
BootROM Ver	Bootrom version of the neighbor device

ndp enable

Syntax

ndp enable [ interface interface-list ]

undo ndp enable [ interface interface-list ]

View

System view, Ethernet port view

Parameters

interface-list: Ethernet port list, in the format of { interface-type interface-number [ to interface-type interface-number ] } &<1-10>, where to is used to specify a port range, and &<1-10> means that you can provide up to ten port indexes/port index ranges for this argument. The interface-number argument is in the format of unit ID/slot number/port number.

Description

Use the ndp enable command to enable NDP globally or on a port.

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

If you execute the ndp enable command in system view without the interface keyword specified, NDP will be enabled globally; if you specify the interface keyword in the command, NDP will be enabled on the specified ports. In Ethernet port view, the interface keyword is unavailable, and execution of the command will enable NDP on the current port only.

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

Note that NDP can take effect on a port only when NDP is enabled both globally and on the port.

Examples

# Enable NDP globally, and then enable NDP on port Ethernet 1/0/1.

<Sysname> system-view

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

[Sysname] ndp enable

[Sysname] interface Ethernet 1/0/1

[Sysname-Ethernet1/0/1] ndp enable

ndp timer aging

Syntax

ndp timer aging aging-in-seconds

undo ndp timer aging

View

System view

Parameters

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

Description

Use the ndp timer aging command to set the holdtime of the NDP information. This command specifies how long an adjacent device should hold the NDP neighbor information received from the local switch 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 the local switch. When an adjacent device receives an NDP packet from the local switch, it learns how long it should keep the NDP information of the switch 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 between sending NDP packets. Otherwise, a neighbor entry will be generated and age out frequently, resulting in instability of the NDP port neighbor table.

Examples

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

<Sysname> system-view

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

[Sysname] ndp timer aging 60

ndp timer hello

Syntax

ndp timer hello timer-in-seconds

undo ndp timer hello

View

System view

Parameters

timer-in-seconds: Interval between sending NDP packets, ranging from 5 to 254 seconds.

Description

Use the ndp timer hello command to set the interval between sending NDP packets.

Use the undo ndp timer hello command to restore the default interval.

By default, this interval is 60 seconds.

A switch should update the NDP information of its neighbors regularly, so that the switch can get the updated information of the neighbors in time. You can use the ndp timer hello command to specify the interval at which the switch sends hello packets to its neighbors for NDP information update.

Examples

# Set the interval between sending NDP packets to 80 seconds.

<Sysname> system-view

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

[Sysname] ndp timer hello 80

reset ndp statistics

Syntax

reset ndp statistics [ interface interface-list ]

View

User view

Parameters

interface-list: Ethernet port list, in the format of { interface-type interface-number [ to interface-type interface-number ] } &<1-10>, where to is used to specify a port range, and &<1-10> means that you can provide up to ten port indexes/port index ranges for this argument. The interface-number argument is in the format of unit ID/slot number/port number.

Description

Use the reset ndp statistics command to clear the NDP statistics on specific ports. When executing the command, if you specify the interface keyword, the command will clear NDP statistics on the specified ports; if you do not specify the interface keyword, the command will clear NDP statistics on all ports.

You can use the display ndp command to view the NDP statistics before and after the execution of the reset ndp statistics command to verify the execution result.

Examples

# Display the NDP statistics on port Ethernet 1/0/6.

<Sysname> display ndp interface ethernet 1/0/6

Interface: Ethernet1/0/6

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

# Clear the NDP statistics on port Ethernet 1/0/6.

<Sysname> reset ndp statistics interface ethernet 1/0/6

# Re-display the NDP statistics on port Ethernet 1/0/6.

<Sysname> display ndp interface ethernet 1/0/6

Interface: Ethernet1/0/6

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

NTDP Configuration Commands

display ntdp

Syntax

display ntdp

View

Any view

Parameters

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 forwarding delay of topology collection requests, and time used by the last topology collection.

Examples

# Display the global NTDP information.

<Sysname> 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 2-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, which is configured through the ntdp hop command
Timer	Interval to collect topology information, which is configured through the ntdp timer command "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, which is configured through the ntdp timer hop-delay command
Port Delay	Delay for ports on other devices to forward topology collection requests, which is configured through the ntdp timer port-delay command
Last collection total time	Time used by the last topology collection

display ntdp device-list

Syntax

display ntdp device-list [ verbose ]

View

Any view

Parameters

verbose: Displays the detailed information of devices in a cluster.

Description

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

Examples

# Display the list of devices collected by NTDP.

<Sysname> display ntdp device-list

MAC HOP IP PLATFORM

000f-e20f-3901 0 100.100.1.1/24 S3100

000f-e20f-3190 1 16.1.1.1/24 S3100

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

[1234_0.Sysname]display ntdp device-list verbose

Hostname : 1234_0.Sysname

MAC : 00e0-fc11-1111

Hop : 0

Platform : S3100

IP : 192.168.0.234/24

Version :

H3C Comware Platform Software

Comware Software, Version 3.10

S3100 3100-0002

Cluster : Administrator switch of cluster 1234

Stack : Candidate switch

Peer MAC Peer Port ID Native Port ID Speed Duplex

00e0-fc12-3450 Ethernet1/0/14 Ethernet1/0/4 100 FULL

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

Hostname : 1234_5.Sysname

MAC : 00e0-fc3d-9da8

Hop : 2

Platform : H3C S3026

IP :

Version :

H3C Comware Platform Software

Comware Software, Version 3.10

S3100 3100-0002

Cluster : Member switch of cluster 1234 , Administrator MAC: 00e0-fc11-1111

Stack : Candidate switch

Peer MAC Peer Port ID Native Port ID Speed Duplex

000f-e200-0144 Ethernet0/3 Ethernet0/24 100 FULL

00e0-fc00-3100 Ethernet1/0/23 Ethernet0/16 100 FULL

00e0-fc12-3450 Ethernet1/0/4 Ethernet0/8 100 FULL

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

Hostname : 1234_4.Sysname

MAC : 00e0-fc00-3100

Hop : 3

Platform : S3100-EI

IP : 192.168.0.241/24

Version :

H3C Comware Platform Software

Comware Software, Version 3.10

S3100 3100-0002

Cluster : Member switch of cluster 1234 , Administrator MAC: 00e0-fc11-1111

Stack : Candidate switch

Peer MAC Peer Port ID Native Port ID Speed Duplex

00e0-fc3d-9da8 Ethernet0/16 Ethernet1/0/23 100 FULL

00e0-fc00-2006 Ethernet1/0/2 Ethernet1/0/7 100 FULL

000f-e247-4ca3 Ethernet1/0/14 Ethernet1/0/1 100 FULL

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

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

ntdp enable

Syntax

ntdp enable

undo ntdp enable

View

System view, Ethernet port view

Parameters

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 both globally and on ports.

Note that NTDP can take effect on a port only when NTDP is enabled both globally and on the port.

Examples

# Enable NTDP globally, and then enable NTDP on port Ethernet 1/0/1.

<Sysname> system-view

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

[Sysname] ntdp enable

[Sysname] interface Ethernet 1/0/1

[Sysname-Ethernet1/0/1] ntdp enable

ntdp explore

Syntax

ntdp explore

View

User view

Parameters

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 (which can be set through the ntdp hop command) 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.

Examples

# Start a topology collection process.

<Sysname> ntdp explore

ntdp hop

Syntax

ntdp hop hop-value

undo ntdp hop

View

System view

Parameters

hop-value: Maximum hops to collect topology information, namely, the topology collection range, in the range of 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:

l The topology collection range set by this command is applicable to both the periodic and manual topology collection.

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

Examples

# Set the topology collection range to 5 hops.

<aaa_0.Sysname> system-view

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

[aaa_0.Sysname] ntdp hop 5

ntdp timer

Syntax

ntdp timer interval-in-minutes

undo ntdp timer

View

System view

Parameters

interval-in-minutes: Interval (in minutes) to collect topology information, ranging from 0 to 65,535. A value of 0 disables topology information 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. You can also use the ndp explore command to start a topology collection process manually.

Note that:

l Only the management switch can collect topology periodically, and a member switch cannot. However, you can use the ndp explore command on the member switch to start a topology collection process manually.

l After a cluster is set up, the management switch will collect the topology information of the network at the topology collection interval you set and automatically add the candidate switches 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, and use the add-member command to add the candidate switches to the cluster manually.

Examples

# Set the topology collection interval to 30 minutes.

<aaa_0.Sysname> system-view

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

[aaa_0.Sysname] ntdp timer 30

ntdp timer hop-delay

Syntax

ntdp timer hop-delay time

undo ntdp timer hop-delay

View

System view

Parameters

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

Description

Use the ntdp timer hop-delay command to set the delay for devices to forward topology collection requests.

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

By default, the device forwarding 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 each NTDP-enabled port.

You can use the ntdp timer hop-delay command to set the delay on a collecting switch. The delay value you set by the 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.

Examples

# Set the delay for collected switches to forward topology collection requests to 300 ms.

<aaa_0.Sysname> system-view

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

[aaa_0.Sysname] ntdp timer hop-delay 300

ntdp timer port-delay

Syntax

ntdp timer port-delay time

undo ntdp timer port-delay

View

System view

Parameters

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

Description

Use the ntdp timer port-delay command to configure the topology request forwarding delay between two ports, that is, the interval at which the device forwards the topology requests through the NTDP-enabled ports one after another.

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

By default, the port forwarding 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 the topology collection request forwarding delay between two ports.

Examples

# Set the port forwarding delay for collected switches to forward NTDP requests to 40 ms.

<aaa_0.Sysname> system-view

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

[aaa_0.Sysname] ntdp timer port-delay 40

Cluster Configuration Commands

add-member

Syntax

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

View

Cluster view

Parameters

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

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

password: Super 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. If the input password is not consistent with the super password configured on the candidate device (through the super password command, refer to the CLI part of the manual), you cannot add the candidate device to the cluster. If a candidate device is not configured with a super password, you can add it to the cluster without providing the password 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. If you want to specify the member manually, you need to specify a number that is never used by a member device of the cluster.

After you add a candidate device to the cluster, the super password of the device automatically changes to the super password of the management device. If the management device changes its super password, the member devices will automatically synchronize their super passwords to the new super password of the management device.

Examples

# Add a candidate device, whose MAC address and user password are 000f-e20f-35e7 and 123456 respectively, to the cluster, and set the member number to 6.

<aaa_0.Sysname> system-view

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

[aaa_0.Sysname] cluster

[aaa_0.Sysname-cluster] add-member 6 mac-address 000f-e20f-35e7 password 123456

administrator-address

Syntax

administrator-address mac-address name name

undo administrator-address

View

Cluster view

Parameters

mac-address: MAC address of the management device to be specified.

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

Description

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

Use the undo administrator-address command to remove the management device MAC address from the MAC address list of a member device, that is, remove the member device from the cluster. Normally, this command is used for debugging and restoring purpose.

By default, a switch is not a member of any cluster.

A cluster has one and only one management device. Setting the management device MAC address on a device can add the device to the cluster and enable the device to identify the management device even if it restarts.

You can add a device to a cluster using the administrator-address command no matter whether the super password of the device is consistent with that of the management device.

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

Examples

# Remove the current member device from the cluster.

<aaa_1.Sysname> system-view

System View: return to User View with Ctrl+Z

[aaa_1.Sysname] cluster

[aaa_1.Sysname-cluster] undo administrator-address

auto-build

Syntax

auto-build [ recover ]

View

Cluster view

Parameters

recover: Recovers all member devices.

Description

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

You can execute this command on a management device or on a switch to be configured as a management device.

When you execute this command on a candidate device, you are prompted to enter a cluster name to build a cluster. The candidate device will automatically become the management device of the cluster. Then, the management device will collect candidate devices and add them to the cluster automatically.

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. Therefore, 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 cannot be added to the cluster.

l After a cluster is built automatically, ACL 3998 and ACL 3999 will automatically generate a rule respectively to prohibit packets whose source and destination addresses are private IP addresses of the cluster from being sent to or received from the public network. The two ACL rules will be automatically applied to all ports of the cluster members.

l After a cluster is built automatically, ACL 3998 and ACL 3999 can neither be configured/modified nor removed.

Examples

# Start an automatic cluster building process.

<Sysname> system-view

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

[Sysname] cluster

[Sysname-cluster] auto-build

There is no base topology, if set up from local flash file?(Y/N)

Please input cluster name:aaa

Collecting candidate list, please wait...

#Apr 3 08:12:32:832 2000 aaa_0.Sysname CLST/5/Cluster_Trap:- 1 -

OID:1.3.6.1.4.1.2011.6.7.1.0.3(hgmpMemberStatusChange):member 00.00.00.00.00.12.

a9.90.22.40 role change, NTDPIndex:0.00.00.00.00.00.12.a9.90.22.40, Role:1

Candidate list:

Name Hops MAC Address Device

Sysname 2 0016-e0c0-c201 H3C S3100-28F-EI

H3C 2 000f-e221-616e H3C S3100-28F-EI

H3C 2 000f-e202-2180 H3C S3100-28P-SI

SwitchA 2 0016-e0be-e200 H3C S5600-26C

H3C 3 000f-e200-1774 H3C S5600-26F

H3C 2 000f-e200-5600 H3C S5600-26F

H3C 3 000f-e200-5104 H3C S3100-28P-SI

H3C 2 000f-e200-2420 H3C S3100-28P-SI

Processing...please wait

%Apr 3 08:12:37:813 2000 aaa_0.Sysname CLST/5/LOG:- 1 -

Member 000f-e200-2200 is joined in cluster aaa.

%Apr 3 08:12:37:831 2000 aaa_0.Sysname CLST/5/LOG:- 1 -

Member 000f-e200-0000 is joined in cluster aaa.

%Apr 3 08:12:37:847 2000 aaa_0.Sysname CLST/5/LOG:- 1 -

Member 000f-e200-7800 is joined in cluster aaa.

%Apr 3 08:12:37:863 2000 aaa_0.Sysname CLST/5/LOG:- 1 -

Member 000f-e200-2420 is joined in cluster aaa.

%Apr 3 08:12:37:996 2000 aaa_0.Sysname CLST/5/LOG:- 1 -

Member 000f-e202-2180 is joined in cluster aaa.

%Apr 3 08:12:38:113 2000 aaa_0.Sysname CLST/5/LOG:- 1 -

Member 0016-e0c0-c201 is joined in cluster aaa.

%Apr 3 08:12:38:139 2000 aaa_0.Sysname CLST/5/LOG:- 1 -

Member 000f-e200-5104 is joined in cluster aaa.

%Apr 3 08:12:38:367 2000 aaa_0.Sysname CLST/5/LOG:- 1 -

Member 000f-e200-5600 is joined in cluster aaa.

Cluster auto-build Finish!

8 member(s) added successfully.

[aaa_0.Sysname-cluster]

build

Syntax

build name

undo build

View

Cluster view

Parameters

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, and the member number of the management device is 0.

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

Different from the auto-build command, the build command only builds a cluster on the management device, which will not immediately collect the topology information to add the candidate devices into the cluster, but wait for an interval (configured through the ntdp timer command) before it starts the topology collection.

To reduce the risk of being attacked by malicious users against opened socket and enhance switch security, the S3100 series 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.

Examples

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

<Sysname> system-view

System View: return to User View with Ctrl+Z

[Sysname] cluster

[Sysname-cluster] build aaa

There is no base topology, if set up from local flash file?(Y/N)

#Apr 3 08:15:03:166 2000 aaa_0. H3C CLST/5/Cluster_Trap:- 1 -

OID:1.3.6.1.4.1.2011.6.7.1.0.3(hgmpMemberStatusChange):member 00.00.00.00.00.12.

a9.90.22.40 role change, NTDPIndex:0.00.00.00.00.00.12.a9.90.22.40, Role:1

[aaa_0.Sysname-cluster]

cluster

Syntax

cluster

View

System view

Parameters

None

Description

Use the cluster command to enter cluster view.

Examples

# Enter cluster view.

<Sysname> system-view

System View: return to User View with Ctrl+Z

[Sysname] cluster

[Sysname-cluster]

cluster enable

Syntax

cluster enable

undo cluster enable

View

System view

Parameters

None

Description

Use the cluster enable command to enable the cluster function.

Use the undo cluster enable command to disable the cluster function.

By default, the cluster function is enabled.

Note that:

l To create a cluster on a management device through the build command or the auto-build command, you must first enable the cluster function by executing the cluster enable command.

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

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

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, and thus you cannot create a cluster on the device or add the device to an existing cluster.

Examples

# Enable the cluster function on the switch.

<Sysname> system-view

System View: return to User View with Ctrl+Z

[Sysname] cluster enable

cluster switch-to

Syntax

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

View

User view

Parameters

member-number: Member number of a 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 (this is not true when you add the candidate device to the cluster using the administrator-address command). 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.

Examples

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

<aaa_0.Sysname> cluster switch-to 6

<aaa_6.Sysname> quit

<aaa_0.Sysname>

cluster-mac

Syntax

cluster-mac H-H-H

undo cluster-mac

View

Cluster view

Parameters

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 destination MAC address for HGMPv2 protocol packets.

Use the undo cluster-mac command to restore the default multicast destination MAC address of HGMPv2 protocol packets.

The default multicast destination MAC address of HGMPv2 protocol packets is 0180-C200-000A.

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

With the destination MAC address of HGMPv2 protocol packets configured on the management device, through the multicast MAC synchronization packets, the member devices can learn the multicast MAC address of HGMPv2 protocol packets and use it to send NDP multicast packets, NTDP multicast packets, and cluster packets.

Since some devices cannot forward the multicast packets with the destination MAC address of 0180-C200-000A, HGMPv2 packets cannot traverse these devices. For a cluster to work normally in this case, you can modify the multicast destination MAC address of HGMPv2 protocol packets without changing the current networking.

Related commands: cluster-mac syn-interval.

Examples

# Configure multicast MAC address 0180-C200-0028 for HGMPv2 protocol packets.

<aaa_0.Sysname> system-view

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

[aaa_0.Sysname] cluster

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

cluster-mac syn-interval

Syntax

cluster-mac syn-interval time-interval

View

Cluster view

Parameters

time-interval: Interval to send 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.

HGMPv2 multicast MAC synchronization packets are used for synchronizing the HGMPv2 multicast MAC address configuration (configured through the cluster-mac command) between devices in a cluster, so that HGMPv2 protocol packets can be forwarded normally within the cluster. HGMPv2 multicast MAC synchronization packets are Layer 2 multicast packets.

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.

Related commands: cluster-mac.

Examples

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

<aaa_0.Sysname> system-view

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

[aaa_0.Sysname] cluster

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

delete-member

Syntax

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

View

Cluster view

Parameters

member-id: Member number of a member device, ranging 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.

Note that a cluster will collect the topology information at the topology collection interval. If you do not add a device to the cluster blacklist when removing it from the cluster, the device will be added to the cluster again when the cluster collects topology information. Therefore, to remove a device from a cluster permanently, you can use the following methods:

l Use the delete-member command with the to-black-list keyword specified to remove a device and add the device to the blacklist of the cluster.

l Before using the delete-member command to remove a device from the cluster, use the undo ndp enable and undo ntdp enable command to disable NDP and NTDP on the ports of the device which connect with the cluster member devices.

This command is applicable to management devices only.

Related commands: add-member.

Examples

# Remove the member device numbered 4 from the cluster, and add it to the cluster blacklist.

<aaa_0.Sysname> system-view

Enter system view, return to user view with Ctrl+Z.

[aaa_0.Sysname] cluster

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

display cluster

Syntax

display cluster

View

Any view

Parameters

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.

Examples

# Display cluster information on a management device.

<aaa_0.Sysname-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.3100-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:000f-e20f-3901

Administrator status:Up

Table 2-5 Description on the fields of the display cluster command

Field	Description
Cluster name	Name of the cluster, which can be configured through the build command
Role	Role of this switch
Management-vlan	Number of the management VLAN, which can be configured through the management-vlan command
Member number	Member number of this switch
Handshake timer	Interval to send handshake packets, which can be configured through the timer command
Handshake hold-time	Holdtime of the neighbor status information, which can be configured through the holdtime command
Administrator device mac address	MAC address of the management device
Administrator status	Status of the management device

display cluster candidates

Syntax

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

View

Any view

Parameters

mac-address H-H-H: Specifies a candidate device by its MAC address. H-H-H represents the MAC address.

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

Examples

# Display information about all candidate devices.

<aaa_0.Sysname-cluster> display cluster candidates

MAC HOP IP PLATFORM

3900-0000-3334 2 16.1.1.11/24 S3100

000f-e20f-3190 1 16.1.1.1/24 S3100

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

Field	Description
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

# Display information about a specified candidate device.

<aaa_0.Sysname-cluster> display cluster candidates mac-address 000f-e20f-3190

Hostname : 3100-3

MAC : 000f-e20f-3190

Hop : 1

Platform : S3100

IP : 16.1.1.1/24

# Display detailed information about all candidate devices.

<aaa_0.Sysname-cluster> display cluster candidates verbose

Hostname : H3C

MAC : 3100-0000-3334

Hop : 2

Platform : S3100

IP : 16.1.1.11/24

Hostname : 3100-3

MAC : 000f-e20f-3190

Hop : 1

Platform : S3100

IP : 16.1.1.1/24

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

Field	Description
Hostname	Name of the 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

display cluster members

Syntax

display cluster members [ member-number | verbose ]

View

Any view

Parameters

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.

This command is only applicable to a management device.

Examples

# Display information about all devices in a cluster.

<aaa_0.Sysname-cluster> display cluster members

SN Device MAC Address Status Name

0 S3100 000f-e20f-3901 Admin aaa_0.Sysname

1 S3100 3900-0000-3334 Up aaa_1.Sysname

2 S3100 000f-e20f-3190 Up aaa_2.3100-3

Table 2-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.Sysname-cluster> display cluster members verbose

Member number:0

Name:aaa_0.Sysname

Device:S3100

MAC Address:000f-e20f-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 3100-0002

Member number:1

Name:aaa_1.Sysname

Device:S3100

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 3100-0002

Member number:2

Name: aaa_2.Sysname

Device:S3100

MAC Address:000f-e20f-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 3100-0002

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

Field	Description
Member number	Member number of the 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

ftp cluster

Syntax

ftp cluster

View

User view

Parameters

None

Description

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

You can use the ftp-server command on the management device to configure the shared FTP server of the cluster, which is used for software version update and configuration file backup of the cluster members.

Related commands: ftp-server.

For how to access other FTP servers using the ftp command, refer to the FTP-SFTP-TFTP part of the manual.

Examples

# Connect to the FTP server shared by the cluster.

<123_1.Sysname> 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.

ftp-server

Syntax

ftp-server ip-address

undo ftp-server

View

Cluster view

Parameters

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

Description

Use the ftp-server command to configure 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 of the cluster.

After you configure the IP address of the shared FTP server on the management device, the member devices in the cluster can access the shared FTP sever through the management device to back up configuration and download software. The IP address of the shared FTP server configured on the management device takes effect on the management device only and will not be applied to the member devices through the cluster management packets.

After the IP address of the shared FTP server is configured, network address translation (NAT) is enabled on the management device immediately. When a member device uses the ftp cluster command to access the shared FTP server, the management device will translate the private IP address of the member device to a public network address, forward the requests of the member device to the FTP server, and forward the responses of FTP server to the member device according to the NAT record.

Examples

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

<aaa_0.Sysname> system-view

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

[aaa_0.Sysname] cluster

[aaa_0.Sysname-cluster] ftp-server 1.0.0.9

holdtime

Syntax

holdtime seconds

undo holdtime

View

Cluster view

Parameters

seconds: Neighbor information holdtime in seconds, ranging from 1 to 255.

Description

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

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

By default, the neighbor information holdtime is 60 seconds.

Note that:

l If the management switch does not receive NDP information from a member device within the holdtime, it sets the state of the member device to “down”. When the management device receives the NDP information from the device again, the device will be re-added to the cluster automatically.

l If the management device receives NDP information form a member device within the holdtime, the member device stays in the normal state and does not need to be added to the cluster again.

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

Examples

# Set the neighbor information holdtime of the cluster members to 30 seconds.

<aaa_0.Sysname> system-view

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

[aaa_0.Sysname] cluster

[aaa_0.Sysname-cluster] holdtime 30

ip-pool

Syntax

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

undo ip-pool

View

Cluster view

Parameters

administrator-ip-address: IP address 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 management device.

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

Before creating a cluster, you must first configure a private IP address pool. 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.

As the IP address pool of a cluster cannot be modified, be sure to execute these two commands before a cluster is created.

Examples

# Configure a private IP address pool for a cluster.

<Sysname> system-view

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

[Sysname] cluster

[Sysname-cluster] ip-pool 10.200.0.1 20

logging-host

Syntax

logging-host ip-address

undo logging-host

View

Cluster view

Parameters

ip-address: IP address of the device to be configured as the log host of a cluster.

Description

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

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

By default, no shared log host is configured.

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

Note that you must execute the command on a management device.

For how to configure a switch to send logs to the log host, refer to Information Center Operation.

Examples

# Configure the device with IP address 10.10.10.9 as the log host of a cluster.

<aaa_0.Sysname> system-view

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

[aaa_0.Sysname] cluster

[aaa_0.Sysname-cluster] logging-host 10.10.10.9

management-vlan

Syntax

management-vlan vlan-id

undo management-vlan

View

System view

Parameters

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.

l The management VLAN of a cluster defaults to VLAN 1. To isolate cluster management packets from other packets to improve the cluster information security, it is recommended to configure the management VLAN of the cluster as another VLAN.

Examples

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

<Sysname> system-view

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

[Sysname] management-vlan 2

reboot member

Syntax

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

View

Cluster view

Parameters

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 of the member device 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 maintain the member device remotely. For example, from the management device, you can delete the configuration file on a member device and reboot the member device, and recover the device to the normal state with the backup configuration.

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

Examples

# Reboot number-2 member device.

<aaa_0.Sysname> system-view

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

[aaa_0.Sysname] cluster

[aaa_0.Sysname-cluster] reboot member 2

snmp-host

Syntax

snmp-host ip-address

undo snmp-host

View

Cluster view

Parameters

ip-address: IP address of a SNMP network management station (NMS) to be configured for the cluster.

Description

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

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

By default, no shared SNMP NMS is configured.

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

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

For how to configure a switch to send trap messages to the SNMP NMS, refer to Information Center Operation.

Examples

# Configure SNMP NMS address 1.0.0.9 on the management device for the cluster.

<aaa_0.Sysname> system-view

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

[aaa_0.Sysname] cluster

[aaa_0.Sysname-cluster] snmp-host 1.0.0.9

tftp get

Syntax

tftp { cluster | tftp-server } get source-file [ destination-file ]

View

User view

Parameters

cluster: Downloads files through the shared TFTP server of the cluster.

tftp-server: IP address or host name of the TFTP server.

source-file: Name of the file to be downloaded from the 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 get command to download a file from a specific directory on the shared TFTP server to the switch.

You can use the tftp-server command on the management device to configure the shared TFTP server of the cluster, which is used for software version update and configuration file backup of the cluster members. For TFTP server rights and directory configuration, refer to the user guide of the TFTP server software.

Related commands: tftp put, tftp-server.

l You need to specify the cluster keyword completely in the command.

l For description of other parameters of the tftp command, refer to the FTP-SFTP-TFTP part of the manual.

Examples

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

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

tftp put

Syntax

tftp { cluster | tftp-server } put source-file [ destination-file ]

View

User view

Parameters

cluster: Uploads files through the shared TFTP server of the cluster.

tftp-server: IP address or host name of the TFTP server.

source-file: File name 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 commands: tftp get,tftp-server.

l You need to specify the cluster keyword completely in the command.

l For description of other parameters of the tftp command, refer to the FTP-SFTP-TFTP part of the manual.

Examples

# Upload file config.cfg on the switch to the shared TFTP server of the cluster and save it as temp.cfg.

<123_1.Sysname> tftp cluster put config.cfg temp.cfg

tftp-server

Syntax

tftp-server ip-address

undo tftp-server

View

Cluster view

Parameters

ip-address: IP address of a TFTP server to be configured for 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 the IP address of the shared TFTP server is configured, NAT is enabled on the management device immediately. When a member device uses the tftp cluster get or tftp cluster put command to download or upload a file from the shared TFTP server, the management device translates the private IP address of the member device to a public network address, forwards the requests of the member device to the TFTP server, and forwards the responses of TFTP server to the member device according to the NAT record.

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

Examples

# Configure shared TFTP server 1.0.0.9 on the management device for the cluster.

<aaa_0.Sysname> system-view

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

[aaa_0.Sysname] cluster

[aaa_0.Sysname-cluster] tftp-server 1.0.0.9

timer

Syntax

timer interval

undo timer

View

Cluster view

Parameters

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

Description

Use the timer command to set the interval between sending handshake packets.

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

By default, the interval between sending 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.

Examples

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

<aaa_0.Sysname> system-view

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

[aaa_0.Sysname] cluster

[aaa_0.Sysname-cluster] timer 3

tracemac

Syntax

tracemac { by-mac mac-address vlan vlan-id | by-ip ip-address } [ nondp ]

View

Any view

Parameters

by-mac: Specifies to trace a device through the specified destination MAC address.

mac-address: MAC address of the device to be traced.

vlan vlan-id: Specifies to trace a device in the specified VLAN. vlan-id ranges from 1 to 4094.

by-ip: Specifies to trace a device through the specified destination IP address.

ip-address: IP address of the device to be traced.

nondp: Specifies not to check the NDP neighbor information.

Description

Use the tracemac command to trace a device in a cluster through the specified destination MAC address or IP address, and to display the path from the current device to the destination device.

l When using the destination IP address to trace a device, the switch looks up the ARP entry corresponding to the IP address, and then looks up the MAC address entry according to the ARP entry.

l If the queried IP address has a corresponding ARP entry, but the corresponding MAC address of the IP address does not exist in the MAC address table, the trace of the device fails.

l To trace a specific device using the tracemac command, make sure that all the devices passed support the tracemac function.

l To trace a specific device in a management VLAN using the tracemac command, make sure that all the devices passed are within the same management VLAN as the device to be traced.

Examples

# Trace the device that belongs to VLAN 1 through its MAC address 00e0-f032-0005.

<aaa_0.Sysname> tracemac by-mac 000f-e232-0005 vlan 1

Tracing MAC address 000f-e232-0005 in vlan 1

1 000f-e232-0001 H3C01 Ethernet1/0/2

2 000f-e232-0002 H3C02 Ethernet1/0/7

3 000f-e232-0003 H3C03 Ethernet1/0/4

4 000f-e232-0005 H3C05 Local

# Trace the device that belongs to VLAN 1 through its IP address 192.168.1.5.

<aaa_0.Sysname> tracemac by-ip 192.168.1.5

Tracing MAC address 000f-e232-0005 in vlan 1

1 000f-e232-0001 H3C01 Ethernet1/0/2

2 000f-e232-0002 H3C02 Ethernet1/0/7

3 000f-e232-0003 H3C03 Ethernet1/0/4

4 000f-e232-0005 H3C05 Local

Enhanced Cluster Feature Configuration Commands

black-list

Syntax

black-list add-mac mac-address

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

View

Cluster view

Parameters

mac-address: MAC address of the device to be added to the blacklist. The format is H-H-H, for example, 0100-0498-e001.

all: Deletes all MAC address in the current cluster blacklist.

Description

Use the black-list add-mac command to add the specified MAC address to the cluster blacklist, so that the device with the specified MAC address cannot join the cluster.

Use the black-list delete-mac command to remove all the MAC addresses or the specified MAC address from the current cluster blacklist, so that all devices or the device with the specified MAC address can join the cluster.

By default, no MAC address is added to the cluster blacklist.

You can only use this command on the cluster administrative device.

If the device to be added to the blacklist is a member of the cluster, the execution of the black-list add-mac command will remove the device from the cluster and then add it to the cluster blacklist. In this case, the black-list add-mac command is equivalent to the delete-member member-id to-black-list command.

Examples

# Add the device with the MAC address 0010-3500-e001 to the blacklist.

<aaa_0.Sysname> system-view

Enter system view, return to user view with Ctrl+Z.

[aaa_0.Sysname] cluster

[aaa_0.Sysname-cluster] black-list add-mac 0010-3500-e001

# Delete all addresses in the current cluster blacklist.

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

display cluster base-members

Syntax

display cluster base-members

View

Any view

Parameters

None

Description

Use the display cluster base-members command to display the information about all the devices in the base cluster topology, such as member number, name, MAC address, and the current status of each device in a cluster.

Examples

# Display the information about all the devices in the base cluster topology.

<aaa_0.Sysname> display cluster base-members

SN Device MAC Adress Status

0 aaa_0.Sysname 000f-e200-30a0 UP

1 aaa_1.S3100 000f-e200-86e4 UP

Table 2-10 Description on the fields of display cluster base-members

Field	Description
SN	Device number in the cluster
Device	Device name
MAC Address	Device MAC address
Status	Device status Up: The member is connected. Down: The member is disconnected.

display cluster base-topology

Syntax

display cluster base-topology [ mac-address mac-address | member member-id ]

View

Any view

Parameters

mac-address mac-address: Displays the structure of the standard topology three layers above or below the node specified by the MAC address.

member member-id: Displays the structure of the standard topology three layers above or below the node specified by the member ID.

Description

Use the display cluster base-topology command to display the standard topology of the cluster.

The standard topology of a cluster refers to the topology saved through the topology save-to command. The standard topology is the backup of the normal topology information of a cluster and is mainly used to resume the normal topology of the cluster member devices in case the cluster topology encounters a fault.

Examples

# Display the standard topology of the cluster.

<aaa_0.Sysname> display cluster base-topology

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

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

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

[aaa_0.Sysname:000f-e202-2180]

├-(P_0/40)<-->(P_0/6)[Sysname:000f-e200-2200]

├-(P_0/28)<-->(P_3/0/1)[Sysname:000f-e200-1774]

├-(P_0/22)<-->(P_1/0/2)[aaa_5.Sysname:000f-e200-5111]

├-(P_0/18)<-->(P_3/0/2)[Sysname S3100:000f-e218-d0d0]

├-(P_0/14)<-->(P_1/0/2)[Sysname:000f-e200-5601]

└-(P_0/4)<-->(P_0/2)[S3100:000f-e200-00cc]

The output information of the display cluster base-topology command is in the following format:

(peer port number)<-->(local port number)[peer device name:peer device MAC address]

For example, (P_0/40)<-->(P_0/6)[Sysname:000f-e200-2200] means that the peer device uses its port Ethernet 1/0/40 to connect to port Ethernet 1/0/6 of the local device; the peer device name is Sysname; the MAC address of the peer device is 000f-e200-2200.

display cluster black-list

Syntax

display cluster black-list

View

Any view

Parameters

None

Description

Use the display cluster black-list command to display the information of devices in the current cluster blacklist.

Related commands: black-list.

Examples

# Display the contents of the current cluster blacklist.

<aaa_0.Sysname> display cluster black-list

Device ID Access Device ID Access port

000f-e200-5502 000f-e202-2180 Ethernet1/0/24

00e0-fd34-bc66 000f-e202-2180 Ethernet1/0/1

Table 2-11 Description on the fields of the display cluster black-list command

Field	Description
Device ID	ID of the device in the blacklist, expressed by the MAC address of the device
Access Device ID	ID of the device (in the cluster) that is connected with a device in the blacklist, expressed by the MAC address of the device
Access port	Port (in the cluster) that is connected with a device in the blacklist

display cluster current-topology

Syntax

display cluster current-topology [ mac-address mac-address1 [ to-mac-address mac-address2 ] | member-id member-id1 [ to-member-id member-id2 ] ]

View

Any view

Parameters

mac-address mac-address1: Displays the topology structure three layers above or below the node specified by the MAC address. If to-mac-address is specified, mac-address1 is the start point of the route in the specified route topology displayed.

to-mac-address mac-address2: Displays the topology structure of the route from mac-address1 to mac-address2.

member-id member-id1: Displays the structure of the standard topology three layers above or below the node specified by the member ID. If to-member-id is specified, member-id1 is the start point of the route in the specified route topology displayed.

to-member-id member-id2: Displays the topology structure of the route from member-id1 to member-id2.

Description

Use the display cluster current-topology command to display the topology of the current cluster.

If to-mac-address or to-member-id is not specified, the system displays the topology structure three layers below the node specified by the MAC address or member ID.

If to-mac-address or to-member-id is specified, the system displays the topology structure of the route between the two specified MAC addresses or two member IDs.

When you display the cluster topology information, the devices attached to the switch that is listed in the backlist will not be displayed.

Examples

# Display the topology of the current cluster.

<aaa_0.Sysname> display cluster current-topology

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

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

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

ConnectFlag:

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

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

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

[aaa_0.H3C:000f-e202-2180]

├-(P_0/40)<-->(P_0/6)[Sysname:000f-e200-2200]

├-(P_0/28)<-->(P_3/0/1)[Sysname:000f-e200-1774]

├-(P_0/24)****(P_1/0/6)[clie:000f-e200-5502]

├-(P_0/22)<-->(P_1/0/2)[aaa_5.H3C:000f-e200-5111]

├-(P_0/18)<-->(P_3/0/2)[Sysname S7503S3600:000f-e218-d0d0]

├-(P_0/14)<-->(P_1/0/2)[Sysname:000f-e200-5601]

├-(P_0/10)<-->(P_1/0/1)[aaa_7.S5500-28C-SI:0012-a990-2241]

├-(P_0/4)<-->(P_0/2)[2024CS3600:000f-e200-00cc]

└-(P_0/1)****(P_0/1)[Sysname:00e0-fd34-bc66]

display ntdp single-device mac-address

Syntax

display ntdp single-device mac-address mac-address

View

Any view

Parameters

mac-address: MAC address of the device whose detailed information is to be displayed.

Description

Use the display ntdp single-device mac-address command to display the detailed information, which is collected through NTDP protocol packets, about a single device. The information displayed by the command is similar to that displayed by the display cluster members command. However, if you want to display information about a device that is enabled with only NTDP and is not in any cluster, you have to use the display ntdp single-device mac-address command.

Examples

# Display the detailed information about the switch with the MAC address 000f-e200-3956.

<Sysname> display ntdp single-device mac-address 000f-e200-3956

Hostname : H3C

MAC : 000f-e200-3956

Hop : 0

Platform : H3C S3100-28P-EI

IP :

Version:

H3C Comware Platform Software.

Comware Software, Version 3.10

S3100-28P-EI S3100-EI-1545

Cluster : Candidate switch

Peer MAC Peer Port ID Native Port ID Speed Duplex

000f-e239-1333 Ethernet1/0/4 Ethernet1/0/10 100 FULL

Table 2-12 Description on the fields of the display ntdp single-device command

Field	Description
Hostname	System name of a device
MAC	MAC address of the device
Hop	Number of hops from the device to the topology-collecting device
Platform	Platform information of the device
IP	IP address and mask length of the management VLAN interface of the device
Version	Version information
Cluster	Role the device plays in the cluster
Peer MAC	MAC address of the peer device
Peer Port ID	Name of the port on the peer device connecting to the local device
Native Port ID	Name of the port on the local device connecting to the peer device
Speed	Rate of the local port connecting to the peer device
Duplex	Duplex mode of the local port connecting to the peer device

topology accept

Syntax

topology accept { all [ save-to local-flash ] | mac-address mac-address | member-id member-id | administrator }

View

Cluster view

Parameters

all: Accepts the current cluster topology as the standard topology.

save-to: Saves the standard topology of the current cluster to the local Flash or the cluster FTP server.

local-flash: Saves the standard topology of the current cluster to the local Flash.

mac-address mac-address: Accepts adding the device with the specified MAC address to the standard topology of the cluster.

member-id member-id: Accepts adding the device with the specified member ID to the standard topology of the cluster.

administrator: Accepts adding the administrative device to the standard topology of the cluster.

Description

Use the topology accept command to accept the topology of the current cluster as the standard topology, and save the standard topology to the Flash memory of the administrative device so that the standard topology can be restored when errors occur to the topology.

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

Related commands: display cluster base-topology, topology restore-from, topology save-to.

Examples

# Save the current cluster topology as the base topology and save it in the local flash.

<aaa_0.Sysname> system-view

Enter system view, return to user view with Ctrl+Z.

[aaa_0.Sysname] cluster

[aaa_0.Sysname-cluster] topology accept all save-to local-flash

# Accept the device with the MAC address 0010-0f66-3022 as a member of the base cluster topology.

<aaa_0.Sysname> system-view

Enter system view, return to user view with Ctrl+Z.

[aaa_0.Sysname] cluster

[aaa_0.Sysname-cluster] topology accept mac-address 0010-0f66-3022

topology restore-from

Syntax

topology restore-from local-flash

View

Cluster view

Parameters

local-flash: Restores the standard topology of the cluster from the local Flash memory.

Description

Use the topology restore-from command to restore the standard topology of the cluster from the Flash memory of the administrative device when errors occur to the topology, and advertise the topology to the member devices of the cluster to ensure normal operation of the cluster.

You can only use this command on the cluster administrative device.

Related commands: topology accept, topology save-to.

Examples

# Restore the base cluster topology from the flash of the management device in the cluster.

<aaa_0.Sysname> system-view

Enter system view, return to user view with Ctrl+Z.

[aaa_0.Sysname] cluster

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

topology save-to

Syntax

topology save-to local-flash

View

Cluster view

Parameters

None

Description

Use the topology save-to command to save the standard topology of the cluster to the local Flash memory.

The file name used to save the standard topology is topology.top. Do not modify the file name.

This command is applicable to only the management device of a cluster.

Related commands: topology restore-from.

Examples

# Enter Cluster view.

<aaa_0.Sysname>system-view

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

[aaa_0.Sysname] cluster

[aaa_0.Sysname-cluster]

# Save the standard topology of the cluster to the local Flash.

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

Base topology backup to file OK

H3C S3100 Series Ethernet Switches command Manual-Release 21XX Series(V1.06)

stacking

ndp enable

cluster enable

delete-member

ip-pool

snmp-host

Enhanced Cluster Feature Configuration Commands

display cluster base-members

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