interface interface-list: Specifies an Ethernet port list, which can contain multiple Ethernet ports. The interface-list argument is in the format of interface-list = { interface-type interface-number [ to interface-type interface-number ] } & <1-10>,where, interface-type is port type and interface-number is port number, and &<1-10> means that you can provide up to 10 port indexes/port index lists for this argument.

Description

Use the display ndp command to display NDP configuration information, which includes the interval to send NDP packets, the time for the receiving device to hold NDP information and the information about the neighbors of all ports.

Examples

# Display NDP configuration information.

<Sysname> display ndp

Neighbor Discovery Protocol is enabled.

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

Interface: GigabitEthernet1/0/1

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

Interface: GigabitEthernet1/0/2

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

Interface: GigabitEthernet1/0/3

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

Interface: GigabitEthernet1/0/4

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

Neighbor 1: Aging Time: 122(s)

MAC Address : 00e0-fc00-2579

Host Name : Sysname

Port Name : GigabitEthernet1/0/4

Software Ver: ESS 1101

Device Name : S5810-50S

Port Duplex : AUTO

Product Ver : ESS 1101

BootROM Ver : 105

Interface: GigabitEthernet1/0/5

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

Interface: GigabitEthernet1/0/6

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

Interface: GigabitEthernet1/0/7

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

Interface: GigabitEthernet1/0/8

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

Interface: GigabitEthernet1/0/9

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

Interface: GigabitEthernet1/0/10

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

Neighbor 1: Aging Time: 134(s)

MAC Address : 00e0-fc00-3133

Host Name : Sysname

Port Name : GigabitEthernet1/0/11

Software Ver: ESS 1101

Device Name : S5810-50S

Port Duplex : AUTO

Product Ver : 105

Interface: GigabitEthernet1/0/11

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

Interface: GigabitEthernet1/0/12

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

Interface: GigabitEthernet1/0/13

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

Interface: GigabitEthernet1/0/14

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

Interface: GigabitEthernet1/0/15

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

Interface: GigabitEthernet1/0/16

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

Interface: GigabitEthernet1/0/17

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

Interface: GigabitEthernet1/0/18

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

Interface: GigabitEthernet1/0/19

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

Interface: GigabitEthernet1/0/20

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

Interface: GigabitEthernet1/0/21

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

Interface: GigabitEthernet1/0/22

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

Interface: GigabitEthernet1/0/23

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

Interface: GigabitEthernet1/0/24

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

Table 1-1 display ndp command output description

Field	Description
Neighbor Discovery Protocol is enabled	NDP is enabled globally on the current device.
Neighbor Discovery Protocol Ver	Version of NDP
Hello Timer	Interval to send NDP packets
Aging Timer	The time for the receiving device to hold NDP information
Interface	A specified port
Status	NDP state of a port
Pkts Snd	Number of the NDP packets sent through the port
Pkts Rvd	Number of the NDP packets received on the port
Pkts Err	Number of the error NDP packets received
Neighbor 1: Aging Time	Aging time of the NDP information of a neighbor device
MAC Address	MAC address of a neighbor device
Host Name	Host name of a neighbor device
Port Name	Port name of a neighbor device
Software Ver	Software version of the neighbor device
Device Name	Device name of a neighbor device
Port Duplex	Port duplex mode of a neighbor device
Product Ver	Product version of a neighbor device
BootROM Ver	Boot ROM version of a neighbor device

ndp enable

Syntax

In Ethernet interface view or Layer 2 aggregate interface view:

ndp enable

undo ndp enable

In system view:

ndp enable [ interface interface-list ]

undo ndp enable [ interface interface-list ]

View

System view, Ethernet interface view, Layer 2 aggregate interface view

Default Level

2: System level

Parameters

interface interface-list: Specifies an Ethernet port list, which can contain multiple Ethernet ports. The interface-list argument is in the format of interface-list = { interface-type interface-number [ to interface-type interface-number ] } & <1-10>, where interface-type represents the port type, interface-number represents the port number, and & <1-10> means that you can provide up to 10 port indexes/port index lists for this argument.

Description

Use the ndp enable command to enable NDP.

Use the undo ndp enable command to disable this feature.

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

Note that:

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

l When being executed in interface view, this command enables NDP for the current port only.

l Configured in Layer 2 aggregate interface view, the configuration will not take effect on the member ports of the aggregation group that corresponds to the aggregate interface; configured on a member port of an aggregation group, the configuration will take effect only after the member port quit the aggregation group. For description of aggregation configurations, refer to Link Aggregation Configuration in the Access Volume.

Examples

# Enable NDP globally.

<Sysname> system-view

[Sysname] ndp enable

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

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] ndp enable

ndp timer aging

Syntax

ndp timer aging aging-time

undo ndp timer aging

View

System view

Default Level

2: System level

Parameters

aging-time: Time for a device to keep the NDP packets it receives, in the range 5 to 255 seconds.

Description

Use the ndp timer aging command to specify the time that a device should keep the NDP packets it received from the adjacent device.

Use the undo timer aging command to restore the default.

By default, the time that a receiving device should keep the NDP packets is 180 seconds.

Note that the time for the receiving device to hold NDP packets cannot be shorter than the interval to send NDP packets; otherwise, the NDP table may become instable.

Related commands: ndp timer hello.

Examples

# Configure the time that a receiving device should keep the NDP packets as 100 seconds.

<Sysname> system-view

[Sysname] ndp timer aging 100

ndp timer hello

Syntax

ndp timer hello hello-time

undo ndp timer hello

View

System view

Default Level

2: System level

Parameters

hello-time: Interval to send NDP packets, in the range 5 to 254 seconds.

Description

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

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

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

Note that the interval for sending NDP packets cannot be longer than the time for the receiving device to hold NDP packets; otherwise, the NDP table may become instable.

Related commands: ndp timer aging.

Examples

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

<Sysname> system-view

[Sysname] ndp timer hello 80

reset ndp statistics

Syntax

reset ndp statistics [ interface interface-list ]

View

User view

Default Level

2: System level

Parameters

interface interface-list: Specifies an Ethernet port list, which can contain multiple Ethernet ports. The interface-list argument is in the format of interface-list = { interface-type interface-number [ to interface-type interface-number ] } & <1-10>, where interface-type represents the port type, interface-number represents the port number, and & <1-10> means that you can provide up to 10 port indexes/port index lists for this argument. If you provide this keyword, NDP statistics of the specified port will be cleared; otherwise, NDP statistics of all ports will be cleared.

Description

Use the reset ndp statistics command to clear NDP statistics.

Examples

# Clear NDP statistics of all ports.

<Sysname> reset ndp statistics

NTDP Configuration Commands

display ntdp

Syntax

display ntdp

View

Any view

Default Level

1: Monitor level

Parameters

None

Description

Use the display ntdp command to display NTDP configuration information.

Examples

