Syntax
display stacking [ members ]
View
Any view
Parameter
members: Displays
the information about the members of a stack. Do not specify this keyword when
you execute this command on a slave switch.
Description
Use the display stacking command to
display the information about the main switch or the slave switches of a stack.
When you execute this command on a main
switch, the information displayed depends on the members keyword as
follows:
l
If the members keyword is not specified,
the output information indicates that the local switch is the main switch.
Besides, the number of the switches contained in the stack is also displayed.
l
If the members keyword is specified, the
information about the members of the stack is displayed, including the stack
numbers of the main/slave switches, stack name, stack device name, MAC address
and status.
When you execute this command on a slave
switch, the information displayed indicates that the local switch is a slave
switch. Besides, the information such as the stack number of the local switch,
and the MAC address of the main switch in the stack is also displayed.
Example
# Display the information about a stack on
the main switch.
<stack_0.Sysname>display
stacking
Main device for stack.
Total members:3
Management-vlan:1(default vlan)
# Display the information about the stack
members on the main switch.
<stack_0.Sysname>
display stacking members
Member number: 0
Name:stack_0.Sysname
Device: S3100
MAC Address:000f-e20f-3124
Member status:Admin
IP: 129.10.1.15
/16
Member number: 1
Name:stack_1.Sysname
Device: S3100
MAC Address: 000f-e20f-3130
Member status:Up
IP: 129.10.1.16/16
Member number: 2
Name:stack_2.Sysname
Device: S3100
MAC Address: 000f-e20f-3135
Member status:Up
IP: 129.10.1.17/16
Table 1-1
Description on the fields of the display
stacking command
|
Field
|
Description
|
|
Member number
|
Numbers of the switches in the stack
The main switch is numbered 0.
|
|
Name
|
Switch name
|
|
Device
|
Device type
|
|
MAC Address
|
Mac address of a switch in the stack
|
|
Member status
|
Status of a switch in the stack
“Admin” indicates the switch
is the main switch; “UP” indicates the switch is on.
|
|
IP: 129.10.1.15/16
|
IP address of a switch in the stack
|
Syntax
stack-port
enable
undo
stack-port enable
View
Ethernet
port view
Parameters
None
Description
Use the stack-port enable command to
allow the stack port to send/forward stack join-in requests to/from its
connected switch.
Use the undo stack-port enable
command to prohibit the stack port from sending/forwarding stack join-in
requests to/from its connected switch.
By default, the stack-port function on a
stack port is enabled, indicating that a switch can send/forward the stack
join-in requests through the port.
Examples
# Enable the stack-port function on a stack
port.
<stack_1.Sysname> system-view
System View: return to User View with
Ctrl+Z.
[stack_1.Sysname] interface GigabitEthernet
1/1/2
[stack_1.Sysname-GigabitEthernet1/1/2]
stack-port enable
Syntax
stacking number
View
User view
Parameter
number:
Number of the slave switch to switch.
Description
Use the stacking command to switch
to a slave switch to configure it.
You can use
this command to switch from user view of the main switch to user view of a
slave switch. To switch from a slave switch back to the main switch, execute
the quit command in user view.
Example
# Switch from the main switch Sysname to the
slave switch numbered 1 and then switch back to the main switch.
<stack_0.Sysname> stacking 1
<stack_1.Sysname>
<stack_1.Sysname> quit
<stack_0.Sysname>
Syntax
stacking enable
undo stacking enable
View
System view
Parameter
None
Description
Use the stacking enable command to
create a stack.
Use the undo stacking enable command
to remove a stack.
The stacking enable command triggers
a main switch to add the switches connected to its stack ports to the stack.
The undo stacking enable command can
only be executed on a main switch.
A slave switch quits the stack automatically
when it is disconnected from the stack.
Remove the IP address configured for the existing Layer 3 interface
first if you want to cancel the stack-related configuration, otherwise, IP
address conflicts may occur.
Example
# Create a stack.
<Sysname> system-view
System View: return to User View with
Ctrl+Z.
[Sysname] stacking enable
[stack_0.Sysname] quit
<stack_0.Sysname>
Syntax
stacking ip-pool from-ip-address ip-address-number [
ip-mask ]
undo stacking ip-pool
View
System view
Parameter
from-ip-address: Start address of the stack IP address pool.
ip-address-number: Number of the IP addresses in the stack IP address pool. A stack
IP address pool contains 16 addresses by default.
ip-mask:
Mask of the stack IP address.
Description
Use the stacking ip-pool command to create
a stack IP address pool.
Use the undo stacking ip-pool
command to restore the default stack IP address pool.
You need to create an IP address pool for a
stack before creating the stack. When adding a switch to a stack, the main
switch picks an IP address from the IP address pool and assigns the IP address
to it.
The stacking ip-pool command can
only be executed on switches that do not belong to any stack. That is, the IP
address pool of an existing stack cannot be modified.
To add a switch to a stack successfully,
make sure the value of the ip-address-number argument is larger than the
number of switches currently contained in the stack.
Make sure the IP addresses in the IP
address pool of a stack are successive so that they can be assigned
successively. For example, the IP addresses in an IP address pool with its
start IP address something like 223.255.255.254 are not successive. In this
case, errors may occur when adding a switch to the stack.
IP addresses in the IP address pool of a
stack must be of the same network segment. For example, the 1.1.255.254 is not
a qualified start address for a stack IP address pool.
Note the following when performing stack-related
configurations on the main switch of a stack:
l
After a stack is created, the main switch
automatically adds the switches connected to its stack ports to the stack.
l
A slave switch quits the stack automatically
when it is disconnected from the stack.
l
If the IP address of the management VLAN
interface of the main switch (or a slave switch) is not of the same network
segment as that of the stack address pool, the main switch (or the slave
switch) automatically removes the existing IP address and picks a new one from
the stack address pool as its IP address.
l
Since both stack and cluster use the management
VLAN and only one VLAN interface is available on the S3100 switch, stack and
cluster must share the same management VLAN if you want to configure stack
within a cluster.
Example
# Configure the IP address pool for the
stack.
<Sysname> system-view
System View: return to User View with
Ctrl+Z.
[Sysname] stacking ip-pool 129.10.1.1
5
Syntax
display ndp
[ interface interface-list ]
View
Any view
Parameters
interface
interface-list: Specifies a port list. You need to
provide the interface-list argument in the form of { interface-type
interface-number [ to interface-type interface-number ] } &<1-10>,
where to is used to specify a port range, and &<1-10> means
that you can provide up to ten port indexes/port index ranges for this
argument. The interface-number argument is in the format of unit ID/slot
number/port number.
Description
Use the display ndp command to
display all NDP configuration and operating information, including the global
NDP status, the interval to send NDP packets, the holdtime of NDP information,
and the NDP status and neighbor information on all ports.
If executed with the interface
keyword, the display ndp command will display the NDP status of the
specified interfaces and the related information of the peer device. If
executed without the interface keyword, the command will display the
global NDP configuration information and the statistics on NDP packets received
on and sent by each port.
Examples
# Display all NDP configuration and
operating information.
<aaa_0.Sysname>
display ndp
Neighbor Discovery Protocol is
enabled.
Neighbor Discovery Protocol Ver: 1,
Hello Timer: 60(s), Aging Timer: 180(s)
Interface: Ethernet1/0/1
Status: Enabled, Pkts Snd: 15835,
Pkts Rvd: 2879, Pkts Err: 0
Interface:
Ethernet1/0/2
Status:
Enabled, Pkts Snd: 0, Pkts Rvd: 0, Pkts Err: 0
Interface: Ethernet1/0/3
Status: Enabled, Pkts Snd: 0, Pkts
Rvd: 0, Pkts Err: 0
……(Omitted)
# Display NDP information about Ethernet 1/0/1.
<aaa_0.Sysname>
display ndp interface Ethernet 1/0/1
Interface: Ethernet1/0/1
Status: Enabled, Pkts Snd: 15835,
Pkts Rvd: 2879, Pkts Err: 0
Neighbor 1: Aging Time: 147(s)
MAC Address : 000f-e20f-1234
Host Name : 1234_2.Sysname
Port
Name : Ethernet1/0/1
Software Ver: V100R002B01D001
Device Name : H3C S3100
Port
Duplex : AUTO
Product Ver : 3100
BootROM
Ver : 506
Table 2-1
Description on the fields of the two commands
|
Field
|
Description
|
|
Neighbor Discovery Protocol is enabled
|
NDP is enabled globally on the switch.
|
|
Neighbor Discovery Protocol Ver: 1
|
NDP version 1 is running.
|
|
Hello Timer
|
Interval for the switch to send NDP
packets, which is configured through the ndp timer hello command
|
|
Aging Timer
|
Holdtime for neighbors to keep the NDP
information of the switch, which is configured through the ndp timer aging
command
|
|
Interface
|
Port index, used to identify a port
|
|
Status
|
NDP state on the port (enabled/disabled)
|
|
Pkts Snd:
|
Number of NDP packets sent by the port
|
|
Pkts Rvd:
|
Number of NDP packets received by the
port
|
|
Pkts Err:
|
Number of error NDP packets received by
the port
|
|
Neighbor 1: Aging Time
|
Holdtime for this switch to keep the NDP
information of the neighbor connected to the port
|
|
MAC Address
|
MAC address of the neighbor device
|
|
Host Name
|
Host name of the neighbor device
|
|
Port name
|
Port name of the neighbor device
|
|
Software Ver
|
Software version of the neighbor device
|
|
Device Name
|
Device name of the neighbor device
|
|
Port Duplex
|
Port (full/half) duplex mode of the
neighbor device
|
|
Product Ver
|
Product version of the neighbor device
|
|
BootROM Ver
|
Bootrom version of the neighbor device
|
Syntax
ndp enable [
interface interface-list ]
undo ndp enable [ interface interface-list ]
View
System view, Ethernet port view
Parameters
interface-list: Ethernet port list, in the format of { interface-type interface-number
[ to interface-type interface-number ] } &<1-10>, where
to is used to specify a port range, and &<1-10> means that you
can provide up to ten port indexes/port index ranges for this argument. The interface-number
argument is in the format of unit ID/slot number/port number.
Description
Use the ndp enable command to enable
NDP globally or on a port.
Use the undo ndp enable command to
disable NDP globally or on a port.
If you execute the ndp enable
command in system view without the interface keyword specified, NDP will
be enabled globally; if you specify the interface keyword in the
command, NDP will be enabled on the specified ports. In Ethernet port view, the
interface keyword is unavailable, and execution of the command will
enable NDP on the current port only.
By default, NDP is enabled both globally
and on ports.
Note that NDP can take effect on a port only
when NDP is enabled both globally and on the port.
Examples
# Enable NDP globally, and then enable NDP
on port Ethernet 1/0/1.
<Sysname> system-view
System View: return to User View with
Ctrl+Z.
[Sysname] ndp enable
[Sysname] interface Ethernet 1/0/1
[Sysname-Ethernet1/0/1] ndp enable
Syntax
ndp timer aging aging-in-seconds
undo ndp timer aging
View
System view
Parameters
aging-in-seconds: Holdtime of the NDP information, ranging from 5 to 255 seconds.
Description
Use the ndp timer aging command to
set the holdtime of the NDP information. This command specifies how long an adjacent
device should hold the NDP neighbor information received from the local switch
before discarding the information.
Use the undo timer aging command to
restore the default holdtime of NDP information.
By default, the holdtime of NDP information
is 180 seconds.
You can specify how long the adjacent
devices should hold the NDP information received from the local switch. When an
adjacent device receives an NDP packet from the local switch, it learns how
long it should keep the NDP information of the switch according to the holdtime
carried in the NDP packet, and discards the NDP information when the holdtime
expires.
Note that NDP information holdtime should
be longer than the interval between sending NDP packets. Otherwise, a neighbor
entry will be generated and age out frequently, resulting in instability of the
NDP port neighbor table.
Examples
# Set the holdtime of the NDP information
sent by the switch to 60 seconds.
<Sysname> system-view
System View: return to User View with
Ctrl+Z.
[Sysname] ndp timer aging 60
Syntax
ndp timer hello timer-in-seconds
undo ndp timer hello
View
System view
Parameters
timer-in-seconds: Interval between sending NDP packets, ranging from 5 to 254
seconds.
Description
Use the ndp timer hello command to
set the interval between sending NDP packets.
Use the undo ndp timer hello command
to restore the default interval.
By default, this interval is 60 seconds.
A switch should update the NDP information
of its neighbors regularly, so that the switch can get the updated information
of the neighbors in time. You can use the ndp timer hello command to specify
the interval at which the switch sends hello packets to its neighbors for NDP information
update.
Note that NDP information holdtime should
be longer than the interval between sending NDP packets. Otherwise, a neighbor
entry will be generated and age out frequently, resulting in instability of the
NDP port neighbor table.
Examples
# Set the interval between sending NDP
packets to 80 seconds.
<Sysname> system-view
System View: return to User View with
Ctrl+Z.
[Sysname] ndp timer hello 80
Syntax
reset ndp statistics [ interface interface-list ]
View
User view
Parameters
interface-list: Ethernet port list, in the format of { interface-type interface-number
[ to interface-type interface-number ] } &<1-10>, where
to is used to specify a port range, and &<1-10> means that you
can provide up to ten port indexes/port index ranges for this argument. The
interface-number argument is in the format of unit ID/slot number/port number.
Description
Use the reset ndp statistics command
to clear the NDP statistics on specific ports. When executing the command, if
you specify the interface keyword, the command will clear NDP statistics
on the specified ports; if you do not specify the interface keyword, the
command will clear NDP statistics on all ports.
You can use the display ndp command
to view the NDP statistics before and after the execution of the reset ndp
statistics command to verify the execution result.
Examples
# Display the NDP statistics on port
Ethernet 1/0/6.
<Sysname> display ndp interface
ethernet 1/0/6
Interface: Ethernet1/0/6
Status: Enabled, Pkts Snd: 1,
Pkts Rvd: 2, Pkts Err: 0
# Clear the NDP statistics on port Ethernet
1/0/6.
<Sysname> reset ndp statistics
interface ethernet 1/0/6
# Re-display the NDP statistics on port
Ethernet 1/0/6.
<Sysname> display ndp interface
ethernet 1/0/6
Interface: Ethernet1/0/6
Status: Enabled, Pkts Snd: 0,
Pkts Rvd: 0, Pkts Err: 0
Syntax
display ntdp
View
Any view
Parameters
None
Description
Use the display ntdp command to
display the global NTDP information.
The displayed information includes topology
collection range (hop count), topology collection interval (NTDP timer),
device/port forwarding delay of topology collection requests, and time used by
the last topology collection.
Examples
# Display the global NTDP information.
<Sysname>
display ntdp
NTDP is running.
Hops : 4
Timer : 0 min(disable)
Hop Delay : 100 ms
Port Delay: 10 ms
Last collection total time: 92ms
Table 2-2 Description on the fields of
the display ntdp command
|
Field
|
Description
|
|
NTDP is running.
|
NTDP is enabled globally on this device.
|
|
Hops
|
Hop count for topology collection, which
is configured through the ntdp hop command
|
|
Timer
|
Interval to collect topology information,
which is configured through the ntdp timer command
"disable" means this switch is
not a management device and does not perform periodic topology collection.
|
|
Hop Delay
|
Delay for other devices to forward
topology collection requests, which is configured through the ntdp timer
hop-delay command
|
|
Port Delay
|
Delay for ports on other devices to forward
topology collection requests, which is configured through the ntdp timer
port-delay command
|
|
Last collection total time
|
Time used by the last topology collection
|
Syntax
display ntdp device-list [ verbose ]
View
Any view
Parameters
verbose:
Displays the detailed information of devices in a cluster.
Description
Use the display ntdp device-list
command to display the cluster device information collected by NTDP.
Examples
# Display the list of devices collected by NTDP.
<Sysname> display ntdp device-list
MAC HOP
IP PLATFORM
000f-e20f-3901 0
100.100.1.1/24 S3100
000f-e20f-3190 1
16.1.1.1/24 S3100
Table 2-3
Description on the fields of the display ntdp
device-list command
|
Field
|
Description
|
|
MAC
|
MAC address of a device collected by NTDP
|
|
HOP
|
Hops from this device to the collected
device
|
|
IP
|
IP address and mask length of the
management VLAN interface on the collected device
|
|
PLATFORM
|
Platform information about the collected
device
|
# Display detailed device information collected by NTDP.
[1234_0.Sysname]display ntdp device-list verbose
Hostname : 1234_0.Sysname
MAC : 00e0-fc11-1111
Hop : 0
Platform : S3100
IP :
192.168.0.234/24
Version :
H3C Comware Platform Software
Comware Software, Version 3.10
Copyright(c) 2004-2007 Hangzhou H3C
Technologies Co.,Ltd.All rights reserved.
S3100 3100-0002
Cluster : Administrator switch of
cluster 1234
Stack : Candidate switch
Peer MAC Peer Port
ID Native Port ID Speed Duplex
00e0-fc12-3450
Ethernet1/0/14 Ethernet1/0/4 100 FULL
--------------------------------------------------------------------------
Hostname : 1234_5.Sysname
MAC : 00e0-fc3d-9da8
Hop : 2
Platform : H3C S3026
IP :
Version :
H3C Comware Platform Software
Comware Software, Version 3.10
Copyright(c) 2004-2007 Hangzhou H3C
Technologies Co.,Ltd.All rights reserved.
S3100 3100-0002
Cluster : Member switch of
cluster 1234 , Administrator MAC: 00e0-fc11-1111
Stack : Candidate switch
Peer MAC Peer Port
ID Native Port ID Speed Duplex
000f-e200-0144
Ethernet0/3 Ethernet0/24 100 FULL
00e0-fc00-3100
Ethernet1/0/23 Ethernet0/16 100 FULL
00e0-fc12-3450
Ethernet1/0/4 Ethernet0/8 100 FULL
-----------------------------------------------------------------------------
Hostname : 1234_4.Sysname
MAC : 00e0-fc00-3100
Hop : 3
Platform : S3100
IP : 192.168.0.241/24
Version :
H3C Comware Platform Software
Comware Software, Version 3.10
Copyright(c) 2004-2007 Hangzhou H3C
Technologies Co.,Ltd.All rights reserved.
S3100 3100-0002
Cluster : Member switch of cluster
1234 , Administrator MAC: 00e0-fc11-1111
Stack : Candidate switch
Peer MAC Peer Port
ID Native Port ID Speed Duplex
00e0-fc3d-9da8
Ethernet0/16 Ethernet1/0/23 100 FULL
00e0-fc00-2006
Ethernet1/0/2 Ethernet1/0/7 100 FULL
000f-e247-4ca3
Ethernet1/0/14 Ethernet1/0/1 100 FULL
Table 2-4
Description on the fields of display ntdp
device-list verbose
|
Field
|
Description
|
|
Hostname
|
System
name of a device collected by NTDP
|
|
MAC
|
MAC
address of the collected device
|
|
Hop
|
Hops from
this device to the collected device
|
|
Platform
|
Software
platform of the collected device
|
|
IP
|
IP address
and mask length of the cluster management VLAN interface on the collected
device
|
|
Version
|
Software
version of the collected device
|
|
Cluster
|
The role
of the collected device for the cluster
|
|
Peer MAC
|
MAC
address of a neighbor device connected to the collected device
|
|
Peer Port ID
|
Index of the port on the neighbor device
connected to the collected device
|
|
Native Port ID
|
Index of the port on the collected device
connected to the neighbor device
|
|
Speed
|
Speed of the neighbor device port
|
|
Duplex
|
Duplex mode of the neighbor device port
|
Syntax
ntdp enable
undo ntdp enable
View
System view, Ethernet port view
Parameters
None
Description
Use the ntdp enable command to
enable NTDP globally or on a port.
Use the undo ntdp enable command to
disable NTDP globally or on a port.
By default, NTDP is enabled both globally
and on ports.
Note that NTDP can take effect on a port only
when NTDP is enabled both globally and on the port.
Examples
# Enable NTDP globally, and then enable
NTDP on port Ethernet 1/0/1.
<Sysname>
system-view
System View: return to User View with
Ctrl+Z.
[Sysname] ntdp enable
[Sysname] interface Ethernet 1/0/1
[Sysname-Ethernet1/0/1] ntdp enable
Syntax
ntdp explore
View
User view
Parameters
None
Description
Use the ntdp explore command to
manually start a topology collection process.
NTDP is able to periodically collect
topology information. In addition, you can use this command to manually start a
topology collection process at any moment. If you do this, NTDP collects NDP
information from all devices in a specific network range (which can be set
through the ntdp hop command) as well as the connection information of
all its neighbors. Through this information, the management device or the
network management software knows the topology in the network range, and thus
it can manage and monitor the devices in the range.
Examples
# Start a topology collection process.
<Sysname> ntdp explore
Syntax
ntdp hop hop-value
undo ntdp hop
View
System view
Parameters
hop-value:
Maximum hops to collect topology information, namely, the topology collection
range, in the range of 1 to 16.
Description
Use the ntdp hop command to set the
topology collection range.
Use the undo ntdp hop command
to restore the default topology collection range.
By default, the topology collection range
is three hops.
With the ntdp hop command, you can
specify to collect topology information from the devices within a specified
range to avoid infinite collection. That is, you can limit the range of topology collection by setting
the maximum hops from the collecting device to the collected devices. For example,
if you set the maximum hops to two, the switch initiating the topology
collection collects topology information from the switches within two hops.
Note that:
l
The topology collection range set by this
command is applicable to both the periodic and manual topology collection.
l
This command is only applicable to
topology-collecting device, and a wider collection range requires more memory
of the topology-collecting device.
Examples
# Set the topology collection range to 5
hops.
<aaa_0.Sysname> system-view
System View: return to User View with
Ctrl+Z.
[aaa_0.Sysname] ntdp hop 5
Syntax
ntdp timer interval-in-minutes
undo ntdp timer
View
System view
Parameters
interval-in-minutes: Interval (in minutes) to collect topology information, ranging
from 0 to 65,535. A value of 0 disables topology information collection.
Description
Use the ntdp timer command to
configure the interval to collect topology information periodically.
Use the undo ntdp timer command to
restore the default interval.
By default, this interval is one minute.
After the interval is set to a non-zero
value, the switch will collect topology information periodically at this
interval. You can also use the ndp explore command to start a topology