HP 5820X & 5800 Switch Series Fundamentals Command Reference Abstract This document describes the commands and command syntax options available for the HP 5820X & 5800 Series products. This document is intended for network planners, field technical support and servicing engineers, and network administrators who work with HP 5820X & 5800 Series products. Part number: 5998-1619 Software version: Release 1211 Document version: 6W102-20130520
Transcript
HP 5820X & 5800 Switch Series Fundamentals
Command Reference
Abstract
This document describes the commands and command syntax options available for the HP 5820X & 5800 Series products.
This document is intended for network planners, field technical support and servicing engineers, and network administrators who work with HP 5820X & 5800 Series products.
Part number: 5998-1619 Software version: Release 1211 Document version: 6W102-20130520
No part of this documentation may be reproduced or transmitted in any form or by any means without prior written consent of Hewlett-Packard Development Company, L.P.
The information contained herein is subject to change without notice.
HEWLETT-PACKARD COMPANY MAKES NO WARRANTY OF ANY KIND WITH REGARD TO THIS MATERIAL, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. Hewlett-Packard shall not be liable for errors contained herein or for incidental or consequential damages in connection with the furnishing, performance, or use of this material.
The only warranties for HP products and services are set forth in the express warranty statements accompanying such products and services. Nothing herein should be construed as constituting an additional warranty. HP shall not be liable for technical or editorial errors or omissions contained herein.
Support and other resources ·································································································································· 199 Contacting HP ······························································································································································ 199
Subscription service ············································································································································ 199
vii
Related information ······················································································································································ 199 Documents ···························································································································································· 199 Websites ······························································································································································ 199
Index ········································································································································································ 202
1
CLI configuration commands
command-alias enable Description
Use command-alias enable to enable the command alias function.
Use undo command-alias enable to disable the command alias function (disabled is the default condition).
Syntax
command-alias enable
undo command-alias enable
View
System view
Default level
2: System level
Parameters
None
Examples
1. Enable the command alias function. <Sysname> system-view
[Sysname] command-alias enable
2. Disable the command alias function. <Sysname> system-view
[Sysname] undo command-alias enable
command-alias mapping Description
Use command-alias mapping to configure command aliases.
Use undo command-alias mapping to restore the original configuration. By default, a command has no alias.
Syntax
command-alias mapping cmdkey alias
undo command-alias mapping cmdkey
View
System view
2
Default level
2: System level
Parameters
cmdkey: The complete form of the first keyword of a command.
alias: Specifies the command alias, which cannot be the same as the first keyword of an existing command.
Examples
1. Configure command aliases by specifying show as the replacement of the display keyword. <Sysname> system-view
[Sysname] command-alias mapping display show
After you configure the command aliases, the display commands have aliases. For example, if the original command is display clock, now its alias is show clock and you can input the alias to view the system time and date.
2. Delete the command aliases by canceling the replacement of the display keyword. <Sysname> system-view
[Sysname] undo command-alias mapping display
command-privilege Description
Use command-privilege to change the command privilege level in the specified view. Command levels include four privileges: visit (0), monitor (1), system (2), and manage (3).
By default, each command in a view has a specified privilege level. Changes can cause maintenance, operation, and security problems. HP recommends that you use the default command level or that you modify the command level under the guidance of professional staff.
Assign a privilege level according to the user’s need. When logging in to the switch, the user can access the assigned level and all levels below it.
• The command specified in command-privilege must be complete and have valid arguments. 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 command-privilege level 0 view shell tftp 1.1.1.1 put a.cfg is executed, users with privilege level 0 log in to the switch, and can execute the tftp server-address put source-filename command (such as tftp 192.168.1.26 put syslog.txt). They cannot execute the command with the get, sget or source keyword, and cannot specify the destination-filename argument.
• The command specified in undo command-privilege view can be incomplete. For example, after undo command-privilege view system ftp is executed, all commands starting with the keyword ftp (such as ftp server acl, ftp server enable, and ftp timeout) are restored to their default levels. If you have modified the level of ftp server enable and ftp timeout and you want to restore only ftp server enable to its default level, use undo command-privilege view system ftp server.
• If you modify the command level of in a specified view from the default level to a lower level, 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 interface and system-view is 2 (system level). If you want to make the interface command available to the level 1 users, execute the following three commands: command-privilege level 1 view shell system-view, command-privilege level 1 view system interface GigabitEthernet 1/0/1, and command-privilege level 1 view system quit. The
3
level 1 users can enter system view, execute the interface GigabitEthernet command, and return to user view.
• Use undo command-privilege view to disable the change.
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, which ranges from 0 to 3.
view view: Specifies a view. The value represents a user view. The view argument must be the view where the command resides.
command: Command to be set in the specified view.
Example
# Set the command level of the system-view command to 3 in system view. (By default, level 2 and level 3 users can use the system-view command. After the configuration, only level 3 users can use this command.)
Use display clipboard to view the contents of the clipboard.
To copy content to the clipboard:
• Move the cursor to the starting position of the content and press Esc+Shift+,.
• Move the cursor to the ending position of the content and press Esc+Shift+..
Syntax
display clipboard [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
|: Filters command output by specifying a regular expression. For more information about regular expressions, see “CLI configuration.”
4
begin: Displays the first line that matches the regular expression and all lines that follow.
exclude: Displays all lines that do not match the regular expression.
include: Displays all lines that match the regular expression.
regular-expression: Specifies a regular expression, which is a case-sensitive string of 1 to 256 characters.
Example
# View the content of the clipboard. <Sysname> display clipboard
---------------- CLIPBOARD-----------------
display current-configuration
display command-alias Description
Use display command-alias to display defined command aliases and their corresponding commands.
Syntax
display command-alias [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
|: Filters command output by specifying a regular expression. For more information about regular expressions, see “CLI configuration.”
begin: Displays the first line that matches the regular expression and all lines that follow.
exclude: Displays all lines that do not match the regular expression.
include: Displays all lines that match the regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Example
# Display the defined command aliases and the corresponding commands. <Sysname> display command-alias
Command alias is enabled
index alias command key
1 show display
display history-command Description
Use display history-command to display commands saved in the history command buffer.
5
By default, the system saves the last 10 executed commands. To set the buffer size, use the history-command max-size command. For more information, see “Logging in to the switch commands.”
Syntax
display history-command [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
|: Filters command output by specifying a regular expression. For more information about regular expressions, see “CLI configuration.”
begin: Displays the first line that matches the regular expression and all lines that follow.
exclude: Displays all lines that do not match the regular expression.
include: Displays all lines that match the regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Example
# Display history commands in current user view. <Sysname> display history-command
display history-command
system-view
vlan 2
quit
display hotkey Description
Use display hotkey to display hotkey information.
Syntax
display hotkey [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
|: Filters command output by specifying a regular expression. For more information about regular expressions, see "CLI configuration.”
begin: Displays the first line that matches the regular expression and all lines that follow.
exclude: Displays all lines that do not match the regular expression.
6
include: Displays all lines that match the regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
command: The command line associated with the hot key.
Examples
1. Associate the hot key Ctrl+T to the display tcp status command. <Sysname> system-view
[Sysname] hotkey ctrl_t display tcp status
8
2. Display 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.
9
quit Description
Use quit to return to a lower-level view.
In user view, quit terminates the connection and reconnects to the switch.
Syntax
quit
View
Any view
Default level
0: Visit level (in user view)
2: System level (in other views)
Parameters
None
Example
# Switch from GigabitEthernet 1/0/1 interface view to system view, and then to user view. [Sysname-GigabitEthernet1/0/1] quit
[Sysname] quit
<Sysname>
return Description
Use return to go back into user view, which can also be done with the hot key Ctrl+Z.
Related commands: quit.
Syntax
return
View
Any view except user view
Default level
2: System level
Parameters
None
10
Example
# Return to user view from GigabitEthernet 1/0/1 view. [Sysname-GigabitEthernet1/0/1] return
<Sysname>
screen-length disable Description
Use screen-length disable to disable the multiple-screen output function.
Use undo screen-length disable to enable the multiple-screen output function.
The default settings of the screen-length command are: multiple-screen output enabled and 24 lines displayed on the next screen. For more information about screen-length, see “Logging in to the switch commands.”
When the user logs out, the settings restore to their default values.
Syntax
screen-length disable
undo screen-length disable
View
User view
Default level
1: Monitor level
Parameters
None
Example
# Disable multiple-screen output for the current user. <Sysname> screen-length disable
super Description
Use super to switch user privilege levels.
If no level is specified, the command switches the user privilege level to 3. Command levels include four privileges: visit (0), monitor (1), system (2), and manage (3). Assign privilege level according to the user’s need. When logging in to the switch, the user can access the assigned level and all levels below it.
11
A user can switch to a lower privilege level unconditionally. To switch to a higher privilege level:
• An AUX user can switch to a higher privilege level without entering any password.
• A VTY user must input the switching password set by the super password command to switch to a higher privilege level. If the password is incorrect or no password is configured, the switching operation fails.
Related commands: super password.
Syntax
super [ level ]
View
User view
Default level
0: Visit level
Parameter
level: User level, which ranges from 0 to 3 and defaults to 3.
Examples
1. Switch to user privilege level 2 from privilege level 3. <Sysname> super 2
User privilege level is 2, and only those commands can be used
2. Switch the user privilege level back to 3 (the switching password 123 has been set). If no password is set, 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
Use super authentication-mode to set the authentication mode for user privilege level switch.
Use undo super authentication-mode to restore the default condition (authentication mode).
Related commands: super password.
Syntax
super authentication-mode { local | scheme } *
undo super authentication-mode
View
System view
12
Default level
2: System level
Parameters
local: Authenticates a user by using the local password set by the super password command. When no password is set, two results can occur: the privilege level switch succeeds if the user is logged in through the AUX user interface; the switch operation fails if the user logs in through a VTY user interface. If the user enters the incorrect password, the switch operation fails.
scheme: AAA authentication. For more information about AAA, see the Security Configuration Guide.
local scheme: First local and then scheme, which authenticates a user by using the local password first. If no password is set, the user logged in through the AUX user interface can switch the privilege level; other users need to pass AAA authentication before they can switch the privilege level.
scheme local: First scheme and then local, which authenticates a user by performing the AAA authentication first. If the AAA configuration is invalid (the domain parameters or authentication scheme are not configured) or the server does not respond, the local password authentication is performed.
Examples
1. Set the authentication mode for the user privilege level switch to local. <Sysname> system-view
[Sysname] super authentication-mode local
2. Set the authentication mode for the user privilege level switch to scheme local. <Sysname> system-view
[Sysname] super authentication-mode scheme local
super password Description
Use super password to set the password used to switch user privilege to a higher level.
• Use the simple parameter to set a simple-text password.
• Use the cipher parameter to set a cipher-text password. A cipher-text password is recommended.
• During authentication, you must input a cipher-text password regardless of the password type you set.
Use undo super password to restore the default condition (no password is set).
level user-level: User privilege level, which ranges from 1 to 3 and defaults to 3.
• simple: Plain-text password, a string of 1 to 16 characters.
13
• cipher: Cipher-text password. A cipher password 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!!”.
password: Password, a case-sensitive string of characters.
Examples
1. Set simple-text password abc for switching to user privilege level 3. <Sysname> system-view
[Sysname] super password level 3 simple abc
2. Display the configured password for level switching. [Sysname] display current-configuration
#
super password level 3 simple abc
Set cipher-text password abc for switching to user privilege level 3. <Sysname> system-view
[Sysname] super password level 3 cipher abc
3. Display the configured password for level switching. [Sysname] display current-configuration | include super
#
super password level 3 cipher ;)<01%^&;YGQ=^Q`MAF4<1!!
system-view Description
Use system-view to enter system view from the user view.
Related commands: quit, return.
Syntax
system-view
View
User view
Default level
2: System level
Parameters
None
14
Example
# Enter system view from the user view. <Sysname> system-view
System View: return to User View with Ctrl+Z.
[Sysname]
15
Logging in to the switch commands
acl (user interface view) Description
Use acl to reference ACLs to control access to the VTY user interface.
• If no ACL is referenced in VTY user interface view, the VTY user interface has no access control over establishing a Telnet or SSH connection.
• If an ACL is referenced in VTY user interface view, the connection is permitted only when packets establishing a Telnet or SSH connection match a permit statement in the ACL.
• The system regards the basic/advanced ACL with the inbound keyword, the basic/advanced ACL with the outbound keyword, Ethernet frame header ACL as four different types of ACLs, which can coexist in one VTY user interface.
• The match order is basic/advanced ACL, Ethernet frame header ACL. At most one ACL of each type can be referenced in the same VTY user interface, and the last configured one takes effect.
Use undo acl to cancel the ACL application. For more information about ACL, see the ACL and QoS Configuration Guide. By default, access to the VTY user interface is not restricted.
ipv6: When this keyword is present, the command supports IPv6; otherwise, it supports IPv4.
acl-number: Number of the ACL. The value range varies with devices:
• Basic ACL: 2000 to 2999
• Advanced ACL: 3000 to 3999
• Ethernet frame header ACL: 4000 to 4999
inbound: Restricts Telnet or SSH connections established in the inbound direction through the VTY user interface. If the received packets for establishing a Telnet or SSH connection are permitted by an ACL rule,
16
the connection is allowed to be established. When the device functions as a Telnet server or SSH server, this keyword is used to control access of Telnet clients or SSH clients. outbound: Restricts Telnet connections established in the outbound direction through the VTY user interface. If the packets sent for establishing a Telnet connection are permitted by an ACL rule, the connection is allowed to be established. When the device functions as a Telnet client, this keyword is used to define Telnet servers accessible to the client.
Example
# Allow only the user with the IP address of 192.168.1.26 to access the device through Telnet or SSH. <Sysname> system-view
With this configuration, user A (with IP address 192.168.1.26) can Telnet to the device but user B (with IP address 192.168.1.60) cannot. If a connection failure occurs, the "%connection closed by remote host!" message will appear.
activation-key Description
Use activation-key to define a shortcut key for starting a terminal session.
• The activation-key command is not supported by the VTY user interface.
• To display the shortcut key you have defined, use the display current-configuration| include activation-key command.
• If a new shortcut key is defined with the activation-key command, the Enter key no longer functions.
Use undo activation-key to restore the default. By default, pressing the Enter key starts a terminal session.
Syntax
activation-key character
undo activation-key
View
User interface view
Default level
3: Manage level
17
Parameters
character: Shortcut key for starting a terminal session, a single character (or its ASCII code value that ranges from 0 to 127) or a string of one to three characters. Only the first character functions as the shortcut key. For example, if you input an ASCII code value of 97, the system uses its character a as the shortcut key. If you input string b@c, the system uses the first character b as the shortcut key.
Examples
1. Configure character s as the shortcut key for starting a terminal session on the console port. <Sysname> system-view
[Sysname] user-interface aux 0
[Sysname-ui-aux0] activation-key s
To verify the configuration, perform the following operations:
2. Exit the terminal session on the console port. [Sysname-ui-aux0] return
<Sysname> quit
3. Log in to the console port again. The following message appears: ******************************************************************************
* Copyright (c) 2010-2011 Hewlett-Packard Development Company, L.P. *
* Without the owner's prior written consent, *
* no decompiling or reverse-engineering shall be allowed. *
4. At this moment, pressing Enter does not start a session. To start the terminal session, enter s. <Sysname>
%Mar 2 18:40:27:981 2005 Sysname SHELL/5/LOGIN: Console logged in from aux0.
auto-execute command Description
CAUTION:
Applying auto-execute command to the user interface may disable you from configuring the system. Before configuring the command and saving the configuration (by using the save command), make sure that you can access the device through VTY and AUX interfaces to remove the configuration when a problem occurs.
auto-execute command is not supported by the console port.
Use auto-execute command to specify a command automatically executed when a user logs in to the current user interface.
• The system automatically executes the command when a user logs in to the user interface, and tears down the user connection after the command is executed.
18
• If the command triggers another task, the system does not tear down the user connection until the task is completed.
Use undo auto-execute command to remove the configuration. By default, command auto-execution is disabled.
Syntax
auto-execute command command
undo auto-execute command
View
User interface view
Default level
3: Manage level
Parameter
command: Specifies a command to be automatically executed.
Examples
1. Configure the device to automatically Telnet to 192.168.1.41 after a user logs in to interface VTY 0.
This operation is the same as directly logging in to the device at 192.168.1.41. If the Telnet connection to 192.168.1.41 breaks down, the Telnet connection to 192.168.1.40 breaks down at the same time.
authentication-mode Description
Use authentication-mode to set the authentication mode for the user interface.
Use undo authentication-mode to restore:
• VTY user interfaces authentication mode default (password)
• AUX user interface authentication mode default (none)
Related commands: set authentication password.
Syntax
authentication-mode { none | password | scheme }
undo authentication-mode
View
User interface view
Default level
3: Manage level
Parameters
none: Performs no authentication.
password: Performs local password authentication.
scheme: Performs AAA authentication. For more information about AAA, see the Security Configuration Guide.
20
Examples
1. Specify that no authentication is needed when users log in to the device through VTY 0. This mode is insecure.
<Sysname> system-view
[Sysname] user-interface vty 0
[Sysname-ui-vty0] authentication-mode none
2. Use password authentication when users log in to the device through VTY 0, and set the authentication password to 321.
<Sysname> system-view
[Sysname] user-interface vty 0
[Sysname-ui-vty0] authentication-mode password
[Sysname-ui-vty0] set authentication password cipher 321
3. Authenticate users by username and password when users log in to the device through VTY 0. Set the username to 123 and the password to 321.
Use command accounting to enable command accounting.
• When command accounting is enabled and command authorization is not, every executed command is recorded on the HWTACACS server.
• When both command accounting and command authorization are enabled, only the authorized and executed commands are recorded on the HWTACACS server.
Use undo command accounting to restore the default (command accounting disabled). The accounting server does not record the commands that users have executed.
Syntax
command accounting
undo command accounting
View
User interface view
Default level
3: Manage level
Parameters
None
21
Example
# Enable command accounting on VTY 0. The HWTACACS server records the commands executed by users that have logged in through VTY 0.
<Sysname> system-view
[Sysname] user-interface vty 0
[Sysname-ui-vty0] command accounting
command authorization Description
Use command authorization to enable command authorization. When enabled, users can only perform commands authorized by the server.
Use undo command authorization to restore the default (command authorization disabled). Logged-in users can execute commands without authorization.
Syntax
command authorization
undo command authorization
View
User interface view
Default level
3: Manage level
Parameters
None
Example
# Enable command accounting for VTY 0 so that users logging in from VTY 0 can perform only the commands authorized by the HWTACACS server.
<Sysname> system-view
[Sysname] user-interface vty 0
[Sysname-ui-vty0] command authorization
databits Description
This command only applies to the console port.
Use databits to set data bits for each character. The data bits setting must be the same for the user interface of the connecting port on the device and the terminal device for communication.
Use undo databits to restore the default (8 data bits per character).
Syntax
databits { 5 | 6 | 7 | 8 }
undo databits
22
View
User interface view
Default level
2: System level
Parameters
5: Sets 5 data bits for each character.
6: Sets 6 data bits for each character.
7: Sets 7 data bits for each character.
8: Sets 8 data bits for each character.
Example
# Specify 5 data bits for each character. <Sysname> system-view
[Sysname] user-interface aux 0
[Sysname-ui-aux0] databits 5
display ip http Description
Use display ip http to display HTTP information.
Syntax
display ip http [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
|: Filters command output by specifying a regular expression. For more information about regular expressions, see “CLI configuration.”
begin: Displays the first line that matches the regular expression and all lines that follow.
exclude: Displays all lines that do not match the regular expression.
include: Displays all lines that match the regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Example
# Display information about HTTP. <Sysname> display ip http
HTTP port: 80
Basic ACL: 2222
Current connection: 0
23
Operation status: Running
Table 1 Command output
Field Description
HTTP port Port number used by the HTTP service.
Basic ACL Basic ACL number associated with the HTTP service.
Current connection Number of current connections.
Operation status Operation status: • Running—HTTP service is enabled. • Stopped—HTTP service is disabled.
display ip https Description
Use display ip https to display information about HTTPS.
Syntax
display ip https [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
|: Filters command output by specifying a regular expression. For more information about regular expressions, see “CLI configuration.”
begin: Displays the first line that matches the regular expression and all lines that follow.
exclude: Displays all lines that do not match the regular expression.
include: Displays all lines that match the regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
24
Example
# Display information about HTTPS. <Sysname> display ip https
HTTPS port: 443
SSL server policy: test
Certificate access-control-policy:
Basic ACL: 2222
Current connection: 0
Operation status: Running
Table 2 Command output
Field Description
HTTPS port Port number used by the HTTPS service.
SSL server policy SSL server policy associated with the HTTPS service.
Certificate access-control-policy Certificate attribute access control policy associated with the HTTPS service.
Basic ACL Basic ACL number associated with the HTTPS service.
Current connection Number of current connections.
Operation status Operation status: • Running—HTTPS service is enabled. • Stopped—HTTPS service is disabled.
display telnet client configuration Description
Use display telnet client configuration to display device configuration when it serves as a Telnet client.
Syntax
display telnet client configuration [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
|: Filters command output by specifying a regular expression. For more information about regular expressions, see the Fundamentals Configuration Guide.
begin: Displays the first line that matches the regular expression and all lines that follow.
exclude: Displays all lines that do not match the regular expression.
include: Displays all lines that match the regular expression.
25
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Example
# Display the configuration of the device when it serves as a Telnet client. <Sysname> display telnet client configuration
The source IP address is 1.1.1.1.
The output shows that when the device serves as a client, the source IPv4 address for sending Telnet packets is 1.1.1.1.
display user-interface Description
Use display user-interface to display information about a specific interface or all user interfaces.
• If the summary parameter is included, the command displays all user interface numbers and types.
• If the summary parameter is not included, the command displays the type of the user interface, the absolute or relative number, the transmission rate, the user privilege level, the authentication mode, and the access port.
Syntax
display user-interface [ num1 | { aux | vty } num2 ] [ summary ] [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
num1: Absolute number of a user interface. The value range varies with devices.
aux: Specifies the AUX user interface.
vty: Specifies the VTY user interface.
num2: Relative number of a user interface. It ranges from 0 to 9 for an AUX user interface and 0 to 15 for a VTY user interface.
summary: Displays summary about user interfaces.
|: Filters command output by specifying a regular expression. For more information about regular expressions, see “CLI configuration.”
begin: Displays the first line that matches the regular expression and all lines that follow.
exclude: Displays all lines that do not match the regular expression.
include: Displays all lines that match the regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
26
Examples
1. Display information about user interface 29. <Sysname> display user-interface 29
Idx Type Tx/Rx Modem Privi Auth Int
+ 29 VTY 0 - 3 N -
+ : Current user-interface is active.
F : Current user-interface is active and work in async mode.
Idx : Absolute index of user-interface.
Type : Type and relative index of user-interface.
Privi: The privilege of user-interface.
Auth : The authentication mode of user-interface.
Int : The physical location of UIs.
A : Authentication use AAA.
L : Authentication use local database.
N : Current UI need not authentication.
P : Authentication use current UI's password.
Table 3 Command output
Field Description
+ The current user interface is active.
F The current user interface is active and works in asynchronous mode.
Idx Absolute number of the user interface.
Type Type and relative number of the user interface.
Tx/Rx Transmission/Receive rate of the user interface.
Modem Whether the modem is allowed to dial in (in), dial out (out), or both (inout).
By default, the hyphen (-) is displayed to indicate that this function is disabled.
Privi Indicates the command level of a user under that user interface.
Auth
Authentication mode for the users: • A—AAA authentication. • P—Password authentication. • L—Local authentication. • N—None authentication.
Int The physical port that corresponds to the user interface.
A AAA authentication with the authentication mode of scheme.
L Local authentication (not supported).
N No authentication with the authentication mode of none.
P Password authentication with the authentication mode of password.
27
2. Display summary about all user interfaces. <Sysname> display user-interface summary
User interface type : [TTY]
0:XXX
User interface type : [AUX]
3:XXXX XXXX XX
User interface type : [VTY]
29:UXXX XXXX XXXX XXXX
1 character mode users. (U)
28 UI never used. (X)
1 total UI in use
Table 4 Command output
Field Description
User interface type Type of user interface (AUX or VTY).
0:X • 0—Represents the absolute number of the user interface. • X—This user interface is not used. • U—This user interface is in use.
Character mode users. (U) Number of users or the total number of character U.
UI never used. (X) Number of user interfaces not used or the total number of character X.
Total UI in use Total number of user interfaces in use.
display users Description
Use display users to display information about the interfaces that are active.
Use display users all to display information about all interfaces supported by the device.
Syntax
display users [ all ] [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
all: Displays information about all user interfaces that the device supports.
|: Filters command output by specifying a regular expression. For more information about regular expressions, see “CLI configuration.”
begin: Displays the first line that matches the regular expression and all lines that follow.
exclude: Displays all lines that do not match the regular expression.
28
include: Displays all lines that match the regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Example
# Display information about the user interfaces that are being used. <Sysname> display users
The user application information of the user interface(s):
Idx UI Delay Type Userlevel
+ 29 VTY 0 00:00:00 TEL 3
Following are more details.
VTY 0 :
Location: 192.168.0.5
+ : Current operation user.
F : Current operation user work in async mode.
Table 5 Command output
Field Description
Idx Absolute number of the user interface.
UI Relative number of the user interface. For example, with VTY, the first column represents user interface type, and the second column represents the relative number of the user interface.
Delay Time elapsed since the user's last input, in the format of hh:mm:ss.
Type User type, such as Telnet, SSH.
Userlevel User level: 0 for visit, 1 for monitor, 2 for system, and 3 for manage.
+ Current user.
Location IP address of the user.
F The current user works in asynchronous mode.
display web users Description
Use display web users to display information about web users.
Syntax
display web users [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
29
Parameter
|: Filters command output by specifying a regular expression. For more information about regular expressions, see "CLI configuration.”
begin: Displays the first line that matches the regular expression and all lines that follow.
exclude: Displays all lines that do not match the regular expression.
include: Displays all lines that match the regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Example
# Display information about the current web users. <Sysname> display web users
UserID Name Language Level State LinkCount LoginTime LastTime
ab890000 admin Chinese Management Enable 0 14:13:46 14:14:18
Table 6 Command output
Field Description
UserID ID of a web user.
Name Name of the web user.
Language Login language used by the web user.
Level Level of the web user.
State State of the web user.
LinkCount Number of tasks that the web user runs.
LoginTime Time when the web user logged in.
LastTime Last time when the web user accessed the switch.
escape-key Description
Use escape-key to define a shortcut key for aborting a task. The new shortcut key functions to terminate a task.
If you set the character parameter in a user interface of a device to log in to the device and then Telnet to another device, the character argument can only be used as a control character to abort a task (not for input as a common character). This can cause problems, which you can avoid by specifying character as a key combination rather than as a single character.
For example, in a VTY 0 user interface, if you specify character as e on Device A and log in to Device A on a PC (Hyper Terminal):
• The problem does not occur on Device A. Enter e as a common character on the A, and also use e to terminate the task running on Device A.
• The problem occurs if you Telnet from Device A to Device B. On Device B, you can only use e to terminate the task running on Device B. You cannot input e as a common character (as part of another command, for example) To avoid this, specify character as a key combination.
Use undo escape-key to restore the default key combination (Ctrl+C).
30
To display the shortcut key you have defined, use the display current-configuration command.
Syntax
escape-key { default | character }
undo escape-key
View
User interface view
Default level
3: Manage level
Parameters
character: Specifies the shortcut key for aborting a task, a single character (or its ASCII code value in the range 0 to 127), or a string of 1 to 3 characters. Only the first character of a string functions as the shortcut key. If you enter an ASCII code value of 113, the system uses its character q as the shortcut key. If you enter the string q@c, the system uses the first character q as the shortcut key.
default: Restores the default escape key combination of Ctrl+C.
Examples
# Define key a as the shortcut key for aborting a task. <Sysname> system-view
[Sysname] user-interface aux 0
[Sysname-ui-aux0] escape-key a
# To verify the configuration, perform the following operations:
1. Use the ping command to check the reachability of the device with the IP address of 192.168.1.49, and use the -c keyword to specify the number of ICMP echo packets to be sent as 20.
<Sysname> ping -c 20 192.168.1.49
PING 192.168.1.49: 56 data bytes, press a to break
Reply from 192.168.1.49: bytes=56 Sequence=1 ttl=255 time=3 ms
Reply from 192.168.1.49: bytes=56 Sequence=2 ttl=255 time=3 ms
2. Enter a. The task terminates immediately and the system returns to system view. --- 192.168.1.49 ping statistics ---
2 packet(s) transmitted
2 packet(s) received
0.00% packet loss
round-trip min/avg/max = 3/3/3 ms
<Sysname>
31
flow-control Description
Use flow-control to configure the flow control mode.
• The switch supports the none flow control mode only.
• The command only applies to the console port.
Use undo flow-control to restore the default (none is the default flow control mode). No flow control is performed.
Syntax
flow-control { hardware | none | software }
View
User interface view
Default level
2: System level
Parameters
hardware: Performs hardware flow control.
none: Disables flow control.
software: Performs software flow control.
Example
# Configure no flow control in the inbound and outbound directions for AUX 0. <Sysname> system-view
[Sysname] user-interface aux 0
[Sysname-ui-aux0] flow-control none
free user-interface Description
This command cannot release the connection that you are using.
Use free user-interface to release the established connection.
Syntax
free user-interface { num1 | { aux | vty } num2 }
View
User view
Default level
3: Manage level
32
Parameters
num1: Absolute number of a user interface. The value range varies with devices.
aux: Specifies the AUX user interface.
vty: Specifies the VTY user interface.
num2: Relative number of a user interface. The value ranges from 0 to 9 for an AUX user interface and 0 to 15 for a VTY user interface.
Examples
1. Display the connection established on user interface VTY 1. <Sysname> display users
The user application information of the user interface(s):
Idx UI Delay Type Userlevel
+ 29 VTY 0 00:00:00 TEL 3
Following are more details.
VTY 0 :
Location: 192.168.0.5
+ : Current operation user.
F : Current operation user work in async mode.
2. You can display information about the users that are using the device. <Sysname> free user-interface vty 1
Are you sure to free user-interface vty1? [Y/N]:y
3. To make configurations without interruption from the user using VTY 1, you can release the connection established on VTY 1.
free web-users Description
Use free web-users to disconnect a specific web user or all web users by force.
username: User name of the web user. This argument can contain 1 to 80 characters.
all: Specifies all web users.
33
Example
# Disconnect all web users by force. <Sysname> free web-users all
history-command max-size Description
Use history-command max-size to set the size of the history command buffer for the current user interface.
• The history command buffer saves executed history commands for each user interface.
• Buffers for different user interfaces do not affect each other.
• To display the commands that are stored in the history buffer, use display history.
• To view the recently executed commands, press the upper or lower arrow key. For more information about display history-command, see “CLI configuration commands.”
• After you terminate the current session, the system automatically removes the commands saved in the history buffer.
Use undo history-command max-size to restore the default (10 commands saved).
Syntax
history-command max-size size-value
undo history-command max-size
View
User interface view
Default level
2: System level
Parameters
size-value: Specifies the maximum number of history commands that the buffer can store. The value ranges from 0 to 256.
Example
# Set the buffer to store a maximum of 20 history commands. <Sysname> system-view
[Sysname] user-interface aux 0
[Sysname-ui-aux0] history-command max-size 20
34
idle-timeout Description
Use idle-timeout to set the idle-timeout timer.
• Setting idle-timeout to 0 disables the timer and maintains the connection until you terminate it.
• If no information interaction occurs between the device and the user within the timeout time, the system automatically terminates the connection.
Use undo idle-timeout to restore the default timeout (10 minutes).
Syntax
idle-timeout minutes [ seconds ]
undo idle-timeout
View
User interface view
Default level
2: System level
Parameters
minutes: Specifies the timeout time, in minutes, which ranges from 0 to 35791 and defaults to 10 minutes.
seconds: Specifies the timeout time, in seconds, which ranges from 0 to 59 and defaults to 0 seconds.
Example
# Set the idle-timeout timer to 1 minute and 30 seconds. <Sysname> system-view
[Sysname] user-interface aux 0
[Sysname-ui-aux0] idle-timeout 1 30
ip http acl Description
Use ip http acl to associate an ACL with the HTTP service. After the HTTP service is associated with an ACL, only the clients permitted by the ACL can access the device through HTTP.
Use undo ip http acl to remove the association and restore the default condition (HTTP service is not associated with any ACL by default).
Related commands: display ip http; acl (see ACL and QoS Command Reference).
Syntax
ip http acl acl-number
undo ip http acl
View
System view
35
Default level
2: System level
Parameters
acl-number: ACL number. A basic IPv4 ACL ranges from 2000 to 2999.
Example
# Associate the HTTP service with ACL 2001 to only allow the clients within the 10.10.0.0/16 network to access the device through HTTP.
ip https certificate access-control-policy Description
Use ip https certificate access-control-policy to associate the HTTPS service with a certificate attribute access control policy. Association of the HTTPS service with a certificate attribute access control policy controls client access rights.
Use undo ip https certificate access-control-policy to remove the association and restore the default condition (no association by default).
Related commands: display ip https; pki certificate access-control-policy (see Security Command Reference).
Syntax
ip https certificate access-control-policy policy-name
undo ip https certificate access-control-policy
View
System view
Default level
3: Manage level
Parameter
policy-name: Name of the certificate attribute access control policy, a string of 1 to 16 characters.
Example
# Associate the HTTPS server with certificate attribute access control policy myacl. <Sysname> system-view
[Sysname] ip https certificate access-control-policy myacl
38
ip https enable Description
Use ip https enable to enable the HTTPS service. The device can act as the HTTP server if enabled.
Enabling the HTTPS service triggers an SSL handshake negotiation process.
• If the local certificate of the device exists, the SSL negotiation succeeds and the HTTPS service can be started.
• If no local certificate exists, the SSL negotiation triggers a certificate application process that often fails because it times out. If that happens, execute the ip https enable command multiple times to start the HTTPS service.
Use undo ip https enable to disable the HTTPS service (the default condition).
Related commands: display ip https.
Syntax
ip https enable
undo ip https enable
View
System view
Default level
3: Manage level
Parameters
None
Example
# Enable the HTTPS service. <Sysname> system-view
[Sysname] ip https enable
ip https port Description
Verify that the port number is not used by another service. This command does not check for conflicts with configured port numbers.
Use ip https port to configure the port number of the HTTPS service.
Use undo ip https port to restore the default port number (443 is the default port).
Related commands: display ip https.
Syntax
ip https port port-number
undo ip https port
39
View
System view
Default level
3: Manage level
Parameter
port-number: Port number of the HTTPS service, which ranges from 1 to 65535.
Example
# Configure the port number of the HTTPS service as 6000. <Sysname> system-view
[Sysname] ip https port 6000
ip https ssl-server-policy Description
Use ip https ssl-server-policy to associate the HTTPS service with an SSL server-end policy.
Use undo ip https ssl-server-policy to remove the association and restore the default condition (no association).
The HTTPS service can be enabled only after this command is configured. After the HTTPS service is enabled, you cannot:
• Modify the associated SSL server-end policy.
• Remove the association between the HTTPS service and the SSL server-end policy.
Related commands: display ip https; ssl server-policy (Security Command Reference).
Syntax
ip https ssl-server-policy policy-name
undo ip https ssl-server-policy
View
System view
Default level
3: Manage level
Parameter
policy-name: Name of an SSL server policy, a string of 1 to 16 characters.
Example
# Associate the HTTPS service with SSL server-end policy myssl. <Sysname> system-view
[Sysname] ip https ssl-server-policy myssl
40
lock Description
Use lock to prevent unauthorized users from using the user interface.
• When entering the lock command:
1. Enter a password (up to 16 characters).
2. Confirm it by entering the password again.
3. To set the password, enter the same password.
• After locking the user interface, the next time you access it, you must press Enter and enter the correct password.
Syntax
lock
View
User view
Default level
3: Manage level
Parameters
None
Example
# Lock the current user interface. <Sysname> lock
Please input password<1 to 16> to lock current user terminal interface:
Password:
Again:
locked !
Password:
<Sysname>
parity Description
This command only applies to the console port.
Use parity to set a parity check method. This setting must be identical for the user interface of the connecting port on the device and the target terminal device.
Use undo parity to restore the default (no parity check performed).
Syntax
parity { even | mark | none | odd | space }
undo parity
41
View
User interface view
Default level
2: System level
Parameters
even: Performs an even parity check.
mark: Performs a mark parity check.
none: Performs no parity check.
odd: Performs an odd parity check.
space: Performs a space parity check.
Example
# Configure the console port to perform odd parity check. <Sysname> system-view
[Sysname] user-interface aux 0
[Sysname-ui-aux0] parity odd
protocol inbound Description
Use protocol inbound to enable the user interface to support Telnet, SSH, or both. The configuration is effective next time you log in.
• Before configuring a user interface to support SSH, set the authentication mode to scheme for users logging in through the user interface. Otherwise, protocol inbound ssh fails. For more information, see authentication-mode.
By default:
• All protocols are supported.
• The authentication mode of the Telnet protocol is password.
Syntax
protocol inbound { all | ssh | telnet }
View
VTY interface view
Default level
3: Manage level
Parameters
all: Supports all three protocols: Telnet, SSH, and both.
ssh: Supports SSH only.
telnet: Supports Telnet only.
42
Example
# Enable the VTYs 0 through 15 to support SSH only. <Sysname> system-view
[Sysname] user-interface vty 0 15
[Sysname-ui-vty0-15] authentication-mode scheme
[Sysname-ui-vty0-15] protocol inbound ssh
screen-length Description
Not all display terminals support this command setting.
Use screen-length to set the number of lines on the next screen.
Because terminal display varies, you may need to press the Space, Page Up, or Page Down key to display additional lines of information. For example, if you set screen-length to 40, but the terminal screen can display only 24 lines: When you press Space, the device sends 40 lines, but the next screen displays only lines 18 through 40. To view the first 17 lines, you must press the Page Up or Page Down key.
Use undo screen-length to restore the default next screen display (24 lines).
To disable multiple-screen output of the current user interface, use the screen-length disable command. For more information about the screen-length disable command, see “CLI configuration commands.”
Syntax
screen-length screen-length
undo screen-length
View
User interface view
Default level
2: System level
Parameter
screen-length: Number of lines on the next screen, which ranges from 0 to 512. Setting a value of 0 disables pausing between screens of output.
Example
# Set the next screen of the AUX user interface to display 30 lines. <Sysname> system-view
[Sysname] user-interface aux 0
[Sysname-ui-aux0] screen-length 30
43
send Description
Use send to send messages to the specified user interfaces.
To end the message input, press Ctrl+Z. To cancel the message input and return to user view, press Ctrl+C.
Syntax
send { all | num1 | { aux | vty } num2 }
View
User view
Default level
1: Monitor level
Parameters
all: Sends messages to all user interfaces.
num1: Absolute number of a user interface. The value range varies with devices.
aux: Specifies the AUX user interface.
vty: Specifies the VTY user interface.
num2: Relative number of a user interface. The value ranges from 0 to 9 for an AUX user interface and 0 to 15 for a VTY user interface.
Example
# Send message “hello abc” to the AUX user interface. <Sysname> send aux 0
Enter message, end with CTRL+Z or Enter; abort with CTRL+C:
hello abc^Z
Send message? [Y/N]:y
<Sysname>
***
***
***Message from aux0 to aux0
***
hello abc
<Sysname>
44
set authentication password Description
Use set authentication password to set a local authentication password. You must enter the password in plain-text during authentication. A plain-text password can be easily compromised. It is safer to use a cipher-text password.
Use undo set authentication password to restore the default (no local authentication password).
Related commands: authentication-mode.
Syntax
set authentication password { cipher | simple } password
undo set authentication password
View
User interface view
Default level
3: Manage level
Parameters
cipher: Cipher-text password.
simple: Plain-text password.
password: A case-sensitive string. If the password format is simple, the password argument must be in plain text, and the configuration file saves the password in plain text. If the format is cipher, password can be either in cipher text or in plain text, and the configuration file always saves the password in cipher text. A plain-text password can be a string of up to 16 characters. A cipher-text password or the encrypted version of the plain-text password comprises 24 characters, such as _(TT8F]Y\5SQ=^Q`MAF4<1!!.
Example
# Set the local authentication password for the user interface of console port 0 to hello. <Sysname> system-view
[Sysname] user-interface aux 0
[Sysname-ui-aux0] authentication-mode password
[Sysname-ui-aux0] set authentication password cipher hello
Next time you enter the system, the password is required.
45
shell Description
The command is not applicable to the console port.
Use shell to enable terminal services on the user interface. By default, terminal services are enabled on all user interfaces.
Use undo shell to disable terminal services. You cannot disable the terminal services on the user interface through which you are logged in.
Syntax
shell
undo shell
View
User interface view
Default level
3: Manage level
Parameters
None
Examples
1. Disable terminal services on the VTYs 0 through 4. <Sysname> system-view
[Sysname] user-interface vty 0 4
[Sysname-ui-vty0-4] undo shell
% Disable ui-vty0-4 , are you sure? [Y/N]:y
[Sysname-ui-vty0-4]
2. The following message appears when a terminal tries to Telnet to the device: The connection was closed by the remote host!
speed (user interface view) Description
This command only applies to the console port.
Use speed to set the transmission rate on the user interface. This setting must be identical for the user interface of the connecting port on the device and the target terminal device for communication
Use undo speed to restore the default transmission rate (9600 bps is the default rate).
Syntax
speed speed-value
undo speed
46
View
User interface view
Default level
2: System level
Parameters
speed-value: Transmission rate in bps.
The transmission rates available with asynchronous serial interfaces follow:
• 300 bps
• 600 bps
• 1200 bps
• 2400 bps
• 4800 bps
• 9600 bps
• 19200 bps
• 38400 bps
• 57600 bps
• 115200 bps
The transmission rate varies with devices and configuration environment.
Example
# Set the transmission rate on the user interface AUX 0 to 19200 bps. <Sysname> system-view
[Sysname] user-interface aux 0
[Sysname-ui-aux0] speed 19200
stopbits Description
This command only applies to the console port.
Use stopbits to set the number of stop bits transmitted per byte. This setting must be identical for the user interface of the connecting port on the device and the target device for communication.
Use undo stopbits to restore the default stop bit (1).
Syntax
stopbits { 1 | 1.5 | 2 }
undo stopbits
View
User interface view
Default level
2: System level
47
Parameters
1: One stop bit.
1.5: One and a half stop bits.
2: Two stop bits.
Example
# Set the stop bits on the user interface AUX 0 to 1.5. <Sysname> system-view
[Sysname] user-interface aux 0
[Sysname-ui-aux0] stopbits 1.5
telnet Description
Use telnet to establish Telnet connection with a remote host. The source IPv4 address or source interface specified by this command applies to the current Telnet connection only.
To stop the current Telnet connection, press Ctrl+K or use the quit command.
remote-host: IPv4 address or host name of a remote host, a case-insensitive string of 1 to 20 characters.
service-port: TCP port number of the Telnet service on the remote host. It ranges from 0 to 65535 and defaults to 23.
vpn-instance vpn-instance-name: Specifies the MPLS L3VPN that the remote system belongs to, where vpn-instance-name is a case-sensitive string of 1 to 31 characters. If the remote system is on the public network, do not specify this keyword and argument combination.
source: Specifies the source interface or source IPv4 address of Telnet packets.
interface interface-type interface-number: Specifies the source interface. The source IPv4 address of the Telnet packets that are sent is the IPv4 address of the specified source interface. interface-type interface-number represents the interface type and number, respectively.
ip ip-address: Specifies the source IPv4 address of Telnet packets.
Example
# Telnet to the remote host 1.1.1.2, specifying the source IP address of Telnet packets as 1.1.1.1. <Sysname> telnet 1.1.1.2 source ip 1.1.1.1
48
telnet client source Description
If you use both this command and the telnet command to specify the source IPv4 address or source interface, the source IPv4 address or interface specified by the telnet command takes effect.
Use telnet client source to specify the source IPv4 address or source interface for sending Telnet packets when the device serves as a Telnet client. The source IPv4 address or source interface specified by this command applies to all Telnet connections.
Use undo telnet client source to remove the source IPv4 address or source interface for sending Telnet packets. By default, no source IPv4 address or source interface for sending Telnet packets is specified. The source IPv4 address is selected by routing.
Related commands: display telnet client configuration.
interface interface-type interface-number: Specifies the source interface. The source IPv4 address of the Telnet packets sent is the IPv4 address of a specific interface. interface-type interface-number represents the interface type and number, respectively.
ip ip-address: Specifies the source IPv4 address of Telnet packets.
Example
# Specify the source IPv4 address for sending Telnet packets when the device serves as a Telnet client as 1.1.1.1.
<Sysname> system-view
[Sysname] telnet client source ip 1.1.1.1
49
telnet ipv6 Description
Use telnet ipv6 to establish a Telnet connection to a remote host in an IPv6 network. To stop the current Telnet connection, press Ctrl+K or use the quit command.
remote-host: IP address or host name of a remote host, a case-insensitive string of 1 to 46 characters.
-i interface-type interface-number: Specifies the outbound interface for sending Telnet packets, where interface-type interface-number represents the interface type and number. You need to provide the -i interface-type interface-number argument if the destination address is a link-local address.
port-number: TCP port number for the remote host to provide the Telnet service. It ranges from 0 to 65535 and defaults to 23.
vpn-instance vpn-instance-name: Specifies the MPLS L3VPN that the remote system belongs to, where vpn-instance-name is a case-sensitive string of 1 to 31 characters. If the remote system is on the public network, do not specify this keyword and argument combination.
Example
# Telnet to the remote host with the IPv6 address 5000::1. <Sysname> telnet ipv6 5000::1
telnet server enable Description
Use telnet server enable to enable the Telnet server.
Use undo telnet server enable to disable the Telnet server (disabled is the default condition).
Syntax
telnet server enable
undo telnet server enable
View
System view
Default level
3: Manage level
50
Parameters
None
Example
# Enable the Telnet server. <Sysname> system-view
[Sysname] telnet server enable
terminal type Description
The device supports two types of terminal display: ANSI and VT100. HP recommends you to set the display type to VT100 on both the device and the client to avoid anomalies when the total number of characters of the edited command line exceeds 80.
Use terminal type to configure the current user interface’s type of terminal display.
Use undo terminal type to restore the default (ANSI is the default).
Syntax
terminal type { ansi | vt100 }
undo terminal type
View
User interface view
Default level
2: System level
Parameters
ansi: Specifies the terminal display type as ANSI.
vt100: Specifies the terminal display type as VT100.
Example
# Set the terminal display type to VT100. <Sysname> system-view
[Sysname] user-interface vty 0
[Sysname-ui-vty0] terminal type vt100
51
user privilege level Description
Use user privilege level to assign users logging into the interface a privilege level.
Use undo user privilege level to restore:
• AUX user interfaces default to command level 3.
• Other user interfaces default to command level 0.
Syntax
user privilege level level
undo user privilege level
View
User interface view
Default level
3: Manage level
Parameter
level: Specifies a user privilege level, which ranges from 0 to 3. User privilege levels include visit (0), monitor (1), system (2), and manage (3). The administrator can change the user privilege level as necessary.
Examples
# Set the command level for users logging in through VTY 0 to 0.
<Sysname> system-view
[Sysname] user-interface vty 0
[Sysname-ui-vty0] user privilege level 0
# After you Telnet to the device through VTY 0, the terminal only displays commands of level 0 in the help information:
<Sysname> ?
User view commands:
cluster Run cluster command
display Display current system information
ping Ping function
quit Exit from current command view
ssh2 Establish a secure shell client connection
super Set the current user priority level
telnet Establish one TELNET connection
tracert Trace route function
52
user-interface Description
Use user-interface to enter a single or multiple user interface views.
• In single user interface view, the configuration takes effect in the user view only.
• In multiple user interface view, the configuration takes effect in these user views.
first-num1: Absolute number of the first user interface. The value range varies with devices.
last-num1: Absolute number of the last user interface. The value range varies with devices.
• aux: Specifies the AUX user interface.
• vty: Specifies the VTY user interface.
first-num2: Relative number of the first user interface:
• AUX user interfaces: from 0 to 9
• VTY user interfaces: from 0 to 15
last-num2: Relative number of the last user interface:
• AUX user interfaces: from 0 to 9 for an AUX user interface
• VTY user interfaces: from 0 to 15, but cannot be smaller than first-num 2.
Examples
#Enter AUX user interface view. <Sysname> system-view
[Sysname] user-interface aux 0
[Sysname-ui-aux0]
#Enter the user interface views of VTYs 0 to 4. <Sysname> system-view
[Sysname] user-interface vty 0 4
[Sysname-ui-vty0-4]
53
FTP configuration commands
FTP server configuration commands
display ftp-server Description
Use display ftp-server to view the FTP server configuration. Verify configured FTP server parameter with this command.
Related commands: ftp server enable, ftp timeout, and ftp update.
Syntax
display ftp-server [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
3: Manage level
Parameters
|: Filters command output by specifying a regular expression. For more information about regular expressions, see the Fundamentals Configuration Guide.
begin: Displays the first line that matches the regular expression and all lines that follow.
exclude: Displays all lines that do not match the regular expression.
include: Displays all lines that match the regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Example
# Display the FTP server configuration. <Sysname> display ftp-server
FTP server is running
Max user number: 1
User count: 1
Timeout value(in minute): 30
Put Method: fast
Table 7 Table 1 Command output
Field Description
Max user number Maximum number of login users at a time.
54
Field Description
User count Number of the current login users.
Timeout value (in minute) Allowed idle time of an FTP connection. If there is no packet exchange between the FTP server and client during the whole period, the FTP connection will be disconnected.
Put Method File update method of the FTP server, including: • fast: Fast update. • normal: Normal update.
display ftp-user Description
Use display ftp-user to display detailed information for current FTP users.
Syntax
display ftp-user [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
3: Manage level
Parameters
|: Filters command output by specifying a regular expression. For more information about regular expressions, see the Fundamentals Configuration Guide.
begin: Displays the first line that matches the regular expression and all lines that follow.
exclude: Displays all lines that do not match the regular expression.
include: Displays all lines that match the regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Examples
# Display the detailed information of FTP users. <Sysname> display ftp-user
UserName HostIP Port Idle HomeDir
ftp 192.168.1.54 1190 0 flash:
55
# If the name of the logged-in user exceeds 10 characters, the exceeded characters will appear in the next line and be right justified. For example, if the logged-in user name is administrator, this is how the information would appear:
<Sysname> display ftp-user
UserName HostIP Port Idle HomeDir
administra
tor 192.168.0.152 1031 0 flash:
Table 8 Command output
Field Description
UserName Name of the logged-in user.
HostIP IP address of the logged-in user.
Port Port that the logged-in user is using.
Idle Duration time of the current FTP connection, in minutes.
HomeDir Authorized path of the present logged-in user.
free ftp user Description
Use free ftp user to manually release the FTP connection established with the specified username immediately.
Syntax
free ftp user username
View
User view
Default level
3: Manage level
Parameter
username: Use the display ftp-user command to view the logged-in user name of the current FTP connection.
Example
# Manually release the FTP connection established with username ftpuser. <Sysname> free ftp user ftpuser
Are you sure to free FTP user ftpuser? [Y/N]:y
<Sysname>
56
ftp server acl Description
Use ftp server acl to control FTP clients’ access to the device using an ACL.
• When associated with an ACL, the FTP server denies incoming client requests and permits client access allowed by the ACL rules.
• This configuration has no effect on already established FTP connections and operations.
• If you execute the command multiple times, the last specified ACL takes effect.
Use undo ftp server acl to restore the default (no ACL used is the default condition).
Syntax
ftp server acl acl-number
undo ftp server acl
View
System view
Default level
3: Manage level
Parameter
acl-number: Basic access control list (ACL) number, ranging from 2000 to 2999.
Example
# Associate the FTP service with ACL 2001 to allow only the client 1.1.1.1 to access the device through FTP.
Use ftp server enable to enable the FTP server and allow FTP user login.
Use undo ftp server to disable the FTP server (disabled is the default condition).
Syntax
ftp server enable
undo ftp server
View
System view
57
Default level
3: Manage level
Parameters
None
Example
# Enable the FTP server. <Sysname> system-view
[Sysname] ftp server enable
ftp timeout Description
Use ftp timeout to set the idle-timeout timer.
You can set the timer to disconnect the user connection to the FTP server if no information is received or transmitted before the timer expires.
Use undo ftp timeout to restore the default (30 minutes of idle time is the default condition).
Syntax
ftp timeout minute
undo ftp timeout
View
System view
Default level
3: Manage level
Parameter
minute: Idle-timeout timer in minutes, in the range 1 to 35791.
Example
# Set the idle-timeout timer to 36 minutes. <Sysname> system-view
[Sysname] ftp timeout 36
ftp update Description
Use ftp update to set the file update mode the FTP server uses while receiving data.
Use undo ftp update to restore the default (normal mode is the default condition).
Syntax
ftp update { fast | normal }
undo ftp update
58
View
System view
Default level
3: Manage level
Parameters
fast: Fast update.
normal: Normal update.
Example
# Set the FTP update mode to normal. <Sysname> system-view
[Sysname] ftp update normal
59
FTP client configuration commands Before executing the FTP client configuration commands in this section, make sure you have configured the proper authority for users on the FTP server, including viewing the files under the current directory, reading/downloading the specified file, creating directory/uploading files, and renaming/removing files.
You must use ftp to enter FTP client view for configurations under this view. For more information, see “display ftp client configuration
”.
The prompt information in the following examples varies with FTP server types.
ascii Description
FTP transfers files in two modes:
• Binary mode: for program file or picture transmission.
• ASCII mode: for text file transmission.
Use ascii to set the file transfer mode to ASCII (the default mode).
Because carriage return characters vary with operating systems, the FTP transmission mode must be applied to ensure the correct resolution of the files. For example, to indicate the end of a line and transfer to the next line, the HP device system and Windows system use characters /r/n, and the Linux system uses characters /n.
Related commands: binary.
Syntax
ascii
View
FTP client view
Default level
3: Manage level
Parameters
None
Example
# Set the file transfer mode to ASCII. [ftp] ascii
200 Type set to A.
binary Description
Use binary to set the file transfer mode to binary (flow) mode.
60
By default, the transfer mode is ASCII mode.
Related commands: ascii.
Syntax
binary
View
FTP client view
Default level
3: Manage level
Parameters
None
Examples
# Set the file transfer mode to binary. [ftp] binary
200 Type set to I.
bye Description
Use bye to disconnect from the remote FTP server and return to user view. Use this command to return to user view directly if no connection is established between the device and the remote server.
Related commands: close, disconnect, and quit.
Syntax
bye
View
FTP client view
Default level
3: Manage level
Parameters
None
Example
# Terminate the connection with the remote FTP server and return to user view. [ftp] bye
221 Server closing.
61
cd Description
Use cd to change the current working directory on the remote FTP server to access another authorized directory.
Related commands: pwd.
Syntax
cd { directory | .. | / }
View
FTP client view
Default level
3: Manage level
Parameters
directory: Name of the target directory, in the format of [drive:][/]path, where drive represents the storage medium name, typically flash or cf. If no drive information is provided, the argument represents a folder or subfolder in the current directory. For more information about the drive and path arguments, see the Fundamentals Configuration Guide.
..: Returns to an upper directory. The execution of the cd .. command equals the execution of the cdup command. If the current working directory is the root directory, or no upper directory exists, the current working directory does not change when the cd .. command is executed. This argument does not support command line online help.
/: Returns to the root directory of the storage medium. The keyword does not support command line online help.
Examples
# Change the working directory to the sub-directory logfile of the current directory. [ftp] cd logfile
250 CWD command successful.
# Change the working directory to the sub-directory folder of the authorized directory. [ftp] cd /folder
250 CWD command successful.
cdup Description
Use cdup to exit the current directory and enter the upper directory of the FTP server.
Execution of this command will not change the authorized directory if it is work-directory.
Related commands: cd and pwd.
Syntax
cdup
62
View
FTP client view
Default level
3: Manage level
Parameters
None
Example
# Change the current working directory path to the upper directory. [ftp] pwd
257 "/ftp/subdir" is current directory.
[ftp] cdup
200 CDUP command successful.
[ftp] pwd
257 "/ftp" is current directory.
close Description
Use close to terminate connection to the FTP server, but remain in FTP client view.
This command is equal to the disconnect command.
Syntax
close
View
FTP client view
Default level
3: Manage level
Parameters
None
Example
# Terminate the connection to the FTP server and remain in FTP client view. [ftp] close
221 Server closing.
[ftp]
63
debugging Description
Use debugging to enable FTP client debugging.
Use undo debugging to disable FTP client debugging (disabled is the default condition).
Syntax
debugging
undo debugging
View
FTP client view
Default level
1: Monitor level
Parameters
None
Example
# The device serves as the FTP client. Enable FTP client debugging and use the active mode to download file sample.file from the current directory of the FTP server.
<Sysname> terminal monitor
<Sysname> terminal debugging
<Sysname> ftp 192.168.1.46
Trying 192.168.1.46 ...
Press CTRL+K to abort
Connected to 192.168.1.46.
220 FTP service ready.
User(192.168.1.46:(none)):ftp
331 Password required for ftp.
Password:
230 User logged in.
[ftp]undo passive
FTP: passive is off
[ftp] debugging
FTP: debugging switch is on
64
[ftp] get sample.file
---> PORT 192,168,1,44,4,21
200 Port command okay.
The parsed reply is 200
---> RETR sample.file
150 Opening ASCII mode data connection for /sample.file.
The parsed reply is 150
FTPC: File transfer started with the signal light turned on.
FTPC: File transfer completed with the signal light turned off.
.226 Transfer complete.
FTP: 3304 byte(s) received in 4.889 second(s), 675.00 byte(s)/sec.
[ftp]
Table 9 Command output
Field Description
---> PORT Give an FTP order, with data port numbers being…
The parsed reply is The received reply code, defined in RFC 959.
---> RETR Download the file.
FTPC: File transfer started with the signal light turned on.
File transfer starts, and the signal light is turned on.
FTPC: File transfer completed with the signal light turned off.
File transfer is completed, and the signal light is turned off.
delete Description
Use delete to permanently delete a file on the remote FTP server. You must have delete permission on the remote server to use this command.
Syntax
delete remotefile
View
FTP client view
Default level
3: Manage level
Parameter
remotefile: File name.
65
Example
#Delete file temp.c. [ftp] delete temp.c
250 DELE command successful.
dir Description
The dir command displays names of files and directories, as well as related information, such as the size, and the date they were created.
Compare to the Is command, which can only display the names of files and directories.
Use:
• dir to view the detailed information of the files and subdirectories in the current directory on the remote FTP server.
• dir remotefile to display the detailed information of a specific file or directory on the remote FTP server.
• dir remotefile localfile to display the detailed information of a specific file or directory on the remote FTP server, and save the displayed information into a local file specified by the localfile argument.
Syntax
dir [ remotefile [ localfile ] ]
View
FTP client view
Default level
3: Manage level
Parameters
remotefile: Name of the file or directory on the remote FTP server.
localfile: Name of the local file to save the displayed information.
Examples
#View the detailed information of the files and subdirectories under the current directory on the remote FTP server.
[ftp] dir
227 Entering Passive Mode (192,168,1,46,5,68).
125 ASCII mode data connection already open, transfer starting for /*.
drwxrwxrwx 1 noone nogroup 0 Aug 08 2006 logfile
-rwxrwxrwx 1 noone nogroup 20471748 May 11 10:21 test.bin
-rwxrwxrwx 1 noone nogroup 4001 Dec 08 2007 config.cfg
-rwxrwxrwx 1 noone nogroup 3608 Jun 13 2007 startup.cfg
drwxrwxrwx 1 noone nogroup 0 Dec 03 2007 test
-rwxrwxrwx 1 noone nogroup 299 Oct 15 2007 key.pub
226 Transfer complete.
FTP: 394 byte(s) received in 0.189 second(s), 2.00K byte(s)/sec.
66
[ftp]
#View the information of the file ar-router.cfg, and save the result to aa.txt. [ftp] dir ar-router.cfg aa.txt
227 Entering Passive Mode (192,168,1,50,17,158).
125 ASCII mode data connection already open, transfer starting for /ar-
router.cfg.
....226 Transfer complete.
FTP: 67 byte(s) received in 4.600 second(s), 14.00 byte(s)/sec.
# View the content of aa.txt. [ftp] quit
<Sysname> more aa.txt
-rwxrwxrwx 1 noone nogroup 3077 Jun 20 15:34 ar-router.cfg
disconnect Description
Use disconnect to disconnect from the remote FTP server but remain in FTP client view.
This command is equal to the close command.
Syntax
disconnect
View
FTP client view
Default level
3: Manage level
Parameters
None
Example
#Disconnect from the remote FTP server but remain in FTP client view. [ftp] disconnect
221 Server closing.
display ftp client configuration Description
Use display ftp client configuration to view the configured source IP address or source interface of the FTP client.
Related commands: ftp client source.
Syntax
display ftp client configuration [ | { begin | exclude | include } regular-expression ]
67
View
Any view
Default level
1: Monitor level
Parameters
|: Filters command output by specifying a regular expression. For more information about regular expressions, see the Fundamentals Configuration Guide.
begin: Displays the first line that matches the regular expression and all lines that follow.
exclude: Displays all lines that do not match the regular expression.
include: Displays all lines that match the regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Example
#Display the current configuration information of the FTP client. <Sysname> display ftp client configuration
The source IP address is 192.168.0.123
ftp Description
This command applies to IPv4 networks.
Use ftp to log in to the remote FTP server and enter FTP client view.
• Without parameters, you enter the FTP client view without logging in to the FTP server.
• With parameters, you are prompted to enter the username and password for accessing the FTP server.
server-address: IP address or host name of a remote FTP server, a string of 1 to 20 characters.
service-port: TCP port number of the remote FTP server, in the range 0 to 65535. The default value is 21.
vpn-instance vpn-instance-name: FTP server’s VPN. The vpn-instance-name argument specifies the instance name of the VPN, a case-sensitive string of 1 to 63 characters.
68
source { interface interface-type interface-number | ip source-ip-address } ]: source address used to establish an FTP connection.
• interface interface-type interface-number: source interface by its type and number. The primary IP address configured on this interface is the source address of the transmitted FTP packets. If no primary IP address is configured on the source interface, the connection fails.
• ip source-ip-address: The source IP address (configured on the device) of the transmitted FTP packets.
Example
#Log in from the current device Sysname1 to the device Sysname2 with the IP address of 192.168.0.211. The source IP address of the packets sent is 192.168.0.212.
<Sysname> ftp 192.168.0.211 source ip 192.168.0.212
Trying 192.168.0.211 ...
Press CTRL+K to abort
Connected to 192.168.0.211.
220 FTP Server ready.
User(192.168.0.211:(none)):abc
331 Password required for abc
Password:
230 User logged in.
ftp client source Description
Use ftp client source to configure the source address of packets transmitted by the FTP client.
• The source address can be specified as the source interface and the source IP address. If you use ftp client source to specify the source interface and then the source IP address, the newly specified source IP address overwrites the configured source interface and vice versa.
• If the source address is specified with ftp client source and then with the ftp command, the source address specified with the latter one is used to communicate with the FTP server.
• The source address specified with ftp client source is valid for all FTP connections and the source address specified with the ftp command is valid only for the current FTP connection.
Use undo ftp client source to restore the default. By default, a device uses the IP address of the interface determined by the matched route as the source IP address to communicate with an FTP server.
Related commands: display ftp client configuration.
interface interface-type interface-number: Source interface for the FTP connection, including interface type and interface number. The primary IP address configured on the source interface is the source IP address of the packets sent by FTP. If no primary IP address is configured on the source interface, the connection fails.
ip source-ip-address: Source IP address of the FTP connection. It must be an IP address that has been configured on the device.
Examples
# Specify the source IP address of the FTP client as 2.2.2.2. <Sysname> system-view
[Sysname] ftp client source ip 2.2.2.2
# Specify the source interface of the FTP client as Vlan-interface1. <Sysname> system-view
server-address: IP address or host name of the remote FTP server.
service-port: TCP port number of the FTP server, in the range 0 to 65535. The default value is 21.
source ipv6 source-ipv6-address: Specifies a source IPv6 address for transmitted FTP packets. This address must be an IPv6 address that has been configured on the device.
-i interface-type interface-number: Specifies the type and number of the egress interface. This parameter can only be used when the FTP server address is a link local address and the specified egress interface has a link local address. For the configuration of link local addresses, see the Layer 3—IP Services Configuration Guide.
vpn-instance vpn-instance-name: Specifies the VPN that the FTP server belongs to. The vpn-instance-name argument is a case-sensitive string of 1 to 31 characters.
70
Example
#Log in to the FTP server with IPv6 address 3000::200. <Sysname> ftp ipv6 3000::200
Trying 3000::200 ...
Press CTRL+K to abort
Connected to 3000::200.
220 Welcome!
User(3000::200:(none)): MY_NAME
331 Please specify the password.
Password:
230 Login successful.
[ftp]
get Description
Use get to download a file from a remote FTP server and save it.
Syntax
get remotefile [ localfile ]
View
FTP client view
Default level
3: Manage level
Parameters
remotefile: Name of the file to be downloaded.
localfile: File name used after a file is downloaded and saved locally. If this argument is not specified, the local file uses the name of the source file on the FTP server by default.
Examples
# Download file testcfg.cfg and save it as aa.cfg. [ftp] get testcfg.cfg aa.cfg
227 Entering Passive Mode (192,168,1,50,17,163).
125 ASCII mode data connection already open, transfer starting for /testcfg.cfg.
.....226 Transfer complete.
FTP: 5190 byte(s) received in 7.754 second(s), 669.00 byte(s)/sec.
71
# Download file testcfg.cfg to the root directory of the storage medium of the master, and save it as newest.cfg.
[ftp] get testcfg.cfg newest.cfg
227 Entering Passive Mode (192,168,1,46,4,47).
125 ASCII mode data connection already open, transfer starting for /testcfg.cfg.
..226 Transfer complete.
FTP: 3608 byte(s) received in 2.050 second(s), 1.00K byte(s)/sec.
# Download file testcfg.cfg to the root directory of the storage medium of the subordinate switch (with the member ID 2), and save it as newest.cfg.
[ftp] get testcfg.cfg slot2#flash:/newest.cfg
227 Entering Passive Mode (192,168,1,46,4,48).
125 ASCII mode data connection already open, transfer starting for /testcfg.cfg.
226 Transfer complete.
FTP: 3608 byte(s) received in 2.322 second(s), 1.00K byte(s)/sec.
lcd Description
Use lcd to display the local working directory of the FTP client.
Syntax
lcd
View
FTP client view
Default level
3: Manage level
Parameters
None
Example
# Display the local working directory. [ftp] lcd
FTP: Local directory now flash:/clienttemp.
The above information indicates that the working directory of the FTP client before execution of the ftp command is flash:/clienttemp.
72
ls Description
Use ls to view the information of all the files and subdirectories in the current directory of the remote FTP server. The file names and subdirectory names are displayed. Compare to the dir command, which can display other related information of the files and directories, such as the size, and the date they were created.
• Use ls remotefile to view the information of a file or subdirectory.
• Use ls remotefile localfile to view the information of a file or subdirectory, and save the result to a local file specified by the localfile argument.
Syntax
ls [ remotefile [ localfile ] ]
View
FTP client view
Default level
3: Manage level
Parameters
remotefile: Filename or directory on the remote FTP server.
localfile: Name of a local file used to save the displayed information.
Examples
# View the information of all files and subdirectories under the current directory of the FTP server. [ftp] ls
227 Entering Passive Mode (192,168,1,50,17,165).
125 ASCII mode data connection already open, transfer starting for /*.
ar-router.cfg
logfile
mainar.bin
arbasicbtm.bin
ftp
test
bb.cfg
testcfg.cfg
226 Transfer complete.
FTP: 87 byte(s) received in 0.132 second(s) 659.00 byte(s)/sec.
73
# View the information of directory logfile, and save the result to file aa.txt. [ftp] ls logfile aa.txt
227 Entering Passive Mode (192,168,1,46,4,3).
125 ASCII mode data connection already open, transfer starting for /logfile/*.
....226 Transfer complete.
FTP: 20 byte(s) received in 3.962 second(s), 5.00 byte(s)/sec.
#View the content of file aa.txt. [ftp] quit
<Sysname> more aa.txt
.
..
logfile.log
mkdir Description
Use mkdir to create a subdirectory in the current directory on the remote FTP server. You must have permissions on the remote FTP server.
Syntax
mkdir directory
View
FTP client view
Default level
3: Manage level
Parameter
directory: Name of the directory to be created.
Example
#Create subdirectory mytest on the current directory of the remote FTP server. [ftp] mkdir mytest
257 "/mytest" new directory created.
open Description
Use open to log in to the IPv4 FTP server under FTP client view.
At login, enter the username and password for accessing the FTP server. If your input is correct, the login succeeds.
If you have logged in to the IPv4 FTP server currently, you cannot use the open to log in to another server. You need to disconnect with the current server first, and then try to connect with another one.
Related commands: close.
74
Syntax
open server-address [ service-port ]
View
FTP client view
Default level
3: Manage level
Parameters
server-address: IP address or host name of a remote FTP server.
service-port: Port number of the remote FTP server, in the range 0 to 65535. The default value is 21.
Example
# In FTP client view, log in to the FTP server with the IP address of 192.168.1.50. <Sysname> ftp
[ftp] open 192.168.1.50
Trying 192.168.1.50 ...
Press CTRL+K to abort
Connected to 192.168.1.50.
220 FTP service ready.
User(192.168.1.50:(none)):aa
331 Password required for aa.
Password:
230 User logged in.
[ftp]
open ipv6 Description
Use open ipv6 to log in to the IPv6 FTP server in FTP client view.
At login, enter the username and password for accessing the FTP server. If your input is correct, the login succeeds.
server-address: IP address or host name of the remote FTP server.
service-port: Port number of the remote FTP server, in the range 0 to 65535. The default value is 21.
-i interface-type interface-number: Specifies the egress interface by its type and number. This parameter can be used only when the FTP server address is a link local address and the specified egress interface has a link local address. For the configuration of link local addresses, see the Layer 3—IP Services Configuration Guide.
Example
# Log in to the FTP server (with IPv6 address 3000::200) in FTP client view. <Sysname> ftp
[ftp] open ipv6 3000::200
Trying 3000::200 ...
Press CTRL+K to abort
Connected to 3000::200.
220 Welcome!
User(3000::200:(none)): MY_NAME
331 Please specify the password.
Password:
230 Login successful.
passive Description
This command is mainly used in conjunction with a firewall to restrict the FTP session connection between private and public network users.
Data transmission modes fall into the passive mode and the active mode.
• The active mode means that the data connection request is initiated by a server.
• The passive mode means that the data connection request is initiated by a client. Syntax
Use the passive command to set the data transmission mode to passive (the default mode is passive).
Use the undo passive command to set the data transmission mode to active.
View
FTP client view
Default level
3: Manage level
Parameters
None
Example
# Set the data transmission mode to passive. [ftp] passive
FTP: passive is on
76
put Description
Use put to upload a file on the client to the remote FTP server.
• By default, if no name is assigned to the file to be saved on the FTP server, the name of the source file is used.
• After a file is uploaded, it will be saved under the user’s authorized directory, which can be set with the authorization-attribute command.
Syntax
put localfile [ remotefile ]
View
FTP client view
Default level
3: Manage level
Parameters
localfile: Name of the local file to be uploaded.
remotefile: File name used after a file is uploaded and saved on the FTP server.
Examples
# Upload source file cc.txt to the remote FTP server and save it as dd.txt. [ftp] put cc.txt dd.txt
227 Entering Passive Mode (192,168,1,50,17,169).
125 ASCII mode data connection already open, transfer starting for /dd.txt.
226 Transfer complete.
FTP: 9 byte(s) sent in 0.112 second(s), 80.00 byte(s)/sec.
# Upload source file vrpcfg.cfg on the master to the remote FTP server and save it as ftpclient.cfg. [ftp] put vrpcfg.cfg ftpclient.cfg
227 Entering Passive Mode (192,168,1,46,4,50).
125 ASCII mode data connection already open, transfer starting for
/ftpclient.cfg.
226 Transfer complete.
FTP: 1366 byte(s) sent in 0.064 second(s), 21.00Kbyte(s)/sec.
#Upload source file a.cfg on the subordinate switch (with the member ID 2) to the remote FTP server and save it as ftpclienta.cfg.
[ftp] put slot2#flash:/a.cfg ftpclienta.cfg
227 Entering Passive Mode (192,168,1,46,4,52).
125 ASCII mode data connection already open, transfer starting for
/ftpclienta.cfg.
226 Transfer complete.
FTP: 1226 byte(s) sent in 0.065 second(s), 18.00Kbyte(s)/sec.
77
pwd Description
Use pwd to display the accessed directory on the remote FTP server.
Syntax
pwd
View
FTP client view
Default level
3: Manage level
Parameters
None
Example
# Display the currently accessed directory on the remote FTP server. [ftp] cd servertemp
[ftp] pwd
257 "/servertemp" is current directory.
The above information indicates that the servertemp folder under the root directory of the remote FTP server is being accessed by the user.
quit Description
Use quit to disconnect from the remote FTP server and exit to user view.
Syntax
quit
View
FTP client view
Default level
3: Manage level
Parameters
None
Example
# Disconnect from the remote FTP server and exit to user view. [ftp] quit
221 Server closing.
<Sysname>
78
remotehelp Description
Use remotehelp to display the help information of FTP-related commands supported by the remote FTP server.
• If no parameter is specified, remote server’s FTP-related commands are displayed.
Syntax
remotehelp [ protocol-command ]
View
FTP client view
Default level
3: Manage level
Parameters
protocol-command: FTP command.
Examples
# Display FTP commands supported by the remote FTP server. [ftp] remotehelp
214-Here is a list of available ftp commands
Those with '*' are not yet implemented.
USER PASS ACCT* CWD CDUP SMNT* QUIT REIN*
PORT PASV TYPE STRU* MODE* RETR STOR STOU*
APPE* ALLO* REST* RNFR* RNTO* ABOR* DELE RMD
MKD PWD LIST NLST SITE* SYST STAT* HELP
NOOP* XCUP XCWD XMKD XPWD XRMD
214 Direct comments to HP company.
# Display the help information for the user command. [ftp] remotehelp user
214 Syntax: USER <sp> <username>.
[ftp]
Table 10 Command output
Field Description
USER Username
PASS Password
CWD Change the current working directory
CDUP Change to parent directory
SMNT* File structure setting
QUIT Quit
REIN* Re-initialization
79
Field Description
PORT Port number
PASV Passive mode
TYPE Request type
STRU* File structure
MODE* Transmission mode
RETR Download a file
STOR Upload a file
STOU* Store unique
APPE* Appended file
ALLO* Allocation space
REST* Restart
RNFR* Rename the source
RNTO* Rename the destination
ABOR* Abort the transmission
DELE Delete a file
RMD Delete a folder
MKD Create a folder
PWD Print working directory
LIST List files
NLST List file description
SITE* Locate a parameter
SYST Display system parameters
STAT* State
HELP Help
NOOP* No operation
XCUP Extension command, the same meaning as CUP
XCWD Extension command, the same meaning as CWD
XMKD Extension command, the same meaning as MKD
XPWD Extension command, the same meaning as PWD
XRMD Extension command, the same meaning as RMD
Syntax: USER <sp> <username>. Syntax of the user command: user (keyword) + space + username
80
rmdir Description
Only authorized users are allowed to use this command.
Use rmdir to remove a directory from the FTP server.
• Delete all files and subdirectories in the directory before you delete a directory. For the deletion of files, see the delete command.
• When you execute the rmdir command, the files in the remote recycle bin in the directory will be automatically deleted.
Syntax
rmdir directory
View
FTP client view
Default level
3: Manage level
Parameter
directory: Directory name on the remote FTP server.
Example
# Delete the temp1 directory from the authorized directory on the FTP server. [ftp] rmdir /temp1
200 RMD command successful.
user Description
Before using this command, you must configure the corresponding username and password on the FTP server or the login will fail and the FTP connection will close.
Use user to relog in to the currently accessed FTP server with another username.
Syntax
user username [ password ]
View
FTP client view
Default level
3: Manage level
81
Parameters
username: Login username.
password: Login password. You can input this argument after the username argument plus a space; or you can input this argument when the “Password:” prompt appears after you input the username and then press Enter.
Example
# User ftp1 has logged in to the FTP server. Use username ftp2 to log in to the current FTP server. (Suppose username ftp2 and password 123123123123 have been configured on the FTP server).
• Method 1 [ftp] user ftp2
331 Password required for ftp2.
Password:
230 User logged in.
[ftp]
• Method 2 [ftp] user ftp2 123123123123
331 Password required for ftp.
230 User logged in.
[ftp]
verbose Description
Use verbose to enable the protocol information function to display detailed prompt information (enabled is the default condition).
Use undo verbose to disable the protocol information function.
Syntax
verbose
undo verbose
View
FTP client view
Default level
3: Manage level
Parameters
None
82
Examples
# Enable the protocol information function. [ftp] verbose
FTP: verbose is on
# Disable the protocol information function and perform the Get operation. [ftp] undo verbose
FTP: verbose is off
[ftp] get startup.cfg bb.cfg
FTP: 3608 byte(s) received in 0.052 second(s), 69.00K byte(s)/sec.
[ftp]
# Enable the protocol information function and perform the Get operation. [ftp] verbose
FTP: verbose is on
[ftp] get startup.cfg aa.cfg
227 Entering Passive Mode (192,168,1,46,5,85).
125 ASCII mode data connection already open, transfer starting for /startup.cfg.
226 Transfer complete.
FTP: 3608 byte(s) received in 0.193 second(s), 18.00K byte(s)/sec.
83
TFTP client configuration commands
display tftp client configuration Description
Use display tftp client configuration to view the configuration information of the TFTP client.
Related commands: tftp client source.
Syntax
display tftp client configuration [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
|: Filters command output by specifying a regular expression. For more information about regular expressions, see the Fundamentals Configuration Guide.
begin: Displays the first line that matches the regular expression and all lines that follow.
exclude: Displays all lines that do not match the regular expression.
include: Displays all lines that match the regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Example
# Display the current configuration information of the TFTP client. This command displays the configured source IP address or source interface of the TFTP client.
<Sysname> display tftp client configuration
The source IP address is 192.168.0.123
tftp-server acl Description
Use tftp-server acl to use an ACL’s rules to allow a device access to a specific TFTP server in a network.
Use undo tftp-server acl to restore the default (no ACL is the default condition).
For more information about ACL, see the ACL and QoS Configuration Guide.
Syntax
tftp-server [ ipv6 ] acl acl-number
undo tftp-server [ ipv6 ] acl
84
View
System view
Default level
3: Manage level
Parameters
ipv6: References an IPv6 ACL. If it is not specified, an IPv4 ACL is referenced.
acl-number: Number of a basic ACL, in the range 2000 to 2999.
Examples
# Allow the device to access the TFTP server with the IP address of 1.1.1.1 only (in IPv4 networking environment).
Use tftp to upload files from the local device to a TFTP server and download files from the TFTP server to the local device.
If no destination file name is specified, the saved file uses the source file name.
Syntax
tftp server-address { get | put | sget } source-filename [ destination-filename ] [ vpn-instance vpn-instance-name ] [ source { interface interface-type interface-number | ip source-ip-address } ]
View
User view
Default level
3: Manage level
85
Parameters
server-address: IP address or host name of a TFTP server.
get: Downloads a file in normal mode.
put: Uploads a file.
sget: Downloads a file in secure mode.
source-filename: Source file name.
destination-filename: Destination file name.
vpn-instance vpn-instance-name: Specifies the TFTP server’s VPN. The vpn-instance-name argument refers to the name of a VPN instance, a case-sensitive string of 1 to 31 characters.
source: Configures parameters for source address binding.
interface interface-type interface-number: Specifies the source interface by its type and number. The primary IP address configured on the source interface is the source IP address of the packets sent by TFTP. If no primary IP address is configured on the source interface, the transmission fails.
ip source-ip-address: Specifies the source IP address for the current TFTP client to transmit packets. This source address must be an IP address that has been configured on the device.
Examples
# Download the config.cfg file from the TFTP server with the IP address of 192.168.0.98 and save it as config.bak. Specify the source IP address to be 192.168.0.92.
<Sysname> tftp 192.168.0.98 get config.cfg config.bak source ip 192.168.0.92
...
File will be transferred in binary mode
Downloading file from remote TFTP server, please wait....
TFTP: 372800 bytes received in 1 second(s)
File downloaded successfully.
# Upload the config.cfg file from the local device to the default path of the TFTP server with the IP address of 192.168.0.98 and save it as config.bak. Specify the source IP interface to be Ethernet 1/1.
<Sysname> tftp 192.168.0.98 put config.cfg config.bak source interface ethernet
1/1
File will be transferred in binary mode
Sending file to remote TFTP server. Please wait...
TFTP: 345600 bytes sent in 1 second(s).
File uploaded successfully.
# To upgrade the device, download the newest.bin file from the TFTP server with the IP address of 192.168.1.26 and save it to both the root directory on the flash of the master and the root directory on the flash of the subordinate switch (with the member ID 2).
<Sysname> tftp 192.168.1.26 get newest.bin startup.bin
.
File will be transferred in binary mode
Downloading file from remote TFTP server, please wait..................
TFTP: 2737556 bytes received in 13 second(s)
File downloaded successfully.
86
# Download the file from the TFTP server to the root directory on the flash of the master. <Sysname> tftp 192.168.1.26 get newest.bin slot2#flash:/startup.bin
File will be transferred in binary mode
Downloading file from remote TFTP server, please wait...|
TFTP: 2737556 bytes received in 14 second(s)
File downloaded successfully.
// Download the file from the TFTP server to the root directory on the flash of the subordinate switch.
tftp client source Description
Use tftp client source to configure the source address of the TFTP packets from the TFTP client.
• The source address can be specified as the source interface and the source IP. If you use tftp client source to specify the source interface and then the source IP, the newly specified source IP overwrites the configured source interface and vice versa.
• If the source address is specified with tftp client source and then with the tftp command, the source address specified with the latter one is used to communicate with the TFTP server.
• The source address specified with tftp client source is valid for all tftp connections and the source address specified with the tftp command is valid for the current tftp command.
Use undo telnet client source to restore the default. By default, a device uses the IP address of the interface determined by the matched route as the source IP address to communicate with a TFTP server.
Related commands: display tftp client configuration.
interface interface-type interface-number: Specifies the source interface by its type and number. The primary IP address configured on the source interface is the source IP address of the packets sent by TFTP. If no primary IP address is configured on the source interface, the transmission fails.
ip source-ip-address: The source IP address of TFTP connections. It must be an IP address that has been configured on the device.
Examples
# Specify the source IP address of the TFTP client as 2.2.2.2. <Sysname> system-view
[Sysname] tftp client source ip 2.2.2.2
87
# Specify the source interface of the TFTP client as Vlan-interface1. <Sysname> system-view
tftp-ipv6-server: IPv6 address or host name (a string of 1 to 46 characters) of a TFTP server.
-i interface-type interface-number: Specifies the egress interface by its type and number. This parameter can be used only when the TFTP server address is a link local address and the specified egress interface has a link local address. For the configuration of a link local address, see the Layer 3—IP Services Configuration Guide.
get: Downloads a file.
put: Uploads a file.
source-file: Source filename.
destination-file: Destination filename. If not specified, this filename is the same as the source filename.
vpn-instance vpn-instance-name: Specifies the VPN that the TFTP server belongs to. The vpn-instance-name argument is a case-sensitive string of 1 to 31 characters.
Example
# Download filetoget.txt from the TFTP server. <Sysname> tftp ipv6 fe80::250:daff:fe91:e058 -i Vlan-interface1 get
filetoget.txt
...
File will be transferred in binary mode
Downloading file from remote TFTP server, please wait....
TFTP: 411100 bytes received in 2 second(s)
File downloaded successfully.
88
File management commands
In the following examples, the working directory is the root directory of the storage medium on the device. For the qualified filename formats, see the Fundamentals Configuration Guide.
cd Description
Use cd to change the working directory.
Syntax
cd { directory | .. | / }
View
User view
Default level
3: Manage level
Parameters
directory: Name of the target directory, in the format of [drive:/]path. For the detailed introduction to the drive and path arguments, see the Fundamentals Configuration Guide. If no drive information is provided, the argument represents a folder or subfolder in the directory.
..: Returns to an upper directory. This argument does not support command online help. If the working directory is the root directory, or if no upper directory exists, the working directory does not change when the cd .. command is executed.
/: Returns to the root directory of the storage medium. The keyword does not support command line online help.
Examples
# Enter the test folder after logging in to the device. <Sysname> cd test
# Return to the upper directory (Remember to enter a space after the keyword cd). <Sysname> cd ..
# Return to the root directory. <Sysname> cd /
After you change the directory by using the cd command, use the pwd to view the path of the working directory.
# Enter the root directory of the Flash on a subordinate with the member ID 2 after logging in to the master.
<Sysname> cd slot2#flash:/
89
# Change the current directory from the file system of the subordinate to the test folder in the root directory of the master.
<Sysname> cd flash:/
copy Description
Use copy to copy a file.
If you specify a target folder, the system will copy the file to the folder and use the name of the source file as the file name.
Syntax
copy fileurl-source fileurl-dest
View
User view
Default level
3: Manage level
Parameters
fileurl-source: Name of the source file.
fileurl-dest: Name of the target file or folder.
Examples
# Copy file testcfg.cfg in the current folder and save it as testbackup.cfg. <Sysname> copy testcfg.cfg testbackup.cfg
Copy flash:/test.cfg to flash:/testbackup.cfg?[Y/N]:y
....
%Copy file flash:/test.cfg to flash:/testbackup.cfg...Done.
# Copy the configuration file of the master to the root directory of a subordinate (with the member ID 2).
<Sysname> copy vrcfg.cfg slot2#flash:/
Copy flash:/vrcfg.cfg to slot2#flash:/vrcfg.cfg?[Y/N]:y
%Copy file flash:/vrcfg.cfg to slot2#flash:/vrcfg.cfg...Done.
delete Description
CAUTION:
If you delete one file, and then delete another one with the same filename but in a different directory, only the last one deleted is retained in the recycle bin.
Use delete file-url to temporarily delete a file. The deleted file is saved in the recycle bin.
• The delete /unreserved file-url command permanently deletes a file. The deleted file cannot be restored. Use it with caution.
90
Use undelete to restore a deleted file from the recycle bin.
dir /all displays the files deleted from the directory and moved to the recycle bin. These files are enclosed in pairs of brackets [ ]. To remove the files from the recycle bin, use the reset recycle-bin command.
Syntax
delete [ /unreserved ] file-url
View
User view
Default level
3: Manage level
Parameters
/unreserved: Permanently deletes the specified file, and the deleted file can never be restored.
file-url: Name of the file to be deleted. Asterisks (*) are acceptable as wildcards. For example, to remove files with the extension of .txt in the current directory, you may use the delete *.txt command.
Examples
# Remove file tt.cfg from the root directory of the storage medium on the master. <Sysname> delete tt.cfg
.
Delete flash:/tt.cfg?[Y/N]:y
.
%Delete file flash:/tt.cfg...Done.
# Remove file tt.cfg from the root directory of the storage medium on a subordinate (with the member ID 2).
• Approach 1 <Sysname> delete slot2#flash:/tt.cfg
Delete slot2#flash:/tt.cfg?[Y/N]:y
%Delete file slot2#flash:/tt.cfg...Done.
• Approach 2 <Sysname> cd slot2#flash:/
<Sysname> delete tt.cfg
Delete slot2#flash:/tt.cfg?[Y/N]:y
%Delete file slot2#flash:/tt.cfg...Done.
dir Description
Use dir to display information about all visible files and folders in the current directory.
• Use dir /all to display information about all files and folders in the current directory, including hidden files, hidden sub-folders and the files in the recycle bin that originally belong to the current directory. The names of these deleted files are enclosed in pairs of square brackets [ ].
• The dir file-url command displays information about a file or folder.
91
Syntax
dir [ /all ] [ file-url ]
View
User view
Default level
3: Manage level
Parameters
/all: Displays all files.
file-url: Name of the file or directory to be displayed. Asterisks (*) are acceptable as wildcards. For example, to display files with the .txt extension in the current directory, you may use the dir *.txt command.
Examples
# Display information about all files and folders in the storage medium of the master. <Sysname> dir /all
Directory of flash:/
0 -rwh 4 Apr 26 2008 12:02:05 snmpboots
1 -rw- 10187730 Apr 26 2008 16:47:07 startup.bin
2 -rwh 3144 Apr 26 2008 13:45:35 private-data.txt
3 -rw- 2161 Apr 26 2008 13:53:25 startup.cfg
4 -rw- 10058752 Sep 19 2008 17:41:46 startup1.bin
5 -rw- 10139143 Apr 26 2008 13:08:20 startup2.bin
6 -rwh 716 Apr 26 2008 12:01:58 hostkey
7 -rwh 572 Apr 26 2008 12:02:11 serverkey
8 -rwh 548 Apr 26 2008 12:02:17 dsakey
9 -rw- 3035 Apr 26 2008 13:45:42 new-config.cfg
10 -rw- 2200 Apr 26 2008 14:58:35 [aa.cfg]
515712 KB total (1801 KB free)
# Display information about all files and folders in the storage medium of a subordinate (with the member ID 2).
<Sysname> cd slot2#flash:/
<Sysname> dir /all
Directory of slot2#flash:/
0 -rwh 3144 Apr 26 2008 13:45:28 private-data.txt
1 -rw- 2341 Apr 26 2008 16:36:18 startup.cfg
2 -rw- 124 Apr 26 2008 12:00:22 patchstate
3 -rwh 716 Apr 26 2008 14:31:36 hostkey
4 -rwh 4 Apr 26 2008 14:31:41 snmpboots
5 -rw- 10187730 Apr 26 2008 12:01:10 startup.bin
6 -rwh 572 Apr 26 2008 14:31:47 serverkey
7 -rwh 548 Apr 26 2008 14:31:52 dsakey
8 -rw- 3035 Apr 26 2008 13:45:36 new-config.cfg
92
9 drw- - Apr 26 2008 12:11:53 oldver
515712 KB total (1839 KB free)
Table 11 Command output
Field Description
Directory of The current working directory.
d Indicates a directory. If this field does not exist, it indicates a file.
r Indicates that the file or directory is readable.
w Indicates that the file or directory is writable.
h Indicates that the file or directory is hidden.
[ ] Indicates that the file is in the recycle bin.
display nandflash file-location Description
Use display nandflash file-location for the location of a specific file in the NAND flash memory, including information about all the physical pages corresponding to the logical pages of the file.
Syntax
display nandflash file-location filename [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
2: System level
Parameters
filename: File name.
|: Filters command output by specifying a regular expression. For more information about regular expressions, see “CLI configuration.”
begin: Displays the first line that matches the regular expression and all lines that follow.
exclude: Displays all lines that do not match the regular expression.
include: Displays all lines that match the regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
93
Example
# Display the location of the file test.cfg in the NAND flash memory. <Sysname> display nandflash file-location test.cfg
Logical Chunk Physical Page
---------------------------
chunk(0) 1234
chunk(1) 1236
chunk(2) 1235
filename: test.cfg
Table 12 Command output
Field Description
Logic Chunk Serial number of the logical pages.
Physical Page Serial number of the physical pages.
chunk(0) 1234 The first logical page of this file corresponds to the 1234th physical page on the device.
display nandflash badblock-location Description
Use display nandflash badblock-location to view the number and location of bad blocks in the NAND flash memory.
Syntax
display nandflash badblock-location [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
2: System level
Parameters
|: Filters command output by specifying a regular expression. For more information about regular expressions, see "CLI configuration.”
begin: Displays the first line that matches the regular expression and all lines that follow.
exclude: Displays all lines that do not match the regular expression.
include: Displays all lines that match the regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
94
Example
# Display the number and location of bad blocks in the NAND flash memory. <Sysname> display nandflash badblock-location
No Physical block
------------------------------
badblock(0) 1234
badblock(1) 1235
badblock(2) 1236
3200 block(s) total, 3 block(s) bad.
Table 13 Command output
Field Description
No Serial number of the bad blocks
Physical block Serial number of the physical pages with bad blocks
3200 block(s) total, 3 block(s) bad. Total number of blocks and bad blocks in the NAND flash memory
display nandflash page-data Description
Use display nandflash page-data to view the data on the specified physical page in the NAND flash memory.
This command is always used in combination with the display nandflash file-location to check the correctness of the data in the NAND flash memory.
Syntax
display nandflash page-data page-value [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
page-value: Serial number of a physical page.
|: Filters command output by specifying a regular expression. For more information about regular expressions, see "CLI configuration.”
begin: Displays the first line that matches the regular expression and all lines that follow.
exclude: Displays all lines that do not match the regular expression.
include: Displays all lines that match the regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
95
Example
#Display the content of the file test.cfg which is saved in the NAND flash memory. <Sysname> display nandflash file-location test.cfg
Logical Chunk Physical Page
---------------------------
chunk(0) 1234
chunk(1) 1236
chunk(2) 1235
filename: test.cfg
<Sysname> display nandflash page-data 1236
0000: 0D 0A 23 0D 0A 20 76 65 72 73 69 6F 6E 20 35 2E ..#.. version 5.
• Batch files are command line files. Executing a batch file is to execute a set of command lines in the file.
• Do not include invisible characters in a batch file. When the system encounters them during processing, the batch process will abort and the commands that have been executed cannot be cancelled.
• Incorrectly configured batch file commands will not execute. When encountered, the system omits these commands and proceeds to the next command.
• Each configuration command in a batch file must be a standard configuration command, meaning that the valid configuration information can be displayed with the display current-configuration command.
• The configuration generated after a batch file executes is not automatically backed up to the standby main board.
Syntax
execute filename
View
System view
Default level
2: System level
Parameter
filename: Name of a batch file with a .bat extension. You can use the rename command to change the suffix of the configuration file to .bat to use it as a batch file.
96
Example
# Execute the batch file test.bat in the root directory. <Sysname> system-view
[Sysname] execute test.bat
file prompt Description
Use file prompt to set a prompt mode for file operations.
By default, the prompt mode is alert, which HP recommends to avoid abnormal operations.
Syntax
file prompt { alert | quiet }
View
System view
Default level
3: Manage level
Parameters
alert: Enables the system to warn you about operations that may bring undesirable results such as file corruption or data loss.
quiet: Disables the system from warning you about any operation.
Example
# Set the file operation prompt mode to alert. <Sysname> system-view
[Sysname] file prompt alert
fixdisk Description
Use fixdisk to restore the space of a storage medium when it becomes unavailable due to abnormal operation.
Syntax
fixdisk device
View
User view
Default level
3: Manage level
Parameter
device: Storage medium name.
97
Example
# Restore the space of the Flash. <Sysname> fixdisk flash:
Fixdisk flash: may take some time to complete...
%Fixdisk flash: completed.
format Description
CAUTION:
When you format a storage medium, the files are lost and cannot be restored. If a startup configuration file exists on a storage medium, formatting the storage medium results in loss of the startup configuration file.
Use format to format a storage medium.
Syntax
format device
View
User view
Default level
3: Manage level
Parameter
device: Name of a storage medium.
Example
#Format the Flash. <Sysname> format flash:
All data on flash: will be lost, proceed with format? [Y/N]:y
./
%Format flash: completed.
mkdir Description
Use mkdir to create a folder on the storage medium.
• The destination directory must exist. For instance, to create folder flash:/test/mytest, the test folder must exist. Otherwise, you will fail to create the mytest folder.
• The name of the folder to be created must be unique in the specified directory. Otherwise, mkdir will fail.
Syntax
mkdir directory
98
View
User view
Default level
3: Manage level
Parameter
directory: Name of a folder.
Examples
# Create a folder named test in the current directory. <Sysname> mkdir test
....
%Created dir flash:/test
# Create folder test/subtest in the current directory. <Sysname> mkdir test/subtest
....
%Created dir flash:/test/subtest
# Create folder test on a subordinate (with the member ID 2). <Sysname> mkdir slot2#flash:/test
....
%Created dir slot2#flash:/test.
more Description
This command is valid only for text files.
Use more to display the contents of a specific file when there are more lines that the screen can display.
Syntax
more file-url
View
User view
Default level
3: Manage level
Parameter
file-url: File name.
99
Examples
#Display the contents of file testcfg.cfg. <Sysname> more testcfg.cfg
#
version 5.20, Beta 1201, Standard
#
sysname Sysname
#
vlan 2
#
return
<Sysname>
#Display the contents of file testcfg.cfg on a subordinate (with the member ID 2). <Sysname> more slot2#flash:/testcfg.cfg
#
version 5.20, Release 0000
#
sysname Test
#
---- More ----
move Description
Use move to move a file.
• If you specify a target folder, the system will move the source file to the specified folder, with the file name unchanged.
• You cannot move files between storage media of different types.
Syntax
move fileurl-source fileurl-dest
View
User view
Default level
3: Manage level
Parameters
fileurl-source: Name of the source file.
fileurl-dest: Name of the target file or folder.
100
Examples
# Move file flash:/test/sample.txt to flash:/, and save it as 1.txt. <Sysname> move test/sample.txt 1.txt
Move flash:/test/sample.txt to flash:/1.txt?[Y/N]:y
...
% Moved file flash:/test/sample.txt to flash:/1.txt
# Move file b.cfg to the subfolder test2. <Sysname> move b.cfg test2
Move flash:/b.cfg to flash:/test2/b.cfg?[Y/N]:y
.
%Moved file flash:/b.cfg to flash:/test2/b.cfg.
pwd Description
Use pwd to display the current path.
Syntax
pwd
View
User view
Default level
3: Manage level
Parameters
None
Example
# Display the current path. <Sysname> pwd
flash:
rename Description
Use rename to rename a file or folder. The target file name must be unique in the path.
Syntax
rename fileurl-source fileurl-dest
View
User view
Default level
3: Manage level
101
Parameters
fileurl-source: Name of the source file or folder.
fileurl-dest: Name of the target file or folder.
Example
# Rename file sample.txt as sample.bat. <Sysname> rename sample.txt sample.bat
Rename flash:/sample.txt to flash:/sample.bat? [Y/N]:y
% Renamed file flash:/sample.txt to flash:/sample.bat
reset recycle-bin Description
Use reset recycle-bin to permanently delete the files in the recycle bin in the directory.
• If a file is corrupted, you may not be able to delete the file using the reset recycle-bin command. To force the corrupted file to delete, use the reset recycle-bin /force command.
• The delete file-url command only moves a file to the recycle bin, and the file still occupies the memory space. To delete the file in the recycle bin, execute the reset recycle-bin command in the original directory of the file.
• If the original path of the file to be deleted is not the current directory, use the cd to enter the original directory of the file, and then execute the reset recycle-bin command.
Syntax
reset recycle-bin [ /force ]
View
User view
Default level
3: Manage level
Parameter
/force: Deletes all files in the recycle bin, including files that cannot be deleted by the command without the /force keyword.
102
Examples
# Delete file b.cfg in the current directory and in the recycle bin.
• Display all the files in the recycle bin and in the current directory. <Sysname> dir /all
Directory of flash:/
0 -rwh 3080 Apr 26 2008 16:41:43 private-data.txt
1 -rw- 2416 Apr 26 2008 13:45:36 config.cfg
2 -rw- 8036197 May 14 2008 10:13:18 main.bin
3 -rw- 2386 Apr 26 2008 13:30:30 back.cfg
4 drw- - May 08 2008 09:49:25 test
5 -rwh 716 Apr 24 2007 16:17:30 hostkey
6 -rwh 572 Apr 24 2007 16:17:44 serverkey
7 -rw- 2386 May 08 2008 11:14:20 [a.cfg]
8 -rw- 3608 Dec 03 2007 17:29:30 [b.cfg]
515712 KB total (6730 KB free)
//The output shows that the current directory is flash:, and two files a.cfg and b.cfg are in the recycle bin.
• Delete file b.cfg in the current directory and in the recycle bin. <Sysname> reset recycle-bin
Clear flash:/~/a.cfg ?[Y/N]:n
Clear flash:/~/b.cfg ?[Y/N]:y
Clearing files from flash may take a long time. Please wait...
......
%Cleared file flash:/~/b.cfg...
• In directory flash:, check whether the file b.cfg in the recycle bin is deleted. <Sysname> dir /all
Directory of flash:/
0 -rwh 3080 Apr 26 2008 16:41:43 private-data.txt
1 -rw- 2416 Apr 26 2008 13:45:36 config.cfg
2 -rw- 8036197 May 14 2008 10:13:18 main.bin
3 -rw- 2386 Apr 26 2008 13:30:30 back.cfg
4 drw- - May 08 2008 09:49:25 test
5 -rwh 716 Apr 24 2007 16:17:30 hostkey
6 -rwh 572 Apr 24 2007 16:17:44 serverkey
7 -rw- 2386 May 08 2008 11:14:20 [a.cfg]
515712 KB total (6734 KB free)
// The output shows that file flash:/b.cfg is deleted permanently.
103
rmdir Description
Use rmdir to remove a folder.
• The folder must be an empty one. If not, delete all files and subfolders under it with the delete command.
• After you execute the rmdir command successfully, the files in the recycle bin in the folder will be deleted automatically.
Syntax
rmdir directory
View
User view
Default level
3: Manage level
Parameter
directory: Name of the folder.
Example
# Remove folder mydir. <Sysname> rmdir mydir
Rmdir flash:/mydir?[Y/N]:y
%Removed directory flash:/mydir.
undelete Description
Use undelete to restore a file from the recycle bin.
If you create a file with the same name in the same path, the system prompts you whether to overwrite the original file.
Syntax
undelete file-url
View
User view
Default level
3: Manage level
Parameter
file-url: Name of the file to be restored.
104
Examples
# Restore file a.cfg in directory flash: from the recycle bin. <Sysname> undelete a.cfg
Undelete flash:/a.cfg?[Y/N]:y
.....
%Undeleted file flash:/a.cfg.
# Restore file b.cfg in directory flash:/test from the recycle bin. <Sysname> undelete flash:/test/b.cfg
Undelete flash:/test/b.cfg?[Y/N]:y
.......
%Undeleted file flash:/test/b.cfg.
# Or, you can use the following steps to restore file flash:/test/b.cfg. <Sysname> cd test
<Sysname> undelete b.cfg
Undelete flash:/test/b.cfg?[Y/N]:y
%Undeleted file flash:/test/b.cfg.
105
Configuration file management commands
archive configuration Description
Use archive configuration to manually save the running configuration.
• Before executing archive configuration, you must configure the filename prefix and path for saving configuration files using the archive configuration location command.
• When archive configuration executes, the running configuration file (filename prefix + serial number) is saved to the master. The subordinate switches do not perform the saving operation.
Syntax
archive configuration
View
User view
Default level
3: Manage level
Parameters
None
Example
# Save the running configuration manually. <Sysname> archive configuration
Warning: Save the running configuration to an archive file. Continue? [Y/N]: Y
Please wait...
Info: The archive configuration file myarchive_1.cfg is saved.
archive configuration interval Description
Use archive configuration interval to enable the automatic saving of the running configuration and set the interval.
• Before executing the archive configuration interval command, you must configure the filename prefix and path for saving configuration files by using the archive configuration location command.
• The archive configuration interval command executes on the master and its subordinate switches. Executing this command on the subordinate switches ensures configuration rollback after the master is changed.
• Configure an automatic saving interval according to the storage media performance and the frequency of configuration modification.
106
• If switch configuration does not change frequently, HP recommends that you save the running configuration manually.
Use undo archive configuration interval to restore the default (the system does not automatically save by default).
Syntax
archive configuration interval minutes
undo archive configuration interval
View
System view
Default level
3: Manage level
Parameter
minutes: Specifies the interval for automatically saving the running configuration, in minutes. The value ranges from 10 to 525,600 (365 days).
Example
# Configure the system to save the running configuration every 60 minutes. <Sysname> system-view
[Sysname] archive configuration interval 60
Info: Archive files will be saved every 60 minutes.
archive configuration location Description
Before executing this command, verify that the path is available on both the master and the subordinate switches. The path cannot include any member ID.
Use archive configuration location to configure the path and filename prefix for saving configuration files on both master and subordinate switches.
• Before the running configuration is saved either manually or automatically, the file path and filename prefix must be configured.
• When the switch is operating in active/standby mode, the saving and rollback operations are executed only on the master. After the active/standby switchover, the configuration rollback can take effect on the new master.
Use undo archive configuration location to restore the default.
• By default, the path and filename prefix for saving configuration files are not configured, and the system does not save the configuration file periodically.
• If this command is executed, the running configuration cannot be saved manually or automatically.
• The configuration done by executing the archive configuration interval and archive configuration max commands will restore the default, and clear the saved configuration files.
directory: The path of the folder for saving configuration files, a string of 1 to 63 case-insensitive characters, in the format of storage media name:/[folder name]/subfolder name. The folder must be created before the configuration.
filename-prefix: The filename prefix for saving configuration files, a case-insensitive string of 1 to 30 characters (can include letters, numbers, _, and - only).
Example
# Configure the path and the filename prefix for saving configuration files as flash:/archive/ and my_archive respectively.
• Create folder flash:/archive on the master. <Sysname> mkdir archive
.
%Created dir flash:/archive.
• Create folder flash:/archive on a subordinate switch with the member ID 2. <Sysname> mkdir slot2#flash:/archive
%Created dir slot2#flash:/archive.
• Configure the path and the filename prefix for saving configuration files. <Sysname> system-view
Before executing this command, configure the path and filename prefix for saving configuration files by using the archive configuration location command; otherwise, the execution of this command fails. If the undo archive configuration location command is executed, the maximum number of configuration files that can be saved also restores to the default.
Use archive configuration max to set the maximum number of configuration files that can be saved.
• Excessive configuration files occupy large memory space: Use this command to control the number of files.
• After the maximum number of configuration files is saved, the system deletes the oldest files when the next file is saved (either automatically or manually).
108
• When you change the maximum number of configuration files that can be saved, the exceeded files are not deleted.
• If the number of the existing configuration files is larger than or equal to the newly configured upper limit, the system deletes the oldest n files when the next file is saved, where n = the current number - the newly configured number + 1, for example: if the number of configuration files that have been saved is 7, and the newly configured upper limit is 4, when there is a new configuration file to be saved, the system deletes the 4 oldest files, where 4 = 7-4+1.
Use undo archive configuration max to restore the default (five is the maximum number of configuration files saved by default).
Syntax
archive configuration max file-number
undo archive configuration max
View
System view
Default level
3: Manage level
Parameter
file-number: The maximum number of configuration files that can be saved, in the range 1 to 10. The value of the file-number argument is determined by the memory space. If the available memory space is small, set a comparatively small value for this argument.
Example
# Set the maximum number of configuration files that can be saved to 10. <Sysname> system-view
[Sysname] archive configuration max 10
backup startup-configuration Description
For a switch that has main and backup startup configuration files, this command only backs up the main startup configuration file.
Currently, the switch uses TFTP to back up configuration files.
Use backup startup-configuration to back up the startup configuration file for the next system startup to a specified TFTP server. If you do not specify this filename, the original filename is used.
Syntax
backup startup-configuration to dest-addr [ dest-filename ]
View
User view
Default level
2: System level
109
Parameters
dest-addr: IP address or name of a TFTP server. The address cannot be an IPv6 address.
dest-filename: Target filename used to save the startup configuration file for the next system startup on the server.
Example
# Back up the startup configuration file of the device to the TFTP server with IP address 2.2.2.2, using filename 192-168-1-26.cfg.
<Sysname> display startup
Current startup saved-configuration file: flash:/config.cfg
Next startup saved-configuration file: flash:/test.cfg
<Sysname> backup startup-configuration to 2.2.2.2 192-168-1-26.cfg
Backup next startup-configuration file to 2.2.2.2, please wait…finished!
<Sysname>
After the operation, the device backs up file test.cfg to TFTP server 2.2.2.2, where the file is saved as 192-168-1-26.cfg.
configuration replace file Description
Use configuration replace file to set configuration rollback.
• The configuration file specified with the configuration replace file filename command can only be a simple-text file. Otherwise, errors can occur during configuration rollback.
• When this command is executed, the running configuration rolls back to the configuration state based on the specified configuration file (filename).
Syntax
configuration replace file filename
View
System view
Default level
3: Manage level
Parameter
filename: Specifies the name of the replacement configuration file for configuration rollback.
Example
# Roll back from the running configuration to a previous configuration state based on a saved configuration file my_archive_1.cfg.
Info: Now replacing the current configuration. Please wait...
Info: Succeeded in replacing current configuration with the file
my_archive_1.cfg.
110
display archive configuration Description
Use display archive configuration to display information about configuration rollback.
Syntax
display archive configuration [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
|: Filters command output by specifying a regular expression. For more information about regular expressions, see CLI configuration in the Fundamentals Configuration Guide.
begin: Displays the first line that matches the regular expression and all lines that follow.
exclude: Displays all lines that do not match the regular expression.
include: Displays all lines that match the regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Example
# Display information about configuration rollback. <Sysname> display archive configuration
Location: flash:/archive
Filename prefix: my_archive
Archive interval in minutes: 120
Maximum number of archive files: 10
Saved archive files:
No. TimeStamp FileName
1 Aug 05 2007 20:24:54 my_archive_1.cfg
2 Aug 05 2007 20:34:54 my_archive_2.cfg
# 3 Aug 05 2007 20:44:54 my_archive_3.cfg
‘#’ indicates the most recent archive file.
Next archive file to be saved: my_archive_4.cfg
Table 14 Command output
Field Description
Location Absolute path of the saved configuration files.
Filename prefix Filename prefix of the saved configuration files.
Archive interval in minutes Configuration file saving interval, in minutes.
If the automatic saving is disabled, this field is not displayed.
Filename Filename of the saved configuration files, with path excluded.
111
display current-configuration Description
Use display current-configuration to view the current validated device configuration.
• Parameter retaining their default configurations are not displayed.
• If a validated parameter is changed when you configure it, it is displayed. For example, IP address 11.11.11.11 24 has been configured on a Loopback interface. 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, and display saved-configuration.
configuration [ configuration ]: display a 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:
• isis: Displays the isis configuration.
• isp: Displays the ISP configuration.
• post-system: Displays the post-system configuration.
• radius-template: Displays the Radius template configuration.
• system: Displays the system configuration.
• 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.
exclude modules: Excludes the configuration of a specific module. The modules argument can be acl, acl6, or both separated by a space.
• acl: Excludes the IPv4 ACL configuration.
• acl6: Excludes the IPv6 ACL configuration.
by-linenum: Specifies to display the number of each line.
|: Filters command output by specifying a regular expression. For more information about regular expressions, see CLI configuration in the Fundamentals Configuration Guide.
begin: Displays the first line that matches the regular expression and all lines that follow.
exclude: Displays all lines that do not match the regular expression.
112
include: Displays all lines that match the regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Examples
# Display the configuration from the line containing “user-interface” to the last line in the current validated configuration.
<Sysname> display current-configuration | begin user-interface
user-interface aux 0
user-interface vty 0 15
authentication-mode none
user privilege level 3
#
return
# Display the current valid SNMP configuration on the device. (The output information depends on your 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
display default-configuration Description
Use display default-configuration to display all commands to be executed when the device boots with the factory defaults.
Related commands: display current-configuration and display saved-configuration.
Syntax
display default-configuration [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
2: System level
Parameters
|: Filters command output by specifying a regular expression. For more information about regular expressions, see CLI configuration in the Fundamentals Configuration Guide.
begin: Displays the first line that matches the regular expression and all lines that follow.
exclude: Displays all lines that do not match the regular expression.
include: Displays all lines that match the regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
113
Example
# Display the factory defaults of the device. <Sysname> display default-configuration
#
domain default enable system
#
telnet server enable
#
undo ip redirects
undo ip ttl-expires
undo ip unreachables
#
vlan 1
#
radius scheme system
server-type extended
primary authentication 127.0.0.1 1645
primary accounting 127.0.0.1 1646
user-name-format without-domain
#
domain system
access-limit disable
state active
idle-cut disable
self-service-url disable
#
interface NULL0
#
interface GigabitEthernet1/0/1
#
interface GigabitEthernet1/0/2
#
interface GigabitEthernet1/0/3
#
interface GigabitEthernet1/0/4
#
interface GigabitEthernet1/0/5
#
interface GigabitEthernet1/0/6
#
interface GigabitEthernet1/0/7
#
interface GigabitEthernet1/0/8
#
interface GigabitEthernet1/0/9
#
interface GigabitEthernet1/0/10
114
#
interface GigabitEthernet1/0/11
#
interface GigabitEthernet1/0/12
#
interface GigabitEthernet1/0/13
#
interface GigabitEthernet1/0/14
#
interface GigabitEthernet1/0/15
#
interface GigabitEthernet1/0/16
#
interface GigabitEthernet1/0/17
#
interface GigabitEthernet1/0/18
#
interface GigabitEthernet1/0/19
#
interface GigabitEthernet1/0/20
#
interface GigabitEthernet1/0/21
#
interface GigabitEthernet1/0/22
#
interface GigabitEthernet1/0/23
#
interface GigabitEthernet1/0/24
#
interface Ten-GigabitEthernet1/0/25
#
interface Ten-GigabitEthernet1/0/26
#
interface Ten-GigabitEthernet1/0/27
#
interface Ten-GigabitEthernet1/0/28
#
user-interface aux 0
user-interface vty 0 4
#
return
display saved-configuration Description
Use display saved-configuration to view the contents of the configuration file saved for the next system startup.
115
• During device management and maintenance, you can use this command to check whether important configurations are saved to the configuration file for the next system startup.
• For a switch supporting main and backup configuration files, this command displays the main configuration file for the next system startup.
• If a configuration file is not specified or does not exist for the next startup, the display saved-configuration command displays the default configuration file of the switch.
• If the default configuration file does not exist, the system prompts “The config file does not exist!."
• The configurations are displayed in the order of global, port, and user interface.
The More prompt indicates that there are more lines than the screen can display.
• Pressing Enter displays the next line.
• Pressing Space displays the next screen.
• Pressing Ctrl+C or any other key exist the display.
Related commands: save, reset saved-configuration, and display current-configuration (in Device Management in the Fundamentals Command Reference).
Syntax
display saved-configuration [ by-linenum ] [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
2: System level
Parameters
by-linenum: Identifies each line of displayed information with a line number.
|: Filters command output by specifying a regular expression. For more information about regular expressions, see CLI configuration in the Fundamentals Configuration Guide.
begin: Displays the first line that matches the regular expression and all lines that follow.
exclude: Displays all lines that do not match the regular expression.
include: Displays all lines that match the regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
116
Examples
# Display the configuration file saved for the next system startup. <Sysname> display saved-configuration
#
version 5.20, Test 5310
#
sysname Sysname
#
domain default enable system
#
telnet server enable
#
multicast routing-enable
#
vlan 1
#
vlan 999
#
domain system
access-limit disable
state active
idle-cut disable
self-service-url disable
#
interface NULL0
#
---- More ----
# Display the contents of the configuration file saved for the next system startup with a number identifying each line.
<Sysname> display saved-configuration by-linenum
1: #
2: version 5.20, Test 5310
3: #
4: sysname Sysname
5: #
6: domain default enable system
7: #
8: telnet server enable
9: #
10: multicast routing-enable
11: #
12: vlan 1
13: #
14: vlan 999
15: #
16: domain system
17: access-limit disable
117
18: state active
19: idle-cut disable
20: self-service-url disable
21: #
22: interface NULL0
23: #
---- More ----
display startup Description
Use display startup to view the configuration file for the system startup and the configuration files for the next system startup.
• After the master is changed, it runs with the current configuration.
• The subordinate switches are started and run based on the current master configuration.
• When you execute the display startup command, the startup configuration file for the current startup of the new master is displayed as NULL. The subordinate switches will also be NULL to be consistent with the new master.
• The current startup configuration files displayed on all member devices of an IRF virtual device are always the same.
Related commands: startup saved-configuration.
Syntax
display startup [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
|: Filters command output by specifying a regular expression. For more information about regular expressions, see CLI configuration in the Fundamentals Configuration Guide.
begin: Displays the first line that matches the regular expression and all lines that follow.
exclude: Displays all lines that do not match the regular expression.
include: Displays all lines that match the regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
118
Example
# Display the startup configuration file for the current system startup and the startup configuration files for the next system startup.
<Sysname> display startup
MainBoard:
Current startup saved-configuration file: NULL
Next main startup saved-configuration file: flash:/startup.cfg
Next backup startup saved-configuration file: flash:/startup2.cfg
Slot 2:
Current startup saved-configuration file: NULL
Next main startup saved-configuration file: flash:/startup.cfg
Next backup startup saved-configuration file: flash:/startup2.cfg
Table 15 Command output
Field Description
MainBoard The configuration files for the current and the next startup of the master
Current Startup saved-configuration file The configuration file for the current startup
Next main startup saved-configuration file The main configuration file for the next startup
Next backup startup saved-configuration file The backup configuration file for the next startup
Slot 2 The configuration files for the current and the next startup of the subordinate switch (with the member ID 2)
display this Description
Use display this to check whether your configuration takes effect by displaying the validated configuration information under the current view.
• The validated default configuration is not displayed.
• The invalidated configuration is not displayed.
• Execution of this command in any user interface view displays the valid configuration in all the user interfaces.
• Execution of this command in any VLAN view displays the configurations of all the created VLANs.
Syntax
display this [ by-linenum ] [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
119
Parameters
by-linenum: Displays the number of each line.
|: Filters command output by specifying a regular expression. For more information about regular expressions, see CLI configuration in the Fundamentals Configuration Guide.
begin: Displays the first line that matches the regular expression and all lines that follow.
exclude: Displays all lines that do not match the regular expression.
include: Displays all lines that match the regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Examples
# Display the valid configuration information on interface GigabitEthernet1/0/1.(The output information depends on your device model and the current configuration.)
<Sysname> system-view
[Sysname] interface gigabitethernet 1/0/1
[Sysname-GigabitEthernet1/0/1] display this
#
interface GigabitEthernet1/0/1
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 about all user interfaces. (The output information depends on your device model and the current configuration.)
<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 15
#
return
120
reset saved-configuration Description
Use reset saved-configuration to delete the startup configuration files saved on the storage media of the device.
• This command will permanently delete the startup configuration file from all member devices of the IRF virtual device. Use it with caution.
• You can delete either the main or backup startup configuration file. However, if these files are the same, the system will only set the corresponding startup configuration file (main or backup, according to which one you specified in the command) to NULL.
• Both the reset saved-configuration command and the reset saved-configuration main command delete the main startup configuration file.
Syntax
reset saved-configuration [ backup | main ]
View
User view
Default level
3: Manage level
Parameters
backup: Deletes the backup startup configuration file.
main: Deletes the main startup configuration file.
Related commands: save and display saved-configuration.
Example
# Delete the startup configuration file for the next startup from the storage media of the device. <Sysname> reset saved-configuration backup
The saved configuration file will be erased. Are you sure? [Y/N]:y
Configuration file in flash is being cleared.
Please wait ...
..
MainBoard:
Configuration file is cleared.
Slot 2:
Erase next configuration file successfully
121
restore startup-configuration Description
Use restore startup-configuration to download a configuration file from the specified TFTP server to the switch, and specify it as the startup configuration file for the next system startup.
• The downloaded file is set as the main startup configuration file for the next system startup.
• This command downloads the configuration file to the storage media root directory of all member devices and specifies the file as the startup configuration file for the next startup of all member devices.
• If the file to be downloaded has the same filename as an existing file on a member device, a prompt asks if you want to overwrite the existing file.
• Both master and subordinate switches are assumed to use the same type of storage media when the device is checking the filename or backing up the configuration file to the subordinate switches. If the master and the subordinate switches are of different types, the backup operation fails.
• When backing up the configuration file to the subordinate switches, the device saves the file to the root directory.
Syntax
restore startup-configuration from src-addr src-filename
View
User view
Default level
3: Manage level
Parameters
src-addr: IP address or name of a TFTP server. The address cannot be an IPv6 address.
src-filename: Filename of the configuration file to be downloaded from the specified server.
Example
# Download file config.cfg from the TFTP server whose IP address is 2.2.2.2, and the file is to be used as the main startup configuration file for the next system startup.
<Sysname> restore startup-configuration from 2.2.2.2 config.cfg
Restore next startup-configuration file from 2.2.2.2. Please wait...finished!
Now restore next startup-configuration file from main to slave board. Please
wait...finished!
122
save Description
Use save file-url [ all | slot slot-number ] to save the current configuration to the specified configuration file, but not the startup configuration file for the next system startup.
• If the file specified by file-url does not exist, the system will create the file and then save the configuration to the file.
• If the all or slot parameter is not included, the configuration is saved to the master.
• Use save [ safely ] [ backup | main ] [ force ] to save the current configuration to the root directory of a member device’s storage media, and specify the file as the startup configuration file for the next system startup. If the backup keyword is not included, the main keyword is used by default.
• The configuration file auto-save function determines whether the save [ safely ] [ backup | main ] [ force ] command or the save file-url all command+Enter takes effect on all member devices or only on the master.
Related commands: slave auto-update config, reset saved-configuration, display current-configuration, and display saved-configuration.
Syntax
save file-url [ all | slot slot-number ]
save [ safely ] [ backup | main ] [ force ]
View
Any view
Default level
2: System level
Parameters
file-url: File path, where the extension of the file name must be .cfg. When used with the keyword all or slot, this argument cannot include a member ID. If the file path includes a folder name, you must first create the folder on the member device; otherwise, the operation will fail.
all: Saves the current configuration in the specified filename to all member devices of an IRF virtual device..
slot slot-number: Saves the current configuration in the specified filename to a subordinate switch. slot-number represents the member ID of a member device of an IRF virtual device.
safely: Sets the configuration saving mode to safe. If this argument is not specified, the configuration file is saved in fast mode.
backup: Saves the current configuration to the startup configuration file specified in the interactive mode, and specifies the file as the backup startup configuration file for the next system startup.
main: Saves the current configuration to the main startup configuration file specified in the interactive mode, and specifies the file as the main startup configuration file for the next system startup.
force: Saves the current configuration to the configuration file for the next system startup, and the system does not output any interaction information. By default, when you execute the save command, the system asks you to input Y or N to confirm your operation. If you do not confirm your operation
123
within 30 seconds, the system automatically quits the operation. If you provide the force keyword when executing the save command, the system directly saves the current configuration, not requiring any confirmation.
Examples
# Save the current configuration to the root directory of the storage media on a member device, and specify the file as the startup configuration file for the next startup.
<Sysname> display startup
MainBoard:
Current startup saved-configuration file: NULL
Next main startup saved-configuration file: flash:/aa.cfg
Next backup startup saved-configuration file: NULL
Slot 2:
Current startup saved-configuration file: NULL
Next main startup saved-configuration file: flash:/aa.cfg
Next backup startup saved-configuration file: NULL
// The output indicates that the main startup configuration file for the next startup of all the member devices is aa.cfg.
<Sysname> save
The current configuration will be written to the device. Are you sure? [Y/N]:y
Please input the file name(*.cfg)[flash:/aa.cfg]
(To leave the existing filename unchanged, press the enter key):startup.cfg
flash:/startup.cfg exists, overwrite? [Y/N]:y
Validating file. Please wait.................
Saved the current configuration to mainboard device successfully.
Slot 2:
Save next configuration file successfully
Configuration is saved to device successfully.
<Sysname> display startup
MainBoard:
Current startup saved-configuration file: NULL
Next main startup saved-configuration file: flash:/startup.cfg
Next backup startup saved-configuration file: NULL
Slot 2:
Current startup saved-configuration file: NULL
Next main startup saved-configuration file: flash:/startup.cfg
Next backup startup saved-configuration file: NULL
// The output indicates that the main startup configuration file for the next startup of all member devices of the IRF virtual device is changed to startup.cfg.
124
# Save the current configuration in the name of test.cfg to a subordinate switch.
• Approach 1: With the member ID of 2: <Sysname> save test.cfg slot 2
The current configuration will be saved to slot2#flash:/test.cfg.
Configuration is saved to slot2#flash successfully.
• Approach 2: Use the following command: <Sysname> save slot2#flash:/test.cfg
# Save the current configuration to the main startup configuration file for the next startup of the device, without any confirmation required.
<Sysname> save force
Validating file. Please wait.................
Saved the current configuration to mainboard device successfully.
Slot 2:
Save next configuration file successfully
Configuration is saved to device successfully.
slave auto-update config Description
Use slave auto-update config to enable the configuration file auto-save function. By default, the configuration file auto-save function is enabled.
Use undo slave auto-update config to disable the function.
Syntax
slave auto-update config
undo slave auto-update config
View
System view
Default level
2: System level
Parameters
None
Example
# Enable the configuration file auto-save function. <Sysname> system-view
[Sysname] slave auto-update config
125
startup saved-configuration Description
Before using the command, ensure that the configuration file has been saved to the root directories of the storage media of all the member devices.
Use startup saved-configuration to specify a next system startup configuration file for all member devices.
• The startup configuration file for the next startup of all the member devices must be the same.
• The startup saved-configuration and startup saved-configuration main commands have the same effect: Use both of them to specify the main startup configuration file.
• The main and backup startup configuration files can be specified as the same file. However, HP recommends that you use different files, or, save the same configuration file twice naming one the main startup configuration file, and the other the backup.
Use undo startup saved-configuration to configure all the member devices to start up with the null (factory) configuration.
• If you execute the undo startup saved-configuration command, the system sets the main and backup startup configuration file as NULL, but does not delete the two configuration files.
• When you execute the undo startup saved-configuration command and reboot the IRF virtual device or an IRF member device, the IRF virtual device is partitioned.
Related commands: display startup.
Syntax
startup saved-configuration cfgfile [ backup | main ]
undo startup saved-configuration
View
User view
Default level
3: Manage level
Parameters
cfgfile: Configuration file name. The file must be a file with an extension .cfg stored in the root directory of the storage media.
backup: Sets the configuration file as the backup startup configuration file for the next system startup.
main: Sets the configuration file as the main startup configuration file for the next system startup.
126
Example
# Specify a startup configuration file for the next system startup. <Sysname> startup saved-configuration testcfg.cfg
Please wait ...
Setting the master board ..........
... Done!
Setting the slave board ...
Slot 2:
Set next configuration file successfully
127
Software upgrade commands
boot-loader Description
Use boot-loader to specify a boot file for the next device boot of a member switch.
• To execute the boot-loader command successfully, save the file to be used at the next device boot in the root directory of the storage media on a member switch.
• If the storage media is on the master, specify the storage media by giving its name, such as flash.
• If the storage media is on a subordinate switch, specify the storage media by giving its name and the member ID of the switch, that is, in the format of slotslot-number# StorageMediumName (slot-number represents the member ID of the subordinate), such as slot2#flash.
• When you specify the master’s boot file, the file-url parameter cannot contain the device’s member ID, and slot-number should be specified as the master’s member ID.
• When you specify the subordinate switch’s boot file, the file-url argument must contain the member ID (such as slot2#flash:/test.bin), and slot-number should be specified as the subordinate switch’s member ID.
• If you provide the keyword all, the file-url parameter cannot contain a member ID, otherwise, the execution of this command will fail. You must save the boot file on the storage media of all member switches in the same filename, otherwise, member switches without this file will fail to be reconfigured during the reboot.
• The names of the files for the next boot of the master and subordinate switches may be different, but the file versions must be the same, otherwise, a subordinate switch will reboot using the master's boot file and rejoin the IRF virtual device.
Related commands: display boot-loader.
Syntax
boot-loader file file-url slot { all | slot-number } { main | backup }
View
User view
Default level
3: Manage level
Parameters
file file-url: Specifies a file name, a string of 1 to 63 characters. If you enter a relative path here, the system automatically converts it to an absolute path. The absolute path should contain no more than 63 characters; otherwise, the command cannot be successfully executed. The file name is in the format of [drive:/]file-name, where the following conditions apply:
• The items in square brackets [ ] are optional.
128
• drive specifies the storage media of the file. The value is the name of the storage media. If a device has only one storage media, you can execute this command without providing this argument.
• file-name specifies the filename, usually suffixed by .bin.
slot slot-number: Specifies the member ID of a device.
• all: Specifies a file as the boot file at the next boot for all member switches of an IRF virtual device. Support for this keyword depends on the device model.
• slot-number: Specifies a file as the boot file at the next boot for a member switch. The slot-number argument is the ID of a member switch of the current IRF virtual device.
main: Specifies a file as a main boot file. Use a main boot file to boot a device.
backup: Specifies a file as a backup boot file. Use a backup boot file to boot a device only when a main boot file is unavailable.
Examples
# Specify the main boot file for the master (the member ID is 1) for the next device boot as test.bin. (Make sure that the file test.bin is already saved on the storage media of the master; otherwise, the system prompts an error, and the execution of the command fails.)
<Sysname> boot-loader file test.bin slot 1 main
This command will set the boot file of the specified board. Continue? [Y/N]:y
The specified file will be used as the main boot file at the next reboot on
slot 1!
# Specify the main boot file for the subordinate switch (the member ID is 2) for the next device boot as test.bin. (Make sure that the file test.bin is already saved on the storage media of the subordinate switch; otherwise, the system prompts an error, and the execution of the command fails.)
<Sysname> boot-loader file slot2#flash:/test.bin slot 2 main
This command will set the boot file of the specified board. Continue? [Y/N]:y
The specified file will be used as the main boot file at the next reboot on
slot 2!
# Specify the main boot file for all member switches for the next device boot as test.bin. (Make sure that the file test.bin is already saved on the storage media of all the member switches; otherwise, the system prompts an error and the execution of the command fails.)
<Sysname> boot-loader file test.bin slot all main
This command will set the boot file of the specified board. Continue? [Y/N]:y
The specified file will be used as the main boot file at the next reboot on
slot 1!
The specified file will be used as the main boot file at the next reboot on
slot 2!
boot-loader update file Description
Use boot-loader update file to specify a boot file to be used at the next boot of a member switch or all the member switches. Execution of this command equals the following steps:
• Copying a boot file to an IRF member switch. If the all keyword is specified, the boot file is copied to all the current IRF virtual device’s member switches.
• Specifying the file as the boot file to be used at the next boot of the member switch.
129
Syntax
boot-loader update file file-url slot { slot-number | all } { main | backup }
View
User view
Default level
3: Manage level
Parameters
file-url: Specifies a file name, a string of 1 to 63 characters. For more information, see boot-loader.
slot: Specifies the member ID of a device.
• slot-number: Specifies to upgrade the boot file of a member switch. slot-number is the ID of a member switch of the current IRF virtual device.
• all: Specifies to upgrade boot files for or all member switches of an IRF virtual device.
main: Specifies a file as the main boot file. Use a main boot file to boot a device.
backup: Specifies a file as the backup boot file. Use a backup boot file to boot a device only when a main boot file is unavailable.
Example
# Specify a boot file for the whole switch. <Sysname> boot-loader update file main.bin slot all main
This command will update the specified boot file of all boards. Continue?
[Y/N]:Y
Now is updating, please wait...
<Sysname> reboot
bootrom Description
Use bootrom to read, restore, back up, or upgrade the BOOT ROM program on specified member switches. To execute the bootrom command, save the BOOT ROM program under the root directory of the storage media on a member switch.
• If the storage media is on the master, specify the storage media by giving its name, such as flash.
• If a storage media is on a subordinate switch, specify the storage media by giving its name and the member ID of the device in the format of slotslot-number# StorageMediumName (slot-number represents the subordinate switch’s member ID), such as slot2#flash.
• When you upgrade the master’s BOOT ROM program, the file-url argument cannot contain the device’s member ID, and slot-number should be specified as the master’s member ID.
• When you upgrade the BOOT ROM program for a subordinate switch, the file-url argument must contain the member ID (such as slot2#flash:/test.bin), the slot-number should be specified as the subordinate switch’s member ID, and the subslot-number-list argument should be specified as the subordinate switch’s subslot number.
update file file-url: Upgrades Boot ROM, where file-url is a string of 1 to 63 characters and represents name of the file to be upgraded. For more information about the file-url argument, see boot-loader.
slot slot-number-list: Specifies a list of IDs of member switches, in the format of { slot-number [ to slot-number ] }&<1-7>. The slot-number argument is the ID of a member switch of the current IRF virtual device.
Examples
# Use a.btm file to upgrade the Boot ROM program on the master with member ID of 1. <Sysname> bootrom update file a.btm slot 1
This command will update bootrom file on the specified board(s), Continue?
[Y/N]:y
Now updating bootrom, please wait...
Bootrom update succeeded in slot 1.
# Use the a.btm file to upgrade the Boot ROM program on the subordinate switch with member ID of 2. (The output of this command varies with devices.)
This command will update bootrom file on the specified board(s), Continue?
[Y/N]:y
Now updating bootrom, please wait...
Bootrom update succeeded in slot 2.
bootrom-update security-check enable Description
Use bootrom-update security-check enable to enable the validity check function.
• By default, the validity check function is enabled at the time of upgrading BOOT ROM.
• After the validity check function is enabled, the device will strictly check whether the BOOT ROM upgrade files are valid and can match the hardware.
Use undo bootrom-update security-check enable to disable the validity check function.
Syntax
bootrom-update security-check enable
undo bootrom-update security-check enable
View
System view
131
Default level
2: System level
Parameters
None
Example
# Enable the validity check function when upgrading Boot ROM. <Sysname> system-view
[Sysname] bootrom-update security-check enable
display boot-loader Description
Use display boot-loader to display boot file information.
Related commands: boot-loader.
Syntax
display boot-loader [ slot slot-number ] [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
2: System level
Parameters
slot slot-number: Displays boot file information of a member switch. The slot-number argument is the ID of a member switch of the current IRF virtual device.
|: Filters command output by specifying a regular expression. For more information about regular expressions, see CLI configuration in the Fundamentals Configuration Guide.
begin: Displays the first line that matches the regular expression and all lines that follow.
exclude: Displays all lines that do not match the regular expression.
include: Displays all lines that match the regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Examples
# Display the file adopted for the current and next boot of the device. (The output of this command varies with devices.)
<Sysname> display boot-loader
Slot 1
The current boot app is: flash:/test.bin
The main boot app is: flash:/test.bin
The backup boot app is: flash:/test.bin
132
Table 16 Command output
Field Description
Slot 1 The member ID of the device is 1
The current boot app is Boot file used for the device for the current device boot
The main boot app is Main boot file used for the next device boot of the device
The backup boot app is Backup boot file used for the next device boot of the device
display patch information Description
Use display patch information to view hotfix information.
Syntax
display patch information [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
3: Manage level
Parameters
|: Filters command output by specifying a regular expression. For more information about regular expressions, see CLI configuration in the Fundamentals Configuration Guide.
begin: Displays the first line that matches the regular expression and all lines that follow.
exclude: Displays all lines that do not match the regular expression.
include: Displays all lines that match the regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Example
# Display hotfix information. <Sysname> display patch information
The location of patches: flash:
Slot Version Temporary Common Current Active Running Start-Address
The location of patches Patch file location. To configure the location, use the patch location command.
Slot Member ID.
Version Patch version. The first three characters represent the suffix of the PATCH-FLAG.
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 memory patch area in the memory.
patch active Description
The command applies to only patches in the DEACTIVE state.
Use patch active to activate the specified patch.
• After you execute the command, all the DEACTIVE patches before the specified patch are activated.
• After a system reboot, the original ACTIVE patches change to DEACTIVE and become invalid. To make them effective, activate them again.
Syntax
patch active patch-number slot slot-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 the ID of a member switch of the current IRF virtual device.
Example
# Activate patch 3 and all the DEACTIVE patches before patch 3 on the device with member ID of 1. <Sysname> system-view
[Sysname] patch active 3 slot 1
134
patch deactive Description
This command is not applicable to the patches in the RUNNING state.
Use patch deactive to stop running the patch and all the ACTIVE patches after the patch.
• The system will run at the original software version.
• All the ACTIVE patches (including the specified patch) turn to the DEACTIVE state.
Syntax
patch deactive patch-number slot slot-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 the ID of a member switch of the current IRF virtual device.
Example
# Stop running patch 3 and all the ACTIVE patches after patch 3 on the device with member ID of 1. <Sysname> system-view
[Sysname] patch deactive 3 slot 1
patch delete Description
Use patch delete to delete the specified patch and all the patches after the specified patch.
• This command only removes the patches from the memory patch area, it does not delete them from the storage media.
• The patches are in the IDLE state after execution of this command.
Syntax
patch delete patch-number slot slot-number
View
System view
Default level
3: Manage level
135
Parameters
patch-number: Sequence number of a patch, with values depending on the patch file used.
slot slot-number: Specifies the ID of a member switch of the current IRF virtual device.
Example
# Delete patch 3 and all the patches after patch 3 on the device with member ID being 1. <Sysname> system-view
[Sysname] patch delete 3 slot 1
patch install Description
Before executing the command, save the patch files to root directories in the storage media of the member switches.
Use patch install to install all the patches in one step. When you execute the patch install command, the following message appears: Do you want to continue running patches after reboot? [Y/N]:
• If you enter Y: All the specified patches are installed, and turn to the RUNNING state from IDLE. This equals execution of the commands patch location, patch load, patch active, and patch run. The patches remain RUNNING after system reboot.
• If you enter N: All the specified patches are installed and turn to the ACTIVE state from IDLE. This equals execution of the commands patch location, patch load and patch active. The patches turn to the DEACTIVE state after system reboot.
Use undo patch install to remove the patches.
Syntax
patch install patch-location
undo patch install
View
System view
Default level
3: Manage level
Parameter
patch-location: A string consisting of 1 to 64 characters. It specifies the directory where the patch file locates. It can be a root directory of a storage media or be in the format of "root directory + patch file name". Support for the argument depends on the device model.
136
Example
# Install the patches located on the Flash. <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]
patch load Description
Before executing the command, save the patch files to root directories in the storage media of the member switches.
Use patch load to load the patch file on the storage media to the memory patch area.
Syntax
patch load slot slot-number
View
System view
Default level
3: Manage level
Parameter
slot slot-number: Specifies the ID of a member switch of the current IRF virtual device.
Example
# Load the patch file for the device with member ID of 1. <Sysname> system-view
[Sysname] patch load slot 1
patch location Description
Use patch location to configure the patch file location.
By default, the patch file location is flash:.
Syntax
patch location patch-location
View
System view
137
Default level
3: Manage level
Parameter
patch-location: Specifies the patch file location. It is a string of 1 to 64 characters.
Example
# Configure the root directory of the Flash as the patch file location. <Sysname> system-view
[Sysname] patch location flash:
patch run Description
This command applies to patches in the ACTIVE state only.
Use patch run to confirm the running of a specific patch and all the ACTIVE patches before the specified patch.
• With the slot parameter specified, the command confirms the running state of all qualified patches on a member switch, including patches on the OAM CPU.
• If the slot parameter is not specified, the command confirms the running state of qualified patches on all member switches.
• If the running of a patch is confirmed, after the system reboots, the patch will still be effective.
Syntax
patch run patch-number [ slot slot-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 the ID of a member switch of the current IRF virtual device.
Example
# Confirm the running of patch 3 and all the ACTIVE patches before patch 3 on the device with member ID being 1.
<Sysname> system-view
[Sysname] patch run 3 slot 1
138
ISSU commands
display issu rollback-timer Description
Use display issu rollback-timer to display information about the ISSU rollback timer.
• A newly configured rollback timer takes effect in the next ISSU upgrade.
• The current rollback timer may be greater than the newly configured rollback timer.
Related commands: issu rollback-timer.
Syntax
display issu rollback-timer [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
|: Filters command output by specifying a regular expression. For more information about regular expressions, see the Fundamentals Configuration Guide.
begin: Displays the first line that matches the regular expression and all lines that follow.
exclude: Displays all lines that do not match the regular expression.
include: Displays all lines that match the regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Examples
# Display information about the rollback timer. <Sysname> display issu rollback-timer
RollBack timer is in process.
Configured Rollback Timer: 45 minutes.
Left: 43 minutes.
139
Table 18 Command output
Field Description
RollBack timer is in process An ISSU upgrade is being performed and the rollback timer runs normally.
RollBack timer is not in process
The rollback timer is not working. • No ISSU is performed. • The ISSU upgrade has completed. • The rollback timer has been deleted (the issu accept or issu commit
command deletes the rollback timer).
Left The remaining time in minutes before the rollback timer expires (it is displayed only when the rollback timer is started).
display issu state Description
This command helps you determine the next step during an ISSU upgrade that must follow a strict procedure.
Use display issu state to view the ISSU state, including whether the new boot file is compatible with the current one and the adopted ISSU upgrade method.
Syntax
display issu state [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
|: Filters command output by specifying a regular expression. For more information about regular expressions, see the Fundamentals Configuration Guide.
begin: Displays the first line that matches the regular expression and all lines that follow.
exclude: Displays all lines that do not match the regular expression.
include: Displays all lines that match the regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Examples
# Display the ISSU state before an ISSU upgrade. <Sysname> display issu state
ISSU state: Init
Compatibility: Unknown
Work State: Normal
# After executing the issu load command, display the ISSU state on the master.
140
<Sysname> display issu state
ISSU state: Load
Compatibility: Compatible
Work State: Normal
Upgrade Method: Board by board
Original version: R1210
Original boot file is flash:/A5800_r1210.bin
Upgrade version: R1211
Upgrade boot file is flash:/A5800_r1211.bin
Table 19 Command output
Field Description
ISSU state
• Init: No ISSU upgrade starts or an ISSU process has completed. • Load: The specified subordinate switch has been upgraded. The
rollback timer is running. • Switchover: The master has been rebooted with the issu run
switchover command. • Accept: The ISSU upgrade has been accepted, and the rollback
timer has been deleted. No auto-rollback will be performed during this ISSU process.
• Commit: Not all the IRF member switches have been upgraded. In this state, neither manual nor automatic rollback can be performed.
Compatibility
Version compatibility check results: • Compatible: The current boot file is compatible with the new boot
file. • Incompatible: The current boot file is incompatible with the new boot
file. The force keyword is required when you execute the issu load command. The specified subordinate switch enters the Recover state after rebooted with the new boot file.
• Unknown: The specified boot file version does not support ISSU, or the boot file cannot be upgraded through ISSU. In this mode, you cannot upgrade the boot file of the IRF virtual switch through ISSU.
Work State
The working mode of the IRF virtual switch: • Normal: Normal working mode. • Independent active: Incompatible ISSU is adopted. The specified
IRF member switch enters the Recover state after it is rebooted with the new boot file.
Upgrade Method ISSU upgrade method, which takes the value of Board by board.
Original version Original boot file version.
Original boot file Directory of the original boot file of each IRF member switch.
Upgrade version New boot file version. If the new version is not available (N/A), it may be that an IRF member switch is being upgraded and version information exchange is not yet complete.
Upgrade boot file Directory of the new boot file.
141
display version comp-matrix Description
Use display version comp-matrix to display version compatibility information.
• If you provide the upgrading-filename parameter, the compatibility information between the specified boot file and the boot file is displayed.
• If you do not provide the upgrading-filename parameter, information recorded in the compatibility database reflects version compatibility of the current boot file and the history boot file.
Syntax
display version comp-matrix [ file upgrading-filename ] [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
file upgrading-filename: Displays compatibility information between the specified new boot file and the current boot file.
The specified upgrading-filename must exist in the Flash. The file name is in the format of [drive:/]file-name, where the following conditions apply:
• The items in square brackets [ ] are optional.
• drive specifies the Flash of a member switch, and takes the format [ slotslot-number# ]flash:.
• file-name specifies the name of the new boot file.
If you enter a relative path in the format of file-name, the system automatically converts it to an absolute path in the format of [drive:/]file-name. The absolute path can contain no more than 63 characters.
|: Filters command output by specifying a regular expression. For more information about regular expressions, see the Fundamentals Configuration Guide.
begin: Displays the first line that matches the regular expression and all lines that follow.
exclude: Displays all lines that do not match the regular expression.
include: Displays all lines that match the regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
142
Examples
# Display the version compatibility database information of the current boot file. <Sysname> display version comp-matrix
Number of Matrices in Table = 1
Matrix for HP A5800-24G-PoE+ Switch
Running Version:R1211
Version Compatibility List:
A1210 (Compatible)
# View the version compatibility information between the current boot file and the new boot file bootfile.bin after executing the issu load command.
<Sysname> display version comp-matrix file bootfile.bin
Number of Matrices in Table = 1
Matrix for HP A5800-24G-PoE+ Switch
Running Version:R1210
Version Compatibility List:
R1211 (Compatible)
Table 20 Command output
Field Description
Number of Matrices in Table Number of product versions contained in the current IRF virtual switch.
Matrix for xx Product version of the xx switch series.
Running Version Current boot file version of the IRF virtual switch.
Version Compatibility List List of software version compatibility information.
AA (Compatible) The boot file with version AA is compatible with the current boot file.
BB (Incompatible) The boot file with version BB is incompatible with the current boot file. You must provide the force keyword when you execute the issu load command.
CC (Unknown) Whether the boot file with version CC is compatible with the current boot file is unknown.
issu accept Description
Use issu accept to accept the ISSU upgrade and delete the auto-rollback timer.
With this command executed, the system deletes the rollback timer. IRF member switches cannot automatically roll back to the previous version.
Syntax
issu accept slot slot-number
View
System view
143
Default level
2: System level
Parameters
slot slot-number: Specifies the ID of an IRF member switch. The ID must be the same as that in the issu load command.
Related commands: issu load and issu commit.
Example
# Accept the ISSU upgrade for the IRF member switch in slot 1. <Sysname> system-view
[Sysname] issu accept slot 1
issu commit Description
Use issu commit to upgrade the specified member switch that is not upgraded.
Executing issu commit completes the ISSU upgrade process. You cannot perform a version rollback operation with the issu rollback command.
Related commands: issu load and issu accept.
Syntax
issu commit slot slot-number
View
System view
Default level
2: System level
Parameter
slot slot-number: Specifies the ID of a member switch that is not upgraded.
Example
# Upgrade the member switch with ID 2. <Sysname> system-view
[Sysname] issu commit slot 2
The specified board will reboot and be upgraded. Continue? [Y/N]:y
issu load Description
Use issu load file upgrading-filename slot slot-number [ force ] to upgrade the specified subordinate switch. When this command executes, the subordinate switch reboots with the new boot file.
Before executing the issu load command, verify the following conditions:
144
• The master and subordinate switch must run the same boot file (same version, name, and directory).
• The new boot file has been saved in the Flash of each IRF member switch.
• All IRF member switches run the same boot file.
Syntax
issu load file upgrading-filename slot slot-number [ force ]
View
System view
Default level
2: System level
Parameters
file upgrading-filename: Name of the new boot file, a string of 1 to 63 characters.
The upgrading-filename must exist in the Flash. The file name is in the format of [drive:/]file-name, where the following conditions apply:
• The items in square brackets [ ] are optional.
• drive specifies the Flash of a member switch, and takes the format [ slot slot-number# ]flash:.
• file-name specifies the name of the new boot file.
If you enter a relative path in the format of file-name, the system automatically converts it to an absolute path in the format of [drive:/]file-name. The absolute path can contain no more than 63 characters.
slot slot-number: Specifies the ID of an IRF member switch.
force: Forces the IRF member switch to upgrade its incompatible boot file.
• If the boot file specified by upgrading-filename is incompatible with the boot file, you must provide this key word to ISSU.
• If the boot file specified by upgrading-filename is compatible with the boot file, this keyword is not necessary to upgrade.
Example
# Upgrade the subordinate switch with ID 2 by using upgrade file new.bin. <Sysname> system-view
[Sysname] issu load file new.bin slot 2
This command will begin ISSU, and the specified board will reboot and be upgrade
d. Please save the current running configuration first; otherwise, the configura
tion may be lost. Continue? [Y/N]: y
issu rollback Description
Use issu rollback to cancel the ISSU upgrade and revert to the previous version.
• If the IRF member switch is rebooting, you cannot perform the manual rollback operation.
145
• After you execute the issu commit command for a member switch, the member switch reboots with the new boot file. During the reboot, you cannot perform any manual rollback operation.
Related commands: issu load.
Syntax
issu rollback slot slot-number
View
System view
Default level
2: System level
Parameter
slot slot-number: Specifies the ID of an upgraded member switch. The value must be the same as that specified in the issu load command.
Example
# Assume that the member ID specified in the issu load command is 1. Cancel the ISSU upgrade on the member switch with ID 1 and roll back the boot file to the previous version.
<Sysname> system-view
[Sysname] issu rollback slot 1
This command will quit the ISSU process and the specified board will roll back
to the previous version. Continue? [Y/N]:y
issu rollback-timer Description
Use issu rollback-timer to set the rollback timer.
With the issu load command executed, the system automatically creates a version rollback timer.
If you execute the issu rollback-timer command during an ISSU upgrade process, the newly configured rollback timer takes effect for the next ISSU upgrade.
The system automatically stops the ISSU upgrade and reverts to the previous boot file version if
• IRF member switches are not upgraded with the issu accept command
• the auto-rollback function is not disabled with issu commit command before the specified rollback timer expires.
Use undo issu rollback-timer to restore the default (45 minutes is the default value).
146
Syntax
issu rollback-timer minutes
undo issu rollback-timer
View
System view
Default level
2: System level
Parameter
minutes: Rollback timer in minutes, ranging from 0 to 120. The value of 0 indicates that the version rollback function is disabled and the rollback timer is not created when you execute the issu load command.
Example
# Set the rollback timer value to 30 minutes. <Sysname> system-view
[Sysname] issu rollback-timer 30
issu run switchover Description
Use issu run switchover to reboot the master.
During compatible ISSU upgrade, the system automatically stops the ISSU upgrade process and reverts to the previous boot file version if
• The un-upgraded IRF member switches are not upgraded with the issu accept command.
• The auto-rollback function is not disabled with issu commit command before the specified rollback timer expires.
• During compatible ISSU upgrade, after you execute the issu load command, the system automatically creates a version rollback timer.
During incompatible ISSU upgrade, the process is completed when the IRF member switches accept the specified subordinate switch reboot with the new boot file.
• If you do not upgrade IRF member switches with the issu accept command or you do not disable the auto-rollback function with issu commit command before the specified rollback timer expires, the system automatically stops the ISSU upgrade and reverts to the previous boot file version.
During incompatible ISSU upgrade, when you execute the issu run switchover command, the IRF member switches (except the specified subordinate switch) reboot with the new boot file, and then the ISSU upgrade process is completed.
Related commands: issu load.
Syntax
issu run switchover slot slot-number
View
System view
147
Default level
2: System level
Parameter
slot slot-number: Specifies the ID of an upgraded member switch. The value must be the same as that specified in the issu load command.
Example
# Reboot the master. <Sysname> system-view
[Sysname] issu run switchover slot 1
Master will reboot, switch the specified board to master and update the line
card. Continue? [Y/N]:y
148
Device management commands
clock datetime Description
Use clock datetime to set the device’s current time and date. You can leave the SS field when you specify the time parameters.
Related commands: display clock, clock summer-time one-off, clock summer-time repeating, and clock timezone.
Syntax
clock datetime time date
View
User view
Default level
3: Manage level
Parameters
time: Configured time, in the hh:mm:ss format. The hh value ranges from 00 to 23, the mm value ranges from 00 to 59, and the ss value ranges from 00 to 59. Zeros can be omitted, unless you specify 00:00:00.
date: Configured date, in the MM/DD/YYYY or YYYY/MM/DD format. The YYYY value ranges from 2000 to 2035, the MM value ranges from 1 to 12, and the DD value ranges from 1 to 31.
Examples
# Set the current system time to 14:10:20 08/01/2011. <Sysname> clock datetime 14:10:20 8/1/2011
# Set the current system time to 00:06:00 01/01/2011. <Sysname> clock datetime 0:6 2011/1/1
clock summer-time one-off Description
Use clock summer-time one-off to adopt daylight saving time from the start-time of the start-date to the end-time of the end-date. clock summer-time one-off adds the add-time to the standard time of the device.
• By default, daylight saving time is configured on the device, and the universal time coordinated (UTC) time zone is applied.
• If the device’s standard time is in the range specified with this command, the system time automatically adds “add-time” after the command executes.
149
• 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.
• To view your configuration after it takes effect, use the display clock command. The time displayed in the log or debug information is the adjusted local time.
Use undo clock summer-time to cancel the configuration of the daylight saving time.
Related commands: display clock, clock datetime, clock summer-time repeating, and clock timezone.
Use clock summer-time repeating to adopt daylight saving time repeatedly. Daylight saving time adds one hour to the device’s standard time.
• By default, daylight saving time is configured on the device, and the UTC time zone is applied.
• To view the result after the configuration takes effect, use the display clock command. The time displayed in the log or debug information is the adjusted local time.
• 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. For example, if you specify start-date and start-time as 2007/6/6 and 00:00:00, end-date and end-time as 2007/10/01 and 00:00:00, and add-time to 01:00:00,
150
the daylight saving time range is from 00:00:00 of June 6 to 00:00:00 of October 1 each year from 2007—2007 inclusive. The daylight saving time adds one hour to the standard time of the device.
• If the standard time of the device is in the time range specified with this command, the system time automatically adds “add-time” after the this command executes.
Use undo clock summer-time to cancel the configuration of the daylight saving time.
Related commands: display clock, clock datetime, clock summer-time one-off, and clock timezone.
zone-name: Name of the daylight saving time, a string of 1 to 32 characters.
start-time: Start time, in the hh:mm:ss format. Zeros can be omitted, unless you specify 00:00:00.
start-date: Start date, which can be set in the following ways:
• Enter the year, month and date at one time, in the MM/DD/YYYY or YYYY/MM/DD format.
• 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 hh:mm:ss format . Zeros can be omitted, unless you specify 00:00:00.
end-date: End date which can be set in the following ways:
• Enter the year, month and date at one time, in the MM/DD/YYYY or YYYY/MM/DD format.
• 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 standard time of the device, in the hh:mm:ss format. Zeros can be omitted, unless you specify 00:00:00.
151
Example
# 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.
Use clock timezone to set the local time zone displayed in the log and debug information.
• To view the result after the configuration takes effect, use the display clock command.
• The time displayed in the log or debug information is the specified local time zone.
Use undo clock timezone to restore the local time zone as the default UTC time zone.
Related commands: display clock, clock datetime, clock summer-time one-off, and clock summer-time repeating.
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 case-sensitive string of 1 to 32 characters.
add: Adds a offset to UTC time.
minus: Subtracts a offset to UTC time.
zone-offset: Offset to the UTC time, in the hh:mm:ss format, where the hh value ranges from 0 to 23, the mm value ranges from 0 to 59, and the ss value ranges from 0 to 59. Zeros can be omitted, unless you specify 00:00:00.
Example
# Set the name of the local time zone to Z5, five hours ahead of UTC time. <Sysname> system-view
[Sysname] clock timezone z5 add 5
copyright-info enable Description
Use copyright-info enable to display copyright information.
152
Use undo copyright-info enable to disable display of copyright information.
By default, the display of copyright information is enabled.
Syntax
copyright-info enable
undo copyright-info enable
View
System view
Default level
3: Manage level
Parameters
None
Examples
1. Enable the display of copyright information. <Sysname> system-view
[Sysname] copyright-info enable
• If a user logs in to the device through Telnet, the following information is displayed: *************************************************************************
***
* Copyright (c) 2010-2011 Hewlett-Packard Development Company, L.P.
*
* Without the owner's prior written consent,
*
* no decompiling or reverse-engineering shall be allowed.
2. Disable the display of copyright information. <Sysname> system-view
[Sysname] undo copyright-info enable
• If a user logs in to the device through Telnet, the following information is displayed: <Sysname>
• If a user has already logged in through the console port, and then quits user view, the following information is displayed:
User interface aux0 is available.
Please press ENTER.
display clock Description
Use display clock to view the current system time and date.
The current system time and date are determined by the clock datetime, clock summer-time one-off, or clock summer-time repeating, and clock timezone commands. For more information about how the system time and date are decided, see the Fundamentals Configuration Guide.
Related commands: clock datetime, clock summer-time one-off, clock summer-time repeating, and clock timezone.
Syntax
display clock [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
|: Filters command output by specifying a regular expression. For more information about regular expressions, see the Fundamentals Configuration Guide.
begin: Displays the first line that matches the regular expression and all lines that follow.
exclude: Displays all lines that do not match the regular expression.
include: Displays all lines that match the regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Example
# Display the current time and date. <Sysname> display clock
09:41:23 UTC Thu 12/15/2011
154
display cpu-usage Description
Use display cpu-usage to view the CPU usage statistics.
• The system takes CPU usage statistics at intervals—usually every 60 seconds—and saves them in the history record area.
• The maximum number of records saved depends on device model.
• display cpu-usage entry-number indicates the system displays entry-number records from the latest record.
• display cpu-usage entry-number offset indicates the system displays number records from the last but offset record.
Syntax
display cpu-usage [ slot slot-number [ cpu cpu-number ] ] [ | { begin | exclude | include } regular-expression ]
display cpu-usage entry-number [ offset ] [ verbose ] [ slot slot-number [ cpu cpu-number ] ] [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
entry-number: Number of entries to be displayed, which ranges from 1 to 60.
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. It ranges from 0 to 59.
For example, the idx of the latest statistics record is 12. If the offset is set to 3, the system will display the statistics records from the one with the idx of 9, where idx represents the serial number of the period for the statistics, and its value ranges from 0 to 60 cyclically. The system makes CPU usage statistics periodically, and the system records the average CPU usage during this period, and the idx value is added by 1 automatically.
verbose: Displays detailed information of CPU usage statistics. If this keyword is provided, the system displays the average CPU usage statistics for each task in the specified period. If this keyword is not provided, the system displays the brief information of the CPU usage statistics.
slot slot-number: Displays the statistics of the CPU usage of a specific member device. The slot-number argument is the ID of a member device of the current IRF virtual device. If the slot-number argument is not provided, the system displays the statistics of the CPU usage of all member devices.
|: Filters command output by specifying a regular expression. For more information about regular expressions, see the Fundamentals Configuration Guide.
begin: Displays the first line that matches the regular expression and all lines that follow.
exclude: Displays all lines that do not match the regular expression.
include: Displays all lines that match the regular expression.
155
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
cpu cpu-number: Displays the CPU usage statistics of a specific CPU. If the cpu-number argument is not provided, the system displays the CPU usage statistics of all CPUs of the member device.
Examples
1. Display information of the current CPU usage statistics. <Sysname> display cpu-usage
Slot 1 CPU usage:
6% in last 5 seconds
10% in last 1 minute
5% in last 5 minutes
Slot 2 CPU usage:
5% in last 5 seconds
8% in last 1 minute
5% in last 5 minutes
2. Display the last fifth and sixth records of the CPU usage statistics history. <Sysname> display cpu-usage 2 4
Actual Stat. Cycle : 0x0(CPU Tick High) 0x950906af(CPU Tick Low)
156
Table 21 Command output
Field Description
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.
Slot 2 CPU usage The CPU usage of the device with the member ID of 2). (On a centralized IRF member device).
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 might differ slightly.
display cpu-usage history Description
Use display cpu-usage history to view CPU usage history statistics over the last 60 minutes plotted in a chart.
The system takes CPU usage statistics at intervals and saves the results in the history record area. The statistical results are displayed through x and y coordinates. In the output information:
• The x-axis indicates the CPU usage, rounded up or down in 5% increments. For example, an actual statistical value of 53% is rounded up and displayed as 55%, and an actual statistical value of 52% is rounded down and displayed as 50%.
• The y-axis indicates the time.
157
Consecutive pound marks (#) indicate CPU usage at a certain moment. The value of the x-axis corresponding to the # mark on the top of a moment is the CPU usage at that moment.
Syntax
display cpu-usage history [ task task-id ] [ slot slot-number [ cpu cpu-number ] ] [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
task task-id: Displays the history statistics of the CPU usage of a specific task, where task-id represents the task number. If the task-id argument is not provided, the system displays the history statistics of the CPU usage of the entire system. The CPU usage of the entire system is the sum of CPU usages of all tasks.
slot slot-number: Displays the history statistics of the CPU usage of a specific member device. slot-number is the ID of a member device of the current IRF virtual device. If the slot-number argument is not provided, the system displays the history statistics of the CPU usage of the master.
cpu cpu-number: Displays the history statistics of the CPU usage of a specific CPU. Support for this keyword depends on your device model. If the cpu-number argument is not provided, the system displays the history statistics of the CPU usage of the main CPU.
|: Filters command output by specifying a regular expression. For more information about regular expressions, see the Fundamentals Configuration Guide.
begin: Displays the first line that matches the regular expression and all lines that follow.
exclude: Displays all lines that do not match the regular expression.
include: Displays all lines that match the regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
158
Example
# Display the CPU usage statistics of the whole system. <Sysname> display cpu-usage history
The output shows the CPU usage of task 6 (with the task name T03M) in the last 60 minutes:
• 5%: 20 minutes ago
• 2% or lower than 2%: other time
display device Description
Use display device to view device information.
Syntax
display device [ usb ] [ [ slot slot-number [ subslot subslot-number ] ] | verbose ] [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
2: System level
160
Parameters
usb: Displays the information of the device connected with the universal serial bus (USB) interface.
slot slot-number: Displays the information of a specific member device. The slot-number argument is the ID of a member device of the current IRF virtual device.
subslot subslot-number: Displays the information for a host or subcard (interface card or OAP card). The subslot-number represents the subslot of the host or subcard. If the switch does not support the subcard or the subcard is not installed, slot number 0 is displayed.
verbose: Displays detailed information.
|: Filters command output by specifying a regular expression. For more information about regular expressions, see the Fundamentals Configuration Guide.
begin: Displays the first line that matches the regular expression and all lines that follow.
exclude: Displays all lines that do not match the regular expression.
include: Displays all lines that match the regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Example
# Display the information of all IRF member devices. (The output of this command varies with devices.) <Sysname> display device
Slot 1
SubSNo PortNum PCBVer FPGAVer CPLDVer BootRomVer AddrLM Type State
0 18 Ver.B NULL 002 002 013 IVL MAIN Normal
Slot 2
SubSNo PortNum PCBVer FPGAVer CPLDVer BootRomVer AddrLM Type State
0 18 Ver.A NULL 002 002 013 IVL MAIN Normal
1 4 Ver.A NULL 001 NULL IVL LSW1SP4P0 Normal
2 4 Ver.B NULL 001 NULL IVL LSW1XP4P0 Normal
Slot 3
SubSNo PortNum PCBVer FPGAVer CPLDVer BootRomVer AddrLM Type State
0 18 Ver.B NULL 002 002 013 IVL MAIN Normal
Slot 4
SubSNo PortNum PCBVer FPGAVer CPLDVer BootRomVer AddrLM Type State
0 18 Ver.B NULL 002 002 013 IVL MAIN Normal
161
Table 22 Command output
Field Description
Slot 1 Information of member device 1.
SubSNo
Number of the slot in which the host or subcard resides: • 0—Host slot. • 1—Subcard slot 1. • 2—Subcard slot 2.
PortNum Maximum number of ports that the host or subcard supports.
PCBVer PCB version of the host or subcard.
FPGAVer FPGA version of the host or subcard.
CPLDVer CPLD version of the host or subcard.
BootRomVer Boot ROM version of the host or subcard.
Type Type of the host or subcard: • Host—MAIN is displayed for this type. • Subcard—The specific model is displayed for this type.
State
State of the host or subcard: • Normal. • Absent. • Fault.
display device manuinfo Description
Use display device manuinfo to display electrical label information about the device.
• Electrical label information also called permanent configuration data or archive information is written to the device’s storage medium during debugging and testing. The information includes name of the card, device serial number, and vendor name.
• The output by this command depends on the device model.
Syntax
display device manuinfo [ slot slot-number [ fan fan-id | power power-id | subslot subslot-number ] ] [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
3: Manage level
162
Parameters
slot slot-number: Displays electrical label information for a member device. The slot-number argument is the ID of a member device of the current IRF virtual device. If the slot-number argument is not provided, the system displays the electrical label information of all member devices.
fan fan-id: Displays the electrical label information for a fan.
power power-id: Displays the electrical label information for a power supply unit (PSU), where power-id represents the PSU number.
subslot subslot-number: Displays electrical label information about the interface card or OAP card. The subslot-number represents the number of the slot where the interface card or OAP card resides.
|: Filters command output by specifying a regular expression. For more information about regular expressions, see the Fundamentals Configuration Guide.
begin: Displays the first line that matches the regular expression and all lines that follow.
exclude: Displays all lines that do not match the regular expression.
include: Displays all lines that match the regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Examples
1. Display electrical label information (on the 5800AF-48G Switch(JG225A) or 5820AF-24XG Switch(JG219A)).
<Sysname> display device manuinfo
Slot 1:
DEVICE_NAME : A5800AF-48G JG225A
DEVICE_SERIAL_NUMBER : CN13F5D001
MAC_ADDRESS : 20FDF1AC81BB
MANUFACTURING_DATE : 2011-03-10
VENDOR_NAME : HP
Power 1:
DEVICE_NAME : NONE
MANU SERIAL NUMBER : US0BF64123
MANUFACTURING_DATE : NONE
VENDOR_NAME : NONE
Power 2:
DEVICE_NAME : NONE
MANU SERIAL NUMBER : US0BF75832
MANUFACTURING_DATE : NONE
VENDOR_NAME : NONE
Fan 1:
DEVICE_NAME : HP A58x0AF bck(pwr)-frt(ports)Fan Tray JC682A
DEVICE_SERIAL_NUMBER : WB12FDD001
MANUFACTURING_DATE : 2011-03-25
VENDOR_NAME : HP
163
Fan 2:
DEVICE_NAME : HP A58x0AF bck(pwr)-frt(ports)Fan Tray JC682A
DEVICE_SERIAL_NUMBER : WB12FDD521
MANUFACTURING_DATE : 2011-03-25
VENDOR_NAME : HP
2. Display electrical label information (on a switch except the 5800AF-48G Switch(JG225A) or 5820AF-24XG Switch(JG219A)).
<Sysname> display device manuinfo
Slot 1:
DEVICE_NAME : A5800-24G-PoE+ JC099A
DEVICE_SERIAL_NUMBER : CN13F5D653
MAC_ADDRESS : 00238927AFDB
MANUFACTURING_DATE : 2011-03-24
VENDOR_NAME : HP
Power 1:
MANU SERIAL NUMBER : NONE
Fan 1:
DEVICE_NAME : NONE
DEVICE_SERIAL_NUMBER : NONE
MANUFACTURING_DATE : NONE
VENDOR_NAME : NONE
Table 23 Command output
Field Description
Slot IRF member ID
Fan Fan ID
Power PSU ID
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
164
display diagnostic-information Description
Use display diagnostic-information to view or save running status statistics of multiple modules in the system.
• During daily maintenance or when the system is out of order, display the running information of each functional module to locate the problem.
• Execute the display diagnostic-information for multiple modules running in the system; each module has independent information.
• Execution of the display diagnostic-information command equals execution of the commands display clock, display version, display device, and display current-configuration one by one.
Syntax
display diagnostic-information [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
|: Filters command output by specifying a regular expression. For more information about regular expressions, see the Fundamentals Configuration Guide.
begin: Displays the first line that matches the regular expression and all lines that follow.
exclude: Displays all lines that do not match the regular expression.
include: Displays all lines that match the regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Examples
1. 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.
To view the content of file aa.diag, execute the more.aa.diag command in user view, in combination of the Page Up and Page Down keys.
165
2. 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
Use display environment to view device temperature information, including the current temperature and temperature thresholds.
If the slot parameter is not specified, this command displays the temperature information of all sensors on the IRF member device.
Related commands: temperature-limit.
Syntax
display environment [ slot slot-number] [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
slot slot-number: Displays the temperature information of the sensors on the member device. The slot-number argument is the ID of a member device of the current IRF virtual device.
|: Filters command output by specifying a regular expression. For more information about regular expressions, see the Fundamentals Configuration Guide.
begin: Displays the first line that matches the regular expression and all lines that follow.
exclude: Displays all lines that do not match the regular expression.
include: Displays all lines that match the regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
166
Example
# Display temperature information (the output varies with devices). <Sysname> display environment
Slot 1
System temperature information (degree centigrade):
Sensor Temperature LowerLimit WarningLimit AlarmLimit ShutdownLimit
hotspot 1 44 5 70 80 NA
hotspot 2 37 -10 125 135 NA
Table 24 Command output
Field Description
Slot Member ID of the device.
Sensor Temperature sensor. • hotspot—A hotspot sensor.
Temperature Current temperature of the temperature sensor.
LowerLimit Temperature lower limit of the temperature sensor.
WarningLimit Warning temperature threshold of the temperature sensor.
AlarmLimit Alarming temperature threshold of the temperature sensor.
ShutdownLimit Shut-down temperature threshold of the temperature sensor. When the sensor temperature reaches this limit, the device shuts down automatically.
display fan Description
Use display fan to view fan operating states.
Related commands: fan prefer-direction.
Syntax
display fan [ slot slot-number [ fan-id ] ] [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
167
Parameters
slot slot-number: Displays the operating state of fans for a member device. The slot-number argument is the ID of a member device of the current IRF virtual device. If the slot-number argument is not provided, the system displays the operating state of fans of all member devices.
fan-id: Displays the operating state of the fan, where fan-id represents the built-in fan number. Support for this argument and the value range depend on your device model.
|: Filters command output by specifying a regular expression. For more information about regular expressions, see the Fundamentals Configuration Guide.
begin: Displays the first line that matches the regular expression and all lines that follow.
exclude: Displays all lines that do not match the regular expression.
include: Displays all lines that match the regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Examples
1. Display the operating states of all fans (on the 5800AF-48G Switch(JG225A) or 5820AF-24XG Switch(JG219A)).
<Sysname> display fan
Slot 1
FAN 1
State : Normal
Wind Direction :Power-to-Port
Prefer Wind Direction :Power-to-Port
FAN 2
State : Normal
Wind Direction :Power-to-Port
Prefer Wind Direction :Power-to-Port
2. Display the operating states of all fans (on the switch except the 5800AF-48G Switch(JG225A) or 5820AF-24XG Switch(JG219A)).
<Sysname> display fan
Slot 1
FAN 1
State : Normal
168
Table 25 Command output
Field Description
Slot 1 Member device 1
FAN Fan ID
State
State of the fan: • Normal • Absent • Fault
Wind Direction Actual ventilation direction: • Power-to-Port • Port-to-Power
Prefer Wind Direction Preferred ventilation direction: • Power-to-Port • Port-to-Power
display job Description
Use display job to view detailed information about scheduled tasks that are automatically executed.
• If no parameters are specified, details about all scheduled tasks are displayed.
Related commands: job, time, and view.
Syntax
display job [ job-name ] [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
job-name: Specifies the task name, a string of 1 to 32 characters.
|: Filters command output by specifying a regular expression. For more information about regular expressions, see the Fundamentals Configuration Guide.
begin: Displays the first line that matches the regular expression and all lines that follow.
exclude: Displays all lines that do not match the regular expression.
include: Displays all lines that match the regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
169
Example
# Display configurations of all scheduled tasks. <System> dis job
Job name: phone
Specified view: GigabitEthernet1/0/2
Time 1: Execute command poe enable at 08:00 Mondays Tuesdays Wednesdays
Thursdays Fridays
Table 26 Command output
Field Description
Job name Name of a scheduled task
Specified view View where the specified command or commands are to be executed
Time 1: Execute command Execute the task at the specified time
display memory Description
Use display memory to display a device’s memory usage.
• If the slot parameter is not provided, the system displays the master’s memory usage.
• If the cpu parameter is not provided, the system displays the main CPU memory.
Syntax
display memory [ slot slot-number [ cpu cpu-number ] ] [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
slot slot-number: Displays the memory of a CPU for a member device. The slot-number argument is the ID of a member device of the current IRF virtual device.
cpu cpu-number: Displays the memory of a CPU, where cpu-number represents the ID of the CPU.
|: Filters command output by specifying a regular expression. For more information about regular expressions, see the Fundamentals Configuration Guide.
begin: Displays the first line that matches the regular expression and all lines that follow.
exclude: Displays all lines that do not match the regular expression.
include: Displays all lines that match the regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
170
Example
# Display the usage of the memory of a device. <Sysname> display memory
System Total Memory(bytes): 431869088
Total Used Memory(bytes): 71963156
Used Rate: 16%
Table 27 Command output
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
display power Description
Use display power to display a device’s PSU information.
Syntax
display power [ slot slot-number [ power-id ] ] [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
slot slot-number: Displays the information of the power supply units (PSUs) of the member device. The slot-number argument is the ID of a member device of the current IRF virtual device.
power-id: Displays the information for a PSU, where power-id represents the PSU number.
|: Filters command output by specifying a regular expression. For more information about regular expressions, see the Fundamentals Configuration Guide.
begin: Displays the first line that matches the regular expression and all lines that follow.
exclude: Displays all lines that do not match the regular expression.
include: Displays all lines that match the regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
171
Example
Display the PSU information of the device. <Sysname> display power
Slot 1
Power 1
State : Normal
Type : AC
Slot 2
Power 1
State : Normal
Type : AC
Power 2
State : Normal
Type : AC
Table 28 Command output
Field Description
Slot 1 PSU information of the member device. The member ID is 1 in this output.
Power PSU number: • If only one PSU is displayed, the system uses a fixed PSU. • If two PSUs are displayed, the system uses swappable PSUs.
State
PSU state: • Normal. • Absent. • Fault.
Type PSU type: • DC. • AC.
display reboot-type Description
Use display reboot-type to view the device’s reboot mode. If no parameters are provided, the system displays the master’s reboot mode.
Syntax
display reboot-type [ slot slot-number ] ] [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
2: System level
172
Parameters
slot slot-number: Displays reboot mode for a member device. The slot-number argument is the ID of a member device of the current IRF virtual device.
|: Filters command output by specifying a regular expression. For more information about regular expressions, see the Fundamentals Configuration Guide.
begin: Displays the first line that matches the regular expression and all lines that follow.
exclude: Displays all lines that do not match the regular expression.
include: Displays all lines that match the regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Example
# Display the reboot mode of the device. <Sysname> display reboot-type
The rebooting type this time is: Cold
The output shows that the last reboot mode of the device is Cold boot—the cold boot will restart a device by powering it on. The display of Warm represents a warm boot, which means to restart a device by using the commands like reboot.
display rps Description
This command is available only for the switches that support RPS.
Use display rps to display RPS status.
Syntax
display rps [ slot slot-number [ rps-id ] ] [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
slot slot-number: Displays the RPS status of the member device. The slot-number is the ID of a member device of the current IRF virtual device. If the slot-number is not provided, the system displays the RPS status of all IRF members.
rps-id: Displays the status of the RPS, where rps-id represents the RPS number. The value varies with devices.
|: Filters command output by specifying a regular expression. For more information about regular expressions, see the Fundamentals Configuration Guide.
begin: Displays the first line that matches the regular expression and all lines that follow.
exclude: Displays all lines that do not match the regular expression.
include: Displays all lines that match the regular expression.
173
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Example
# Display RPS status. <Sysname> display rps
Slot 1
Power 2
State : Absent
Slot 2
Power 2
State : Absent
Table 29 Command output
Field Description
Slot 1 Member device 1
Power RPS ID
State
RPS state: • Normal • Absent • Fault
display schedule job Description
Use display schedule job to view the configuration set by the schedule job command.
Related commands: schedule job.
Syntax
display schedule job [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
|: Filters command output by specifying a regular expression. For more information about regular expressions, see the Fundamentals Configuration Guide.
begin: Displays the first line that matches the regular expression and all lines that follow.
exclude: Displays all lines that do not match the regular expression.
include: Displays all lines that match the regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
174
Example
# Display the configuration of the scheduled task configured by the schedule job command. <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 change the system time within 16 minutes after you execute the schedule job command, the scheduled task becomes invalid. Then if you execute the display schedule job command again, the system displays nothing.
Table 30 Command output
Field Description
Specified command Command to be executed
Specified view View for the command to be executed
Executed time Execution time of the command and the difference between the current time and scheduled time
display schedule reboot Description
Use display schedule reboot to view the device reboot time set by the user.
Related commands: schedule reboot at and schedule reboot delay.
Syntax
display schedule reboot [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
3: Manage level
Parameters
|: Filters command output by specifying a regular expression. For more information about regular expressions, see the Fundamentals Configuration Guide.
begin: Displays the first line that matches the regular expression and all lines that follow.
exclude: Displays all lines that do not match the regular expression.
include: Displays all lines that match the regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
175
Example
# Display the reboot time of a device. <Sysname> display schedule reboot
System will reboot at 16:00:00 03/10/2011 (in 2 hours and 5 minutes).
The output shows that the system will reboot at 16:00:00 on March 10, 2011—in two hours and five minutes.
display system-failure Description
Use display system-failure to view the exception handling method of all member devices of an IRF virtual device.
Related commands: system-failure.
Syntax
display system-failure [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
3: Manage level
Parameters
|: Filters command output by specifying a regular expression. For more information about regular expressions, see the Fundamentals Configuration Guide.
begin: Displays the first line that matches the regular expression and all lines that follow.
exclude: Displays all lines that do not match the regular expression.
include: Displays all lines that match the regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Example
# Display the exception handling method. <Sysname> display system-failure
System failure handling method: reboot
display transceiver Description
Use display transceiver to display main parameters of a single or all pluggable transceivers.
Syntax
display transceiver interface [ interface-type interface-number ] [ | { begin | exclude | include } regular-expression ]
176
View
Any view
Default level
2: System level
Parameters
interface [ interface-type interface-number ]: Displays main parameters of the pluggable transceiver plugged in the interface. interface-type interface-number represents interface type and interface number. If it is not , the command displays main parameters of the pluggable transceivers in all the interfaces.
|: Filters command output by specifying a regular expression. For more information about regular expressions, see the Fundamentals Configuration Guide.
begin: Displays the first line that matches the regular expression and all lines that follow.
exclude: Displays all lines that do not match the regular expression.
include: Displays all lines that match the regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Example
# Display main parameters of the pluggable transceiver plugged in interface GigabitEthernet 1/0/3. (The output of this command varies with devices.)
transceiver information Pluggable transceiver information.
Transceiver Type Pluggable transceiver type.
Connector Type
Type of the connectors of the transceiver: • Optical connectors, including SC (SC connector, developed by NTT) and LC
(LC connector, 1.25 mm/RJ-45 optical connector developed by Lucent). • Other connectors, including RJ-45 and CX 4.
Wavelength(nm)
• Optical transceiver: central wavelength of the laser sent, in nm. If the transceiver supports multiple wavelengths, every two wavelength values are separated by a comma.
• Electrical transceiver: displayed as N/A.
Transfer distance(xx)
Transfer distance, with xx representing km for single-mode transceivers and m for other transceivers. If the transceiver supports multiple transfer medium, every two values of the transfer distance are separated by a comma. The corresponding transfer medium is included in the bracket following the transfer distance value. The following are the transfer media: • 9 um—9/125 um single-mode fiber. • 50 um—50/125 um multi-mode fiber. • 62.5 um—62.5/125 um multi-mode fiber. • TP—Twisted pair. • CX4—CX4 cable.
Digital Diagnostic Monitoring
Whether the digital diagnosis function is supported, where: • YES—Supported. • NO—Not supported.
Vendor Name Vendor name.
Ordering Name Product code.
display transceiver alarm Description
Use display transceiver alarm to view the current alarm information of transceivers.
• If no error occurs, None is displayed.
• Support for transceivers depends on the device module.
• Table 32 shows the alarm information that might occur to the commonly used transceivers.
178
Table 32 Alarms for commonly used transceivers
Field Remarks
SFP/SFP+
RX loss of signal Incoming (RX) signal is lost.
RX power high Incoming (RX) power level is high.
RX power low Incoming (RX) power level is low.
TX fault Transmit (TX) fault.
TX bias high TX bias current is high.
TX bias low TX bias current is low.
TX power high TX power is high.
TX power low TX power is low.
Temp high Temperature is high.
Temp low Temperature is low.
Voltage high Voltage is high.
Voltage low Voltage is low.
Transceiver info I/O error Transceiver information read and write error.
Transceiver info checksum error Transceiver information checksum error.
Transceiver type and port configuration mismatch
Transceiver type does not match port configuration.
Transceiver type not supported by port hardware
Transceiver type is not supported on the port.
Syntax
display transceiver alarm interface [ interface-type interface-number ] [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
2: System level
Parameters
interface [ interface-type interface-number ]: Displays the current alarm information of the pluggable transceiver plugged in the specified interface. interface-type interface-number represents interface type and interface number. If not specified, displays the current alarm information of the pluggable transceiver in all the interfaces.
|: Filters command output by specifying a regular expression. For more information about regular expressions, see the Fundamentals Configuration Guide.
begin: Displays the first line that matches the regular expression and all lines that follow.
exclude: Displays all lines that do not match the regular expression.
179
include: Displays all lines that match the regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Example
# Display the alarm information of the pluggable transceiver plugged in interface GigabitEthernet 1/0/1. (The output of this command varies with devices.)
GigabitEthernet1/0/1 transceiver current alarm information:
RX loss of signal
RX power low
Table 33 Command output
Field Description
Transceiver current alarm information Current alarm information of the transceiver.
RX loss of signal Incoming (RX) signal is lost.
RX power low Incoming (RX) power level is low.
display transceiver diagnosis Description
Use display transceiver diagnosis to view the currently measured value of digital diagnosis parameters of pluggable transceivers.
Syntax
display transceiver diagnosis interface [ interface-type interface-number ] [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
2: System level
Parameters
interface [ interface-type interface-number ]: Displays the currently measured value of digital diagnosis parameters of the transceiver plugged in the interface. interface-type interface-number represents interface type and interface number. If not specified, displays the currently measured value of digital diagnosis parameters of transceivers in all the interfaces.
|: Filters command output by specifying a regular expression. For more information about regular expressions, see the Fundamentals Configuration Guide.
begin: Displays the first line that matches the regular expression and all lines that follow.
exclude: Displays all lines that do not match the regular expression.
include: Displays all lines that match the regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
180
Example
# Display the currently measured values of the digital diagnosis parameters of the optical transceiver in interface GigabitEthernet 1/0/2. (The output of this command varies with devices.)
Transceiver diagnostic information Digital diagnosis information of the transceiver plugged in the interface.
Current diagnostic parameters Current diagnostic parameters.
Temp.(°C) Digital diagnosis parameter-temperature, in °C, with the precision to 1°C.
Voltage(V) Digital diagnosis parameter-voltage, in V, with the precision to 0.01 V.
Bias(mA) Digital diagnosis parameter-bias current, in mA, with the precision to 0.01 mA.
RX power(dBm) Digital diagnosis parameter-RX power, in dBm, with the precision to 0.01 dBm.
TX power(dBm) Digital diagnosis parameter-TX power, in dBm, with the precision to 0.01 dBm.
display transceiver manuinfo Description
Use display transceiver manuinfo to view the electrical label information of a single or all pluggable transceivers.
Syntax
display transceiver manuinfo interface [ interface-type interface-number ] [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
2: System level
181
Parameters
interface [ interface-type interface-number ]: Displays the electrical label information of the transceiver plugged in the interface. interface-type interface-number represents interface type and interface number. If it is not specified, the command displays part of the electrical label information of the pluggable transceivers in all the interfaces.
|: Filters command output by specifying a regular expression. For more information about regular expressions, see the Fundamentals Configuration Guide.
begin: Displays the first line that matches the regular expression and all lines that follow.
exclude: Displays all lines that do not match the regular expression.
include: Displays all lines that match the regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Example
# Display the electrical label information of the transceiver plugged in interface GigabitEthernet 1/0/4. (The output of this command varies with devices.)
Manu. Serial Number Serial number generated during debugging and testing of the customized transceivers.
Manufacturing Date Debugging and testing date. The date takes the value of the system clock of the computer that performs debugging and testing.
Vendor Name Vendor name.
display version Description
Use display version to view current system software version information.
Syntax
display version [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
182
Parameters
|: Filters command output by specifying a regular expression. For more information about regular expressions, see the Fundamentals Configuration Guide.
begin: Displays the first line that matches the regular expression and all lines that follow.
exclude: Displays all lines that do not match the regular expression.
include: Displays all lines that match the regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Example
# Display system version information. (The output depends on your device model and the device version)
<Sysname> display version
HP Comware Platform Software
Comware Software, Version 5.20, Release 1211
Copyright (c) 2010-2011 Hewlett-Packard Development Company, L.P.
HP A5800-24G-PoE+ Switch uptime is 0 week, 0 day, 0 hour, 20 minutes
HP A5800-24G-PoE+ Switch with 2 Processors
512M bytes SDRAM
4M bytes Nor Flash Memory
512M bytes Nand Flash Memory
Config Register points to Nand Flash
Hardware Version is Ver.B
CPLD Version is 003
BootRom Version is 212
[SubSlot 0] 24GE+4SFP Plus+POE Hardware Version is Ver.B
[SubSlot 1] No Module
display version-update-record Description
Use display version-update-record to view the device software’s update records.
When the device boots, the system records the device software version. If the software is updated when the device is running, the system records update time and software version. Currently, the system keeps 10 records.
Related commands: reset version-update-record.
Syntax
display version-update-record [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
3: Manage level
183
Parameters
|: Filters command output by specifying a regular expression. For more information about regular expressions, see the Fundamentals Configuration Guide.
begin: Displays the first line that matches the regular expression and all lines that follow.
exclude: Displays all lines that do not match the regular expression.
include: Displays all lines that match the regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Example
# Display the version update records of the device software. <Sysname> display version-update-record
No. Update time version
1 2009-09-28 14:39:11 5.20 Release 0000
Table 36 Command output
Field Description
No. Serial number
Version The updated version
fan prefer-direction Description
This command is available only for the 5800AF-48G Switch(JG225A) or 5820AF-24XG Switch(JG219A). If one or both the two fan trays have a different ventilation direction from the switch, the system outputs traps and logs for you to replace the wrong ones or modify the fan ventilation direction for the switch.
Use fan prefer-direction to configure the fan ventilation direction.
Use undo fan prefer-direction to restore the default (fan ventilation direction is power-to-port by default).
Related commands: display fan.
Syntax
fan prefer-direction slot slot-number { power-to-port | port-to-power }
undo fan prefer-direction slot slot-number
View
System view
Default level
2: System level
184
Parameters
slot slot-number: Configures the fan ventilation direction of the member device. The slot-number is the ID of a member device of the current IRF virtual device.
power-to-port: Specifies the fan ventilation direction from the PSU side to the port side.
port-to-power: Specifies the fan ventilation direction from the port side to the PSU side.
Example
# Configure the fan ventilation direction as port-to-power. <Sysname> system-view
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 in to 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.
shell: Sets the banner displayed when a non-Modem login user enters user view.
text: Banner message, which can be input in two formats. For more information, see the Fundamentals Configuration Guide.
185
Examples
1. Configure banners. 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.
<Sysname> system-view
[Sysname] header incoming %
Please input banner content, and quit with the character '%'.
Welcome to incoming(header incoming)%
[Sysname] header legal %
Please input banner content, and quit with the character '%'.
Welcome to incoming(header incoming)%
[Sysname] header legal %
Please input banner content, and quit with the character '%'.
Welcome to legal (header legal)%
[Sysname] header login %
Please input banner content, and quit with the character '%'.
Welcome to login(header login)%
[Sysname] header motd %
Please input banner content, and quit with the character '%'.
Welcome to motd(header motd)%
[Sysname] header shell %
Please input banner content, and quit with the character '%'.
Welcome to shell(header shell)%
2. Test the configuration by using Telnet. The login banner can be displayed only when login authentication is configured.
Use job to create a scheduled task or enter scheduled task view. You can create up to 100 scheduled tasks, each task is uniquely identified by its job-name.
Use undo job to restore the default (no scheduled task is created).
Syntax
job job-name
undo job job-name
View
System view
Default level
3: Manage level
Parameter
job-name: Name of a scheduled task, a string of 1 to 32 characters.
Example
# Create a scheduled task or enter an existing scheduled task view. <Sysname> system-view
[Sysname] job saveconfig
[Sysname-job-saveconfig]
reboot Description
CAUTION:
• Device reboot might result in the interruption of the ongoing services. Use these commands with caution.
• If a main boot file fails or does not exist, the device cannot be rebooted with the reboot command. In this case, re-specify a main boot file, or power off the device and then power it on. The system automatically uses the backup boot file to restart the device.
• If you are performing file operations when the device will be rebooted, the system does not execute the command for the sake of security.
Use reboot to reboot a member device, a subcard, or all member devices.
You can use reboot [ slot slot-number ] on the master to reboot it or a subordinate device. If the slot parameter is not provided, all member devices reboot.
Syntax
reboot [ slot slot-number ]
View
User view
187
Default level
3: Manage level
Parameter
slot slot-number: Specifies a device by its member ID of the IRF virtual device.
Examples
1. If the current configuration does not change, reboot the device. (The output of this command varies with devices.) <Sysname> reboot
Start to check configuration with next startup configuration file, please
wait.........DONE!
This command will reboot the device. Continue? [Y/N]:y
2. If the current configuration changes, reboot the device. (The output of this command varies with devices.) <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, save c
urrent configuration? [Y/N]:y
Please input the file name(*.cfg)[flash:/config.cfg]
(To leave the existing filename unchanged, press the enter key):
flash:/config.cfg exists, overwrite? [Y/N]:y
Validating file. Please wait....
Saved the current configuration to mainboard device successfully.
Configuration is saved to device successfully.
This command will reboot the device. Continue? [Y/N]:y
reset unused porttag Description
Use reset unused porttag to clear the 16-bit index saved but not used in the current systems of all member devices.
A confirmation within 30 seconds is required. The command will not execute if you fail to make a confirmation within 30 seconds or enter N to cancel the operation.
Syntax
reset unused porttag
View
User view
Default level
1: Monitor level
Parameters
None
188
Example
# 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>
reset version-update-record Description
Use reset version-update-record to clear the records of updating the device software.
Related commands: display version-update-record.
Syntax
reset version-update-record
View
System view
Default level
3: Manage level
Parameters
None
Example
# Clear the records of updating the device software. <Sysname> system-view
[Sysname] reset version-update-record
schedule job Description
Use schedule job to schedule a task.
• If you provide both the time1 and date parameters, the execution time must be in the future.
• If you provide only a time1 parameter earlier than the current system time, the command executes at time1 of the next day.
• If you provide only a time1 parameter later than the current system time, the command executes at time1 of the current day.
• When using the at or delay parameter, the difference between the execution time of the command and the current system time cannot exceed 720 hours (30 days).
• If you change the system time after the scheduled task is configured, the task becomes invalid.
• Only the latest configuration takes effect if you execute the schedule job command repeatedly.
• The system does not check the values of the view and command parameters. You must ensure the commands and their corresponding views are correct for the commands to execute.
• The system does not require any interactive information when executing the schedule task. The system will automatically input confirmation and default or empty character strings as needed.
189
• The operation interface, command view and status of the current user are not changed after execution if a scheduled task contains commands used to switch user interfaces (such as telnet, ftp, and ssh2), commands used to switch views (such as system-view and quit), or commands used to modify status of a user executing commands (such as super).
Use undo schedule job to remove the scheduled task.
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.
• time1: Execution time of the command, in the hh:mm format. The hh value ranges from 0 to 23, and the mm value ranges from 0 to 59.
• date: Execution date of the command, in the MM/DD/YYYY or YYYY/MM/DD format. The YYYY value ranges from 2000 to 2035, the MM value ranges from 1 to 12, and the DD value ranges from 1 to 31.
delay time2: Specifies the execution waiting time of a specified command. time2 represents the waiting time, which can be in the following format:
• hh:mm format—The hh value ranges from 0 to 720, and the mm value ranges from 0 to 59. When the hh value is 720, the mm value cannot be more than 0.
• mm format—It ranges from 0 to 432000 minutes, with 0 indicating that the command is executed immediately.
view view: Specifies the view in which the command is executed. The view argument represents the view name, and it takes either of the following values at present:
• shell—Represents user view.
• system—Represents system view.
command: Command to be executed.
Examples
1. Schedule a task to execute the batch file 1.bat in system view in 60 minutes (assuming 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).
2. Schedule a task to execute the batch file 1.bat in system view at 12:00 in the current day (assuming 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).
190
schedule reboot at Description
CAUTION:
This command reboots the device in a future time and results in service interruption. Use it with caution.
Use schedule reboot at to enable the scheduled reboot function on all member devices and specify a specific reboot time and date. The difference between the reboot date and the current date cannot exceed 30 x 24 hours (30 days).
• If the date specified for the schedule reboot at command is later than the current date, the device will reboot at that reboot time.
• If no date is specified for a reboot time later than the current time, the device reboots at the current day’s reboot time.
• If no date is specified for a reboot time earlier than the current time, the device reboots at the following day’s reboot time.
• If you are performing file operations when the device will be rebooted, the system does not execute the command for the sake of security.
• One minute before the reboot time, the device will prompt “REBOOT IN ONE MINUTE.”
• After you execute the command, the device will prompt you to confirm the configuration. You must enter Y to make the configuration take effect. The original configuration will be overwritten at the same time.
• If you use the clock command after the schedule reboot at to adjust the system time, the reboot time set by the schedule reboot at command will become invalid.
Use undo schedule reboot to restore the default condition. By default, the scheduled reboot function is disabled.
Syntax
schedule reboot at hh:mm [ date ]
undo schedule reboot
View
User view
Default level
3: Manage level
191
Parameters
hh:mm: Reboot time for the device, in the hh:mm format. The hh value ranges from 0 to 23, and the mm value ranges from 0 to 59.
date: Reboot date for the device, in the MM/DD/YYYY or YYYY/MM/DD format. The YYYY value ranges from 2000 to 2035, the MM value ranges from 1 to 12, and the DD value ranges from 1 to 31.
Examples
1. 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]:
2. If you have used the terminal logging 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/4/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.
schedule reboot delay Description
CAUTION:
This command reboots the device after the specified delay time, which results in service interruption. Use it with caution.
Use schedule reboot delay to enable the scheduled reboot function of all member devices and set a reboot wait time.
• The reboot wait time can be in the hh:mm format or mm format—absolute minutes. The absolute minutes cannot exceed 30 x 24 x 60 minutes (30 days).
• One minute before the reboot time, the device will prompt “REBOOT IN ONE MINUTE.”
• After you execute the command, the device will prompt you to confirm the configuration. You must enter Y to make the configuration take effect. The original configuration will be overwritten at the same time.
• If you use the clock command after the schedule reboot delay to adjust the system time, the reboot wait time set by the schedule reboot delay command will become invalid.
• If you are performing file operations when the device will be rebooted, the system does not execute the command for the sake of security.
Use undo schedule reboot to disable the scheduled reboot function (by default, this function is disabled).
Syntax
schedule reboot delay { hh:mm | mm }
undo schedule reboot
192
View
User view
Default level
3: Manage level
Parameters
hh:mm: Device reboot wait time, in the hh:mm format. The hh value ranges from 0 to 720, and the mm value ranges from 0 to 59. When the hh value is 720, the mm value cannot be more than 0.
mm: Device reboot wait time in minutes, which ranges from 0 to 43,200.
Examples
1. 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]:
2. If you have used the terminal logging 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/4/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.
shutdown-interval Description
Use shutdown-interval to set a detection interval.
Use undo shutdown-interval to restore the default detection interval of 30 seconds.
Some protocol modules might shut down ports under specific circumstances. For example, an MSTP module will automatically shut down a port that receives configuration messages after the BPDU guard function is enabled on the port. Then, the MSTP module enables a detection timer and detects the status of the port. If the port is still down when the detection timer times out, the MSTP module will automatically bring up the port.
• If you change the detection interval to T1 during port detection, the interval from when you change the interval to the time when the protocol module shuts down the port is T. If T<T1, the port which is down will be brought up after T1-T time. If T>=T1, the port which is down will be brought up immediately. For example, if the detection interval is set to 30 seconds and you change it to 10 seconds (T1=10) two seconds after the port is shut down (T=2), this port will be brought up 8 seconds later. If the detection interval is set to 30 seconds and you change it to 2 seconds ten seconds after the port is shut down, this port will be brought up immediately.
• If the detection interval is set to 0, the protocol module will never automatically recover the port. You need to manually bring up the port by using the undo shutdown command or change the detection interval to a non-zero value.
193
Syntax
shutdown-interval time
undo shutdown-interval
View
System view
Default level
2: System level
Parameter
time: Detection interval in seconds, which ranges from 0 to 300.
Example
# Set the detection interval to 100 seconds. <Sysname> system-view
[Sysname] shutdown-interval 100
sysname Description
Use sysname to set the name of the device.
• Changing device name affects the prompt of the CLI configuration. For example, if the device name is Sysname, the prompt of user view is <Sysname>.
Use undo sysname demand to restore the device name to the default, which is HP.
Syntax
sysname sysname
undo sysname
View
System view
Default level
2: System level
Parameter
sysname: Name of the device, a string of 1 to 30 characters.
Example
# Set the name of the device to S2000. <Sysname> system-view
[Sysname] sysname S2000
[S2000]
194
system-failure Description
Use system-failure to configure the exception handling method on all member devices. The exception handling method is effective to the failed member device only, and does not influence the operations of other IRF members.
By default, all member devices adopt the reboot method to handle exceptions.
Syntax
system-failure { maintain | reboot }
undo system-failure
View
System view
Default level
3: Manage 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.
Example
# Set the exception handling method to reboot. <Sysname> system-view
[Sysname] system-failure reboot
temperature-limit Description
Use temperature-limit to set the temperature alarm thresholds for a device.
• If the temperature is lower than the lower limit, the device logs the event and outputs the log and trap information for users.
• The warning and alarming thresholds must be higher than the lower temperature limit.
• The alarming threshold must be higher than the warning threshold.
• If the temperature reaches the warning threshold, the device logs the event and outputs the log and trap information for users.
• If the temperature reaches the alarming threshold, the device repeatedly outputs the log and trap information in the terminal display, and alerts users through the LED on the device panel.
Use undo temperature-limit to restore the default temperature alarm threshold (see Table 37).
195
Table 37 Temperature alarm thresholds for a device
Device Sensor Lower limit
Warning limit
Alarm limit
5820X-14XG-SFP+ Switch with 2 Interface Slots(JC106A)/
5820X-14XG-SFP+ TAA Switch with 2 Interface Slots(JG259A)
slot slot-number: Specifies device by its slot number, which is the ID of a member device of the current IRF virtual device.
196
hotspot: Specifies a hotspot sensor, typically placed near the chip that generates a great amount of heat for temperature monitoring.
sensor-number: Specifies the sensor number. The values are positive integers starting from 1, each representing a temperature sensor. For the assignment of temperature sensors on different devices, see Table 37.
lowerlimit: Lower temperature limit in Celsius degrees. The value range from -10 to 70.
warninglimit: Warning temperature threshold in Celsius degrees. The value range from 15 to 125.
alarmlimit: Alarming temperature threshold in Celsius degrees. The value range from 20 to 135.
Example
# Set the lower limit for the sensor 1 on the device of the IRF member 1 to –10 Celsius degrees, the warning threshold to 70, and the alarming threshold to 100 Celsius degrees.
• The commands in a scheduled task must be in the same view.
• A scheduled task can contain up to 10 commands.
• To execute more than 10 commands, configure multiple scheduled tasks.
Use undo time to remove the time schedule for the task.
Syntax
time time-id { one-off | repeating } at time [ week-day week-daylist | month-date month-day ] command command
time time-id at time date command command
undo time time-id
View
Scheduled task view
Default level
3: Manage level
Parameters
time time-id: Time setting entry, where time-id is an integer ranging from 1 to 10. A scheduled task can be specified with up to 10 time setting entries.
one-off: Specifies that the command is executed for once. That is, the command runs when the time is reached, and will not be executed when the time is reached next time.
repeating: Specifies a recurring time schedule.
at time: Specifies the execution time, in the hh:mm format, where the hh value ranges from 0 to 23 and the mm value ranges from 0 to 59.
197
week-day week-daylist: Executes a command on a specified day or the days of a week. week-daylist represents a day or multiple days in a week, taking the value of Mon, Tue, Wed, Thu, Fri, Sat, or Sun. Multiple days must be separated by spaces, and you can set at most seven days.
month-date month-day: Executes a command on a specified day of a month, where month-day represents the day, an integer in the range 1 to 31.
date: Date when a command is executed, in the MM/DD/YYYY or YYYY/MM/DD format. The YYYY value ranges from 2000 to 2035, the MM value ranges from 1 to 12, and the DD value ranges from 1 to 31. The execution date must be ahead of the current date.
command command: Command to be executed at a specified time.
Examples
1. Schedule a task to enable PoE on the device at eight AM from Monday to Friday. <Sysname> system-view
[Sysname] job phone
[Sysname-job-phone] time 1 repeating at 8:00 week-day Mon Tue Wed Thu Fri
command poe enable
2. Schedule a task to disable PoE on the device on sixth April 2008. <Sysname> system-view
[Sysname] job phone
[Sysname-job-phone] time 2 at 8:00 2008/04/06 command undo poe enable
time delay Description
Use time delay to configure a scheduled task to be executed after a delay time.
• The commands in a scheduled task must be in the same view.
• A scheduled task can contain up to 10 commands.
• To execute more than 10 commands, configure them in different tasks.
Use undo time to remove it (by default no time delay is configured).
Syntax
time time-id { one-off | repeating } delay time command command
undo time time-id
View
Scheduled task view
Default level
3: Manage level
Parameters
time time-id: Time setting entry, where time-id is an integer ranging from 1 to 10. A scheduled task can be specified with up to 10 time setting entries.
one-off: Specifies that the specified command is executed for once. That is, the command is executed when the time is reached, and will not be executed when the time is reached next time.
repeating: Specifies a recurring time schedule.
198
delay time: Specifies the delay time for executing the command, in the hh:mm format or mm format.
• When the time argument is in the hh:mm format, the hh value ranges from 0 to 720, and the mm value ranges from 0 to 59. When the hh value is 720, the mm value can be only 00.
• When the time argument is in the mm format, the mm value ranges from 1 to 43,200. That is, the maximum value of the delay timer is 30 days.
The delay time parameter is unrelated to the system time. Even though the system time changes, the command is executed after the specified delay time.
command command: Command to run at a specified time.
Example
# Configure a scheduled task so that PoE is disabled on the device five hours after the command is configured.
<Sysname> system-view
[Sysname] job phone
[Sysname-job-phone] time 3 one-off delay 5:00 command undo poe enable
view Description
Use view to specify a view where the commands are to be executed.
Use undo view to remove the view existing in a scheduled task and restore the default (no view is specified by default).
Only one view can be specified for a scheduled task and all the commands are automatically executed in that view. If the view view-name command is executed repeatedly, only the last configuration takes effect.
Syntax
view view-name
undo view
View
Scheduled task view
Default level
3: Manage level
Parameter
view-name: View name, which a string of 1 to 90 characters used to specify in which view the commands in a scheduled task are executed.
Examples
# Specify system view where the specified commands are to be executed. <Sysname> system-view
[Sysname] job saveconfig
[Sysname-job-saveconfig] view system
199
Support and other resources
Contacting HP For worldwide technical support information, see the HP support website:
http://www.hp.com/support
Before contacting HP, collect the following information:
• Product model names and numbers
• Technical support registration number (if applicable)
• Product serial numbers
• Error messages
• Operating system type and revision level
• Detailed questions
Subscription service HP recommends that you register your product at the Subscriber's Choice for Business website:
http://www.hp.com/go/wwalerts
After registering, you will receive email notification of product enhancements, new driver versions, firmware updates, and other product resources.
Related information
Documents To find related documents, browse to the Manuals page of the HP Business Support Center website:
http://www.hp.com/support/manuals
• For related documentation, navigate to the Networking section, and select a networking category.
• For a complete list of acronyms and their definitions, see HP A-Series Acronyms.
Websites • HP.com http://www.hp.com
• HP Networking http://www.hp.com/go/networking
• HP manuals http://www.hp.com/support/manuals
• HP download drivers and software http://www.hp.com/support/downloads
Conventions This section describes the conventions used in this documentation set.
Command conventions
Convention Description
Boldface Bold text represents commands and keywords that you enter literally as shown.
Italic Italic text represents arguments that you replace with actual values.
[ ] Square brackets enclose syntax choices (keywords or arguments) that are optional.
{ x | y | ... } Braces enclose a set of required syntax choices separated by vertical bars, from which you select one.
[ x | y | ... ] Square brackets enclose a set of optional syntax choices separated by vertical bars, from which you select one or none.
{ x | y | ... } * Asterisk-marked braces enclose a set of required syntax choices separated by vertical bars, from which you select at least one.
[ x | y | ... ] * Asterisk-marked square brackets enclose optional syntax choices separated by vertical bars, from which you select one choice, multiple choices, or none.
&<1-n> The argument or keyword and argument combination before the ampersand (&) sign can be entered 1 to n times.
# A line that starts with a pound (#) sign is comments.
GUI conventions
Convention Description
Boldface Window names, button names, field names, and menu items are in bold text. For example, the New User window appears; click OK.
> Multi-level menus are separated by angle brackets. For example, File > Create > Folder.
Symbols
Convention Description
WARNING An alert that calls attention to important information that if not understood or followed can result in personal injury.
CAUTION An alert that calls attention to important information that if not understood or followed can result in data loss, data corruption, or damage to hardware or software.
IMPORTANT An alert that calls attention to essential information.
NOTE An alert that contains additional or supplementary information.
TIP An alert that provides helpful information.
201
Network topology icons
Represents a generic network device, such as a router, switch, or firewall.
Represents a routing-capable device, such as a router or Layer 3 switch.
Represents a generic switch, such as a Layer 2 or Layer 3 switch, or a router that supports Layer 2 forwarding and other Layer 2 features.
Port numbering in examples
The port numbers in this document are for illustration only and might be unavailable on your device.
fan prefer-direction,183 file prompt,96 fixdisk,96 flow-control,31 format,97 free ftp user,55 free user-interface,31 free web-users,32 ftp,67 ftp client source, 68 ftp ipv6,69 ftp server acl,56 ftp server enable,56
ftp timeout,57 ftp update,57
G
get,70
H
header,184 history-command max-size,33 hotkey,7
I
idle-timeout,34 ip http acl,34 ip http enable,35 ip http port,35 ip https acl,36 ip https certificate access-control-policy,37 ip https enable,38 ip https port,38 ip https ssl-server-policy,39 issu accept,142 issu commit,143 issu load,143 issu rollback,144 issu rollback-timer,145 issu run switchover,146