# Display NTDP configuration information.

<Sysname> display ntdp

NTDP is running.

Hops : 4

Timer : 1 min

Hop Delay : 100 ms

Port Delay: 10 ms

Last collection total time: 92ms

Table 1-2 display ntdp command output description

Field	Description
NTDP is running	NTDP is enabled globally on the local device.
Hops	Hop count for topology collection
Timer	Interval to collect topology information (after the cluster is created)
disable	Indicates the device is not a management device and unable to perform periodical topology collection
Hop Delay	Delay time for the device to forward topology collection requests
Port Delay	Delay time for a topology-collection request to be forwarded through a port
Last collection total time	Time cost during the last collection

display ntdp device-list

Syntax

display ntdp device-list [ verbose ]

View

Any view

Default Level

1: Monitor level

Parameters

verbose: Displays the detailed device information collected through NTDP.

Description

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

Note that the information displayed may not be that of the latest device if you do not execute the ntdp explore command before using this command.

Related commands: ntdp explore.

Examples

# Display the device information collected through NTDP.

<Sysname> display ntdp device-list

MAC HOP IP Device

00e0-fc00-3133 2 S5810-50S

000f-e20f-c415 2 31.31.31.5/24 S5810-50S

00e0-fc00-2579 1 S5810-50S

00e0-fc00-1751 0 31.31.31.1/24 S5810-50S

00e0-fd00-0043 2 Sysname S3610

00e0-fc00-3199 3 S5810-50S

Table 1-3 display ntdp device-list command output description

Field	Description
MAC	MAC address of a device
HOP	Hops to the collecting device
IP	IP address and mask length of the management VLAN interface on the device
Device	Device name

# Display the detailed device information collected through NTDP.

<aabbcc_0.Sysname> display ntdp device-list verbose

Hostname : aabbcc_0.Sysname

MAC : 00e0-fc00-1400

Hop : 0

Device : H3C S5810-50S

IP : 192.168.1.5/24

Version :

H3C Comware Platform Software

Comware Software, Version 5.20, Test 1102

H3C S5810-50S

Cluster : Administrator switch of cluster aaa

Peer MAC Peer Port ID Native Port ID Speed Duplex

00e0-fc00-5175 GigabitEthernet1/0/1 GigabitEthernet1/0/1 100 FULL

Table 1-4 display ntdp device-list verbose command output description

Field	Description
Hostname	System name of the device
MAC	MAC address of the device
Hop	Hops from the current device to the device that collect topology information
Device	Device name
IP	IP address and subnet mask length of the management VLAN interface on the device
Version	Version information
Cluster	Role of the device in the cluster: l Member switch of cluster aabbcc: The device is a member device of the cluster aabbcc. l Administrator switch of cluster aabbcc: The device is the management device of the cluster aabbcc.
Administrator MAC	MAC address of the management device
Peer MAC	MAC address of a neighbor device
Peer Port ID	Name of the peer port connected to the local port
Native Port ID	Name of the local port to which a neighbor device is connected
Speed	Speed of the local port to which a neighbor device is connected
Duplex	Duplex mode of the local port to which a neighbor device is connected

display ntdp single-device

Syntax

display ntdp single-device mac-address mac-address

View

Any view

Default Level

1: Monitor level

Parameters

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

Description

Use the display ntdp single-device mac-address command to view the detailed NTDP information of a specified device.

Examples

# Display the detailed NTDP information of the device with a MAC address of 00E0-FC00-5111.

<Sysname> display ntdp single-device mac-address 00e0-fc00-5111

Hostname : aaa_1.42-com2

MAC : 00e0-fc00-5111

Hop : 1

Device : S5810-50S

IP : 16.168.1.2/24

Version :

H3C Comware Platform Software

Comware Software, Version 5.20, Test 1102

H3C S5810-50S

Cluster : Member switch of cluster aaa , Administrator MAC: 00e0-fc00-5175

Peer MAC Peer Port ID Native Port ID Speed Duplex

00e0-fc00-5175 GigabitEthernet1/0/1 GigabitEthernet1/0/1 100 FULL

00e0-fc00-5175 GigabitEthernet1/0/5 GigabitEthernet1/0/7 100 FULL

Table 1-5 display ntdp device-list command output description

Field	Description
Hostname	System name of the device
MAC	MAC address of the device
Hop	Hops from the current device to the device that collect topology information
Device	Device name
IP	IP address and subnet mask length of the management VLAN interface on the device
Version	Version information
Cluster	Role of the device in the cluster: l Member switch of cluster aabbcc: The device is a member device of the cluster aabbcc. l Administrator switch of cluster aabbcc: The device is the management device of the cluster aabbcc.
Administrator MAC	MAC address of the management device
Peer MAC	MAC address of a neighbor device
Peer Port ID	Name of the peer port connected to the local port
Native Port ID	Name of the local port to which a neighbor device is connected
Speed	Speed of the local port to which a neighbor device is connected
Duplex	Duplex mode of the local port to which a neighbor device is connected

ntdp enable

Syntax

ntdp enable

undo ntdp enable

View

System view, Ethernet interface view, Layer 2 aggregate interface view

Default Level

2: System level

Parameters

None

Description

Use the ntdp enable command to enable NTDP.

Use the undo ntdp enable command to disable NTDP.

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

Note that:

l Execution of the command in system view enables the global NTDP; execution of the command in interface view enables NTDP of the current port.

Examples

# Enable NTDP globally.

<Sysname> system-view

[Sysname] ntdp enable

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

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] ntdp enable

ntdp explore

Syntax

ntdp explore

View

User view

Default Level

2: System level

Parameters

None

Description

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

Examples

# Start topology information collection manually.

<Sysname> ntdp explore

ntdp hop

Syntax

ntdp hop hop-value

undo ntdp hop

View

System view

Default Level

2: System level

Parameters

hop-value: Maximum hop for collecting topology information, in the range 1 to 16.

Description

Use the ntdp hop command to set maximum hop for collecting topology information.

Use the undo ntdp hop command to restore the default.

By default, the value is 3.

Note that this command is only applicable to the topology-collecting device. A bigger number of hops requires more memory of the topology-collecting device.

Examples

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

<Sysname> system-view

[Sysname] ntdp hop 5

ntdp timer

Syntax

ntdp timer interval

undo ntdp timer

View

System view

Default Level

2: System level

Parameters

interval: Interval (in minutes) to collect topology information, in the range 0 to 65,535. The value 0 means not to collect topology information.

Description

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

Use the undo ntdp timer command to restore the default.

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

Note that the management device can start to collect the topology information only after the cluster is set up.

Examples

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

<Sysname> system-view

[Sysname] ntdp timer 30

ntdp timer hop-delay

Syntax

ntdp timer hop-delay delay-time

undo ntdp timer hop-delay

View

System view

Default Level

2: System level

Parameters

