H3C S5500-EI Series Switches Command Manual-Release 2102(V1.01)

HomeSupportSwitchesH3C S5500 Switch SeriesReference GuidesCommand ReferencesH3C S5500-EI Series Switches Command Manual-Release 2102(V1.01)
23-Cluster Management Commands
Title Size Download
23-Cluster Management Commands 244 KB

Chapter 1  Cluster Management Configuration Commands

1.1  NDP Configuration Commands

1.1.1  display ndp

Syntax

display ndp [ interface interface-list ]

View

Any view

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 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   : Ethernet1/0/4

       Software Ver: V100R001B01D013

       Device Name : S3126C

       Port Duplex : AUTO

       Product Ver : 005

       BootROM Ver : 137

 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   : Ethernet1/0/11

       Software Ver: V100R001B01D013

       Device Name : S3126T

       Port Duplex : AUTO

       Product Ver : 005

 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

 Interface: GigabitEthernet1/0/25

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

 Interface: GigabitEthernet1/0/26

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

 Interface: GigabitEthernet1/0/27

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

 Interface: GigabitEthernet1/0/28

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

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

Field

Description

Neighbor Discovery Protocol is enabled

NDP is enabled 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

 

1.1.2  ndp enable

Syntax

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

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 interface-list argument. And if you specify the interface interface-list argument, the command enables NDP for the specified Ethernet port(s).

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

l           The NDP cannot operate normally unless it is enabled on a specified port and globally.

l           If the port connecting the management device to a member or candidate device is the port of a member in an aggregation group, you must enable NTDP on all ports of the members in the aggregation group; otherwise, NTDP cannot operate normally.

Examples

# Enable NDP globally.

<Sysname> system-view

[Sysname] ndp enable

# Enable NDP for port GigabitEthernet1/0/1

<Sysname> system-view

[Sysname] interface GigabitEthernet1/0/1

