Chapter 1 Basic
System Configuration and Debugging Commands
l
The configuration of real-time monitoring of the
running status of the system is added. For the detailed configuration, refer to
section 3.1.24 system-monitor enable.
l
The configuration of loading hot patch is added.
For the detailed configuration, refer to sections 3.1.9 display patch-information, 3.1.16 patch activate, 3.1.17 patch delete,
3.1.18 patch load,
and 3.1.19 patch run.
l
The configuration of identifying and diagnosing
pluggable transceivers is added. For the detailed configuration, refer to
sections 3.1.12 display transceiver alarm interface, 3.1.13 display transceiver diagnosis interface, 3.1.14 display transceiver interface, and 3.1.15 display transceiver manuinfo interface.
l
The language-mode command is deleted.
Syntax
clock datetime HH:MM:SS { YYYY/MM/DD | MM/DD/YYYY }
View
User view
Parameters
HH:MM:SS:
Current time, where HH ranges from 0 to 23, MM and SS
range from 0 to 59.
YYYY/MM/DD
or MM/DD/YYYY: Current date, where YYYY represents year ranging
from 2000 to 2099, MM represents month ranging from 1 to 12, and DD
represents day ranging from 1 to 31.
Description
Use the clock datetime command to set
the current date and time of the Ethernet switch.
By default, it is 23:55:00 04/01/2000 when
the system starts up.
In an implementation where exact absolute
time is required, it is necessary to use this command to set the current date
and time of the Ethernet switch.
Related commands: display clock.
Examples
# Set the current date and time of the
Ethernet switch to 0:0:0 2001/01/01.
<Sysname> clock
datetime 0:0:0 2001/01/01
<Sysname> display
clock
00:00:04 UTC Mon 01/01/2001
Time Zone : add 00:00:00
Syntax
clock summer-time zone-name { one-off | repeating } start-time
start-date end-time end-date offset-time
undo clock summer-time
View
User view
Parameters
zone-name:
Name of the summer time, a string of 1 to 32 characters.
one-off: Sets
the summer time for only one year (the specified year).
repeating: Sets
the summer time for every year starting from the specified year.
start-time:
Start time of the summer time, in the form of HH:MM:SS.
start-date:
Start date of the summer time, in the form of YYYY/MM/DD or MM/DD/YYYY.
end-time:
End time of the summer time, in the form of HH:MM:SS.
end-date:
end date of the summer time, in the form of YYYY/MM/DD or MM/DD/YYYY.
offset-time:
Offset of the summer time relative to the standard time, in the form of
HH:MM:SS.
Description
Use the clock summer-time command to
set the name, time range and time offset of the summer time.
After the setting, you can use the display
clock command to check the results.
Examples
# Set the summer time named abc1, which
starts from 06:00:00 2005/08/01, ends until 06:00:00 2005/09/01, and is one hour
ahead of the standard time.
<Sysname> clock
summer-time abc1 one-off 06:00:00 08/01/2005 06:00:00 09/01/2005 01:00:00
<Sysname> display
clock
00:02:36 UTC Mon
01/01/2001
Time Zone : add 00:00:00
Summer-Time : abc1 one-off
06:00:00 08/01/2005 06:00:00 09/01/2005 01:00:00
# Set the summer time named abc2, which starts
from 06:00:00 08/01, ends until 06:00:00 09/01, and is one hour ahead of the
standard time every year from 2005 on.
<Sysname> clock
summer-time abc2 repeating 06:00:00 08/01/2005 06:00:00 09/01/2005 01:00:00
<Sysname> display
clock
00:01:25 UTC Mon 01/01/2001
Time Zone : add 00:00:00
Summer-Time : abc2 repeating
06:00:00 08/01/2005 06:00:00 09/01/2005 01:00:00
Syntax
clock timezone zone-name { add | minus } HH:MM:SS
undo clock timezone
View
User view
Parameters
zone-name:
Name of the time zone, in length of 1 to 32 characters.
add: Specifies
to add a time value based on the universal time coordinated (UTC) time to
generate a later time.
minus: Specifies
to subtract a time value based on the UTC time to generate an earlier time.
HH:MM:SS:
Time to be added or subtracted from the UTC time, in the form of HH:MM:SS.
Description
Use the clock timezone command to
set the local time zone.
Use the undo clock timezone command
to restore the local time zone to the default UTC time zone.
After the setting, you can use the display
clock command to check the setting. The log information time and the debugging
information time adopts the local time after the time zone and the summer time
have been adjusted.
Related commands: clock summer-time,
display clock.
Examples
# Set the local time zone named z5, which
is five hours earlier than the UTC time.
<Sysname> clock
timezone z5 add 05:00:00
<Sysname> display
clock
05:03:17 z5 Mon 01/01/2001
Time Zone : z5 add 05:00:00
Summer-Time : abc1 one-off
06:00:00 08/01/2005 06:00:00 09/01/2005 01:00:00
1.1.4 quit
Syntax
quit
View
Any view
Parameters
None
Description
Use the quit command to return from
current view to a lower level view.
The following lists the three levels of
views available on a switch (from lower level to higher level):
l
User view
l
System view
l
VLAN view, Ethernet port view, and so on
If the current view is user view, this
command is used to quit the system.
Related commands: return, system-view.
Examples
# Return from system view to user view.
<Sysname> system-view
System View: return to User
View with Ctrl+Z.
[Sysname] quit
<Sysname>
# Return to system view from Ethernet port
view.
<Sysname> system-view
System View: return to User View with
Ctrl+Z.
[Sysname] interface gigabitethernet 1/0/1
[Sysname-GigabitEthernet1/0/1] quit
[Sysname]
Syntax
return
View
Views other than user view
Parameters
None
Description
Use the return command to return
from current view to user view. The composite key <Ctrl+Z> has the same
effect with the return command.
Related commands: quit.
Examples
# Return from interface view to user view.
<Sysname> system-view
System View: return to User
View with Ctrl+Z.
[Sysname] interface GigabitEthernet
1/0/1
[Sysname-GigabitEthernet1/0/1]
return
<Sysname>
Syntax
sysname sysname
undo sysname
View
System view
Parameters
sysname: System
name of the Ethernet switch. It is a string of 1 to 30 characters. By default,
it is H3C.
Description
Use the sysname command to set the
system name of an Ethernet switch. Use the undo sysname command
to restore the default system name of the Ethernet switch.
Changing the system name will affect the
CLI prompt. For example, if the system name of the switch is H3C, the prompt for
user view is <H3C>.
Examples
# Set the system name of the Ethernet
switch to LANSwitch.
<Sysname> system-view
System View: return to User
View with Ctrl+Z.
[Sysname] sysname LANSwitch
[LANSwitch]
Syntax
system-view
View
User view
Parameters
None
Description
Use the system-view command to enter
system view from user view.
Related commands: quit, return.
Examples
# Enter system view from user view.
<Sysname> system-view
System View: return to User
View with Ctrl+Z.
[Sysname]
Syntax
display clock
View
Any view
Parameters
None
Description
Use the display clock command to
display the current date, time, timezone and summertime of the system, so that
you can adjust them if they are wrong.
The maximum date and time that can be
displayed by this command is 23:59:59 9999/12/31.
Related commands: clock datetime,
clock timezone, clock summer-time.
Examples
# Display the current date and time of the
system.
<Sysname> display clock
18:36:31 beijing Sat 2002/02/02
Time Zone : beijing add
01:00:00
Summer-Time : bj one-off
01:00:00 2003/01/01 01:00:00 2003/08/08 01:00:00
Table 1-1 Field
description of the display clock command
|
Field
|
Description
|
|
18:36:31 beijing Sat 2002/02/02
|
Current date and time of the system
|
|
Time Zone
|
Configured time zone information
|
|
Summer-Time
|
Configured summer time information
|
Syntax
display debugging [ unit unit-id ] [
interface interface-type interface-number ] [ module-name ]
display debugging fabric [
by-module | interface interface-type interface-number [ module-name
] | module-name ]
View
Any view
Parameters
fabric: Specifies
to display the enabled debugging of the switches in the Fabric.
unit-id:
Unit ID of a switch.
interface-type:
Interface type.
interface-number: Interface number.
module-name:
Functional module name.
by-module: Specifies to display fabric debugging by module.
Description
Use the display debugging command to
display enabled debugging on a specified device.
Examples
# Display enabled debugging on unit 1.
<Sysname>
display debugging unit 1
IP icmp debugging is on
Rip packet debugging switch
is on
Rip receive debugging switch
is on
Rip send debugging switch is
on
Syntax
display version
View
Any view
Parameters
None
Description
Use the display version command to
display the version information about the switch system.
Specifically, you can use this command to
check the software version and release time, the basic hardware configuration,
and some other information about the switch.
Examples
# Display the version information of the
system.
<Sysname>
display version
H3C Comware Platform
Software
Comware Software, Version
3.10, Test 1545
Copyright (c) 2004-2007
Hangzhou H3C Technologies Co., Ltd. All rights reserved.
S5600-50C uptime is 0 week, 0
day, 22 hours, 12 minutes
S5600-50C with 1 Processor
128M bytes SDRAM
16384K bytes Flash Memory
Config Register points to
FLASH
Hardware Version is REV.B
CPLD Version is 001
Bootrom Version is 506
[Subslot 0] 48GE+4SFP
Hardware Version is REV.B
[Subslot 2] 2 STACK Hardware
Version is REV.B
Syntax
debugging module-name
[ debugging-option ]
undo debugging { all | module-name [ debugging-option
] }
View
User view
Parameters
module-name:
Module name.
debugging-option:
Debugging option.
all: Specifies
to disable all debugging.
Description
Use the debugging command to enable
system debugging.
Use the undo debugging command to
disable system debugging.
By default, all debugging is disabled for
the system.
Note that:
l
Enabled debugging will generate a great deal of
debugging information and thus will affect the efficiency of the system.
Therefore, it is recommended not to enable debugging for multiple functions at
the same time. To disable all debugging at a time, you can use the undo
debugging all command.
l
The specific debugging information can be
displayed on a terminal only after you have configured the debugging, terminal
debugging, and terminal monitor commands.
l
To display the enabled debugging types, use the display
debugging command.
For information about the terminal
monitor command, refer to Information Center Command.
Examples
# Enable packet debugging of the IP module.
<Sysname> debugging ip
packet
<Sysname> display
debugging
IP packet debugging is on
Syntax
display diagnostic-information
View
Any view
Parameters
None
Description
Use the display diagnostic-information
command to display system diagnostic information, or save system diagnostic
information to a file with the extension .diag in the Flash memory.
Examples
# Save system
diagnostic information to the file default.diag.
<Sysname> display
diagnostic-information
This operation may take a
few minutes, continue?[Y/N]y
Diagnostic-information is
saved to Flash or displayed(Y=save N=display)?[Y/N]y
Please input the file
name(*.diag)[flash:/default.diag]:
The file is already
existing, overwrite it? [Y/N]y
% Output information to file:
flash:/default.diag.
Please wait......
# Display the diagnostic information of the
system.
<Sysname> display
diagnostic-information
This operation may take a
few minutes, continue?[Y/N]y
Diagnostic-information is
saved to Flash or displayed(Y=save N=display)?[Y/N]n
-------------------- display
version --------------------
……
<Omitted>
Syntax
terminal debugging
undo terminal debugging
View
User view
Parameters
None
Description
Use the terminal debugging command
to enable terminal display for debugging information.
Use the undo terminal debugging
command to disable terminal display for debugging information.
By default, terminal display for debugging
information is disabled.
Note that:
l
To display the debugging information on the
terminal, you need to configure both the terminal debugging and terminal
monitor commands.
l
If you execute the undo terminal monitor command,
you will disable the monitoring of the log, trap, and debugging information on
the current terminal. Thereby, no log, trap, or debugging information will be
displayed on the terminal.
l
The configuration of the terminal debugging
command takes effect for the current connection only. If the terminal
re-establishes a connection, the terminal display for debugging information is
disabled.
Related commands: debugging.
Examples
# Enable terminal display for debugging
information.
<Sysname> terminal
debugging
% Current terminal debugging
is on
Syntax
ping [ -a
ip-address ] [ -c count ] [ -d ] [ -f ] [ -h
ttl ] [ -i interface-type interface-number ] [ ip ]
[ -n ] [ - p pattern ] [ -q ] [ -s packetsize
] [ -t timeout ] [ -tos tos ] [ -v ] host
View
Any view
Parameters
-a ip-address:
Specifies the source IP address to send ICMP ECHO-REQUEST packet. This IP
address must be a local interface IP address.
-c count: Specifies how many times the ICMP ECHO-REQUEST packet will be
sent. The count argument is the times, which ranges from 1 to
4,294,967,295 and defaults to 5.
-d: Specifies
the socket to be in DEBUGGING mode. By default, the socket is in non-DEBUGGING
mode.
-f:
Specifies to discard a packet directly instead of fragmenting it if its length
is greater than the maximum transmission unit (MTU) of the interface.
-h ttl:
Specifies the Time To Live (TTL) value of the ICMP ECHO-REQUEST packets in the
range 1 to 255. By default, the TTL value is 255.
-i interface-type
interface-number: Specifies the ICMP echo request sending interface by its type
and number. With the interface specified, the TTL of packets are set to 1
automatically to test the directly-connected device (the IP address of the
device is in the same network segment with that of the interface).
ip: Specifies
the device to support IPv4. By default, the device supports IPv4.
-n:
Specifies to directly regard the host argument as an IP address without
performing domain name resolution. By default, the host argument is
first regarded as an IP address; if it is not an IP address, domain name
resolution is performed.
-p pattern: Specifies the padding byte pattern of the ICMP ECHO-REQUEST
packets. The pattern argument is a byte in hexadecimal. For example, -p
ff fills a packet with all ffs. By default, the system fills a packet with
0x01, 0x02, and so on, until 0x09; then it repeats this procedure from 0x01
again.
-q: Specifies
to display only the statistics without the details. By default, all the
information including the details and statistics will be displayed.
-s packetsize: Specifies the size (in bytes) of each ICMP ECHO-REQUEST packet (excluding
the IP and ICMP headers). The packetsize argument ranges from 20 to 32,000
and defaults to 56 bytes.
-t timeout: Specifies the timeout time (in milliseconds) before an ICMP ECHO-REPLY
packet is received after an ICMP ECHO-REQUEST packet is sent. The timeout
argument ranges from 0 to 65535 ms and defaults to 2,000 ms.
-tos tos:
Specifies the ToS value of the ICMP ECHO-REQUEST packets in the range 0 to 255.
By default, this value is 0.
-v: Specifies
to display other ICMP packets received (that is, non-ECHO-REPLY packets). By
default, other ICMP packets like non-ECHO-REPLY packets are not displayed.
host: Domain
name or IP address of the destination host.
The ping
command also supports the ipv6 keyword. For details, refer to IPv6
Management Command.
Description
Use the ping command to check the
reachability of a host, and output the related statistics information.
The executing procedure of the ping
command is as follows: First, the source host sends an ICMP ECHO-REQUEST packet
to the destination host. If the connection to the destination network is
normal, the destination host receives this packet and responds with an ICMP
ECHO-REPLY packet.
You can use the ping command to
check the network connectivity and the quality of a network line. This command
can output the following information:
l
Response status of the destination to each ICMP
ECHO-REQUEST packet, including the number of bytes, packet sequence number, TTL
and response time of the response packet if the response packet is received
within the timeout time. If no response packet is received within the timeout
time, the message "Request time out" is
displayed instead.
l
Final statistics, including the numbers of sent
packets and received response packets, the irresponsive packet percentage, and
the minimum, average and maximum values of response time.
You can set a relatively long timeout time
if the network transmission speed is slow.
Related commands: tracert.
Examples
# Check the reachability of the host whose IP
address is 202.38.160.244.
<Sysname> ping 202.38.160.244
ping 202.38.160.244 : 56 data
bytes, press CTRL_C to break
Reply from 202.38.160.244 :
bytes=56 sequence=1 ttl=255 time = 1ms
Reply from 202.38.160.244 :
bytes=56 sequence=2 ttl=255 time = 2ms
Reply from 202.38.160.244 :
bytes=56 sequence=3 ttl=255 time = 1ms
Reply from 202.38.160.244 :
bytes=56 sequence=4 ttl=255 time = 3ms
Reply from 202.38.160.244 :
bytes=56 sequence=5 ttl=255 time = 2ms
--202.38.160.244 ping
statistics--
5 packet transmitted
5 packet received
0% packet loss
round-trip min/avg/max =
1/2/3 ms
The above output information indicates that
the destination host is reachable. Each probe packet from the source device has
got a reply, with the minimum/average/maximum packet roundtrip time being
1ms/2ms/3ms.
Syntax
tracert [ -a
source-ip ] [ -f first-ttl ] [ -m max-ttl
] [ -p port ] [ -q num-packet ] [ -w timeout
] string
View
Any view
Parameters
-a source-ip: Specifies the source interface IP address used by this command.
-f first-ttl: Specifies the initial TTL value of the
packets to be sent, so as to only display the addresses of those gateways on
the path whose hop counts are not smaller than the hop count specified by the first-ttl
argument. For example, if the first-ttl argument is 3, the command
displays the addresses of the gateways from the third hop. The first-ttl
argument ranges from 1 to 255 and defaults to 1.
-m max-ttl: Specifies the maximum TTL value of the packets to be sent. After the command sends a packet with the maximum TTL, it will not
send any more packets. With this argument, this command only displays the addresses
of those gateways from the source address to hop according to the hop count
specified by the argument. For example, if the max-ttl argument is 5,
the command displays the addresses of the gateways from the source to the fifth
hop. The max-ttl argument ranges from 1 to 255 and defaults to 30.
-p port: Specifies the destination port of the packets to be sent. The port
argument ranges from 0 to 65535 and defaults to 33434. Generally, you need not
change the argument.
-q num-packet: Specifies the
number of packets to be sent each time. The num-packet argument ranges
from 0 to 65,535 and defaults to 3.
-w timeout: Specifies the timeout time to wait for ICMP error packets. The timeout argument ranges from 0 to 65,535
and defaults to 5,000 (in milliseconds).
string: IP
address of the destination host, or host name of the remote system with 1 to 20
characters.
The tracert
command also supports the ipv6 keyword. For details, refer to IPv6
Management Command.
Description
Use the tracert command to trace the
gateways that the test packets pass through from the source device to the
destination device. This command is mainly used to check the network
connectivity and help locate the network faults.
The executing procedure of the tracert
command is as follows: First, the source sends a packet with the TTL of 1, and
the first hop device returns an ICMP error message indicating that it cannot
forward this packet because of TTL timeout. Then, the source resends a packet
with the TTL of 2, and the second hop device also returns an ICMP TTL timeout
message. This procedure goes on and on until a packet gets to the destination
or the maximum TTL is reached. During the procedure, the system records the
source address of each ICMP TTL timeout message in order to offer the path that
the packets pass through to the destination.
If you find that the network is faulty by
using the ping command, you can use the tracert command to find
where the fault is in the network.
The tracert command can output the
IP addresses of all the gateways that the packets pass through to the
destination. It outputs the string "***" if the response from a
gateway times out.
Examples
# Trace the gateways that the packets pass
through to the destination with IP address 18.26.0.115.
<Sysname> tracert
18.26.0.115
tracert to 18.26.0.115
(18.26.0.115), 30 hops max,40 bytes packet
1 128.3.112.1 (128.3.112.1) 0
ms 0 ms 0 ms
2 128.32.216.1 (128.32.216.1)
19 ms 19 ms 19 ms
3 128.32.206.1 (128.32.206.1)
39 ms 19 ms 19 ms
4 128.32.136.23
(128.32.136.23) 19 ms 39 ms 39 ms
5 128.32.168.22
(128.32.168.22) 20 ms 39 ms 39 ms
6 128.32.197.4 (128.32.197.4)
59 ms 119 ms 39 ms
7 131.119.2.5 (131.119.2.5)
59 ms 59 ms 39 ms
8 129.140.70.13
(129.140.70.13) 80 ms 79 ms 99 ms
9 129.140.71.6 (129.140.71.6)
139 ms 139 ms 159 ms
10 129.140.81.7
(129.140.81.7) 199 ms 180 ms 300 ms
11 129.140.72.17
(129.140.72.17) 300 ms 239 ms 239 ms
12 * * *
13 128.121.54.72
(128.121.54.72) 259 ms 499 ms 279 ms
14 * * *
15 * * *
16 * * *
17 * * *
18 18.26.0.115 (18.26.0.115)
339 ms 279 ms 279 ms
Syntax
boot boot-loader [ backup-attribute ] { file-url [
fabric ] | device-name }
View
User view
Parameters
backup-attribute: Specifies the backup attribute for a file.
file-url:
Path plus name of a host software file in the Flash, a string of 1 to 64
characters.
fabric: Specifies
the file path in fabric mode.
device-name:
File name, in the form of unit[NO.]>flash:, which is used to indicate
that the specified file is stored in the Flash memory of a specified switch.
Description
Use the boot boot-loader command to
specify the host software that will be used when the switch starts up next
time.
You can use this command to specify a .bin
file in the Flash as the host software to be adopted at next startup.
Examples
# Specify the host software that will be used
when the current switch starts up next time.
<Sysname> boot
boot-loader S5600.BIN
The specified file will be
booted next time on unit 1!
Syntax
boot bootrom
{ file-url | device-name }
View
User view
Parameters
file-ulr:
Path plus name of a Boot ROM file (that is, a .btm file) in the Flash, a string
of 1 to 64 characters.
device-name:
File name, beginning with a device name in the form of unit[NO.]>flash,
used to indicates that the specified file is stored in the Flash memory of a
specified switch.
Description
Use the boot bootrom command to
update the Boot ROM. The updated Boot ROM is used at next startup.
Examples
# Update the Boot ROM of the switch using
the file named S5600.btm.
<Sysname> boot bootrom
S5600.btm
This will update Bootrom on
unit 1. Continue? [Y/N] y
Upgrading Bootrom, please
wait...
Upgrade Bootrom succeeded!
Syntax
display boot-loader [ unit unit-id ]
View
Any view
Parameters
unit-id:
Unit ID of a switch.
Description
Use the display boot-loader command
to display the host software (.bin file) that will be adopted when the switch starts
up next time.
Examples
# Display the host software that will be
adopted when the switch starts up next time.
<Sysname> display boot-loader
Unit 1:
The current boot app is: s5600.bin
The main boot app is: s5600.bin
The backup boot app is: s5600back.bin
Table 3-1
Description for the fields of the display
boot-loader command
|
Field
|
Description
|
|
The current boot app is
|
Boot file used for the current boot of
the system
|
|
The main boot app is
|
Main boot file to be used for the next
boot of the system
|
|
The backup boot app is
|
Backup boot file to be used for the next
boot of the system
|
Syntax
display cpu [
unit unit-id ]
View
Any view
Parameters
unit-id:
Unit ID of a switch.
Description
Use the display cpu command to
display the CPU usage.
Examples
# Display the CPU usage of this switch.
<Sysname> display cpu
Unit 1
Board 0 CPU busy status:
12% in last 5 seconds
12% in last 1 minute
12% in last 5 minutes
Table 3-2
Description for the fields of the display cpu
command
|
Field
|
Description
|
|
CPU busy status
|
CPU usage status.
|
|
12% in last 5 seconds
12% in last 1 minute
12% in last 5 minutes
|
The CPU usage in the last five
seconds is 12%.
The CPU usage in the last one minute
is 12%.
The CPU usage in the last five
minutes is 12%.
|
Syntax
display device [ manuinfo [ unit unit-id ] | unit unit-id
]
View
Any view
Parameters
manuinfo: Specifies
to display the manufacture information of the specified switch.
unit-id:
Unit ID of a switch.
Description
Use the display device command to
display the information, such as the module type and operating status, about
each board (main board and sub-board) of a specified switch.
You can use this command to display the
following information about each board, including slot number, sub-slot number,
the number of ports, versions of PCB, FPGA, CPLD and Boot ROM software, address
learning mode, interface board type, and so on.
Examples
# Display board information of this switch.
<Sysname>
display device
Unit 1
SlotNo SubSNo PortNum PCBVer FPGAVer
CPLDVer BootRomVer AddrLM Type State
0 0 48 REV.B NULL
001 506 IVL MAIN Normal
0 2 2 REV.B
NULL NULL NULL IVL Cascade Normal
Table 3-3 Description on the fields of the display device command
|
Field
|
Description
|
|
SlotNo
|
Serial number of the slot
|
|
SubSNo
|
Serial number of the sub slot
|
|
PortNum
|
Number of ports
|
|
PCBVer
|
Version number of the PCB card
|
|
FPGAVer
|
Version number of the FPGA
encapsulation
|
|
CPLDVer
|
|