delay-time: Delay time (in milliseconds) for a device receiving topology-collection requests to forward them through its first port. This argument ranges from 1 to 1,000.

Description

Use the ntdp timer hop-delay command to set the delay time for the device to forward topology-collection requests through the first port.

Use the undo ntdp timer hop-delay command to restore the default delay time, which is 200 ms.

Examples

# Set the delay time for the device to forward topology-collection requests through the first port to 300 ms.

<Sysname> system-view

[Sysname] ntdp timer hop-delay 300

ntdp timer port-delay

Syntax

ntdp timer port-delay delay-time

undo ntdp timer port-delay

View

System view

Default Level

2: System level

Parameters

delay-time: Delay time (in milliseconds) for a device to forward a topology-collection request through its successive ports, in the range 1 to 100.

Description

Use the ntdp timer port-delay command to set the delay time for a device to forward a received topology-collection request through its successive ports.

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

Examples

# Set the delay time for the device to forward topology-collection requests through the successive ports to 40 ms.

<Sysname> system-view

[Sysname] ntdp timer port-delay 40

Cluster Configuration Commands

add-member

Syntax

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

View

Cluster view

Default Level

2: System level

Parameters

member-number: Member number assigned to the candidate device to be added to a cluster, in the range 1 to 255.

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

password: Password of the candidate device, a string of 1 to 16 characters. The password is required when you add a candidate device to a cluster. However, this argument is not needed if the candidate device is not configured with a super password.

Description

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

Note that:

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

l When adding a member device to a cluster, you need not assign a number to the device. The management device will automatically assign a usable number to the newly added member device.

l After a candidate device joins the cluster, its level 3 password is replaced by the super password of the management device in cipher text.

Examples

#Add a candidate device to the cluster on the management device, setting the member number to 6. (Assume that the MAC address and user password of the candidate device are 00E0-FC00-35E7 and 123456 respectively.)

<aabbcc_0.Sysname> system-view

[aabbcc_0.Sysname] cluster

[aabbcc_0.Sysname-cluster] add-member 6 mac-address 00e0-fc00-35e7 password 123456

administrator-address

Syntax

administrator-address mac-address name cluster-name

undo administrator-address

View

Cluster view

Default Level

2: System level

Parameters

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

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

Description

Use the administrator-address command to add a candidate device to a cluster.

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

By default, a device belongs to no cluster.

Note that:

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

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

Examples

# Remove a member device from the cluster on the member device.

<aabbcc_1.Sysname> system-view

[aabbcc_1.Sysname] cluster

[aabbcc_1.Sysname-cluster] undo administrator-address

auto-build

Syntax

auto-build [ recover ]

View

Cluster view

Default Level

2: System level

Parameters

recover: Automatically reestablishes communication with all the member devices.

Description

Use the auto-build command to establish a cluster automatically.

Note that:

l This command can be executed on a candidate device or the management device.

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

l If you execute this command on the management device, the system will collect candidates directly and add them into the cluster automatically.

l The recover keyword is used to recover a cluster. Using the auto-build recover command, you can find the members that are currently not in the member list and add them to the cluster again.

l Ensure that NTDP is enabled, because it is the basis of candidate and member collection. The collection range is also decided through NTDP. You can use the ntdp hop command in system view to modify the collection range.

l If a member is configured with a super password different from the super password of the management device, it cannot be added to the cluster automatically.

Examples

# Establish a cluster automatically on the management device.

<Sysname> system-view

[Sysname] cluster

[Sysname-cluster] auto-build

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

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

Get file error, can not finish base topology recover

Please input cluster name:aabbcc

Collecting candidate list, please wait...

#Jul 22 14:35:18:841 2006 Sysname CLST/5/Cluster_Trap:

OID:1.3.6.1.4.1.2011.6.7.1.0.3: member 0.0.0.0.0.224.252.0.0.0 role change, NTDP

Index:0.0.0.0.0.0.224.252.0.0.0, Role:1

Candidate list:

Name Hops MAC Address Device

Processing...please wait

Cluster auto-build Finish!

0 member(s) added successfully.

black-list add-mac

Syntax

black-list add-mac mac-address

View

Cluster view

Default Level

2: System level

Parameters

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

Description

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

Note that this command can be executed on the management device only.

Examples

# Add a device with the MAC address of 0EC0-FC00-0001 to the blacklist on the management device.

<aabbcc_0.Sysname> system-view

[aabbcc_0.Sysname] cluster

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

black-list delete-mac

Syntax

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

View

Cluster view

Default Level

2: System level

Parameters

all: Deletes all devices from the blacklist.

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

Description

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

Note that this command can be executed on the management device only.

Examples

# Delete a device with the MAC address of 0EC0-FC00-0001 from the blacklist on the management device.

<aabbcc_0.Sysname> system-view

[aabbcc_0.Sysname] cluster

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

# Delete all devices in the blacklist on the management device.

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

build

Syntax

build cluster-name

undo build

View

Cluster view

Default Level

2: System level

Parameters

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

Description

Use the build command to configure the current device as the management device and specify a name for it.

Use the undo build command to configure the current management device as a candidate device.

By default, the device is not a management device.

Note that:

l When executing this command, you will be asked whether to create a standard topology map or not.

l This command can only be applied to devices that are capable of being a management device and are not members of other clusters. The command takes no effect if you execute the command on a device which is already a member of another cluster. If you execute this command on a management device, you will replace the cluster name with the one you specify.

l The member number of the management device is 0.

Examples

# Configure the current device as a management device and specify the cluster name as aabbcc.

<Sysname> system-view

[Sysname] cluster

[Sysname-cluster] build aabbcc

[Sysname-cluster] ip-pool 172.16.0.1 255.255.255.248

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

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

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

Get file error, can not finish base topology recover

#Sep 18 19:56:03:804 2006 Sysname IFNET/4/INTERFACE UPDOWN:

Trap 1.3.6.1.6.3.1.1.5.4: Interface 3276899 is Up, ifAdminStatus is 1, ifOperSt

atus is 1

#Sep 18 19:56:03:804 2006 Sysname CLST/4/Cluster_Trap:

OID:1.3.6.1.4.1.2011.6.7.1.0.3: member 0.0.0.0.0.224.252.0.29.0 role change, NTD

PIndex:0.0.0.0.0.0.224.252.0.29.0, Role:1

%Sep 18 19:56:03:804 2006 Sysname IFNET/4/UPDOWN:

Line protocol on the interface Vlan-interface100 is UP

[aabbcc_0.Sysname-cluster]

%Sep 18 19:56:18:782 2006 Sysname CLST/4/LOG:

Member 00e0-fc00-1e00 is joined in cluster aabbcc.

[aabbcc_0.Sysname-cluster]

cluster

Syntax

cluster

View

System view

Default Level

2: System level

Parameters

None

Description

Use the cluster command to enter cluster view.