[Sysname-GigabitEthernet1/0/1 ndp enable

1.1.3  ndp timer aging

Syntax

ndp timer aging aging-time

undo ndp timer aging

View

System view

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. After the aging timer expires, the receiving device removes the corresponding entry.

Use the undo timer aging command to restore the default.

By default, the time that a receiving device should keep the NDP packets it received from the local device 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.

Examples

# Configure the time that a receiving device should keep the NDP packets it received from the local device as 60 seconds.

<Sysname> system-view

[Sysname] ndp timer aging 60

1.1.4  ndp timer hello

Syntax

ndp timer hello hello-time

undo ndp timer hello

View

System view

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.

Examples

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

<Sysname> system-view

[Sysname] ndp timer hello 80

1.1.5  reset ndp statistics

Syntax

reset ndp statistics [ interface interface-list ]

View

User view

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 reset ndp statistics command to clear NDP statistics.

If no interface interface-list is specified, NDP statistics of all ports are cleared; otherwise, NDP statistics of a specified port are cleared.

Examples

# Clear NDP statistics of all ports.

<Sysname> reset ndp statistics

1.2  NTDP Configuration Commands

1.2.1  display ntdp

Syntax

display ntdp

View

Any view

Parameters

None

Description

Use the display ntdp command to display NTDP configuration information.

Examples

# Display the global NTDP information.

<Sysname> display ntdp

 NTDP is running.

 Hops      : 4

 Timer     : 1 min(disable)

 Hop Delay : 100 ms

 Port Delay: 10 ms

 Last collection total time: 92ms

Table 1-2 Description on the fields of the display ntdp command

Field

Description

NTDP is running

NTDP is enabled globally on the local device.

Hops

Hop count for topology collection

Timer

Interval to collect topology information (after the cluster is created)

disable

Indicates the device is not a management device 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

 

1.2.2  display ntdp device-list

Syntax

display ntdp device-list [ verbose ]

View

Any view

Parameters

verbose: Displays the detailed device information.

Description

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

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

Examples

# Display the device list collected through NTDP.

<Sysname> display ntdp device-list

MAC             HOP  IP                  Device

00e0-fc00-3133  2                        H3C S5500-28C-EI

000f-e20f-c415  2    31.31.31.5/24       H3C S5500-52C-EI

00e0-fc00-2579  1                        H3C S5500-52C-PWR-EI

00e0-fc00-1751  0    31.31.31.1/24       H3C S5500-28F-EI

00e0-fc00-3199  3                        H3C S5500-28F-EI

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

Field

Description

MAC

MAC address of a device

HOP

Hops to the collecting device

IP

IP address and mask length of the management VLAN interface on the device

Device

Device name

 

# Display the detailed device information collected through NTDP.

<aabbcc_1.Sysname> display ntdp device-list verbose

Hostname   : H3C

 MAC       : 00e0-fc00-3510

 Hop       : 1

 Device    : H3C S5500-28F-EI

 IP        :

 Version   :

H3C Versatile Routing Platform Software

Comware Software, Version 5.20

Copyright (c) 2004-2007 By H3C TECH CO., LTD.

H3C S5500-28F-EI V200R001B01D015SP01        

Cluster   :  Member switch of cluster aabbcc , Administrator MAC: 00e0-fc00-600

0

 Peer MAC         Peer Port ID             Native Port ID            Speed Duplex

 00e0-fc00-6000 GigabitEthernet1/0/9   GigabitEthernet1/0/14  100   FULL

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

 Hostname  : H3C

 MAC       : 00e0-fc00-6000

 Hop       : 0

 Device    : H3C S5500-52C-PWR-EI

 IP        :

 Version   :

H3C Versatile Routing Platform Software

Comware Software, Version 5.20

Copyright (c) 2004-2007 By H3C TECH CO., LTD.

H3C S5500-52C-PWR-EI V200R001B01D015SP01        

 Cluster   :  Administrator switch of cluster aabbcc

 Peer MAC        Peer Port ID              Native Port ID            Speed  Duplex

 00e0-fc00-3510 GigabitEthernet1/0/14 GigabitEthernet1/0/9    100   FULL

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

Field

Description

Hostname

System name of the device

MAC

MAC address of the device

Hop

Hops 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

Cluster   :  Member switch of cluster aabbcc

The device is a member device of the cluster aabbcc.

Administrator MAC

MAC address of the management device

Administrator switch of cluster aabbcc

The device is the management device of the cluster aabbcc.

Peer MAC

MAC address of a neighbor device

Peer Port ID

Name of the peer port connected to the local port

Native Port ID

Name of the local port to which a neighbor device is connected

Speed

Speed of the local port to which a neighbor device is connected

Duplex

Duplex mode of the local port to which a neighbor device is connected

 

1.2.3  display ntdp single-device mac-address

Syntax

display ntdp single-device mac-address mac-address

View

Any view

Parameters

mac-address: MAC address of the device, 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.

 

&  Note:

Support for this command varies with devices.

 

Examples

# Display the detailed NTDP information of the device with a MAC address of 000f-e200-2200.

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

Hostname  : H3C

 MAC       : 000f-e200-2200

 Hop       : 0

 Device    : H3C S5500-28F-EI

 IP        : 192.168.0.136/24

 Version   :

H3C Versatile Routing Platform Software

Comware Software, Version 5.20

Copyright (c) 2004-2007 By H3C TECH CO., LTD.

 H3C S5500-28F-EI V200R001B01D015SP01

 Cluster   :  Administrator switch of cluster king

 Peer MAC        Peer Port ID              Native Port ID            Speed Duplex

 00e0-fc00-2420 GigabitEthernet1/0/1   Ethernet1/0/2            100   FULL 

Refer to Table 1-4 for the description of the above prompt information.

1.2.4  ntdp enable

Syntax

ntdp enable

undo ntdp enable

View

System view, Ethernet interface view

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 Ethernet interface view enables NTDP of the current port.

l           The NTDP cannot operate normally unless it is enabled on a specified port and globally.

l           The ntdp enable command is contradictory to the bpdu-tunnel dot1q enable command in BPDU tunnel. You cannot configure both commands. For more information about BPDU Tunnel, refer to BPDU Tunnel Configuration in the Access Volume.

l           If the port connecting the management device to a member or candidate device is the port of a member in an aggregation group, you must enable NTDP on all ports on the members in the aggregation group; otherwise, NTDP cannot operate normally.

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

1.2.5  ntdp explore

Syntax

ntdp explore

View

User view

Parameters

None

Description

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

Usually, the management device collects topology information periodically. You can also use this command to start topology information collection on the management device or an NTDP-enabled device. NTDP collects the NDP information of each device in a specific network range as well as the connection information of all its neighbors. Based on the collected information, the management device can know the network topology structure, so as to manage and monitor the member devices.

Examples

# Start the topology information collection.

<Sysname> ntdp explore

1.2.6  ntdp hop

Syntax

ntdp hop hop-value

undo ntdp hop

View

System view

Parameters

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

Description

Use the ntdp hop command to set a range (in terms of hop count) for topology information collection.

Use the undo ntdp hop command to restore the default.

By default, the value is 3.

Note that:

l           You can specify to collect the topology information of the devices within a specified range to avoid infinitive collection. The limit is performed by controlling the permitted hops from collection origination. For example, if you set the hop number limit to 2, only the switches less than 2 hops away from the switch starting the topology collection are collected.

l           This command is only applicable to the topology-collecting device. A broader collection scope requires more memory of the topology-collecting device.

Examples

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

<Sysname> system-view

[Sysname] ntdp hop 5

1.2.7  ntdp timer

Syntax

ntdp timer interval-time

undo ntdp timer

View

System view

Parameters

interval-time: 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:

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

l           If you set a new interval, the topology information will be collected at this new interval.

Examples

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

<Sysname> system-view

[Sysname] ntdp timer 30

1.2.8  ntdp timer hop-delay

Syntax

ntdp timer hop-delay time

undo ntdp timer hop-delay

View

System view

Parameters

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 a device receiving topology-collection requests to forward them through its first port.

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

To avoid network congestion caused by large amount of topology response packets received in short periods, a device waits for some time before it forwards a received topology-collection request through its first port.

Note that:

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

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

1.2.9  ntdp timer port-delay

Syntax

ntdp timer port-delay time

undo ntdp timer port-delay

View

System view

Parameters

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.

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

Note that:

These two commands are intended for devices that collect topology information. They actually set the port-delay value for topology-collection requests sent by these switches. The port-delay value determines the delay time for a device receiving topology-collection requests to forward them through the next port.

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

1.3  Cluster Configuration Commands

1.3.1  add-member

Syntax

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

View

Cluster view

Parameters

member-number: Member number assigned to the candidate device to be added to a cluster. This argument varies with devices.

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           You must add a cluster member through 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.

 

  Caution:

If the routing table of a candidate device is full when the candidate device is added to a cluster, the candidate device will be added to and removed from the cluster repeatedly.

 

Examples

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

<aabbcc_0.Sysname> system-view

[aabbcc_0.Sysname] cluster

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

1.3.2  administrator-address

Syntax

administrator-address mac-address name cluster-name

undo administrator-address

View

Cluster view

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.

<aabbcc_1.Sysname> system-view

[aabbcc_1.Sysname] cluster

[aabbcc_1.Sysname-cluster] undo administrator-address

1.3.3  auto-build

Syntax

auto-build [ recover ]

View

Cluster view

Parameters

recover: Automatically reestablishes communication with all the member devices.

Description

Use the auto-build command to establish a cluster automatically. When executing this command, you will be asked if you want to create a standard topology map.

Note that:

l           This command can be executed on a candidate device or 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.

 

  Caution:

l      If the routing table of the management device is full when a cluster is created, meaning entries with the destination address as a candidate device cannot be added to the routing table, all candidate devices will be added to and removed from the cluster repeatedly.

l      If the routing table of a candidate device is full when a candidate device is added to the cluster, meaning entries with the destination address as the management device cannot be added to the routing table, the candidate device will be added to and removed from the cluster repeatedly.

 

Examples

# Establish a cluster automatically.

<Sysname> system-view

[Sysname] cluster

[Sysname-cluster] auto-build

1.3.4  black-list add-mac

Syntax

black-list add-mac mac-address

View

Cluster view

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.

<aabbcc_0.Sysname> system-view

[aabbcc_0.Sysname] cluster

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

1.3.5  black-list delete-mac

Syntax

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

View

Cluster view

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.

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

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

1.3.6  build

Syntax

build name

undo build

View

Cluster view

Parameters

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. When executing this command, you will be asked whether you want to create a standard topology map or not.

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

By default, the device is not a management device.

Note that:

l           This command can only be applied to devices that are capable 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] ip-pool 172.16.0.1 255.255.255.248

