32-System Configuration and Debugging Command
Chapters Download (269.45 KB)
Table of Contents
1 Basic Configuration Commands
display diagnostic-information
bootrom-update security-check enable
3 System Maintaining and Debugging Commands
4 Hotfix Configuration Commands
Syntax
clock datetime time date
View
User view
Default Level
3: Manage level
Parameters
time: Current time in the format of HH:MM:SS, where HH is hours in the range 0 to 23, MM is minutes in the range 0 to 59, and SS is seconds in the range 0 to 59. The zeros in the argument can be omitted except for indicating 0 hours.
date: Current date in the format of MM/DD/YYYY or YYYY/MM/DD. MM is the month of the year in the range 1 to 12, DD is the day of the month that varies with months, and YYYY is a year in the range 2000 to 2035.
Description
Use the clock datetime command to set the current time and date of the device.
The current time and date of the device must be set in an environment that requires the acquisition of absolute time.
You may choose not to provide seconds when inputting the time parameters.
Related commands: clock summer-time one-off, clock summer-time repeating, clock timezone, display clock.
Examples
# Set the current system time to 14:10:20 08/01/2005.
<Sysname> clock datetime 14:10:20 8/1/2005
# Set the current system time to 00:06:00 01/01/2007.
<Sysname> clock datetime 0:6 2007/1/1
Syntax
clock summer-time zone-name one-off start-time start-date end-time end-date add-time
undo clock summer-time
View
System view
Default Level
3: Manage level
Parameters
zone-name: Name of the daylight saving time, a string of 1 to 32 characters. It is case sensitive.
start-time: Start time, in the format of HH:MM:SS (hours/minutes/seconds). The zeros in the argument can be omitted except for indicating 0 hours.
start-date: Start date, in the format of MM/DD/YYYY (months/days/years) or YYYY/MM/DD.
end-time: End time, in the format of HH:MM:SS (hours/minutes/seconds). The zeros in the argument can be omitted except for indicating 0 hours.
end-date: End date, in the format of MM/DD/YYYY (months/days/years) or YYYY/MM/DD.
add-time: Time added to the standard time of the device, in the format of HH:MM:SS (hours/minutes/seconds). The zeros in the argument can be omitted except for indicating 0 hours.
Description
Use the clock summer-time one-off command to adopt daylight saving time from the start-time of the start-date to the end-time of the end-date. Daylight saving time adds the add-time to the current time of the device.
Use the undo clock summer-time command to cancel the configuration of the daylight saving time.
After the configuration takes effect, you can use the display clock command to view it. Besides, the time of the log or debug information is the local time of which the time zone and daylight saving time have been adjusted.
Note that:
l The time range from start-time in start-date to end-time in end-date must be longer than one day and shorter than one year. Otherwise, the argument is considered as invalid and the configuration fails.
l If the current system time is in the time range specified with this command, the system time automatically adds “add-time” after the execution of this command.
Related commands: clock datetime, clock summer-time repeating, clock timezone, display clock.
Examples
# For daylight saving time in abc1 between 06:00:00 on 08/01/2006 and 06:00:00 on 09/01/2006, set the system clock ahead one hour.
<Sysname> system-view
[Sysname] clock summer-time abc1 one-off 6 08/01/2006 6 09/01/2006 1
Syntax
clock summer-time zone-name repeating start-time start-date end-time end-date add-time
undo clock summer-time
View
System view
Default Level
3: Manage level
Parameters
zone-name: Name of the daylight saving time, a string of 1 to 32 characters.
start-time: Start time, in the format of HH:MM:SS (hours/minutes/seconds). The zeros in the argument can be omitted except for indicating 0 hours.
start-date: Start date which can be set in two ways:
l Enter the year, month and date at one time, in the format of MM/DD/YYYY (months/days/years) or YYYY/MM/DD.
l Enter the year, month and date one by one, separated by spaces. The year ranges from 2000 to 2035; the month can be January, February, March, April, May, June, July, August, September, October, November or December; the start week can be the first, second, third, fourth, fifth or last week of the month; the start date is Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday.
end-time: End time, in the format of HH:MM:SS (hours/minutes/seconds). The zeros in the argument can be omitted except for indicating 0 hours.
end-date: End date which can be set in two ways:
l Enter the year, month and date at one time, in the format of MM/DD/YYYY (months/days/years) or YYYY/MM/DD.
l Enter the year, month and date one by one, separated by spaces. The year ranges from 2000 to 2035; the month can be January, February, March, April, May, June, July, August, September, October, November or December; the end week can be the first, second, third, fourth, fifth or last week of the month; the end date is Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday.
add-time: Time added to the current standard time of the device, in the format of HH:MM:SS (hours/minutes/seconds). The zeros in the argument can be omitted except for indicating 0 hours.
Description
Use the clock summer-time repeating command to adopt summer-time repeatedly.
Use the undo clock summer-time command to cancel the configuration of the daylight saving time.
For example, when start-date and start-time are set to 2007/6/6 and 00:00:00, end-date and end-time to 2007/10/01 and 00:00:00, and add-time to 01:00:00, it specifies to adopt daylight saving time from 00:00:00 of June 6 until 00:00:00 of October 1 each year from 2007 (2007 inclusive). The daylight saving time adds one hour to the current device time.
After the configuration takes effect, use the display clock command to view the result. The information such as log file and debug adopts the local time modified by time-zone and daylight saving time.
Note that:
l The time range from “start-time” in “start-date” to “end-time” in “end-date” must be longer than one day and shorter than one year. Otherwise, the argument is considered as invalid and the configuration fails.
l If the current system time is in the time range specified with this command, the system time automatically adds “add-time” after the execution of this command.
Related commands: clock datetime, clock summer-time one-off, clock timezone, display clock.
Examples
# For the daylight saving time in abc2 between 06:00:00 on 08/01/2007 and 06:00:00 on 09/01/2007 and from 06:00:00 08/01 to 06:00:00 on 09/01 each year after 2007, set the system clock ahead one hour.
<Sysname> system-view
[Sysname] clock summer-time abc2 repeating 06:00:00 08/01/2007 06:00:00 09/01/2007 01:00:00
Syntax
clock timezone zone-name { add | minus } zone-offset
undo clock timezone
View
System view
Default Level
3: Manage level
Parameters
zone-name: Time zone name, a string of 1 to 32 characters. It is case sensitive.
add: Positive offset to universal time coordinated (UTC) time.
minus: Negative offset to UTC time.
zone-offset: In the format of HH/MM/SS (hours/minutes/seconds), where HH is hours in the range 0 to 23, MM is minutes in the range 0 to 59, and SS is seconds in the range 0 to 59. The zeros in the argument can be omitted except for indicating 0 hours.
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.
By default, the local time zone is UTC zone.
After the configuration takes effect, use the display clock command to view the result. The information such as log file and debug adopts the local time modified by time-zone and daylight saving time.
Related commands: clock datetime, clock summer-time one-off, clock summer-time repeating, display clock.
Examples
# Set the name of the local time zone to Z5, five hours ahead of UTC time.
[Sysname] clock timezone z5 add 5
Syntax
command-privilege level level view view command
undo command-privilege view view command
View
System view
Default Level
3: Manage level
Parameters
level level: Command level, in the range 0 to 3.
view view: Specifies a view. The value shell of the argument view represents user view. The specified view must be the view to which the command provided by the command argument belongs; for the corresponding view, refer to the "View" section of the specified command.
command: Command to be set in the specified view.
Description
Use the command-privilege command to assign a level for the specified command in the specified view.
Use the undo command-privilege view command to restore the default.
By default, each command in a view has its specified level. For the details, refer to the related part of Basic System Configuration in this manual. Command level falls into four levels: visit, monitor, system, and manage, which are identified by 0 through 3. The administrator can assign a privilege level for a user according to his need. When the user logs on a device, the commands available depend on the user’s privilege. For example, if a user’s privilege is 3 and the command privilege of VTY 0 user interface is 1, and the user logs on the system from VTY 0, he can use all the commands with privilege smaller than three (inclusive).
Note that:
l You are recommended to use the default command level or modify the command level under the guidance of professional staff; otherwise, the change of command level may bring inconvenience to your maintenance and operation, or even potential security problem.
l When you configure the command-privilege command, the value of the command argument must be a complete form of the specified command, that is, you must enter all needed keywords and arguments of the command. The argument should be in the value range. For example, the default level of the tftp server-address { get | put | sget } source-filename [ destination-filename ] [ source { interface interface-type interface-number | ip source-ip-address } ] command is 3; after the command-privilege level 0 view shell tftp 1.1.1.1 put a.cfg command is executed, when users with the user privilege level of 0 log in to the device, they can execute the tftp server-address put source-filename command (such as the tftp 192.168.1.26 put syslog.txt command); users with the user privilege level of 0 cannot execute the command with the get, sget or source keyword, and cannot specify the destination-filename argument.
l When you configure the undo command-privilege view command, the value of the command argument can be an abbreviated form of the specified command, that is, you only need to enter the keywords at the beginning of the command. For example, after the undo command-privilege view system ftp command is executed, all commands starting with the keyword ftp (such as ftp server acl, ftp server enable, and ftp timeout) will be restored to the default level; if you have modified the command level of commands ftp server enable and ftp timeout, and you want to restore only the ftp server enable command to its default level, you should use the undo command-privilege view system ftp server command.
l If you modify the command level of a command in a specified view from the default command level to a lower level, remember to modify the command levels of the quit command and the corresponding command that is used to enter this view. For example, the default command level of commands interface and system-view is 2 (system level); if you want to make the interface command available to the users with the user privilege level of 1, you need to execute the following three commands: command-privilege level 1 view shell system-view, command-privilege level 1 view system interface gigabitethernet 1/1/1, and command-privilege level 1 view system quit, so that the login users with the user privilege level of 1 can enter system view, execute the interface gigabitethernet command, and then return to user view.
Examples
# Set the command level of the system-view command in user view to 3. (By default, users with the user privilege level of 2 or 3 can use the system-view command after login; after the following configuration, only users with the user privilege level of 3 can use this command to enter system view and configure the device. Therefore, the device security is improved.)
[Sysname] command-privilege level 3 view shell system-view
Syntax
copyright-info enable
undo copyright-info enable
View
System view
Default Level
3: Manage level
Parameters
None
Description
Use the copyright-info enable command to enable the display of copyright information.
Use the undo copyright-info enable command to disable the display of copyright information.
By default, the display of copyright information is enabled.
Examples
# Enable the display of copyright information
<Sysname> system-view
[Sysname] copyright-info enable
l If a user logs in to the device through Telnet, the following information is displayed:
**************************************************************************
* Copyright (c) 2004-2008 Hangzhou H3C Tech. Co., Ltd. All rights reserved.*
* Without the owner's prior written consent, *
* no decompiling or reverse-engineering shall be allowed. *
****************************************************************************
<Sysname>
l If a user has already logged in through the console port, and then quits user view, the following information is displayed:
**************************************************************************
* Copyright (c) 2004-2008 Hangzhou H3C Tech. Co., Ltd. All rights reserved.*
* Without the owner's prior written consent, *
* no decompiling or reverse-engineering shall be allowed. *
****************************************************************************
User interface aux0 is available.
Please press ENTER.
Syntax
display clipboard
View
Any view
Default Level
1: Monitor level
Parameters
None
Description
Use the display clipboard command to view the contents of the clipboard.
To copy the specified content to the clipboard:
Move the cursor to the starting position of the content and press the <Esc+Shift+,> combination (“,” is an English comma).
Move the cursor to the ending position of the content and press the <Esc+Shift+.> combination (“.” is an English dot) to copy the specified content to the clipboard.
Examples
# View the content of the clipboard.
<Sysname> display clipboard
---------------- CLIPBOARD-----------------
telnet server enable
Syntax
display clock
View
Any view
Default Level
1: Monitor level
Parameters
None
Description
Use the display clock command to view the current system time and date.
The current system time and date are decided by the clock datetime, clock summer-time one-off (or clock summer-time repeating), clock timezone. Refer to Configuring the system clock in the operation manual for the detailed rules.
Related commands: clock datetime, clock summer-time one-off, clock summer-time repeating, clock timezone.
Examples
# Display the current time and date.
09:41:23 UTC Thu 12/15/2005
Syntax
display current-configuration [ [ configuration [ configuration ] | interface [ interface-type ] [ interface-number ] ] [ by-linenum ] [ | { begin | exclude | include } regular-expression ] ]
View
Any view
Default Level
2: System level
Parameters
configuration [ configuration ]: Specifies to display non-interface configuration. If no parameter is used, all the non-interface configuration is displayed; if parameters are used, display the specified information. For example:
l isp: Displays the ISP configuration.
l ftth: Displays the ftth configuration.
l igmp-snooping: Displays the igmp-snooping configuration.
l luser: Displays the luser configuration.
l ugroup: Displays the ugroup configuration.
l radius-template: Displays the Radius template configuration.
l system: Displays the system configuration.
l user-interface: Displays the user interface configuration.
interface [ interface-type ] [ interface-number ]: Displays the interface configuration, where interface-type represents the interface type and interface-number represents the interface number.
by-linenum: Specifies to display the number of each line.
|: Specifies to use regular expression to filter the configuration of display device. For the detailed description of the regular expression, refer to the CLI Display part of Basic System Configuration in the System Volume.
l begin: Displays the line that matches the regular expression and all the subsequent lines.
l exclude: Displays the lines that do not match the regular expression.
l include: Displays only the lines that match the regular expression.
regular-expression: Regular expression, a string of 1 to 256 characters. Note that this argument is case-sensitive and can have spaces included.
Description
Use the display current-configuration command to display the current validated configuration of a device.
You can use the display current-configuration command to view the currently validated configuration. A parameter is not displayed if it has the default configuration. If the validated parameter is changed, although you have configured it, the validated parameter is displayed. For example, ip address 11.11.11.11 24 has been configured on a Loopback interface. In this case, if you execute the display current-configuration command, ip address 11.11.11.11 255.255.255.255 is displayed, meaning the validated subnet mask is 32 bits.
Related commands: save, reset saved-configuration, display saved-configuration.
Examples
# Display the configuration from the line containing “user-interface” to the last line in the current validated configuration (the output information depends on the device model and the current configuration).
<Sysname> display current-configuration | begin user-interface
user-interface aux 0
user-interface vty 0 4
authentication-mode none
user privilege level 3
#
return
# Display the current valid SNMP configuration on the device (the output information depends on the device model and the current configuration).
<Sysname> display current-configuration | include snmp
snmp-agent
snmp-agent local-engineid 800063A203000FE240A1A6
snmp-agent community read public
snmp-agent community write private
snmp-agent sys-info version all
undo snmp-agent trap enable ospf 100
Syntax
display default-configuration
View
Any view
Default Level
2: System level
Parameters
None
Description
Use the display default-configuration command to display the factory defaults of a device. The command displays all commands to be executed when the device boots with the factory defaults.
Related commands: display current-configuration, display saved-configuration.
Examples
# Display the factory defaults of the device (The factory defaults vary with device models. The detailed displays are omitted here).
<Sysname> display default-configuration
Syntax
display diagnostic-information
View
Any view
Default Level
1: Monitor level
Parameters
None
Description
Use the display diagnostic-information command to display or save the statistics of each module’s running status in the system.
When the system is out of order, you need to collect a lot of information to locate the problem. At this time you can use the display diagnostic-information command to display or save the statistics of each module’s running status in the system. The display diagnostic-information command collects prompt information of the commands display clock, display version, display device, and display current-configuration.
Examples
# Save the statistics of each module's running status in the system.
<Sysname> display diagnostic-information
Save or display diagnostic information (Y=save, N=display)?[Y/N]y
Please input the file name(*.diag)[flash:/default.diag]:aa.diag
Diagnostic information is outputting to flash:/aa.diag.
Please wait...
Save succeeded.
You can view the content of the file aa.diag by executing the more.aa.diag command in user view, in combination of the Page Up and Page Down keys.
# Display the statistics of each module's running status in the system.
<Sysname> display diagnostic-information
Save or display diagnostic information (Y=save, N=display)? [Y/N]:n
Syntax
display history-command
View
Any view
Default Level
1: Monitor level
Parameters
None
Description
Use the display history-command command to display commands saved in the history buffer.
The system will save validated history commands performed last in current user view to the history buffer, which can save up to ten commands by default. You can use the history-command max-size command to set the size of the history buffer. Refer to the history-command max-size command in Login Commands in the System Volume for related configuration.
Examples
# Display validated history commands in current user view (the display information varies with configuration).
<Sysname> display history-command
display history-command
system-view
vlan 2
quit
Syntax
display hotkey
View
Any view
Default Level
1: Monitor level
Parameters
None
Description
Use the display hotkey command to display hotkey information.
Examples
# Display hotkey information.
<Sysname> display hotkey
----------------- HOTKEY -----------------
=Defined hotkeys=
Hotkeys Command
CTRL_G display current-configuration
CTRL_L display ip routing-table
CTRL_O undo debug all
=Undefined hotkeys=
Hotkeys Command
CTRL_T NULL
CTRL_U NULL
=System hotkeys=
Hotkeys Function
CTRL_A Move the cursor to the beginning of the current line.
CTRL_B Move the cursor one character left.
CTRL_C Stop current command function.
CTRL_D Erase current character.
CTRL_E Move the cursor to the end of the current line.
CTRL_F Move the cursor one character right.
CTRL_H Erase the character left of the cursor.
CTRL_K Kill outgoing connection.
CTRL_N Display the next command from the history buffer.
CTRL_P Display the previous command from the history buffer.
CTRL_R Redisplay the current line.
CTRL_V Paste text from the clipboard.
CTRL_W Delete the word left of the cursor.
CTRL_X Delete all characters up to the cursor.
CTRL_Y Delete all characters after the cursor.
CTRL_Z Return to the User View.
CTRL_] Kill incoming connection or redirect connection.
ESC_B Move the cursor one word back.
ESC_D Delete remainder of word.
ESC_F Move the cursor forward one word.
ESC_N Move the cursor down a line.
ESC_P Move the cursor up a line.
ESC_< Specify the beginning of clipboard.
ESC_> Specify the end of clipboard.
Syntax
display this [ by-linenum ]
Any view
Default Level
1: Monitor level
Parameters
by-linenum: Specifies to display the number of each line.
Use the display this command to display the validated configuration information under the current view.
After finishing a set of configurations under a view, you can use the display this command to check whether the configuration takes effect.
Note that:
l A parameter is not displayed if it has the default configuration.
l A parameter is not displayed if the configuration has not taken effect.
l When you use the command in a user interface view or VLAN view, the command displays the valid configuration in all the user interfaces or VLANs.
Examples
# Display the valid configuration information of the current view (the output information depends on the current configuration of the device).
<Sysname> system-view
[Sysname] user-interface vty 0
[Sysname-ui-vty0] display this
#
user-interface aux 0
user-interface vty 0
history-command max-size 256
user-interface vty 1 4
#
return
# Display the valid configuration information on interface GigabitEthernet1/1/1 (the output information depends on the current configuration of the device).
<Sysname> system-view
[Sysname] interface gigabitethernet1/1/1
[Sysname-GigabitEthernet1/1/1] display this
#
interface GigabitEthernet1/1/1
port link-mode bridge
port link-type hybrid
undo port hybrid vlan 1
port hybrid vlan 2 to 4 untagged
port hybrid pvid vlan 2
#
return
# Display the valid configuration information on interface Olt 1/0/1 (the output information depends on the current configuration of the device).
<Sysname> system-view
[Sysname] interface olt 1/0/1
[Sysname-Olt1/0/1] display this
#
interface Olt1/0/1
using onu 1 to 4
port link-type hybrid
port hybrid vlan 1 tagged
port-isolate enable
#
return
Syntax
display version
View
Default Level
1: Monitor level
Parameters
None
Description
Use the display version command to view system version information.
By viewing system version information, you can learn about the current software version, rack type and the information related to the main control board and interface boards.
Examples
# Display system version information (The system version information varies with devices.).
Syntax
header { incoming | legal | login | motd | shell } text
undo header { incoming | legal | login | motd | shell }
View
System view
Default Level
2: System level
Parameters
incoming: Sets the banner displayed when a Modem login user enters user view. If authentication is needed, the incoming banner is displayed after the authentication is passed.
legal: Sets the authorization banner before a user logs onto the terminal interface. The legal banner is displayed before the user inputs the username and password.
login: Sets the login banner at authentication.
motd: Banner displayed before login. If authentication is required, the banner is displayed before authentication. The support for the keyword varies with devices.
shell: Sets the banner displayed when a non Modem login user enters user view.
text: Banner message, which can be input in two formats. Refer to Basic System Configuration for the detailed information.
Description
Use the header command to create a banner.
Use the undo header command to clear a banner.
Examples
# Configure banners.
<Sysname> system-view
[Sysname] header incoming %
Input banner text, and quit with the character '%'.
Welcome to incoming(header incoming)%
[Sysname] header legal %
Input banner text, and quit with the character '%'.
Welcome to legal (header legal)%
[Sysname] header login %
Input banner text, and quit with the character '%'.
Welcome to login(header login)%
[Sysname] header motd %
Input banner text, and quit with the character '%'.
Welcome to motd(header motd)%
[Sysname] header shell %
Input banner text, and quit with the character '%'.
Welcome to shell(header shell)%
The character % is the starting/ending character of text in this example. Entering % after the displayed text quits the header command.
As the starting and ending character, % is not a part of a banner.
# Test the configuration remotely using Telnet. (only when login authentication is configured can the login banner be displayed).
******************************************************************************
* Copyright (c) 2004-2008 Hangzhou H3C Tech. Co., Ltd. All rights reserved. *
* Without the owner's prior written consent, *
* no decompiling or reverse-engineering shall be allowed. *
******************************************************************************
Welcome to legal(header legal)
Press Y or ENTER to continue, N to exit.
Welcome to motd(header motd)
Welcome to login(header login)
Login authentication
Password:
Welcome to shell(header shell)
<Sysname>
Syntax
hotkey { CTRL_G | CTRL_L | CTRL_O | CTRL_T | CTRL_U } command
undo hotkey { CTRL_G | CTRL_L | CTRL_O | CTRL_T | CTRL_U }
View
System view
Default Level
2: System level
Parameters
CTRL_G: Assigns the hot key Ctrl+G to a command.
CTRL_L: Assigns the hot key Ctrl+L to a command.
CTRL_O: Assigns the hot key Ctrl+O to a command.
CTRL_T: Assigns the hot key Ctrl+T to a command.
CTRL_U: Assigns the hot key Ctrl+U to a command.
command: The command line associated with the hot key.
Description
Use the hotkey command to assign a hot key to a command line.
Use the undo hotkey command to restore the default.
By default, the system specifies corresponding commands for Ctrl+G, Ctrl+L and Ctrl+O, while the others are null.
l Ctrl+G corresponds to display current-configuration
l Ctrl+L corresponds to display ip routing-table
l Ctrl+O corresponds to undo debugging all
You can customize this scheme as needed however.
Examples
# Assign the hot key Ctrl+T to the display tcp status command.
<Sysname> system-view
[Sysname] hotkey ctrl_t display tcp status
# Display the configuration of hotkeys.
[Sysname] display hotkey
----------------- HOTKEY -----------------
=Defined hotkeys=
Hotkeys Command
CTRL_G display current-configuration
CTRL_L display ip routing-table
CTRL_O undo debug all
CTRL_T display tcp status
=Undefined hotkeys=
Hotkeys Command
CTRL_U NULL
=System hotkeys=
Hotkeys Function
CTRL_A Move the cursor to the beginning of the current line.
CTRL_B Move the cursor one character left.
CTRL_C Stop current command function.
CTRL_D Erase current character.
CTRL_E Move the cursor to the end of the current line.
CTRL_F Move the cursor one character right.
CTRL_H Erase the character left of the cursor.
CTRL_K Kill outgoing connection.
CTRL_N Display the next command from the history buffer.
CTRL_P Display the previous command from the history buffer.
CTRL_R Redisplay the current line.
CTRL_V Paste text from the clipboard.
CTRL_W Delete the word left of the cursor.
CTRL_X Delete all characters up to the cursor.
CTRL_Y Delete all characters after the cursor.
CTRL_Z Return to the user view.
CTRL_] Kill incoming connection or redirect connection.
ESC_B Move the cursor one word back.
ESC_D Delete remainder of word.
ESC_F Move the cursor forward one word.
ESC_N Move the cursor down a line.
ESC_P Move the cursor up a line.
ESC_< Specify the beginning of clipboard.
ESC_> Specify the end of clipboard.
Syntax
quit
View
Any view
Default Level
0: Visit level (in user view)
2: System level (in other views)
Parameters
None
Description
Use the quit command to exit to a lower-level view. If the current view is user view, the quit command terminates the current connection and reconnects to the device.
Examples
# Switch from GigabitEthernet1/1/1 interface view to system view, and then to user view.
[Sysname-GigabitEthernet1/1/1] quit
[Sysname] quit
<Sysname>
# Switch from Onu1/0/1:2 interface view to system view, and then to user view.
[Sysname-Onu1/0/1:2] quit
[Sysname] quit
<Sysname>
Syntax
return
View
Any view except user view
Default Level
2: System level
Parameters
None
Description
Use the return command to return to user view from current view, as you do with the hot key Ctrl+Z.
Related commands: quit.
Examples
# Return to user view from GigabitEthernet1/1/1 view.
[Sysname-GigabitEthernet1/1/1] return
<Sysname>
Syntax
screen-length disable
undo screen-length disable
View
User view
Default Level
1: Monitor level
Parameters
None
Description
Use the screen-length disable command to disable the multiple-screen output function of the current user.
Use the undo screen-length disable command to enable the multiple-screen output function of the current user.
By default, a login user uses the settings of the screen-length command. The default settings of the screen-length command are: multiple-screen output is enabled and 24 lines are displayed on the next screen. (For the details of the screen-length command, refer to User Interface Commands in the System Volume.)
Note that this command is applicable to the current user only and when a user re-logs in, the settings restore to the system default.
Examples
# Disable multiple-screen output of the current user.
<Sysname> screen-length disable
Syntax
super [ level ]
View
User view
Default Level
0: Visit level
Parameters
level: User level, in the range 0 to 3, and defaults to 3.
Description
Use the super command to switch from the current user privilege level to a specified user privilege level.
If you do not provide the level argument, the current user privilege level will be switched to 3.
Login users are classified into four levels that correspond to the four command levels. After users at different levels log in, they can only use commands at their own, or lower, levels.
Note that:
Users can switch to a lower user privilege level unconditionally. However, no password is needed only for console login user level switching; to switch to a higher user privilege level, and log in from VTY user interfaces, users need to enter the password needed for the security’s sake. If the entered password is incorrect or no password is configured, the switching fails. Therefore, before switching a user to a higher user privilege level, you should configure the password needed.
Related commands: super password.
Examples
# Set the user privilege level to 2 (The current user privilege level is 3.).
<Sysname> super 2
User privilege level is 2, and only those commands can be used
whose level is equal or less than this.
Privilege note: 0-VISIT, 1-MONITOR, 2-SYSTEM, 3-MANAGE
# Switch the user privilege level back to 3 (Suppose password 123 has been set; otherwise, the user privilege level cannot be switched to 3.).
<Sysname> super 3
Password:
User privilege level is 3, and only those commands can be used
whose level is equal or less than this.
Privilege note: 0-VISIT, 1-MONITOR, 2-SYSTEM, 3-MANAGE
Syntax
super password [ level user-level ] { simple | cipher } password
undo super password [ level user-level ]
View
System view
Default Level
2: System level
Parameters
level user-level: User privilege level in the range 1 to 3, with the default as 3.
simple: Plain text password.
cipher: Cipher text password.
password: Password, a string of characters. It is case-sensitive.
l For simple password, it is a string of 1 to 16 characters.
l For cipher password, it is a string of 1 to 16 characters in plain text or 24 characters in cipher text. For example, the simple text “1234567” corresponds to the cipher text “(TT8F]Y\5SQ=^Q`MAF4<1!!”.
Description
Use the super password command to set the password needed to switch from a lower user privilege level to a higher one.
Use the undo super password command to restore the default.
By default, no password is set to switch from a lower user privilege level to a higher one.
Note that:
l If simple is specified, the configuration file saves a simple password.
l If cipher is specified, the configuration file saves a cipher password.
l The user must always enter a simple password, no matter simple or cipher is specified.
l Cipher passwords are recommended, as simple ones are easily getting cracked.
Examples
# Set the password to abc in simple form for switching user-level to 3.
<Sysname> system-view
[Sysname] super password level 3 simple abc
Display the password for switching user-level.
[Sysname] display current-configuration
#
super password level 3 simple abc
# Set the password to abc in cipher form for switching user-level to 3.
<Sysname> system-view
[Sysname] super password level 3 cipher abc
Display the password for switching user-level.
[Sysname] display current-configuration
#
super password level 3 cipher =`*Y=F>*.%-a_SW8\MYM2A!!
Syntax
sysname sysname
undo sysname
View
System view
Default Level
2: System level
Parameters
sysname: Name of the device, a string of 1 to 30 characters.
Description
Use the sysname command to set the name of the device.
Use the undo sysname demand to restore the device name to the default.
The default name is H3C.
Modifying device name affects the prompt of the CLI. For example, if the device name is Sysname, the prompt of user view is <Sysname>.
Examples
# Set the name of the device to R2000.
[Sysname] sysname R2000
[R2000]
Syntax
system-view
View
User view
Default Level
2: System level
Parameters
None
Description
Use the system-view command to enter system view from the current user view.
Related commands: quit, return.
Examples
# Enter system view from the current user view.
<Sysname> system-view
System View: return to User View with Ctrl+Z.
[Sysname]
File names in this document comply with the following rules:
l Path + file name (namely, a full file name): File on a specified path. A full file name consists of 1 to 135 characters.
l “File name” (namely, only a file name without a path): File on the current working path. The file name without a path consists of 1 to 91 characters.
Syntax
boot-loader file file-url { main | backup }
View
User view
Default Level
2: System level
Parameters
file file-url: Specifies a file name, a string of 1 to 64 characters.
main: Specifies a file as a main boot file.
backup: Specifies a file as a backup boot file.
Description
Use the boot-loader command to specify a boot file for the next boot.
A main boot file is used to boot a device and a backup boot file is used to boot a device only when a main boot file is unavailable.
Related commands: display boot-loader.
Examples
# Specify the main boot file for the next boot of a centralized device as plat.app.
<Sysname> boot-loader file plat.app main
This command will set boot file, Continue? [Y/N]:y
The specified file will be used as the main boot file at the next reboot!
Syntax
bootrom update file file-url
View
User view
Default Level
2: System level
Parameters
update file file-url: Upgrades Boot ROM, where file-url represents name of the file to be upgraded.
Description
Use the bootrom command to upgrade the Boot ROM program on a board(s).
Examples
# Use the a.btm file to upgrade the Boot ROM program on subboard 1 of a centralized device.
Sysname> bootrom update file a.btm
This command will update BootRom file on the specified subcard(s), Continue?[Y/N]:y
Updating BootRom, please wait...
User 0 update Bootrom on subcard 1 of board 0 with a.btm success,type is all
Syntax
bootrom-update security-check enable
undo bootrom-update security-check enable
View
System view
Default Level
2: System level
Parameters
None
Description
Use the bootrom-update security-check enable command to enable the validity check function.
Use the undo bootrom-update security-check enable command to disable the validity check function.
By default, the validity check function is enabled at the time of upgrading Boot ROM.
Examples
# Enable the validity check function when upgrading Boot ROM.
<Sysname> system-view
[Sysname] bootrom-update security-check enable
Syntax
display boot-loader
View
Any view
Default Level
2: System level
Parameters
slot slot-number: Displays boot file information of the specified board, where slot-number represents the slot number of a board. The value range varies with devices.
Description
Use the display boot-loader command to display information of the boot file.
Related commands: boot-loader.
Examples
# Display the file adopted for the current and next boot of a centralized device (The prompt information of this command varies with devices).
<Sysname> display boot-loader
Slot 1
The current boot app is: flash:/S3600-V3R1B1D059SP02_A0.app
The main boot app is: flash:/S3600-V3R1B1D059SP02_A0.app
The backup boot app is: flash:/bcm5836.app
Syntax
display cpu-usage [ number [ offset ] [ verbose ] | task ]
View
Any view
Default Level
1: Monitor level
Parameters
number: Number of CPU usage statistics records to be displayed.
offset: Offset between the serial number of the first CPU usage statistics record to be displayed and that of the last CPU usage record to be displayed.
verbose: Specifies to display detailed information of CPU usage statistics.
task: Displays CPU usage of each task.
Description
Use the display cpu-usage command to display the CPU usage statistics.
The system takes statistics of CPU usage at intervals (usually every 60 seconds) and saves the statistical results in the history record area. The maximum number of records that can be saved depends on the device model. display cpu-usage number indicates the system displays number records from the newest (last) record. display cpu-usage number offset indicates the system displays number records from the last but offset record.
Equivalent to the display cpu-usage 1 0 verbose command, the display cpu-usage command displays detailed information of the last CPU usage statistics record.
Examples
# Display information of the current CPU usage statistics on a centralized device.
<Sysname> display cpu-usage
Unit CPU usage:
1% in last 5 seconds
1% in last 1 minute
1% in last 5 minutes
# Display the last fifth and sixth records of the CPU usage statistics history.
<Sysname> display cpu-usage 2 4
===== CPU usage info (no: 0 idx: 58) =====
CPU Usage Stat. Cycle: 60 (Second)
CPU Usage : 3%
CPU Usage Stat. Time : 2006-07-10 10:56:55
CPU Usage Stat. Tick : 0x1d9d(CPU Tick High) 0x3a659a70(CPU Tick Low)
Actual Stat. Cycle : 0x0(CPU Tick High) 0x95030517(CPU Tick Low)
===== CPU usage info (no: 1 idx: 57) =====
CPU Usage Stat. Cycle: 60 (Second)
CPU Usage : 3%
CPU Usage Stat. Time : 2006-07-10 10:55:55
CPU Usage Stat. Tick : 0x1d9c(CPU Tick High) 0xa50e5351(CPU Tick Low)
Actual Stat. Cycle : 0x0(CPU Tick High) 0x950906af(CPU Tick Low)
Table 2-1 display cpu-usage command output description
|
Field |
Description |
|
Unit CPU usage |
CPU usage statistics (displayed only on a centralized device) |
|
1% in last 5 seconds |
After the device boots, the system calculates and records the average CPU usage in every five seconds. This field displays the average CPU usage in the last five seconds. |
|
1% in last 1 minute |
After the device boots, the system calculates and records the average CPU usage in every one minute. This field displays the average CPU usage in the last minute. |
|
1% in last 5 minutes |
After the device boots, the system calculates and records the average CPU usage in every five minutes. This field displays the average CPU usage in the last five minutes. |
|
CPU usage info (no: idx:) |
Information of CPU usage records (no: The (no+1)th record is currently displayed. no numbers from 0, a smaller number equals a newer record. idx: index of the current record in the history record table). If only the information of the current record is displayed, no and idx are not displayed. |
|
CPU Usage Stat. Cycle |
CPU usage measurement interval, in seconds. For example, if the value is 41, it indicates that the average CPU usage during the last 41 seconds is calculated. The value range of this field is 1 to 60. |
|
CPU Usage |
Average CPU usage in a measurement interval, in percentage |
|
CPU Usage Stat. Time |
CPU usage statistics time in seconds, that is, the system time when the command is executed |
|
CPU Usage Stat. Tick |
System runtime in ticks, represented by a 64-bit hexadecimal. CPU Tick High represents the most significant 32 bits and the CPU Tick Low the least significant 32 bits. |
|
Actual Stat. Cycle |
Actual CPU usage measurement interval in ticks, represented by a 64-bit hexadecimal. CPU Tick High represents the most significant 32 bits and the CPU Tick Low the least significant 32 bits. Owing to the precision of less than one second, the actual measurement periods of different CPU usage records may differ slightly. |
|
TaskName |
Task name |
|
CPU |
Average CPU usage of the current task in a measurement interval |
|
Runtime(CPU Tick High/CPU Tick Low) |
Running time of the current task |
Syntax
display cpu-usage history [ task task-id ]
View
Any view
Default Level
1: Monitor level
Parameters
task task-id: Displays the history statistics of the CPU usage of a task, where task-id represents the task number.
Description
Use the display cpu-usage history command to display the history statistics of the CPU usage in a chart. If no argument is specified, the CPU usage of the whole system is displayed for a centralized device, and the CPU usage of the active board is displayed for a distributed device.
The system takes statistics of the CPU usage at an interval and saves the statistical results in the history record area. You can use the display cpu-usage history command to display the last 60 CPU usage statistics records. The statistical results are displayed through geographical coordinates. In the output information:
l Latitude indicates the CPU usage, which is displayed based on the step. For example, if the step of the CPU usage is 5%, then the actual statistics value 53% is displayed as 55%, and actual statistics value 52% is displayed as 50%.
l Longitude indicates the time.
l Consecutive pond marks (#) indicate the CPU usage at a certain moment. The value of the latitude corresponding to the # mark on the top of a moment is the CPU usage at this moment.
Examples
# Display the CPU usage statistics of the whole system.
<Sysname> display cpu-usage history
100%|
95%|
90%|
85%|
80%|
75%|
70%|
65%|
60%|
55%|
50%|
45%|
40%|
35%|
30%|
25%|
20%|
15%| #
10%| ### #
5%| ########
------------------------------------------------------------
10 20 30 40 50 60 (minutes)
cpu-usage last 60 minutes(SYSTEM)
The above output information indicates the CPU usage of the whole system in the last 60 minutes: 5% in the twelfth minute, 10% in the thirteenth minute, 15% in the fourteenth minute, 10% in the fifteenth minute, 5% in the sixteenth and seventeenth minute, 10% in the eighteenth minute, 5% in the nineteenth minute, and 2% or lower than 2% at other times.
# Display the CPU usage statistics of task 6.
<Sysname> display cpu-usage history task 6
100%|
95%|
90%|
85%|
80%|
75%|
70%|
65%|
60%|
55%|
50%|
45%|
40%|
35%|
30%|
25%|
20%|
15%|
10%|
5%| #
------------------------------------------------------------
10 20 30 40 50 60 (minutes)
cpu-usage last 60 minutes(T03M)
The above output information indicates the CPU usage of task 6 (with the task name T03M) in the last 60 minutes: 5% in the twentieth minute, and 2% or lower than 2% at other times.
Syntax
display device [ subslot subslot-number | verbose ]
View
Any view
Default Level
2: System level
Parameters
subslot subslot-number: Displays detailed information of the specified subboard. The subslot-number represents the subslot of a subboard and the value range varies with devices.
verbose: Displays detailed information.
Description
Use the display device command to display information about storage media such as board.
Examples
# Display brief information of boards. (The displayed information varies with devices.)
<Sysname> display device
SubSNo PortNum PCBVer FPGAVer CPLDVer BootwareVer AddrLM Type State
0 2 REV.A NULL 003 1.06 IVL MAIN Normal
1 4 REV.A NULL 003 1.06 IVL SUB Normal
Syntax
display device manuinfo
View
Any view
Default Level
3: Manage level
Parameters
None
Description
Use the display device manuinfo command to display electrical label information about the device.
Electrical label information is also called permanent configuration data or archive information, which is written to the storage device of a board during debugging or test of a board or device. The information includes name of the board, device serial number, and vendor name. This command displays part of the electrical label information of the device.
Examples
# Display electrical label information of a centralized device.
<Sysname> display device manuinfo
DEVICE_NAME : S3600-2P-OLT
DEVICE_SERIAL_NUMBER : DPPMWWB123456
MAC_ADDRESS : 303030462D45
MANUFACTURING_DATE : 2008-08-08
Table 2-2 display device manuinfo command output description
|
Field |
Description |
|
DEVICE_NAME |
Device name |
|
DEVICE_SERIAL_NUMBER |
Device serial number |
|
MAC_ADDRESS |
MAC address of the device |
|
MANUFACTURING_DATE |
Manufacturing date of the device |
|
VENDOR_NAME |
Vendor name |
Syntax
display fan fan-id
View
Any view
Default Level
1: Monitor level
Parameters
fan-id: Displays the operating state of the specified fan, where fan-id represents the built-in fan number.
Description
Use the display fan command to display the operating state of built-in fans.
Examples
# Display the operating state of all fans in a device.
<Sysname> display fan
FAN : 1
State : Normal
The above information displays all fans work normally.
Syntax
display memory
View
Any view
Default Level
1: Monitor level
Parameters
slot slot-number: Specifies the slot number of a board. The value range varies with devices.
cpu cpu-number: Displays the memory of a specified CPU, where cpu-number represents the ID of the CPU. Support for the cpu-id argument depends on the device model.
Description
Use the display memory command to display the usage of the memory of all or specified boards of a device.
Examples
# Display the usage of the memory of a device.
<Sysname> display memory
System Total Memory(bytes): 158592960
Total Used Memory(bytes): 64651456
Used Rate: 40%
Table 2-3 display memory command output description
|
Field |
Description |
|
System Total Memory(bytes) |
Total size of the system memory (in bytes) |
|
Total Used Memory(bytes) |
Size of the memory used (in bytes) |
|
Used Rate |
Percentage of the memory used to the total memory |
Syntax
display power [ power-id ]
View
Any view
Default Level
1: Monitor level
Parameters
power-id: Displays the status of the specified power supply unit (PSU), where power-id represents the PSU number. The value varies with devices.
Description
Use the display power command to display the status of the power supply of a device.
Examples
# Display the status of the power supply of a device (The displayed information varies with devices).
<Sysname> display power
Power : 1
State : Normal
Syntax
display reboot-type
View
Any view
Default Level
2: System level
Parameters
None
Description
Use the display reboot-type command to display the reboot type of a board or subboard.
Examples
# Display the reboot type of the board in subslot 2 of the device.
<Sysname> display reboot-type subslot 2
The rebooting type this time is: Cold
The above information indicates that the last reboot type of the device is Cold boot. (If it is displayed as Warm, it indicates the reboot type is ware boot).
Syntax
display schedule job
View
Any view
Default Level
1: Monitor level
Parameters
None
Description
Use the display schedule job command to display the detailed configurations of the scheduled automatic execution function.
Examples
# Display the detailed configurations of the current scheduled automatic execution function.
<Sysname> display schedule job
Specified command: execute 1.bat
Specified view: system view
Executed time: at 12:00 10/31/2007 (in 0 hours and 16 minutes)
If you modify the system time within 16 minutes, the configurations of scheduled automatic execution of the batch file will become invalid, and then when you execute the display schedule job command again, the system displays nothing.
Syntax
display schedule reboot
View
Any view
Default Level
3: Manage level
Parameters
None
Description
Use the display schedule reboot command to display the device reboot time set by the user.
Related commands: schedule reboot at and schedule reboot delay.
Examples
# Display the reboot time of a device.
<Sysname> display schedule reboot
System will reboot at 16:00:00 03/10/2006 (in 2 hours and 5 minutes).
The above information indicates the system will reboot at 16:00:00 on March 10, 2006 (in two hours and five minutes).
Syntax
display system-failure
View
Any view
Default Level
0: Visit level
Parameters
None
Description
Use the display system-failure command to display the exception handling method.
Examples
# Display the exception handling method.
<Sysname> display system-failure
System failure handling method: reboot
Syntax
reboot
View
User view
Default Level
2: System level
Parameters
None
Description
Use the reboot command to reboot a board, a subboard, or the whole system.
l Device reboot may result in the interruption of the ongoing services. Use these commands with caution.
l If a main boot file fails or does not exist, the device cannot be rebooted with this command. In this case, you can re-specify a main boot file to reboot the device, or you can power off the device, then power it on and the system automatically uses the backup boot file to restart the device.
l If you are performing file operations when the device is to be rebooted, the system does not execute the command for the sake of security.
Examples
# If the current configuration does not change, reboot the device.
<Sysname> reboot
Start to check configuration with next startup configuration file, please wait.........DONE!
This command will reboot the device. Continue? [Y/N]:y
Starting......
# If the current configuration changes, reboot the device.
<Sysname> reboot
Start to check configuration with next startup configuration file, please wait.........DONE!
This command will reboot the device. Current configuration will be lost in next startup if you continue. Continue? [Y/N]:y
Starting......
Syntax
reboot onu
View
ONU port view
Default Level
2: System level
Parameters
None
Description
Use the reboot onu command to restart the ONU.
Before using this command, make sure the ONU is online.
Examples
# Restart ONU 1/0/1:1.
<Sysname> system-view
[Sysname] interface onu 1/0/1:1
[Sysname-Onu1/0/1:1] reboot onu
Syntax
reset unused porttag
View
User view
Default Level
1: Monitor level
Parameters
None
Description
Use the reset unused porttag command to clear the 16-bit index saved but not used in the current system.
A confirmation is required when you carry out this command. If you fail to make a confirmation within 30 seconds or enter “N” to cancel the operation, the command will not be carried out.
Examples
# Clear the 16-bit index saved but not used in the current system.
<Sysname> reset unused porttag
Current operation will delete all unused port tag(s). Continue? [Y/N]:y
<Sysname>
Syntax
schedule job { at time1 [ date ] | delay time2 } view view command
undo schedule job
View
User view
Default Level
3: Manage level
Parameters
at time1 [ date ]: Specifies the execution time of a specified command.
l time1: Execution time of the command, in the format of hh:mm (hour/minute). The hh value ranges from 0 to 23, and the mm value ranges from 0 to 59. The value of hh:mm cannot exceed 23:59.
l date: Execution date of the command, in the format of MM/DD/YYYY (month/day/year) or YYYY/MM/DD (year/month/day). The YYYY value ranges from 2000 to 2035, the MM value ranges from 1 to 12, and the DD value range depends on a specific month.
delay time2: Specifies the execution waiting time of a specified command. time2 represents the waiting time, which can be in the following format:
l hh:mm (hour/minute): The hh value ranges from 0 to 720, and the mm value ranges from 0 to 59. The value of hh:mm cannot exceed 720:00.
l mm (minute): It ranges from 0 to 432000, with 0 indicating that a command is executed immediately without any delay.
view view: Specifies the view in which a command is executed. view represents the view name, and it takes the following values at present:
l shell, represents user view.
l system, represents system view.
command: The command string to be automatically executed at the scheduled time.
Description
Use the schedule job command to automatically execute a specified command at the scheduled time.
Use the undo schedule job command to remove the configuration.
Note the following:
l If you provide both the time1 and date arguments, the execution time must be a future time.
l If you only provide the time1 argument, when time1 is earlier than the current system time, the specified command is executed at time1 of the next day; when time1 is later than the current system time, the specified command is executed at time1 of the current day.
l No matter whether you use the at or delay keyword, the difference between the execution time of a command and the current system time cannot exceed 720 hours (namely, 30 days).
l At present, you can specify only user view and system view. To automatically execute the specified commands in other views or automatically execute multiple commands at a time, you can configure the system to automatically execute a batch file at a specified time (note that you must provide a complete file path for the system to execute the batch file.).
l The system does not check the view and command arguments. Therefore, ensure the correctness of the command argument (including the correct format of command and the correct relationship between the command and view arguments.).
l After the specified automatic execution time is reached, the system executes the specified commands without displaying any information except system information such as log, trap and debug.
l When the system is executing the specified command, you do not need to input any information. If there is information for you to confirm, the system automatically inputs Y or Yes; if certain characters need to be input, the system automatically inputs a default character string, and inputs an empty character string when there is no default character string.
l For the commands used to switch user interfaces, such as telnet, ftp, and ssh2, the commands used to switch views, such as system-view, quit and interface ethernet, and the commands used to modify status of the user that is executing commands, such as super, the operation interface, command view and status of the current user are not changed after the automatic execution function is performed.
l If you modify the system time after the automatic execution function is configured, the scheduled automatic execution configuration turns invalid automatically.
l Only the latest configuration takes effect if you execute the schedule job command repeatedly.
Examples
# Configure that the device will execute the batch file 1.bat in system view in 60 minutes (supposing that the current time is 11:43).
<Sysname> schedule job delay 60 view system execute 1.bat
Info: Command execute 1.bat in system view will be executed at 12:43 10/31/2007 (in 1 hours and 0 minutes).
# Configure that the device will execute the batch file 1.bat in system view at 12:00 in the current day (supposing that the current time is 11:43).
<Sysname> schedule job at 12:00 view system execute 1.bat
Info: Command execute 1.bat in system view will be executed at 12:00 10/31/2007 (in 0 hours and 16 minutes).
Syntax
schedule reboot at hh:mm [ date ]
undo schedule reboot
View
User view
Default Level
3: Manage level
Parameters
hh:mm: Reboot time of a device, in the format of hh:mm (hours:minutes). The value of the hh argument ranges from 0 to 23, and the value of the mm argument ranges from 0 to 59.
date: Reboot date of a device, in the format mm/dd/yyyy (month/day/year) or in the format yyyy/mm/dd (year/month/day) The yyyy value ranges from 2000 to 2035, the mm value ranges from 1 to 12, and the dd value depends on a specific month.
Description
Use the schedule reboot at command to enable the scheduled reboot function and specify a specific reboot time and date.
Use the undo schedule reboot command to disable the scheduled reboot function.
By default, the scheduled reboot function is disabled.
There are two cases if no specific reboot date is specified:
l When the specified reboot time is later than the current time, the device will be rebooted at the reboot time of the current day.
l When the specified reboot time is earlier than the current time, the device will be rebooted at the reboot time the next day.
l If you are performing file operations when the device is to be rebooted, the system does not execute the command for the sake of security.
Note that:
l The precision of the device timer is 1 minute. One minute before the reboot time, the device will prompt “REBOOT IN ONE MINUTE” and will be rebooted in one minute.
l The difference between the reboot date and the current date cannot exceed 30 x 24 hours (namely, 30 days).
l After you execute the above command, the device will prompt you to confirm the configuration. You must enter <Y> or <y> to make the configuration take effect. The original configuration will be overwritten at the same time.
l If a date (month/day/year or year/month/day) later than the current date is specified for the schedule reboot at command, the device will be rebooted at the reboot time.
l If you use the clock command after the schedule reboot at command to adjust the system time, the reboot time set by the schedule reboot at command will become invalid.
This command reboots the device in a future time, thus resulting in service interruption. Please use it with caution.
Examples
# Configure the device to reboot at 12:00 AM (supposing that the current time is 11:43).
<Sysname> schedule reboot at 12:00
Reboot system at 12:00 06/06/2006(in 0 hour(s) and 16 minute(s))
confirm? [Y/N]:
# If you have used the terminal logging command to enable the log display function on the terminal before setting a reboot time, the system will automatically display related log information after you enter <y>. By default, the log display function is enabled.
<Sysname>
%Jun 6 11:43:11:629 2006 Sysname CMD/5/REBOOT:
vty0(192.168.1.54): Set schedule reboot parameters at 11:43:11 06/06/2006, and system will reboot at 12:00 06/06/2006.
Syntax
schedule reboot delay { hh:mm | mm }
undo schedule reboot
View
User view
Default Level
3: Manage level
Parameters
hh:mm: Device reboot wait time, in the format of hh:mm (hours:minutes). The value of the hh argument ranges from 0 to 720, and the value of the mm argument ranges from 0 to 59, and the value of the hh:mm argument cannot exceed 720:00.
mm: Device reboot wait time in minutes, in the range of 0 to 43,200.
Description
Use the schedule reboot delay command to enable the scheduled reboot function and set a reboot wait time.
Use the undo schedule reboot command to disable the scheduled reboot function.
By default, the scheduled reboot function is disabled.
Note that:
l The reboot wait time can be in the format of hh:mm (hours:minutes) or mm (absolute minutes). The absolute minutes cannot exceed 30 x 24 x 60 minutes, namely, 30 days.
l The precision of the device timer is 1 minute. One minute before the reboot time, the device will prompt “REBOOT IN ONE MINUTE” and will be rebooted in one minute.
l After you execute the above command, the device will prompt you to confirm the configuration. You must enter <Y> or <y> to make the configuration take effect. The original configuration will be overwritten at the same time.
l If you use the clock command after the schedule reboot delay command to adjust the system time, the reboot wait time set by the schedule reboot delay command will become invalid.
l If you are performing file operations when the device is to be rebooted, the system does not execute the command for the sake of security.
This command reboots the device after the specified delay time, thus resulting in service interruption. Please use it with caution.
Examples
# Configure the device to reboot in 88 minutes (supposing the current time is 11:48).
<Sysname> schedule reboot delay 88
Reboot system at 13:16 06/06/2006 in 1 hour(s) and 28 minute(s))
confirm? [Y/N]:
# If you have used the terminal logging command to enable the log display function on the terminal before setting a reboot time, the system will automatically display related log information after you enter <y>. By default, the log display function is enabled on the terminal.
<Sysname>
%Jun 6 11:48:44:860 2006 Sysname CMD/5/REBOOT:
vty0(192.168.1.54): Set schedule reboot parameters at 11:48:44 06/06/2006, and system will reboot at 13:16 06/06/2006.
Syntax
shutdown-interval time
undo shutdown-interval
View
System view
Default Level
2: System level
Parameters
time: Detection interval in seconds, in the range of 1 to 300.
Description
Use the shutdown-interval command to set a detection interval.
Use the undo shutdown-interval command to restore the default.
By default, the detection interval is 30 seconds.
Note that:
l Support for this command depends on the device model.
l If a protocol module such as the operation, administration and maintenance (OAM) module detects an exception on a port (for example, signal loss of the link on the peer end), the port will be closed automatically, without execution of the shutdown command. You can set the automatic recovery time of the port by using the shutdown-interval command.
l The shutdown-interval command helps you to dynamically set a detection interval to cooperate with the OAM module.
l If you change the detection interval to T1 during interface detection, the interval from when you change the interval to the time when detection starts is T. If T<T1, the interface which is down will be brought up after T1-T time; if T>=T1, the interface which is down will be brought up immediately.
Examples
# Set the detection interval to 100 seconds.
<Sysname> system-view
[Sysname] shutdown-interval 100
Syntax
system-failure { maintain | reboot }
undo system-failure { maintain | reboot }
View
System view
Default Level
0: Visit level
Parameters
maintain: Specifies that when the system detects any software abnormality, it maintains the current situation, and does not take any measure to recover itself.
reboot: Specifies that when the system detects any software abnormality, it recovers itself through automatic reboot.
Description
Use the system-failure command to configure the exception handling method.
By default, the system adopts the reboot method to handle exceptions.
This configuration is effective for centralized devices and the main boards of distributed devices. For the interface boards of distributed devices and systems using the operation, administration, and maintenance (OAM) CPUs, if software abnormality occurs, the system adopts the reboot method to handle exceptions.
Examples
# Set the exception handling method to maintain.
<Sysname> system-view
[Sysname] system-failure maintain
Change the system failure handling method from reboot to maintain. Continue? [Y/N]: y
Syntax
update onu filename file-url
undo update onu
View
OLT port view, ONU port view
Default Level
2: System level
Parameters
file-url: Update file name, a string of 1 to 64 characters composed of the device name and the ONU update file name. If no device name is specified, it is the name of the Flash of the SRPU. The files in the salve SRPU cannot be used for the update.
Description
Use the update onu filename command to remotely update ONU(s) by using the update file stored on the OLT.
Use the undo update onu command to cancel the remote ONU update configuration.
l Executing this command in OLT port view will update all the ONUs corresponding to the created ONUs under the OLT port.
l Executing this command in ONU port view will update the ONU corresponding to the ONU port.
Note that this is a configuration command. After it is configured in OLT port view or ONU port view, the update command will be executed on the corresponding ONU port:
l If the ONU corresponding to the ONU port is online and matches the update file, the ONU is updated directly.
l If the ONU corresponding to the ONU port is online but does not match the update file, the ONU cannot be updated.
l If the ONU corresponding to the ONU port is not online (because the ONU port is not bound with any ONU or the extended OAM connection fails on the bound ONU), the update process will not start until the ONU goes online.
l After the update command is issued, the OLT will wait 15 to 20 seconds before executing the command. This allows for batch updating and saves system resources.
l Any power failure during the ONU software upgrade may cause update failure.
l Once the update file is transferred to the ONU, the ONU restarts automatically to complete the update.
Examples
# Update an ONU.
<Sysname> system-view
[Sysname] interface onu 3/0/1:1
[Sysname-Onu3/0/1:1] update onu filename file.app
Update flash:/file.app?[Y/N]
# To start the upgrade, enter Y; to abort, enter N. The following example shows the output after you enter Y.
Info: Download file to onu may take a long time, please wait...
Please wait while the firmware is being burnt, and check the software version after re-registration!
Syntax
update onu onu-type onu-type filename file-url
undo update onu onu-type onu-type
View
FTTH view
Default Level
2: System level
Parameters
onu-type: ONU type, a string of 1 to 16 case-insensitive characters, such as ET704-A and ET704-A-L.
file-url: Update file name, a string of 1 to 64 characters composed of the device name and the ONU update file name. If no device name is specified, it is the name of the Flash of the SRPU. The files in the salve SRPU cannot be used for the update.
Description
Use the update onu onu-type command to update ONUs by type.
Use the undo update onu onu-type command to cancel ONU update configuration by type.
Note that this is a configuration command. It takes effect only on the specified type of ONUs on which no update command is configured under the ONU port.
l If the ONU is online and matches the specified update file, the ONU is updated directly.
l If the ONU is online but does not match the update file, the update will fail.
l If the ONU is not online (because the ONU port is not bound with any ONU or the extended OAM connection fails on the bound ONU), the update process will not start until the ONU goes online.
Updating ONUs by type is recommended because it is efficient and easy-to-use.
l After the update command is issued, the OLT will wait 15 to 20 seconds before executing the command. This allows for batch updating and saves system resources.
l The update configuration performed in port view takes precedence over that in FTTH view. For example, assume the ONU corresponding to ONU port ONU 1/0/1:1 is of type A. If you configure the update file for type A ONUs as 1.app in FTTH view and configure the update file as 2.app in ONU 1/0/1:1 port view, 2.app will be used to update the ONU.
l Any power failure during the ONU software upgrade may cause update failure.
l Once the update file is transferred to the ONU, the ONU restarts automatically to complete the update.
l An OLT can update up to 64 types of ONUs at the same time. That is, update files can be specified for up to 64 types of ONUs at the same time through the command line for updating ONUs by type.
l The update onu onu-type command is a configuration command, that is, after the update onu onu-type command is executed, it will be saved in the configuration file of the device. If the ONU port corresponding to an ONU that goes online is created before the update command is used, the ONU will be updated directly (if it matches the update files). Otherwise, the ONU will not be updated. To update only the current ONUs online but not the offline ONUs or subsequently registered ONUs, execute the update onu onu-type command, and use the undo update onu onu-type command after you make sure that all online ONUs have been updated.
Examples
# Update all the ET704-A-L ONUs under the switch.
<Sysname> system-view
[Sysname] ftth
[Sysname-ftth] update onu onu-type et704-a-l filename file.app
After the command is executed, the OLT starts updating all the ET704-A-L ONUs on which no update command is configured under the ONU port.
Syntax
ping [ ip ] [ -a source-ip | -c count | -f | -h ttl | -i interface-type interface-number | -m interval | -n | -p pad | -q | -r | -s packet-size | -t timeout | -tos tos | -v ] * remote-system
View
Any view
Default Level
0: Visit level
Parameters
ip: Supports IPv4 protocol.
-a source-ip: Specifies the source IP address of an ICMP echo request (ECHO-REQUEST). It must be a legal IP address configured on the device.
-c count: Specifies the number of times that an ICMP echo request is sent, in the range 1 to 4294967295. The default value is 5.
-f: Discards packets larger than the MTU of a given interface, that is, the ICMP echo request is not allowed to be fragmented.
-h ttl: Specifies the TTL value for an ICMP echo request, in the range 1 to 255. The default value is 255.
-i interface-type interface-number: Specifies the ICMP echo request sending interface by its type and number.
-m interval: Specifies the interval (in milliseconds) to send an ICMP echo response, in the range 1 to 65535. The default value is 200 ms.
l If a response from the destination is received within the timeout time, the interval to send the next echo request equals the actual response period plus the value of interval.
l If no response from the destination is received within the timeout time, the interval to send the next echo request equals the timeout value plus the value of interval.
-n: Specifies that the Domain Name System (DNS) is disabled. DNS is enabled by default, that is, the hostname is translated into an address.
-p pad: Specifies the value of the pad field in an ICMP echo request, in hexadecimal format, 1 to 8 bits, in the range 0 to ffffffff. If the specified value is less than 8 bits, 0s will be added in front of the value to extend it to 8 bits. For example, if pad is configured as 0x2f, then the packets will be padded with 0x0000002f repeatedly to make the total length of the packet meet the requirements of the device. By default, the padded value starts from 0x01 up to 0xff, where another round starts again if necessary, like 0x010203…feff01….
-q: Presence of this parameter indicates that only statistics are displayed. By default, all information is displayed.
-r: Records routes. By default, routes are not recorded.
-s packet-size: Specifies length (in bytes) of an ICMP echo request, in the range 20 to 8100. The default value is 56.
-t timeout: Specifies the timeout value (in milliseconds) of an ICMP echo reply (ECHO-REPLY), in the range 0 to 65535. It defaults to 2000.
-tos tos: Specifies type of service (ToS) of an echo request, in the range 0 to 255. The default value is 0.
-v: Displays non ICMP echo reply received. By default, the system does not display non ICMP echo reply.
remote-system: IP address or host name (a string of 1 to 20 characters) of the destination device.
Description
Use the ping command to verify whether the destination device in an IP network is reachable, and to display the related statistics.
Note that:
l You must use the command in the form of ping ip ip instead of ping ip if the destination name is a key word, such as ip.
l Only the directly connected segment address can be pinged if the outgoing interface is specified with the -i argument.
During the execution of the command, you can press Ctrl+C to abort the ping operation.
Examples
# Check whether the device with an IP address of 10.1.1.5 is reachable.
<Sysname> ping 10.1.1.5
PING 10.1.1.5 : 56 data bytes, press CTRL_C to break
Reply from 10.1.1.5 : bytes=56 Sequence=1 ttl=255 time=1 ms
Reply from 10.1.1.5 : bytes=56 Sequence=2 ttl=255 time=2 ms
Reply from 10.1.1.5 : bytes=56 Sequence=3 ttl=255 time=1 ms
Reply from 10.1.1.5 : bytes=56 Sequence=4 ttl=255 time=3 ms
Reply from 10.1.1.5 : bytes=56 Sequence=5 ttl=255 time=2 ms
--- 10.1.1.5 ping statistics ---
5 packet(s) transmitted
5 packet(s) received
0.00% packet loss
round-trip min/avg/max = 1/2/3 ms
The above information indicates the following:
l The destination host was reachable
l All probe packets sent by the source device got responses
l The minimum time, average time, and maximum time for the packet’s roundtrip time are 1 ms, 2 ms, and 3 ms respectively
# Check whether the device with an IP address of 3.3.3.2 is reachable. Only the check results are displayed.
<Sysname> ping -q 3.3.3.2
PING 3.3.3.2: 56 data bytes, press CTRL_C to break
--- 3.3.3.2 ping statistics ---
5 packet(s) transmitted
5 packet(s) received
0.00% packet loss
round-trip min/avg/max = 1/1/1 ms
# Check whether the device with an IP address of 3.3.3.2 is reachable. The route information is required to be displayed.
<Sysname> ping -r 3.3.3.2
PING 3.3.3.2: 56 data bytes, press CTRL_C to break
Reply from 3.3.3.2: bytes=56 Sequence=1 ttl=255 time=2 ms
Record Route:
3.3.3.2
3.3.3.1
Reply from 3.3.3.2: bytes=56 Sequence=2 ttl=255 time=1 ms
Record Route:
3.3.3.2
3.3.3.1
Reply from 3.3.3.2: bytes=56 Sequence=3 ttl=255 time=1 ms
Record Route:
3.3.3.2
3.3.3.1
Reply from 3.3.3.2: bytes=56 Sequence=4 ttl=255 time=2 ms
Record Route:
3.3.3.2
3.3.3.1
Reply from 3.3.3.2: bytes=56 Sequence=5 ttl=255 time=1 ms
Record Route:
3.3.3.2
3.3.3.1
--- 3.3.3.2 ping statistics ---
5 packet(s) transmitted
5 packet(s) received
0.00% packet loss
round-trip min/avg/max = 1/1/2 ms
The above information indicates the following:
l The destination host was reachable
l The IP address 3.3.3.1 was reached first, and then 3.3.3.2.
Table 3-1 ping command output description
|
Field |
Description |
|
PING 10.1.1.5 |
Check whether the device with IP address 10.1.1.5 is reachable |
|
56 data bytes |
Number of data bytes in the ICMP echo request |
|
press CTRL_C to break |
During the execution of the command, you can press Ctrl+C to abort the ping operation. |
|
Reply from 10.1.1.5 : bytes=56 Sequence=1 ttl=255 time=1 ms |
Received the ICMP reply from the device whose IP address is 10.1.1.5. If no reply is received during the timeout period, “Request time out” will be displayed. l bytes= indicates the number of data bytes in the ICMP reply. l Sequence= indicates the packet sequence. l ttl= indicates the TTL value in the ICMP reply. l time= indicates the response time. |
|
Record Route: |
The routers through which the ICMP echo request passed. They are displayed in inversed order, that is, the router with a smaller distance to the destination is displayed first. |
|
--- 10.1.1.5 ping statistics --- |
Statistics on data received and sent in the ping operation |
|
5 packet(s) transmitted |
Number of ICMP echo requests sent |
|
5 packet(s) received |
Number of ICMP echo requests received |
|
0.00% packet loss |
Percentage of packets not responded to the total packets sent |
|
round-trip min/avg/max = 0/4/20 ms |
Minimum/average/maximum response time, in ms |
Syntax
tracert [ -a source-ip | -f first-ttl | -m max-ttl | -p port | -q packet-number | -w timeout ] * remote-system
View
Any view
Default Level
0: Visit level
Parameters
-a source-ip: Specifies the source IP address of a tracert packet. It must be a legal IP address configured on the device.
-f first-ttl: Specifies the first TTL, that is, the allowed number of hops for the first packet, in the range 1 to 255. It defaults to 1 and must be less than the maximum TTL.
-m max-ttl: Specifies the maximum TTL, that is, the maximum allowed number of hops for a packet, in the range 1 to 255. It defaults to 30, and must be greater than the first TTL.
-p port: Specifies the UDP port number of the destination device, in the range 1 to 65535. The default value is 33434. You do not need to modify this parameter.
-q packet-number: Specifies the number of probe packets sent each time, in the range 1 to 65535. The default value is 3.
-w timeout: Specifies the timeout time of the reply packet of a probe packet, in the range 1 to 65535, in milliseconds. The default value is 5000 ms.
remote-system: IP address or host name (a string of 1 to 20 characters) of the destination device.
Description
Use the tracert command to trace the path the packets traverse from the source to the destination device.
After having identified network failure with the ping command, you can use the tracert command to determine the failed node(s).
Output information of the tracert command includes IP addresses of all the Layer 3 devices the packets traverse from the source to the destination device. If a device times out, "* * *" will be displayed.
During the execution of the command, you can press Ctrl+C to abort the tracert operation.
Examples
# Display the path the packets traverse from the source device to the destination device with an IP address of 18.26.0.115.
<Sysname> tracert 18.26.0.115
traceroute to 18.26.0.115(18.26.0.115) 30 hops max,40 bytes packet, press CTRL_C to break
1 128.3.112.1 10 ms 10 ms 10 ms
2 128.32.210.1 19 ms 19 ms 19 ms
3 128.32.216.1 39 ms 19 ms 19 ms
4 128.32.136.23 19 ms 39 ms 39 ms
5 128.32.168.22 20 ms 39 ms 39 ms
6 128.32.197.4 59 ms 119 ms 39 ms
7 131.119.2.5 59 ms 59 ms 39 ms
8 129.140.70.13 80 ms 79 ms 99 ms
9 129.140.71.6 139 ms 139 ms 159 ms
10 129.140.81.7 199 ms 180 ms 300 ms
11 129.140.72.17 300 ms 239 ms 239 ms
12 * * *
13 128.121.54.72 259 ms 499 ms 279 ms
14 * * *
15 * * *
16 * * *
17 * * *
18 18.26.0.115 339 ms 279 ms 279 ms
Table 3-2 tracert command output description
|
Field |
Description |
|
traceroute to 18.26.0.115(18.26.0.115) |
Display the route the IP packets traverse from the current device to the device whose IP address is 18.26.0.115. |
|
30 hops max |
Maximum number of hops of the probe packets, which can be set through the -m keyword |
|
60 bytes packet |
Number of bytes of a probe packet |
|
press CTRL_C to break |
During the execution of the command, you can press Ctrl+C to abort the tracert operation. |
|
1 128.3.112.1 10 ms 10 ms 10 ms |
The probe result of the probe packets whose TTL is 1, including the IP address of the device and the roundtrip time of three probe packets. The number of packets that can be sent in each probe can be set through the -q keyword. |
|
12 * * * |
The probe result of the probe packets whose TTL is 12. The result is: timeout |
Syntax
debugging { all [ timeout time ] | module-name [ option ] }
undo debugging { all | module-name [ option ] }
View
User view
Default Level
1: Monitor level
Parameters
all: All debugging functions.
timeout time: Specifies the timeout time for the debugging all command. When all debugging is enabled, the system automatically executes the undo debugging all command after the time. The value ranges from 1 to 1440, in minutes.
module-name: Module name, such as arp or device. You can use the debugging ? command to display the current module name.
option: The debugging option for a specific module. Different modules have different debugging options in terms of their number and content. You can use the debugging module-name ? command to display the currently supported options.
Description
Use the debugging command to enable the debugging of a specific module.
Use the undo debugging command to disable the debugging of a specific module.
By default, debugging functions of all modules are disabled.
Note the following:
l Output of the debugging information may degrade system efficiency, so you are recommended to enable the debugging of a specific module for diagnosing network failure, and not to enable the debugging of multiple modules at the same time.
l Default Level describes the default level of the debugging all command. Different debugging commands may have different default levels.
l You must configure the debugging, terminal debugging and terminal monitor commands first to display detailed debugging information on the terminal. For the detailed description on the terminal debugging and terminal monitor commands, refer to Information Center Commands in the System Volume.
Related commands: display debugging.
Examples
# Enable IP packet debugging.
<Sysname> debugging ip packet
Syntax
display debugging [ interface interface-type interface-number ] [ module-name ]
View
Any view
Default Level
1: Monitor level
Parameters
interface interface-type interface-number: Displays the debugging settings of the specified interface, where interface-type interface-number represents the interface type and number.
module-name: Module name.
Description
Use the display debugging command to display enabled debugging functions.
Related commands: debugging.
Examples
# Display all enabled debugging functions.
<Sysname> display debugging
Syntax
display patch information
View
Any view
Default Level
3: Manage level
Parameters
None
Description
Use the display patch information command to display the hotfix information on the specified board.
Examples
# Display hotfix information on a centralized device.
<Sysname> display patch information
The location of patches: flash:
Slot Version Temporaty Common Current Active Running Start-Address
----------------------------------------------------------------------
0 RPE004 0 1 1 0 1 0x310bd74
Table 4-1 display patch information command output description
|
Field |
Description |
|
The location of patches |
Path to the source patch files. You can configure it using the patch location command. |
|
Version |
Patch version. If no patch is installed, the flag suffix of the patch is displayed. For example, if the flag of the patch for a board is PATCH-RPE, "RPE" is displayed. |
|
Temporary |
Number of temporary patches |
|
Common |
Number of common patches |
|
Current |
Total number of patches |
|
Running |
Number of patches in the RUNNING state |
|
Active |
Number of patches in the ACTIVE state |
|
Start-Address |
Starting address of the patch area |
Syntax
patch active patch-number
View
System view
Default Level
3: Manage level
Parameters
patch-number: Sequence number of a patch. The valid values of this argument depend on the patch file used.
slot slot-number: Specifies a board by its slot number. The value range of this argument varies with the device model.
Description
Use the patch active command to activate the specified patch, namely, the system will run the patch functions instead of the original functions, and all the DEACTIVE patches before the specified patch number are activated.
After a system reboot, the original ACTIVE patches change to DEACTIVE, and become invalid. To make them effective, you need to activate them again.
Examples
# Activate patch 3 and all the DEACTIVE patches before patch 3 on board 5.
<Sysname> system-view
[Sysname] patch active 3 slot 5
Syntax
patch deactive patch-number
View
System view
Default Level
3: Manage level
Parameters
patch-number: Sequence number of a patch. The valid values of this argument depend on the patch file used.
Description
Use the patch deactive command to deactivate the specified patch and all the ACTIVE patches after the specified patch number, and the system will run at the original software version.
This command is not applicable to the patches in the RUNNING state.
Examples
# Deactivate patch 3 and all the ACTIVE patches after patch 3 on board 5.
<Sysname> system-view
[Sysname] patch deactive 3 slot 5
Syntax
patch delete patch-number
View
System view
Default Level
3: Manage level
Parameters
patch-number: Sequence number of a patch. The valid values of this argument depend on the patch file used.
Description
Use the patch delete command to delete the specified patch and all the patches after the specified patch number.
Examples
# Delete patch 3 and all the patches after patch 3 on board 5.
<Sysname> system-view
[Sysname] patch delete 3 slot 5
Syntax
patch install patch-file
undo patch install
View
System view
Default Level
3: Manage level
Parameters
patch-file: A string consisting of 1 to 64 characters. It specifies the directory where the patch file locates. The file must be under the root directory of a storage medium. If the storage medium is a CF card with partitions, the patch files must be under the root directory of the first partition.
Description
Use the patch install command to install all the patches in one step.
Use the undo patch install to remove the patches.
After you execute the patch install command, a message "Do you want to continue running patches after reboot? [Y/N]:" is displayed.
l Entering y or Y: All the patches are installed, and turn to the RUNNING state from IDLE. This equals execution of the commands patch load, patch active, and patch run. The patches remain RUNNING after system reboot.
l Entering n or N: All the patches are installed and turn to the ACTIVE state from IDLE. This equals execution of the commands patch load and patch active. The patches turn to the DEACTIVE state after system reboot.
Note that the patch install command changes the patch file location specified with the patch location command to the directory specified by the patch-file argument of the patch install command.. For example, if you execute the patch location xxx command and then the patch install yyy command, the patch file location automatically changes from xxx to yyy.
Examples
# Specify the directory for the source patch files to the Flash, and run the patches.
<Sysname> system-view
[Sysname] patch-install flash:
Patches will be installed. Continue? [Y/N]:y
Do you want to run patches after reboot? [Y/N]:y
Installing patches…
Installation completed, and patches will continue to run after reboot.
[Sysname]
Syntax
patch load
View
System view
Default Level
3: Manage level
Parameters
slot slot-number: Specifies a board by its slot number. The value range of this argument varies with the device model.
Description
Use the patch load command to load the patch file on the Flash to the memory patch area of the system.
Examples
# Load the patch files
<Sysname> system-view
[Sysname] patch load slot 3
Syntax
patch location patch-file
View
System view
Default Level
3: Manage level
Parameters
patch-file: A string consisting of 1 to 64 characters, It can be a root directory of a storage medium or be in the format of "root directory + patch file name".
Description
Use the patch location command to configure the path to the source patch files.
By default, the path is flash:.
If you save the patch files to other storage media except the Flash on the device, you need to specify the directory where the patch files locate with the patch-file argument. Then the system loads the appropriate patch files in the specified directory.
Examples
# Configure the root directory of the CF card as the path to the source patch files.
<Sysname> system-view
[Sysname] patch location cf:
Syntax
patch run patch-number
View
System view
Default Level
3: Manage level
Parameters
patch-number: Sequence number of a patch. The valid values of this argument depend on the patch file used.
Description
Use the patch run command to confirm the running of the specified patch and all the ACTIVE patches before the specified patch number.
This operation is applicable to patches in the ACTIVE state only.
If the running of a patch is confirmed, after the system reboots, the patch will still be effective.
Examples
# Confirm the running of patch 3 and all the ACTIVE patches before patch 3.
<Sysname> system-view
[Sysname] patch run 3