Examples

# Enter cluster view

<Sysname> system-view

[Sysname] cluster

[Sysname-cluster]

cluster enable

Syntax

cluster enable

undo cluster enable

View

System view

Default Level

2: System level

Parameters

None

Description

Use the cluster enable command to enable the cluster function.

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

By default, the cluster function is enabled.

Note that:

l When you execute the undo cluster enable command on a management device, you remove the cluster and its members, and the device stops operating as a management device.

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

l When you execute the undo cluster enable command on a device that belongs to no cluster, you disable the cluster function on the device.

Examples

# Enable the cluster function.

<Sysname> system-view

[Sysname] cluster enable

cluster switch-to

Syntax

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

View

User view

Default Level

0: Visit level

Parameters

member-number: Number of a member device in a cluster, in the range 1 to 255.

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

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

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

Description

Use the cluster switch-to command to switch between the management device and member devices.

Examples

# Switch from the operation interface of the management device to that of the member device numbered 6 and then switch back to the operation interface of the management device.

<aaa_0.Sysname> cluster switch-to 6

<aaa_6.Sysname> quit

<aaa_0.Sysname>

# Enter the member device numbered 5 with the system name of switcha.

<aaa_0.Sysname> cluster switch-to sysname switcha

SN Device MAC Address Status Name

5 S5810 00e0-fc00-5101 UP test_5.switcha

6 S5810 00e0-fc00-5102 UP test_6.switcha

press SN number to switch to the device, other number will quit the command: 5

<aaa_5.switcha>

cluster-local-user

Syntax

cluster-local-user user-name password { cipher | simple } password

undo cluster-local-user user-name

View

Cluster view

Default Level

1: Monitor level

Parameters

cipher: Indicates that the password is in cipher text.

simple: Indicates that the password is in plain text.

username: Username used for logging onto the devices within a cluster through Web, a string of 1 to 55 characters.

password: Password used for logging onto the devices within a cluster through Web. This password is a string of 1 to 63 characters when the simple keyword is specified, and can be in either plain text or cipher text when the cipher keyword is specified. A plain text password must be a string of 1 to 63 characters. The cipher text password must have a fixed length of 24 or 88 characters. The password is case sensitive.

Description

Use the cluster-local-user command to configure Web user accounts in batches.

Use the undo cluster-local-user command to remove the configuration.

Note that the command can be configured once on the management device only.

Examples

# On the management device, configure Web user accounts for the devices within a cluster, with username being abc, password being 123456 and displayed in plain text.

<aaa_0.Sysname> system-view

[aaa_0.Sysname] cluster

[aaa_0.Sysname-cluster] cluster-local-user abc password simple 123456

cluster-mac

Syntax

cluster-mac mac-address

undo cluster-mac

View

Cluster view

Default Level

2: System level

Parameters

mac-address: Multicast MAC address (in hexadecimal in the format of H-H-H), which can be 0180-C200-0000, 0180-C200-000A, 0180-C200-0020 through 0180-C200-002F, or 010F-E200-0002.

Description

Use the cluster-mac command to configure the destination MAC address for cluster management protocol packets.

Use the undo cluster-mac command to restore the default.

By default, the destination MAC address is 0180-C200-000A.

Note that this command can be executed on the management device only.

Examples

# Set the multicast MAC address of the cluster management protocol packets to 0180-C200-0000 on the management device.

<Sysname> system-view

[Sysname] cluster

[Sysname-cluster] ip-pool 10.1.1.1 24

[Sysname-cluster] build aaa

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

cluster-mac syn-interval

Syntax

cluster-mac syn-interval interval

View

Cluster view

Default Level

2: System level

Parameters

interval: Interval (in minutes) to send broadcast packets, in the range 0 to 30. If the interval is set to 0, the management device does not send broadcast packets to the member devices.

Description

Use the cluster-mac syn-interval command to set the interval for a management device to send MAC address negotiation broadcast packets for cluster management.

By default, the interval is set to one minute.

Note that this command can be executed on the management device only.

Examples

# Set the interval for the management device to send MAC address negotiation broadcast packets for cluster management to two minutes on the management device.

<Sysname> system-view

[Sysname] cluster

[Sysname-cluster] ip-pool 10.1.1.1 24

[Sysname-cluster] build aaa

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

cluster-snmp-agent community

Syntax

cluster-snmp-agent community { read | write } community-name [ mib-view view-name ]

undo cluster-snmp-agent community community-name

View

Cluster view

Default Level

1: Monitor level

Parameters

read: Indicates to allow the community’s read-only access to MIB objects. The community with read-only authority can only query the device information.

write: Indicates to allow the community’s read-write access to MIB objects. The community with read-write authority can configure the device information.

community-name: Community name, a string of 1 to 26 characters.

view-name: MIB view name, a string of 1 to 32 characters.

Description

Use the cluster-snmp-agent community command to configure an SNMP community shared by a cluster and set its access authority.

Use the undo cluster-snmp-agent community command to remove a specified community name.

Note that:

l The command used to configure the SNMP community with read or read-only authority can only be executed once on the management device. This configuration will be synchronized to the member devices in the whitelist, which is equal to configuring multiple member devices at one time.

l SNMP community name will be retained if a cluster is dismissed or a member device is removed from the whitelist.

l If the same community name as the current one has been configured on a member device, the current community name will replace the original one.

Examples

# Configure the SNMP community name shared by a cluster as comaccess and allow the community’s read-only access to MIB objects.

<aaa_0.Sysname> system-view

[aaa_0.Sysname] cluster

[aaa_0.Sysname-cluster] cluster-snmp-agent community read comaccess

# Configure the SNMP community name shared by a cluster as comaccesswr and allow the community’s read-write access to MIB objects.

[aaa_0.Sysname-cluster] cluster-snmp-agent community write comacceswr

cluster-snmp-agent group v3

Syntax

cluster-snmp-agent group v3 group-name [ authentication | privacy ] [ read-view read-view ] [ write-view write-view ] [ notify-view notify-view ]

undo cluster-snmp-agent group v3 group-name [ authentication | privacy ]

View

Cluster view

Default Level

1: Monitor level

Parameters

group-name: Group name, a string of 1 to 32 characters.

authentication: Specifies to authenticate a packet but not to encrypt it.

privacy: Specifies to authenticate and encrypt a packet.

read-view: Read-only view name, a string of 1 to 32 characters.

write-view: Read-write view name, a string of 1 to 32 characters.

notify-view: View name in which Trap messages can be sent, a string of 1 to 32 characters.

Description

Use the cluster-snmp-agent group command to configure the SNMPv3 group shared by a cluster and set its access rights.

Use the undo cluster-snmp-agent group command to remove the SNMPv3 group shared by a cluster.

Note that:

l The command can be executed once on the management device only. This configuration will be synchronized to the member devices in the whitelist, which is equal to configuring multiple member devices at one time.