[Sysname-cluster] build aabbcc

1.3.7  cluster

Syntax

cluster

View

System view

Parameters

None

Description

Use the cluster command to enter cluster view.

Examples

# Enter cluster view

<Sysname> system-view

[Sysname] cluster

[Sysname-cluster]

1.3.8  cluster enable

Syntax

cluster enable

undo cluster enable

View

System view

Parameters

None

Description

Use the cluster enable command to enable the cluster function.

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

By default, the cluster function is enabled.

Note that:

l           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

1.3.9  cluster switch-to

Syntax

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

View

User view

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.

Description

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

Note that Telnet connection is used on the switch between the management device and member devices. Note the following when switching between them:

l           Before the switch, use the telnet server enable command to enable Telnet; otherwise, the switch fails.

l           Authentication is required when you switch a member device to the management device. The switch fails if authentication is not passed. Your user level is allocated according to the level predefined by the management device if authentication is passed.

l           When a candidate device is added to a cluster, its super password will be automatically synchronized to the management device. Therefore, after a cluster is established, you are not recommended to modify the super password of any members (including the management device and member devices) of the cluster; otherwise, the switch may fail because of authentication failure.

l           If member n does not exist when you execute this command on the management device, the system prompts error; if the switch succeeds, the user level of member n on the management device is retained.

