25-Stack-Cluster Commands

Download

Table of Contents

Chapter 1 Stack Function Configuration Commands. 1-1

1.1 Stack Function Configuration Commands. 1-1

1.1.1 display stacking. 1-1

1.1.2 stack-port enable. 1-3

1.1.3 stacking. 1-3

1.1.4 stacking enable. 1-4

1.1.5 stacking ip-pool 1-5

Chapter 2 HGMP V2 Configuration Commands. 2-1

2.1 NDP Configuration Commands. 2-1

2.1.1 display ndp. 2-1

2.1.2 ndp enable. 2-3

2.1.3 ndp timer aging. 2-4

2.1.4 ndp timer hello. 2-5

2.1.5 reset ndp statistics. 2-6

2.2 NTDP Configuration Commands. 2-6

2.2.1 display ntdp. 2-6

2.2.2 display ntdp device-list 2-8

2.2.3 ntdp enable. 2-10

2.2.4 ntdp explore. 2-11

2.2.5 ntdp hop. 2-11

2.2.6 ntdp timer 2-12

2.2.7 ntdp timer hop-delay. 2-13

2.2.8 ntdp timer port-delay. 2-14

2.3 Cluster Configuration Commands. 2-15

2.3.1 add-member 2-15

2.3.2 administrator-address. 2-16

2.3.3 auto-build. 2-17

2.3.4 build. 2-19

2.3.5 cluster 2-22

2.3.6 cluster enable. 2-22

2.3.7 cluster switch-to. 2-23

2.3.8 cluster-mac. 2-24

2.3.9 cluster-mac syn-interval 2-25

2.3.10 delete-member 2-26

2.3.11 display cluster 2-27

2.3.12 display cluster candidates. 2-29

2.3.13 display cluster members. 2-31

2.3.14 ftp cluster 2-33

2.3.15 ftp-server 2-34

2.3.16 holdtime. 2-35

2.3.17 ip-pool 2-36

2.3.18 logging-host 2-37

2.3.19 management-vlan. 2-38

2.3.20 reboot member 2-38

2.3.21 snmp-host 2-39

2.3.22 tftp get 2-40

2.3.23 tftp put 2-41

2.3.24 tftp-server 2-42

2.3.25 timer 2-43

2.3.26 tracemac. 2-44

2.4 Enhanced Cluster Feature Configuration Commands. 2-45

2.4.1 black-list 2-45

2.4.2 display cluster base-members. 2-46

2.4.3 display cluster base-topology. 2-47

2.4.4 display cluster black-list 2-48

2.4.5 display cluster current-topology. 2-49

2.4.6 display ntdp single-device mac-address. 2-51

2.4.7 topology accept 2-52

2.4.8 topology restore-from.. 2-53

2.4.9 topology save-to. 2-54

 


Chapter 1  Stack Function Configuration Commands

1.1  Stack Function Configuration Commands

1.1.1  display stacking

Syntax

display stacking [ members ]

View

Any view

Parameter

members: Displays the information about the members of a stack. Do not specify this keyword when you execute this command on a slave switch.

Description

Use the display stacking command to display the information about the main switch or the slave switches of a stack.

When you execute this command on a main switch, the information displayed depends on the members keyword as follows:

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

 

1.1.2  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

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

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

 

&  Note:

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>

1.1.5  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

 


Chapter 2  HGMP V2 Configuration Commands

2.1  NDP Configuration Commands

2.1.1  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

 

2.1.2  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

2.1.3  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

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

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

2.1.5  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

2.2  NTDP Configuration Commands

2.2.1  display ntdp

Syntax

display ntdp

View

Any view

Parameters

None

Description

Use the display ntdp command to display the global NTDP information.

The 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

 

2.2.2  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

Copyright(c) 2004-2007 Hangzhou H3C Technologies Co.,Ltd.All rights reserved.

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

Copyright(c) 2004-2007 Hangzhou H3C Technologies Co.,Ltd.All rights reserved.

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

 IP        : 192.168.0.241/24

 Version   :

H3C Comware Platform Software

Comware Software, Version 3.10

Copyright(c) 2004-2007 Hangzhou H3C Technologies Co.,Ltd.All rights reserved.

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

 

2.2.3  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

2.2.4  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

2.2.5  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

2.2.6  ntdp timer

Syntax

ntdp timer interval-in-minutes

undo ntdp timer

View

System view

Parameters

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