l SNMPv3 group name will be retained if a cluster is dismissed or a member device is deleted from the whitelist.

l If the same group name as the current one has been configured on a member device, the current group name will replace the original one.

Examples

# Create an SNMP group snmpgroup.

<aaa_0.Sysname> system-view

[aaa_0.Sysname] cluster

[aaa_0.Sysname-cluster] cluster-snmp-agent group v3 snmpgroup

cluster-snmp-agent mib-view

Syntax

cluster-snmp-agent mib-view included view-name oid-tree

undo cluster-snmp-agent mib-view view-name

View

Cluster view

Default Level

1: Monitor level

Parameters

included: Includes MIB view.

view-name: MIB view name, a string of 1 to 32 characters.

oid-tree: MIB subtree, a string of 1 to 255 characters, which can only be a variable OID string or variable name string. OID is composed of a series of integers, indicating where a node is in the MIB tree. It can uniquely identify an object in a MIB.

Description

Use the cluster-snmp-agent mib-view command to create or update the MIB view information shared by a cluster.

Use the undo cluster-snmp-agent mib-view command to delete the MIB view information shared by a cluster.

By default, the MIB view name shared by a cluster is ViewDefault, in which the cluster can access ISO subtree.

Note that:

l This command can be executed once on the management device only. This configuration will be synchronized to member devices on the whitelist, which is equal to configuring multiple member devices at one time.

l The MIB view will be retained if a cluster is dismissed or a member device is deleted from the whitelist.

l If the same view name as the current one has been configured on a member device, the current view will replace the original one on the member device.

Examples

# Create a view including all objects of mib2.

<aaa_0.Sysname> system-view

[aaa_0.Sysname] cluster

[aaa_0.Sysname-cluster] cluster-snmp-agent mib-view included mib2 1.3.6.1.2.1

cluster-snmp-agent usm-user v3

Syntax

cluster-snmp-agent usm-user v3 user-name group-name [ authentication-mode { md5 | sha } auth-password ] [ privacy-mode des56 priv-password ]

undo cluster-snmp-agent usm-user v3 user-name group-name

View

Cluster view

Default Level

1: Monitor level

Parameters

user-name: User name, a string of 1 to 32 characters.

group-name: Group name, a string of 1 to 32 characters.

authentication-mode: Specifies the security level to be authentication needed.

md5: Specifies the authentication protocol to be HMAC-MD5-96.

sha: Specifies the authentication protocol to be HMAC-SHA-96.

auth-password: Authentication password, a string of 1 to 16 characters if in plain text; it can only be a string of 24 characters if in cipher text.

privacy-mode: Specifies the security level to be encrypted.

des56: Specifies the encryption protocol to be DES (data encryption standard).

priv-password: Encryption password, a string of 1 to 16 characters in plain text; it can only be a string of 24 characters in cipher text.

Description

Use the cluster-snmp-agent usm-user v3 command to add a new user to the SNMP v3 group shared by a cluster.

Use the undo cluster-snmp-agent usm-user v3 command to delete the SNMP v3 group user shared by the cluster.

Note that:

l The command can be executed once on the management device only. This configuration will be synchronized to member devices on the whitelist, which is equal to configuring multiple member devices at one time.

l SNMPv3 group user will be retained if a cluster is dismissed or a member device is deleted from the whitelist.

l If the same username as the current one has been configured on a member device, the current username will replace the original one on the member device.

Examples

# Add a user wang to the SNMP group snmpgroup, set the security level to authentication-needed and specify the authentication protocol as HMAC-MD5-96 and authentication password as pass.

<aaa_0.Sysname> system-view

[aaa_0.Sysname] cluster

[aaa_0.Sysname-cluster] cluster-snmp-agent usm-user v3 wang snmpgroup authentication-mode md5 pass

delete-member

Syntax

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

View

Cluster view

Default Level

2: System level

Parameters

member-number: Number of a member device in a cluster, in the range 1 to 255.

to-black-list: Adds the device removed from a cluster to the blacklist to prevent it from being added to the cluster again.

Description

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

Note that:

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

l If you only remove a member device from the cluster without adding it to the blacklist, the device will be automatically added to the cluster again.

Examples

# Remove the member device numbered 2 from the cluster on the management device.

<Sysname> system-view

[Sysname] cluster

[Sysname-cluster] ip-pool 10.1.1.1 24

[Sysname-cluster] build aaa

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

display cluster

Syntax

display cluster

View

Any view

Default Level

1: Monitor level

Parameters

None

Description

Use the display cluster command to display the information of the cluster to which the current device belongs.

Note that this command can be executed on the management device and member devices only.

Examples

# Display the information of the cluster to which the current device belongs on the management device.

<aaa_0.Sysname> display cluster

Cluster name:"aaa"

Role:Administrator

Management-vlan:100

Handshake timer:10 sec

Handshake hold-time:60 sec

IP-Pool:1.1.1.1/16

cluster-mac:0180-c200-000a

No logging host configured

No SNMP host configured

No FTP server configured

No TFTP server configured

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

# Display the information of the cluster to which the current device belongs on a member device.

<aaa_1.Sysname> display cluster

Cluster name:"aaa"

Role:Member

Member number:1

Management-vlan:100

cluster-mac:0180-c200-000a

Handshake timer:10 sec

Handshake hold-time:60 sec

Administrator device IP address:1.1.1.1

Administrator device mac address:00e0-fc00-1d00

Administrator status:Up

Table 1-6 display cluster command output description

Field	Description
Cluster name	Name of the cluster
Role	Role of the switch in the cluster" l Administrator: The current device is a management device. l Member: The current device is a member device.
Member number	Member number of the switch in the cluster
Management-vlan	Management VLAN of the cluster
Handshake timer	Interval to send handshake packets
Handshake hold-time	Value of handshake timer
IP-Pool	Private IP addresses of the member devices in the cluster
cluster-mac	Multicast MAC address of cluster management packets
Administrator device IP address	IP address of the management device
Administrator device mac address	MAC address of the management device
Administrator status	State of the management device

display cluster base-topology

Syntax

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

View

Any view

Default Level

2: System level

Parameters

mac-address: Specifies a device by its MAC address. The system will display the standard topology with the device as the root.

member-number: Specifies a device by its number. The system will display the standard topology with the device as the root.

Description

Use the display cluster topology command to display the standard topology information of a cluster.

You can create a standard topology map when executing the build or auto-build command, or you can use the topology accept command to save the current topology map as the standard topology map.

Note that this command can be executed on the management device only.

Examples

# Display the standard topology of a cluster.

<aaa_0.Sysname> display cluster base-topology

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

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

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

[aaa_0.Sysname:00e0-fc00-1400]

├-(P_4/1)<-->(P_1/7)[Sysname:00e0-fc00-3333]

| |