l           If the Telnet users on the device to be logged in reach the maximum number, the switch fails.

l           To prevent resource waste, avoid recycling switch when configuring access between the management device and the member devices. For example, if you switch from the operation interface of the management device to that of a member device and then need to switch back to that of the management device, use the quit command to end the switch, but not the cluster switch-to administrator command to switch to the operation interface of the management device.

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>

1.3.10  delete-member

Syntax

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

View

Cluster view

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.

Description

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

Note that you should perform the operation to remove a member device from a cluster on the management device only.

Examples

# Remove the member device numbered 2 from the cluster.

<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

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

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

1.3.11  display cluster

Syntax

display cluster

View

Any view

Parameters

None

Description

Use the display cluster command to display the state and statistics 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 cluster information 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 cluster information 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-5 Description on the fields of the display cluster command

Field

Description

Cluster name

Name of the cluster

Role

Role of the switch in the cluster, Administrator means the current device is a management device and Member means the current device is a member device.

Member number

Member number of the switch in the cluster

Management-vlan

Management VLAN of the cluster

Handshake timer

Value of handshake timer

Handshake hold-time

Interval to send handshake packets

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

 

1.3.12  display cluster base-topology

Syntax

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

View

Any view

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 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-fc50-5500]

    |

    |--(P_1/0/6)<-->(P_1/0/6)[00e0-fc00-5700]

    |

    |--(P_1/0/8)<-->(P_1/0/8)[00e0-fc00-5150]

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

Field

Description

PeerPort

Peer port

ConnectFlag

Connection flag: <-->

NativePort

Local port

SysName

System name of the peer device

DeviceMac

MAC address of the peer device

 

1.3.13  display cluster black-list

Syntax

display cluster black-list

View

Any view

Parameters

None

Description

Use the display cluster black-list command to display the 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-7 Description on the fields of the display cluster black-list command

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.

 

1.3.14  display cluster candidates

Syntax

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

View

Any view

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

 000f-cbb8-9528  1    31.31.31.56/24      S5500-EI

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

Field

Description

MAC

MAC address of a candidate device

HOP

Hops from a candidate device to the management device

IP

IP address of a candidate device

Device

Platform information of a device

 

# 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 S5500-EI

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

 IP        :

 Hostname  : Sysname

 MAC       : 000f-cbb8-9528

 Hop       : 1

 Device  : S3100

 IP        : 31.31.31.56/24

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

Field

Description

Hostname

Name of a candidate device

MAC

MAC address of a candidate device

Hop

Hops from a candidate device to the management device

IP

IP address of a candidate device

Device

Platform information of a candidate device

 

1.3.15  display cluster current-topology

Syntax

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

View

Any view

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.

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.

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