| ├-(P_1/7)<-->(P_4/1)[aaa_3.Sysname:00e0-fc00-0000]

| | |

| | ├-(P_4/1)<-->(P_4/1)[aaa_0.Sysname:00e0-fc00-1400]

| | |

| | ├-(P_4/1)<-->(P_1/9)[Sysname:00e0-fc00-5500]

| | |

| | └-(P_4/1)<-->(P_1/11)[Sysname:00e0-fc00-7000]

| |

| ├-(P_1/7)<-->(P_1/9)[Sysname:00e0-fc00-5500]

| | |

| | ├-(P_1/9)<-->(P_4/1)[aaa_0.H3C:00e0-fc00-1400]

| | |

| | └-(P_1/9)<-->(P_1/11)[Sysname:00e0-fc00-7000]

| |

| └-(P_1/7)<-->(P_1/11)[Sysname:00e0-fc00-7000]

| |

| ├-(P_1/3)<-->(P_1/2)[aaa_2.Sysname:00e0-fd00-5500]

| |

| ├-(P_1/10)<-->(P_4/1)[Sysname:00e0-fc05-4300]

| |

| ├-(P_1/11)<-->(P_4/1)[aaa_0.Sysname:00e0-fc00-1400]

| |

| └-(P_1/8)<-->(P_1/12)[aaa_1.Sysname:00e0-fc00-7016]

├-(P_4/1)<-->(P_4/1)[aaa_3.Sysname:00e0-fc00-0000]

| |

| ├-(P_4/1)<-->(P_1/9)[Sysname:00e0-fc00-5500]

| |

| └-(P_4/1)<-->(P_1/11)[Sysname:00e0-fc00-7000]

├-(P_4/1)<-->(P_1/9)[Sysname:00e0-fc00-5500]

| |

| └-(P_1/9)<-->(P_1/11)[Sysname:00e0-fc00-7000]

└-(P_4/1)<-->(P_1/11)[Sysname:00e0-fc00-7000]

├-(P_1/3)<-->(P_1/2)[aaa_2.Sysname:00e0-fd00-5500]

├-(P_1/10)<-->(P_4/1)[Sysname:00e0-fc05-4300]

└-(P_1/8)<-->(P_1/12)[aaa_1.Sysname:00e0-fc00-7016]

Table 1-7 display cluster base-topology command output description

Field	Description
PeerPort	Peer port
ConnectFlag	Connection flag: <-->
NativePort	Local port
SysName	System name of the peer device
DeviceMac	MAC address of the peer device

display cluster black-list

Syntax

display cluster black-list

View

Any view

Default Level

2: System level

Parameters

None

Description

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

Note that this command can be executed on the management device only.

Examples

# View the current blacklist of the cluster.

<aaa_0.Sysname> display cluster black-list

Device ID Access Device ID Access port

00e0-fc00-0010 00e0-fc00-3550 GigabitEthernet1/0/1

Table 1-8 display cluster black-list command output description

Field	Description
Device ID	ID of the blacklist device, indicated by its MAC address.
Access Device ID	ID of the device connected to the blacklist device, indicated by its MAC address.
Access port	Port connected to the blacklist device.

display cluster candidates

Syntax

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

View

Any view

Default Level

1: Monitor level

Parameters

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

verbose: Displays the detailed information about a candidate device.

Description

Use the display cluster candidates command to display the information about the candidate devices of a cluster.

Note that the command can be executed on the management device only.

Examples

# Display the information about all the candidate devices.

<aaa_0.Sysname> display cluster candidates

MAC HOP IP Device

00e0-fc00-3199 3 S5810-50S

000f-cbb8-9528 1 31.31.31.56/24 S5810-50S

# Display the information about a specified candidate device.

<aaa_0.Sysname> display cluster candidates mac-address 00e0-fc61-c4c0

Hostname : LSW1

MAC : 00e0-fc61-c4c0

Hop : 1

Device : Sysname S5810-50S

IP : 1.5.6.9/16

# Display the detailed information about all the candidate devices.

<aaa_0.Sysname> display cluster candidates verbose

Hostname : 3100_4

MAC : 00e0-fc00-3199

Hop : 3

Device : S5810-50S

IP :

Hostname : Sysname

MAC : 000f-cbb8-9528

Hop : 1

Device : S5810-50S

IP : 31.31.31.56/24

Table 1-9 display cluster candidates command output description

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

display cluster current-topology

Syntax

display cluster current-topology [ mac-address mac-address [ to-mac-address mac-address ] | member-id member-number [ to-member-id member-number ] ]

View

Any view

Default Level

2: System level

Parameters

member-number: Number of the devices in a cluster (including the management device and member devices).

mac-address: MAC addresses of the devices in a cluster (including the management device and member devices).

Description

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

Note that:

l If you specify both the mac-address mac-address and to-mac-address mac-address arguments, the topology information of the devices that are in a cluster and form the connection between two specified devices is displayed.

l If you specify both the member-id member-number and to-member-id member-number arguments, the topology information of the devices that are in a cluster and form the connection between two specified devices is displayed.

l If you specify only the mac-address mac-address or member-id member-number argument, the topology information of all the devices in a cluster is displayed, with a specified device as the root node.

This command can be executed on the management device only.

Examples

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

<aaa_0.Sysname> display cluster current-topology

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

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

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

ConnectFlag:

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

???? lost device ++++ new device -||- STP discarding

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

[aaa_0.Sysname:00e0-fc00-7016]

└-(P_1/12)++++(P_1/8)[Sysname:00e0-fc00-7000]

|-(P_1/11)++++(P_1/9)[Sysname:00e0-fc00-5500]

| |

| |-(P_1/9)++++(P_4/1)[aaa_2.Sysname:00e0-fc00-0000]

| |

| └-(P_1/9)++++(P_1/7)[Sysname:00e0-fc00-3333]

|-(P_1/11)++++(P_4/1)[bbb_2.H3C:00e0-fc00-0000]

| |

| └-(P_4/1)++++(P_1/7)[Sysname:00e0-fc00-3333]

└-(P_1/11)++++(P_1/7)[Sysname:00e0-fc00-3333]

Table 1-10 display cluster current-topology command output description

Field	Description
PeerPort	Peer port
ConnectFlag	Connection flag
NativePort	Local port
SysName:DeviceMac	System name of the device
<--> normal connect	Indicates a normal connection between the device and the management device
---> odd connect	Indicates a unidirectional connection between the device and the management device
**** in blacklist	Indicates the device is in the blacklist
???? lost device	Indicates a lost connection between the device and the management device
++++ new device	Indicates this is a new device, whose identity is to be recognized by the administrator
-\|\|- STP discarding	STP is blocked

A new device in the topology information is identified based on the standard topology. After you add a device into a cluster, if you do not use the topology accept command to confirm the current topology and save it as the standard topology, this device is still regarded as a new device.

display cluster members

Syntax