<king_0.H3C>display cluster current-topology

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

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

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

ConnectFlag:

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

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

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

[king_0.H3C:00fc-1111-bcef]

    |

    ├-(P_1/0/38)<-->(P_1/0/30)[king_2.H3C:0011-2233-5577]

    |   |

    |   ├-(P_1/0/30)<-->(P_1/0/2)[H3C:000f-e200-2200]

    |   |   |

    |   |   ├-(P_1/0/2)<-->(P_1/0/38)[king_0.H3C:00fc-1111-bcef]

    |   |   |

    |   |   ├-(P_1/0/2)<-->(P_1/0/26)[king_1.H3C:000f-e200-7510]

    |   |   |

    |   |   ├-(P_1/0/2)<-->(P_1/0/32)[H3C:000f-e255-0010]

    |   |   |

    |   |   └-(P_1/0/2)<-->(P_1/0/5)[king_3.H3C:000f-e200-2420]

    |   |

    |   ├-(P_1/0/30)<-->(P_1/0/26)[king_1.H3C:000f-e200-7510]

    |   |   |

    |   |   ├-(P_1/0/26)<-->(P_1/0/38)[king_0.H3C:00fc-1111-bcef]

    |   |   |

    |   |   ├-(P_1/0/26)<-->(P_1/0/32)[H3C:000f-e255-0010]

    |   |   |

    |   |   └-(P_1/0/26)<-->(P_1/0/5)[king_3.H3C:000f-e200-2420]

    |   |

    |   ├-(P_1/0/30)<-->(P_1/0/32)[H3C:000f-e255-0010]

    |   |   |

    |   |   ├-(P_1/0/32)<-->(P_1/0/38)[king_0.H3C:00fc-1111-bcef]

    |   |   |

    |   |   └-(P_1/0/32)<-->(P_1/0/5)[king_3.H3C:000f-e200-2420]

    |   |

    |   └-(P_1/0/30)<-->(P_1/0/5)[king_3.H3C:000f-e200-2420]

    |       |

    |       └-(P_1/0/5)<-->(P_1/0/38)[king_0.H3C:00fc-1111-bcef]

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

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,RRPP discarding

STP RRPP are blocked

 

&  Note:

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

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

 

1.3.16  display cluster members

Syntax

display cluster members [ member-number | verbose ]

View

Any view

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    S5500-28C-EI        000f-e200-1751  Admin  aaa_0.5500-EI_1

 2    S5500-28C-EI        000f-e200-3199  Up     aaa_2.5500-EI_4

 4    S5500-28C-EI        000f-e200-2579  Up     aaa_4.5500-EI_2

 5    S5500-28C-EI        000f-e20f-c415  Up     aaa_5.5500-EI_5

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

Field

Description

SN

Member number

Device

Device type

MAC Address

MAC address of a device

Status

State of a device:

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

 Device:Sysname S5500-28C-EI

 MAC Address:000f-e200-2200

 Member status:Admin

 Hops to administrator device:0

 IP: 192.168.0.136/24

 Version:

H3C Versatile Routing Platform Software

Comware Software, Version 5.20

Copyright (c) 2004-2007 By H3C TECH CO., LTD.

H3C S5500-28C-EI V200R001B01D015SP01 

 

Member number:1

 Name:aaa_1.H3C

 Device:H3C S5510-24P

 MAC Address:000f-e200-2420

 Member status:Up

 Hops to administrator device:1

 IP: 192.168.0.156/24

 Version:

H3C Versatile Routing Platform Software

Comware Software, Version 5.20

Copyright (c) 2004-2007 By H3C TECH CO., LTD.

H3C S5510-24P V500R003B03D008

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

Field

Description

Member number

Device member number

Name

Name of a member device, composed of the cluster name and the host name of the member device, in the format of cluster name.hostname

When the management device type is not consistent with the member device type, if a user modifies the cluster name on the management device continuously, the cluster name may appear twice in the cluster member name, for example, “clustername.clustername.hostname”. This abnormal case can restore in a period of time.

Device

Device type

MAC Address

MAC address of a device

Member status

State of a device

Hops to administrator device

Hops from the current device to the management device

IP

IP address of a device

Version

Software version of the current device

 

1.3.17  ftp-server

Syntax

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

undo ftp-server

View

Cluster view

Parameters

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

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

1.3.18  holdtime

Syntax

holdtime seconds

undo holdtime

View

Cluster view

Parameters

seconds: Holdtime in seconds, in the range 1 to 255.

Description

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

Use the undo holdtime command to restore the default.

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

Note that:

l           If the management does not receive any information of a member device during the holdtime, it sets the state of the member device to “Disconnect”. When the communication between the two resumes, the corresponding member device is re-added to the cluster (automatically). If the management device receives the information of a member device during the holdtime, the member device stays in the normal state and needs not to be added again.

l           This command can be executed on the management device only. The configuration is valid on all member devices in a cluster.

Examples

# Set the holdtime to 30 seconds.

<Sysname> system-view

[Sysname] cluster

[Sysname-cluster] ip-pool 10.1.1.1 24

[Sysname-cluster] build aaa

[aaa_0.Sysname-cluster] holdtime 30

1.3.19  ip-pool

Syntax

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

undo ip-pool

View

Cluster view

Parameters

administrator-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 administrator-ip-address. 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 on the device to be configured as the management device.

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

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

1.3.20  logging-host

Syntax

logging-host ip-address

undo logging-host

View

Cluster view

Parameters

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

Description

Use the logging-host command to configure a logging host for the member devices in a cluster.

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

By default, no logging host is configured.

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 more information about the info-center loghost command, refer to Information Center Commands in the System Volume.

Examples

# Configure the IP address of the logging host 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] logging-host 10.10.10.9

1.3.21  management-vlan

Syntax

management-vlan vlan-id

undo management-vlan

View

System view

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

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

By default, VLAN 1 is the management VLAN.

Note the following when configuring the management VLAN:

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

1.3.22  nm-interface vlan-interface

Syntax

nm-interface vlan-interface vlan-interface-id

View

Cluster view

Parameters

vlan-interface-id: 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

1.3.23  reboot member

Syntax

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

View

Cluster view

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 on the management device.

Note that:

l           Communication between the management and member devices may be interrupted due to some configuration errors. You can control the member devices remotely on the management device in this case. For example, you can reboot a member device that operates improperly and specify to delete the booting configuration file when the member device reboots, and thus achieve normal communication between the management and member devices.

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

Examples

# Reboot the member device numbered 2.

<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

1.3.24  snmp-host

Syntax

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

undo snmp-host

View

Cluster view

Parameters

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

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 an SNMP host for the member devices inside a cluster.

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

By default, no SNMP host is configured.

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

Examples

# Configure an 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

1.3.25  tftp-server

Syntax

tftp-server ip-address

undo tftp-server

View

Cluster view

Parameters

ip-address: IP address of a TFTP server to be configured for a cluster.

Description

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

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

By default, no TFTP server is configured.

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

Examples

# Configure a TFTP server 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] tftp-server 1.0.0.9

1.3.26  timer

Syntax

timer interval-time

undo timer

View

Cluster view

Parameters

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

Description

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

Use the undo timer command to restore the default.

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

Note that this command can be executed on the management device only and is valid for all member devices in a cluster.

Examples

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

<Sysname> system-view

[Sysname] cluster

[Sysname-cluster] ip-pool 10.1.1.1 24

[Sysname-cluster] build aaa

[aaa_0.Sysname-cluster] timer 3

1.3.27  topology accept

Syntax

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

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

View

Cluster view

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.

<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

1.3.28  topology restore-from

Syntax

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

View

Cluster view

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 from the FTP server or the local flash in case the cluster topology information is incorrect.

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

Examples

# Restore the standard topology.

<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

1.3.29  topology save-to

Syntax

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

View

Cluster view

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

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

Examples

# Save the standard topology information to the local flash.

<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

 

  • Cloud & AI
  • InterConnect
  • Intelligent Computing
  • Security
  • SMB Products
  • Intelligent Terminal Products
  • Product Support Services
  • Technical Service Solutions
All Services
  • Resource Center
  • Policy
  • Online Help
All Support
  • Become a Partner
  • Partner Resources
  • Partner Business Management
All Partners
  • Profile
  • News & Events
  • Online Exhibition Center
  • Contact Us
All About Us
新华三官网