display cluster members [ member-number | verbose ]

View

Any view

Default Level

1: Monitor level

Parameters

member-number: Number of the member device, in the range 0 to 255.

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

Description

Use the display cluster members command to display the information about cluster members.

Note that this command can be executed on the management device only.

Examples

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

<aaa_0.Sysname> display cluster members

SN Device MAC Address Status Name

0 S3100 00e0-fc00-1751 Admin aaa_0.Sysname

2 S3100 00e0-fc00-3199 Up aaa_2.S5810_4

3 Sysname S3528P 00e0-fd00-0043 Up aaa_3.S5810-50S

4 S3100 00e0-fc00-2579 Up aaa_4.5810_2

5 S3100 000f-e20f-c415 Up aaa_5.5810_5

Table 1-11 display cluster members command output description

Field	Description
SN	Member number
Device	Device type
MAC Address	MAC address of a device
Status	State of a device: l up: The member device which is up l down: The member which is down l deleting: The member which is being deleted l admin: The management device
Name	Name of a device

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

<aaa_0.Sysname> display cluster members verbose

Member number:0

Name:aaa_0.Sysname

Device:H3C S5810-50S

MAC Address:00e0-fc00-1400

Member status:Admin

Hops to administrator device:0

IP:

Version:

H3C Comware Platform Software

Comware Software, Version 5.20, Test 1102

H3C S5810-50S

Member number:1

Name:aaa_1.Sysname

Device:H3C S5810-50S

MAC Address:00e0-fc00-7016

Member status:Up

Hops to administrator device:2

IP: 192.168.100.245/24

Version:

H3C Comware Platform Software

Comware Software, Version 5.20, Test 1102

H3C S5810-50S

Member number:2

Name:aaa_2.Sysname

Device:H3C S5810-50S

MAC Address:00e0-fd00-5500

Member status:Up

Hops to administrator device:2

IP:

Version:

H3C Comware Platform Software

Comware Software, Version 5.20, Test 1102

H3C S5810-50S

Table 1-12 display cluster members verbose command output description

Field	Description
Member number	Device member number
Name	Name of a member device, composed of the cluster name and the host name of the member device, in the format of cluster name.hostname When the management device type is not consistent with the member device type, if a user modifies the cluster name on the management device continuously, the cluster name may appear twice in the cluster member name, for example, “clustername.clustername.hostname”. This abnormal case can restore in a period of time.
Device	Device type
MAC Address	MAC address of a device
Member status	State of a device
Hops to administrator device	Hops from the current device to the management device
IP	IP address of a device
Version	Software version of the current device

ftp-server

Syntax

ftp-server ip-address [ user-name username password { simple | cipher } password ]

undo ftp-server

View

Cluster view

Default Level

3: Manage level

Parameters

ip-address: IP address of the FTP server.

username: Username used to log onto the FTP server, a string of 1 to 32 characters.

simple: Indicates that the password is in plain text.

cipher: Indicates that the password is in cipher text.

password: Password used to log onto the FTP server. This password must be in plain text when the simple keyword is specified, and can be in either plain text or cipher text when the cipher keyword is specified. A plain text password must be a string of no more than 16 characters, such as “aabbcc”. The cipher text password must have a fixed length of 24 characters, such as _(TT8F]Y\5SQ=^Q`MAF4<1!!.

Description

Use the ftp-server command to configure a public FTP server (by setting its IP address, username, and password) on the management device for the member devices in the cluster.

Use the undo ftp-server command to remove the FTP server configured for the member devices in the cluster.

By default, a cluster is not configured with a public FTP server.

Note that the command can be executed on the management device only.

Examples

# Set the IP address, username and password of an FTP server shared by the cluster on the management device to be 1.0.0.9, ftp, and in plain text respectively.

<Sysname> system-view

[Sysname] cluster

[Sysname-cluster] ip-pool 10.1.1.1 24

[Sysname-cluster] build aaa

[aaa_0.Sysname-cluster] ftp-server 1.0.0.9 user-name ftp password simple ftp

holdtime

Syntax

holdtime hold-time

undo holdtime

View

Cluster view

Default Level

2: System level

Parameters

hold-time: Holdtime in seconds, in the range 1 to 255.

Description

Use the holdtime command to configure the holdtime of a device.

Use the undo holdtime command to restore the default.

By default, the holdtime of a device is 60 seconds.

Note that:

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

l The configuration is valid on all member devices in a cluster.

Examples

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

<Sysname> system-view

[Sysname] cluster

[Sysname-cluster] ip-pool 10.1.1.1 24

[Sysname-cluster] build aaa

[aaa_0.Sysname-cluster] holdtime 30

ip-pool

Syntax

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

undo ip-pool

View

Cluster view

Default Level

2: System level

Parameters

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

{ mask | mask-length }: Mask of the IP address pool of a cluster. It is an integer or in dotted decimal notation. When it is an integer, it ranges from 1 to 30. A network address can be obtained by ANDing this mask with the private IP address of the administrator device. The private IP addresses of all member devices in a cluster belong to this network segment.

Description

Use the ip-pool command to configure a private IP address range for cluster members.

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

By default, no private IP address range is configured for cluster members.

Note that:

l You must configure the IP address range on the management device only and before establishing a cluster. If a cluster has already been established, you are not allowed to change the IP address range.

l For a cluster to work normally, the IP addresses of the VLAN interfaces of the management device and member devices must not be in the same network segment as that of the cluster address pool.

Examples

# Configure the IP address range of a cluster.

<Sysname> system-view

[Sysname] cluster

[Sysname-cluster] ip-pool 10.200.0.1 20

logging-host

Syntax

logging-host ip-address

undo logging-host

View

Cluster view

Default Level

2: System level

Parameters

ip-address: IP address of the logging host.

Description

Use the logging-host command to configure a logging host shared by a cluster.

Use the undo logging-host command to remove the logging host configuration.

By default, no logging host is configured for a cluster.

Note that:

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

l You have to execute the info-center loghost command in system view first for the logging host you configured to take effect.

For related configuration, refer to the info-center loghost command in Information Center Commands in the System Volume.

Examples

# Configure the IP address of the logging host shared by a cluster on the management device as 10.10.10.9.

<Sysname> system-view

[Sysname] cluster

[Sysname-cluster] ip-pool 10.1.1.1 24

[Sysname-cluster] build aaa

[aaa_0.Sysname-cluster] logging-host 10.10.10.9

management-vlan

Syntax

management-vlan vlan-id

undo management-vlan

View

System view

Default Level

2: System level

Parameters

vlan-id: ID of the management VLAN, in the range 1 to 4094.

Description

Use the management-vlan command to specify the management VLAN.

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

By default, VLAN 1 is the management VLAN.

Note that:

l The management VLAN must be specified before a cluster is created. Once a member device is added to a cluster, the management VLAN configuration cannot be modified. To modify the management VLAN for a device belonging to a cluster, you need to cancel the cluster-related configurations on the device, specify the desired VLAN to be the management VLAN, and then re-create the cluster.

l For the purpose of security, you are not recommended to configure the management VLAN as the default VLAN ID of the port connecting the management device and the member devices.

l Only when the default VLAN ID of all cascade ports and the port connecting the management device and the member device is the management VLAN, can the packets in the management VLAN packets be passed without a tag. Otherwise, you must configure the packets from a management VLAN to pass these ports. For the configuration procedure, refer to VLAN Configuration in the Access Volume.

Examples

# Specify VLAN 2 as the management VLAN.

<Sysname> system-view

[Sysname] management-vlan 2

management-vlan synchronization enable

Syntax

management-vlan synchronization enable

undo management-vlan synchronization enable

View

Cluster view

Default Level

1: Monitor level

Parameters

None

Description

Use the management-vlan synchronization enable command to enable the management VLAN auto-negotiation function.

Use the undo management-vlan synchronization enable command to disable the management VLAN auto-negotiation function.

By default, the management VLAN auto-negotiation function is disabled.

Examples

# Enable the management VLAN auto-negotiation function on the management device.

<aaa_0.Sysname> system-view

[aaa_0.Sysname] cluster

[aaa_0.Sysname-cluster] management-vlan synchronization enable

nm-interface vlan-interface

Syntax

nm-interface vlan-interface interface-name

View

Cluster view

Default Level

2: System level

Parameters

interface-name: ID of the VLAN interface. The value range is the same as that of the existing VLAN interface ID.

Description

Use the nm-interface vlan-interface command to configure the VLAN interface of the access management device (including FTP/TFTP server, management host and log host) as the network management interface of the management device.

Examples

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

<aaa_0.Sysname> system-view

[aaa_0.Sysname] cluster

[aaa_0.Sysname-cluster] nm-interface vlan-interface 2

reboot member

Syntax

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

View

Cluster view

Default Level

2: System level

Parameters

member-number: Number of the member device, in the range 1 to 255.

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

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

Description

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

Note that this command can be executed only on the management device.

Examples

# Reboot the member device numbered 2 on the management device.

<Sysname> system-view

[Sysname] cluster

[Sysname-cluster] ip-pool 10.1.1.1 24

[Sysname-cluster] build aaa

[aaa_0.Sysname-cluster] reboot member 2

snmp-host

Syntax

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

undo snmp-host

View

Cluster view

Default Level

3: Manage level

Parameters

ip-address: IP address of an SNMP host.

string1: Community name of read-only access, a string of 1 to 26 characters.

string2: Community name of read-write access, a string of 1 to 26 characters.

Description

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

Use the undo snmp-host command to cancel the SNMP host configuration.

By default, no SNMP host is configured for a cluster.

Note that this command can be executed on the management device only.

Examples

# Configure a shared SNMP host for the cluster on the management device.

<Sysname> system-view

[Sysname] cluster

[Sysname-cluster] ip-pool 10.1.1.1 24

[Sysname-cluster] build aaa

[aaa_0.Sysname-cluster] snmp-host 1.0.0.9 community-string read 123 write 456

tftp-server

Syntax

tftp-server ip-address

undo tftp-server

View

Cluster view

Default Level

2: System level

Parameters

ip-address: IP address of a TFTP server.

Description

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

Use the undo tftp-server command to cancel the TFTP server of the cluster.

By default, no TFTP server is configured.

Note that this command can be executed on the management device only.

Examples

# Configure a shared TFTP server on the management device as 1.0.0.9.

<Sysname> system-view

[Sysname] cluster

[Sysname-cluster] ip-pool 10.1.1.1 24

[Sysname-cluster] build aaa

[aaa_0.Sysname-cluster] tftp-server 1.0.0.9

timer

Syntax

timer interval

undo timer

View

Cluster view

Default Level

2: System level

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 to send handshake packets.

Use the undo timer command to restore the default.

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

Note that:

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

l This configuration is valid for all member devices in a cluster.

Examples

# Configure the interval to send handshake packets as 3 seconds on the management device.

<Sysname> system-view

[Sysname] cluster

[Sysname-cluster] ip-pool 10.1.1.1 24

[Sysname-cluster] build aaa

[aaa_0.Sysname-cluster] timer 3

topology accept

Syntax

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

undo topology accept { all | mac-address mac-address | member-id member-number }

View

Cluster view

Default Level

2: System level

Parameters

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

mac-address mac-address: Specifies a device by its MAC address. The device will be accepted to join the standard topology of the cluster.

member-id member-number: Specifies a device by its member number. The device will be accepted to join the standard topology of the cluster. The member-number argument is in the range 0 to 255.

save-to: Confirms the current topology as the standard topology, and backs up the standard topology on the FTP server or local flash in a file named “topology.top”.

Description

Use the topology accept command to confirm the current topology information and save it as the standard topology.

Use the undo topology accept to delete the standard topology information.

Note that:

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

l The file used to save standard topology on the FTP server or the local flash is named “topology.top”, which includes both the information of blacklist and whitelist. A blacklist contains the devices that are prohibited to be added to a cluster. A whitelist contains devices that can be added to a cluster.

Examples

# Take the current topology as the standard topology on the management device.

<Sysname> system-view

[Sysname] cluster

[Sysname-cluster] ip-pool 10.1.1.1 24

[Sysname-cluster] build aaa

[aaa_0.Sysname-cluster] topology accept all

topology restore-from

Syntax

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

View

Cluster view

Default Level

2: System level

Parameters

ftp-server: Restores the standard topology information from the FTP server.

local-flash: Restores the standard topology information from the local flash.

Description

Use the topology restore-from command to restore the standard topology information in case the cluster topology information is incorrect.

Note that:

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

l If the stored standard topology is not correct, the device cannot be aware of if. Therefore, you must ensure that the standard topology is correct.

Examples

# Restore the standard topology on the management device.

<Sysname> system-view

[Sysname] cluster

[Sysname-cluster] ip-pool 10.1.1.1 24

[Sysname-cluster] build aaa

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

topology save-to

Syntax

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

View

Cluster view

Default Level

2: System level

Parameters

ftp-server: Saves the standard topology information to the FTP server.

local-flash: Saves the standard topology information to the local flash.

Description

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

Note that:

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

Examples

# Save the standard topology information to the local flash on the management device.

<Sysname> system-view

[Sysname] cluster

[Sysname-cluster] ip-pool 10.1.1.1 24

[Sysname-cluster] build aaa

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

TOP

H3C reserves the right to modify its collaterals without any prior notice. For the latest information of the collaterals, please consult H3C sales or call 400 hotline.

07-System Volume

Table of Content

14-Cluster Management Commands

NDP Configuration Commands

ndp enable

display ntdp single-device

cluster enable

cluster-snmp-agent community