H3C S5820 series Command Reference Manual

H3C S5820 series Command Reference Manual

Hide thumbs Also See for S5820 series:
Table of Contents

Advertisement

H3C S5820X&S5800 Switch Series
Fundamentals Command Reference
Hangzhou H3C Technologies Co., Ltd.
http://www.h3c.com
Software version: Release 1805P02
Release 1808P12
Document version: 6W101-20140314

Advertisement

Table of Contents
loading

Summary of Contents for H3C S5820 series

  • Page 1 H3C S5820X&S5800 Switch Series Fundamentals Command Reference Hangzhou H3C Technologies Co., Ltd. http://www.h3c.com Software version: Release 1805P02 Release 1808P12 Document version: 6W101-20140314...
  • Page 2 Copyright © 2012-2014, Hangzhou H3C Technologies Co., Ltd. and its licensors All rights reserved No part of this manual may be reproduced or transmitted in any form or by any means without prior written consent of Hangzhou H3C Technologies Co., Ltd.
  • Page 3 Preface The H3C S5820X&S5800 documentation set includes 12 command references, which describe the commands and command syntax options available for the S5820X&S5800 Switch Series. The Fundamentals Command Reference describes how to configure the command line interface (CLI), log in to the switch, perform file management, FTP and TFTP, configuration file management, and device management for your switch, upgrade the software and perform automatic configuration.
  • Page 4 Release 1805P02 has the following command changes over Release 121 1: • Command reference Added and modified commands Modified commands: a password configured by the super password command for user privilege level switching can be hashed. Added commands: • ip http dscp •...
  • Page 5: Command Conventions

    • display alarm • display copyright • usb disable • time time-id { one-off | repeating } at time [ month-date month-day | week-day week-daylist ] command command Conventions This section describes the conventions used in this documentation set. Command conventions Convention Description Boldface...
  • Page 6 Represents a security card, such as a firewall card, a load-balancing card, or a NetStream card. Port numbering in examples The port numbers in this document are for illustration only and might be unavailable on your device. About the H3C S5820X&S5800 documentation set The H3C S5820X&S5800 documentation set includes: Category Documents...
  • Page 7 Interface Cards User available for the products. Manual Describes the benefits, features, hardware H3C OAP Cards User specifications, installation, and removal of the OAP Manual cards available for the products. H3C Low End Series...
  • Page 8: Obtaining Documentation

    Obtaining documentation You can access the most up-to-date H3C product documentation on the World Wide Web at http://www.h3c.com. Click the links on the top navigation bar to obtain different categories of product documentation: [Technical Support & Documents > Technical Documents]—Provides hardware installation, software...
  • Page 9: Documentation Feedback

    Documentation feedback You can e-mail your comments about product documentation to info@h3c.com. We appreciate your comments.
  • Page 10: Table Of Contents

    Contents CLI configuration commands ······································································································································· 1   command-alias enable ············································································································································· 1   command-alias mapping ········································································································································· 1   command-privilege ··················································································································································· 2   display clipboard ····················································································································································· 3   display command-alias ············································································································································ 4   display history-command ········································································································································· 4   display hotkey ··························································································································································· 5  ...
  • Page 11 protocol inbound ··················································································································································· 40   screen-length ·························································································································································· 41   send ········································································································································································ 42   set authentication password ································································································································· 43   shell ········································································································································································· 44   speed (user interface view) ··································································································································· 45   stopbits···································································································································································· 45   telnet ······································································································································································· 46   telnet client dscp ···················································································································································· 47  ...
  • Page 12 open ipv6 ······························································································································································· 78   passive ···································································································································································· 79   put ··········································································································································································· 80   pwd ········································································································································································· 80   quit ·········································································································································································· 81   remotehelp ····························································································································································· 81   rmdir ······································································································································································· 83   user ········································································································································································· 84   verbose ··································································································································································· 84   TFTP configuration commands ··································································································································· 86  ...
  • Page 13 save ······································································································································································· 124   slave auto-update config····································································································································· 128   startup saved-configuration ································································································································ 128   Software upgrade commands ································································································································ 130   boot-loader ··························································································································································· 130   boot-loader update file ······································································································································· 131   bootrom ································································································································································ 132   bootrom-update security-check enable ·············································································································· 133   display boot-loader ·············································································································································...
  • Page 14 display system-failure ·········································································································································· 176   display transceiver ·············································································································································· 177   display transceiver alarm ··································································································································· 178   display transceiver diagnosis ····························································································································· 180   display transceiver manuinfo ····························································································································· 181   display version ····················································································································································· 182   display version-update-record ···························································································································· 183   fan prefer-direction (available only on S5800-54S and S5820X-26S switches) ········································· 184  ...
  • Page 15: Cli Configuration Commands

    CLI configuration commands In R1808P12 and later versions, the device supports the FIPS mode that complies with NIST FIPS 140-2 requirements. Support for features, commands, and parameters might differ in FIPS mode and non-FIPS mode. For more information about FIPS mode, see Security Configuration Guide. command-alias enable Use command-alias enable to enable the command keyword alias function.
  • Page 16: Command-Privilege

    Default A command keyword has no alias. Views System view Default command level 2: System level Parameters cmdkey: Specifies the complete form of the first keyword of a non-undo command, or the second keyword of an undo command. alias: Specifies an alias for the keyword. It must be different from the first keyword of any non-undo command.
  • Page 17: Display Clipboard

    command: Specifies a command in the specified view. Usage guidelines Command levels include four privileges: visit (0), monitor (1), system (2), and manage (3). You can assign a privilege level according to the user's need. When logging in to the device, the user can access the assigned level and all levels below it.
  • Page 18: Display Command-Alias

    begin: Displays the first line that matches the specified regular expression and all lines that follow. exclude: Displays all lines that do not match the specified regular expression. include: Displays all lines that match the specified regular expression. regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters. Usage guidelines To copy some content to the clipboard: Move the cursor to the starting position of the content, and then press the Esc+Shift+, combination.
  • Page 19: Display Hotkey

    Syntax display history-command [ | { begin | exclude | include } regular-expression ] Views Any view Default command level 1: Monitor level Parameters |: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide. begin: Displays the first line that matches the specified regular expression and all lines that follow.
  • Page 20: Hotkey

    Examples # Display hotkey information. <Sysname> display hotkey ----------------- HOTKEY ----------------- =Defined hotkeys= Hotkeys Command CTRL_G display current-configuration CTRL_L display ip routing-table CTRL_O undo debug all =Undefined hotkeys= Hotkeys Command CTRL_T NULL CTRL_U NULL =System hotkeys= Hotkeys Function CTRL_A Move the cursor to the beginning of the current line. CTRL_B Move the cursor one character left.
  • Page 21: Quit

    Syntax hotkey { CTRL_G | CTRL_L | CTRL_O | CTRL_T | CTRL_U } command undo hotkey { CTRL_G | CTRL_L | CTRL_O | CTRL_T | CTRL_U } Default Ctrl_G: display current-configuration (display the running configuration). • Ctrl_L: display ip routing-table (display the IPv4 routing table information). •...
  • Page 22: Return

    Examples # Return from GigabitEthernet 1/0/1 interface view to system view and then to user view. [Sysname-GigabitEthernet1/0/1] quit [Sysname] quit <Sysname> return Use return to return to user view from any other view. Pressing Ctrl+Z has the same effect. Syntax return Views Any view except user view...
  • Page 23: Super

    Examples # Disable pausing between screens of output for the current session. <Sysname> screen-length disable Related commands screen-length super Use super to switch from the current user privilege level to a specified user privilege level. Syntax super [ level ] Views User view Default command level...
  • Page 24: Super Authentication-Mode

    Related commands super password • super authentication-mode • super authentication-mode Use super authentication-mode to set the authentication mode for user privilege level switching. Use undo super authentication-mode to restore the default. Syntax super authentication-mode { local | scheme } * undo super authentication-mode Default The authentication mode for the user privilege level switching is local.
  • Page 25: Super Password

    super password Use super password to set the password used to switch from the current user privilege level to a higher one. Use undo super password to restore the default. Syntax In non-FIPS mode: super password [ level user-level ] [ hash ] { cipher | simple } password undo super password [ level user-level ] In FIPS mode: super password [ level user-level ] { cipher | simple } password...
  • Page 26: System-View

    Usage guidelines Whether you specify the cipher or simple keyword, the password is saved in cipher text in the configuration file. You cannot configure the super password [ level user-level ] hash cipher command when the password-control enable command is configured. Examples # Use the password abc in plain text to authenticate a user switching to privilege level 3.
  • Page 27: Login Management Commands

    Login management commands In R1808P12 and later versions, the device supports the FIPS mode that complies with NIST FIPS 140-2 requirements. Support for features, commands, and parameters might differ in FIPS mode and non-FIPS mode. For more information about FIPS mode, see Security Configuration Guide. Telnet and HTTP are not supported in FIPS mode.
  • Page 28: Activation-Key

    connection is allowed to be established. When the device functions as a Telnet client, use this keyword to define Telnet servers accessible to the client. Usage guidelines 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.
  • Page 29 Log in to the console port again. The following message appears. ****************************************************************************** * Copyright (c) 2004-2014 Hangzhou H3C Tech. Co., Ltd. All rights reserved. * Without the owner's prior written consent, * no decompiling or reverse-engineering shall be allowed. ****************************************************************************** User interface aux0 is available.
  • Page 30: Auto-Execute Command

    Enter s. A terminal session is started. <Sysname> %Mar 2 18:40:27:981 2011 Sysname SHELL/5/LOGIN: Console login from aux0 auto-execute command CAUTION: After configuring this command for a user interface, you might be unable to access the CLI through the user interface. Make sure you can access the CLI through a different user interface before you configure this command and save the configuration.
  • Page 31: Authentication-Mode

    The device automatically Telnets to 192.168.1.41. The following output is displayed: C:\> telnet 192.168.1.40 ****************************************************************************** * Copyright (c) 2004-2014 Hangzhou H3C Tech. Co., Ltd. All rights reserved. * Without the owner's prior written consent, * no decompiling or reverse-engineering shall be allowed.
  • Page 32: Command Accounting

    (unless the user uses SSH for the first login). If NTP synchronization is also configured, H3C recommends that you wait 10 minutes before changing the password. Otherwise, NTP synchronization might not be finished when the password is created.
  • Page 33: Command Authorization

    Default Command accounting is disabled, and the accounting server does not record executed commands. Views User interface view Default command level 3: Manage level Usage guidelines When command accounting is enabled and command authorization is not, every executed command is recorded on the HWTACACS server.
  • Page 34: Databits

    databits Use databits to set the number of data bits for each character. Use undo databits to restore the default. Syntax databits { 7 | 8 } undo databits Default Eight data bits are used for each character. Views User interface view Default command level 2: System level Parameters...
  • Page 35: Display Ip Https

    exclude: Displays all lines that do not match the specified regular expression. include: Displays all lines that match the specified regular expression. regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters. Examples # Display information about HTTP. <Sysname>...
  • Page 36: Display Telnet Client Configuration

    HTTPS port: 443 SSL server policy: test Certificate access-control-policy: Basic ACL: 2222 Current connection: 0 Operation status: Running Table 4 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 attribute access control policy associated Certificate access-control-policy with the HTTPS service.
  • Page 37: Display User-Interface

    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 Use display user-interface to display information about the specified or all user interfaces. Syntax display user-interface [ num1 | { aux | vty } num2 ] [ summary ] [ | { begin | exclude | include } regular-expression ] Views Any view...
  • Page 38 Physical port that corresponds to the user interface. For AUX and VTY user interfaces, a hyphen (-) is displayed. # Display summary about all user interfaces. <Sysname> display user-interface summary <H3C>dis user-interface summary User interface type : [TTY] 0:XXX User interface type : [AUX]...
  • Page 39: Display Users

    Table 6 Command output Field Description Type of the user interface, AUX or VTY. User interface type Type of the user interface, AUX, VTY, or TTY. The switch does not support TTY user interfaces. 0 represents the absolute number of the user interface. If the user interface is not used, an X is displayed.
  • Page 40: Display Web Users

    Following are more details. VTY 0 Location: 192.168.0.54 VTY 1 Location: 192.168.0.58 : Current operation user. : Current operation user work in async mode. The output shows that two users have logged in to the device. The one with IP address 192.168.1.54 uses VTY 0, and the other with IP address 192.168.1.58 uses VTY 1.
  • Page 41: Escape-Key

    <Sysname> display web users UserID Name Language Level State LinkCount LoginTime LastTime ab890000 admin Chinese Management Enable 14:13:46 14:14:18 Table 8 Command output Field Description UserID Web user ID. Name Web username. Language Language used in Web login. Level Web user level. State Web user status.
  • Page 42: Flow-Control

    character to terminate a task, rather than a common character. For example, if you specify character e in VTY 0 user interface of Device A, when you log in to Device A through VTY 0 from a PC (HyperTerminal), you can enter e as a common character on the PC, and you can also use e to terminate the task running on Device A.
  • Page 43: Free User-Interface

    none: Disables flow control. software: Performs software flow control. Usage guidelines The device supports only the none mode. A flow control mode takes effect on both the inbound and outbound directions. In inbound flow control, the local device listens to the remote device for flow control information. In the outbound flow control, the local device sends flow control information to the remote device.
  • Page 44: Free Web-Users

    Following are more details. VTY 0 Location: 192.168.0.5 VTY 1 Location: 192.168.0.202 VTY 2 Location: 192.168.0.5 VTY 3 Location: 192.168.0.108 : Current operation user. : Current operation user work in async mode. If the operations of the user using VTY 1 affect the operations of the administrator, log out the user. <Sysname>...
  • Page 45: Idle-Timeout

    The buffer of a user interface saves 10 history commands at most. Views User interface view Default command level 2: System level Parameters size-value: Specifies the maximum number of history commands the buffer can store. The value ranges from 0 to 256. Usage guidelines The command history buffer saves executed history commands per user interface and buffers for different user interfaces do not affect each other.
  • Page 46: Ip Http Acl

    Usage guidelines The system automatically terminates the user's connections if there is no information interaction between the device and the users within the idle timeout time. Setting idle-timeout to zero disables the timer. In this case, connections are maintained unless you terminate them.
  • Page 47: Ip Http Enable

    Related commands display ip http • acl number (ACL and QoS Command Reference) • ip http enable Use ip http enable to enable the HTTP service. Use undo ip http enable to disable the HTTP service. Syntax ip http enable undo ip http enable Default The HTTP service is disabled.
  • Page 48: Ip Http Port

    Views System view Default command level 2: System level Parameters dscp-value: Specifies a DSCP value in the range of 0 to 63. Examples # Set the DSCP value for IPv4 to use for outgoing HTTP packets to 30. <Sysname> system-view [Sysname] ip http dscp 30 ip http port Use ip http port to configure the port number of the HTTP service.
  • Page 49: Ip Https Certificate Access-Control-Policy

    Syntax ip https acl acl-number undo ip https acl acl-number Default The HTTPS service is not associated with any ACL. Views System view Default command level 3: Manage level Parameters acl-number: Specifies an ACL number in the range of 2000 to 2999. Usage guidelines After the HTTPS service is associated with an ACL, only the clients permitted by the ACL can access the device.
  • Page 50: Ip Https Enable

    Default command level 3: Manage level Parameters policy-name: Specifies the name of the certificate attribute access control policy, a string of 1 to 16 characters. Usage guidelines Association of the HTTPS service with a certificate attribute access control policy can control the access rights of clients.
  • Page 51: Ip Https Port

    [Sysname] ip https enable ip https port Use ip https port to configure the port number of the HTTPS service. Use undo ip https port to restore the default. Syntax ip https port port-number undo ip https port Default The port number of the HTTPS service is 443. Views System view Default command level...
  • Page 52: Ipv6 Http Dscp

    Default command level 3: Manage level Parameters policy-name: Specifies the name of an SSL server policy, a string of 1 to 16 characters. Usage guidelines The HTTPS service can be enabled only after this command is configured successfully. With the HTTPS service enabled, you cannot modify the associated SSL server-end policy or remove the association between the HTTPS service and the SSL server-end policy after the HTTPS service is enabled.
  • Page 53: Parity

    lock Default This function is disabled. Views User view Default command level 3: Manage level Usage guidelines This command is not supported in FIPS mode. When you must leave the device for a while, use this command to lock the current user interface to prevent unauthorized access.
  • Page 54: Protocol Inbound

    Views AUX user interface view Default command level 2: System level Parameters even: Performs an even parity check. none: Performs no parity check. odd: Performs an odd parity check. Usage guidelines The parity check setting must be the same for the user interfaces of the connecting ports on the device and the target terminal device for communication.
  • Page 55: Screen-Length

    telnet: Supports only Telnet. This keyword is not supported in FIPS mode. Usage guidelines Before configuring a user interface to support SSH, set the authentication mode to scheme for the user interface; otherwise, the protocol inbound ssh command fails. For more information, see authentication-mode.
  • Page 56: Send

    Related commands screen-length disable send Use send to send messages to user interfaces. Syntax send { all | num1 | { aux | vty } num2 } Views User view Default command level 1: Monitor level Parameters all: Specifies all user interfaces. num1: Specifies the absolute number of a user interface, in the range of 0 to 44.
  • Page 57: Set Authentication Password

    <Sysname> display users The user application information of the user interface(s): Idx UI Delay Type Userlevel VTY 0 06:07:50 TEL + 30 VTY 1 00:00:00 TEL VTY 2 00:54:02 TEL VTY 3 06:00:24 TEL Following are more details. VTY 0 Location: 192.168.0.5 VTY 1 Location: 192.168.0.202...
  • Page 58: Shell

    Default command level 3: Manage level Parameters hash: Uses a hash algorithm to encrypt the password. This keyword is supported only in R1808P12 or later. cipher: Sets a ciphertext password. simple: Sets a plaintext password. password: Specifies the password string. This argument is case sensitive. If simple is specified, it must be a string of 1 to 16 characters.
  • Page 59: Speed (User Interface View)

    # Disable the terminal service for VTYs 0 through 15, so no user can log in to the device through VTYs 0 through 15. <Sysname> system-view [Sysname] user-interface vty 0 15 [Sysname-ui-vty0-15] undo shell % Disable ui-vty0-15 , are you sure? [Y/N]:y [Sysname-ui-vty0-15] The following message appears when a user tries to Telnet to the device: The connection was closed by the remote host!
  • Page 60: Telnet

    stopbits { 1 | 1.5 | 2 } undo stopbits Default The stop bit is one. Views AUX user interface view Default command level 2: System level Parameters 1: Uses one stop bit. 1.5: Uses one and a half stop bits. 2: Uses two stop bits.
  • Page 61: Telnet Client Dscp

    vpn-instance vpn-instance-name: Specifies the MPLS L3VPN 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 option. source: Specifies a source interface or source IPv4 address for outgoing Telnet packets. interface interface-type interface-number: Specifies a source interface for outgoing Telnet packets.
  • Page 62: Telnet Client Source

    Syntax telnet client ipv6 dscp dscp-value undo telnet client ipv6 dscp Default IPv6 uses the DSCP value 0 for outgoing Telnet packets on a Telnet client. Views System view Default command level 2: System level Parameters dscp-value: Specifies a DSCP value in the range of 0 to 63. Examples # Set the DSCP value for IPv6 to use for outgoing Telnet packets to 30 on a Telnet client.
  • Page 63: Telnet Ipv6

    Examples # Specify the source IPv4 address for outgoing 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 Related commands display telnet client configuration telnet ipv6 Use telnet ipv6 to Telnet to a remote host in an IPv6 network. Syntax telnet ipv6 remote-host [ -i interface-type interface-number ] [ port-number ] [ vpn-instance vpn-instance-name ]...
  • Page 64: Telnet Server Enable

    Default IPv4 uses the DSCP value 48 for outgoing Telnet packets on a Telnet server. Views System view Default command level 2: System level Parameters dscp-value: Specifies a DSCP value in the range of 0 to 63. Examples # Set the DSCP value for IPv4 to use for outgoing Telnet packets to 30 on a Telnet server. <Sysname>...
  • Page 65: Terminal Type

    Specifies the terminal display type as VT100. Usage guidelines The device supports two terminal display types: ANSI and VT100. H3C recommends setting the display type to VT100 for both the device and the client. If the device and the client use different display types or both are using the ANSI display type, when the total number of characters for a command line exceeds 80, the screen display on the terminal might be abnormal.
  • Page 66: User Privilege Level

    Examples # Set the terminal display type to VT100. <Sysname> system-view [Sysname] user-interface vty 0 [Sysname-ui-vty0] terminal type vt100 user privilege level Use user privilege level to configure the user privilege level. Users logging into the user interface are assigned a user privilege level. Use undo user privilege level to restore the default.
  • Page 67: User-Interface

    clock Specify the system clock cluster Run cluster command copy Copy from one file to another debugging Enable system debugging functions delete Delete a file List files on a file system display Display current system information fixdisk Recover lost chains in storage device format Format the device free...
  • Page 68: Web Captcha

    <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] web captcha Use web captcha to specify a fixed verification code for Web login. Use undo web captcha to restore the default.
  • Page 69: Web Idle-Timeout

    Syntax web https-authorization mode { auto | manual } undo web https-authorization mode Default A user must enter correct username and password to log in through HTTPS. Views System view Default command level 2: System level Parameters auto: Uses the PKI certificates of HTTPS users to automatically authenticate them. manual: Provides a login page for HTTPS users to enter the correct username and password.
  • Page 70: Web Logbuffer Size

    Parameters minutes: Specifies the timeout time in minutes, in the range of 1 to 999. Examples # Set the Web user connection timeout time to 20 minutes. <System> system-view [System] web idle-timeout 20 web logbuffer size Use web logbuffer size to set the size of the buffer for Web login logging. Use undo web logbuffer size to restore the default.
  • Page 71: Ftp Configuration Commands

    FTP configuration commands In R1808P12 and later versions, the device supports the FIPS mode that complies with NIST FIPS 140-2 requirements. Support for features, commands, and parameters might differ in FIPS mode and non-FIPS mode. For more information about FIPS mode, see Security Configuration Guide. FTP is not supported in FIPS mode.
  • Page 72: Display Ftp-User

    Table 9 Command output Field Description Max user number Maximum number of concurrent login users. User count Number of the current login users. Allowed idle time of an FTP connection. If no packet exchange occurs Timeout value (in minute) between the FTP server and client during this period, the FTP connection is broken.
  • Page 73: Free Ftp User

    // The output shows two online FTP users, where the username of the second user is administrator. This username exceeds 10 characters and the excessive characters are displayed in the next line and right justified. Table 10 Command output Field Description UserName Name of the user.
  • Page 74: Ftp Server Dscp

    Default No ACL is used to control FTP client access to the FTP server. Views System view Default command level 3: Manage level Parameters acl-number: Basic ACL number, in the range of 2000 to 2999. Usage guidelines You can use this command to permit only FTP requests from specific FTP clients. This configuration only takes effect for FTP connections to be established;...
  • Page 75: Ftp Server Enable

    [Sysname] ftp server dscp 30 ftp server enable Use ftp server enable to enable the FTP server. Use undo ftp server to disable the FTP server. Syntax ftp server enable undo ftp server Default The FTP server is disabled. Views System view Default command level 3: Manage level...
  • Page 76: Ftp Update

    Examples # Set the idle-timeout timer to 36 minutes. <Sysname> system-view [Sysname] ftp timeout 36 [Sysname] ftp update Use ftp update to set the file update mode that the FTP server uses while receiving data. Use undo ftp update to restore the default. Syntax ftp update { fast | normal } undo ftp update...
  • Page 77: Binary

    3: Manage level Usage guidelines The carriage return characters vary with operating systems. For example, H3C and Windows use characters /r/n, and Linux uses characters /n. To transfer files between two systems that use different carriage return characters, determine FTP transfer mode according to the file type.
  • Page 78: Bye

    [ftp] Related commands ascii Use bye to disconnect from the remote FTP server and return to user view. Syntax Views FTP client view Default command level 3: Manage level Usage guidelines If no connection is established between the device and the remote FTP server, use this command to return to user view.
  • Page 79: Cdup

    ..: Returns to the upper directory. The execution of the cd .. command equals the execution of the cdup command. If the current working directory is the FTP root directory, the cd .. command does not change the current working directory. This argument does not support command line online help. /: Returns to the FTP root directory.
  • Page 80: Close

    Related commands • • close Use close to terminate the connection to the FTP server, but remain in FTP client view. Syntax close Views FTP client view Default command level 3: Manage level Usage guidelines This command is equal to the disconnect command. Examples # Terminate the connection to the FTP server and remain in FTP client view.
  • Page 81: Delete

    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 [ftp] get sample.file --->...
  • Page 82: Dir

    Syntax delete remotefile Views FTP client view Default command level 3: Manage level Parameters remotefile: File name. Usage guidelines To perform this operation, you must have delete permission on the FTP server. Examples # Delete file temp.c. [ftp] delete temp.c 250 DELE command successful.
  • Page 83: Disconnect

    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...
  • Page 84: Ftp

    Syntax display ftp client configuration [ | { begin | exclude | include } regular-expression ] Views Any view Default command level 1: Monitor level Parameters |: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.
  • Page 85: Ftp Client Dscp

    source { interface interface-type interface-number | ip source-ip-address }: Specifies a source address for outgoing FTP packets. interface interface-type interface-number: Specifies a source interface. The primary IP address of • this interface will be used as the source address for outgoing FTP packets. If no primary IP address is configured on the source interface, the connection cannot be established.
  • Page 86: Ftp Client Ipv6 Dscp

    Parameters dscp-value: Specifies a DSCP value in the range of 0 to 63. Examples # Set the DSCP value for IPv4 to use for outgoing FTP packets to 30 on an FTP client. <Sysname> system-view [Sysname] ftp client dscp 30 ftp client ipv6 dscp Use ftp client ipv6 dscp to set the DSCP value for IPv6 to use for outgoing FTP packets on an FTP client.
  • Page 87: Ftp Ipv6

    Parameters interface interface-type interface-number: Specifies a source interface for outgoing FTP packets. The primary IP address of this interface will be used as the source address for outgoing FTP packets. If no primary IP address is configured on the source interface, the connection cannot be established. ip source-ip-address: Specifies a source IP address for outgoing FTP packets.
  • Page 88: Get

    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 an output 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 output interface has a link local address.
  • Page 89: Lcd

    Default command level 3: Manage level Parameters remotefile: Name of the file to be downloaded. localfile: Name for the downloaded file. If this argument is not specified, the original name is used. Examples # Download file testcfg.cfg to the root directory of the storage medium on the master, and save it as newest.cfg.
  • Page 90 Use ls remotefile to list files under a specific subdirectory or verify the existence of a file in the current directory of the FTP server . Use ls remotefile localfile to save the name of file or the list of files under a specific subdirectory to a local file.
  • Page 91: Mkdir

    ..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 221 Server closing. <Sysname> more aa.txt logfile.log a.cfg <Sysname> mkdir Use mkdir to create a subdirectory in the current directory on the FTP server. Syntax mkdir directory Views...
  • Page 92: Open Ipv6

    Parameters server-address: IP address or host name of an FTP server. service-port: Port number of the FTP server, in the range of 0 to 65535. The default value is 21. Usage guidelines At login, you must enter the correct username and password. If you have logged in to one IPv4 FTP server, you cannot use the open command to log in to another server.
  • Page 93: Passive

    Usage guidelines At login, enter the username and password for accessing the FTP server. If your input is correct, the login succeeds. Examples # Log in to the FTP server at 3000::200 in FTP client view. <Sysname> ftp [ftp] open ipv6 3000::200 Trying 3000::200 ...
  • Page 94: Put

    Use put to upload a file on the client to the FTP server. Syntax put localfile [ remotefile ] Default If no name is assigned to the file to be saved on the FTP server, the name of the source file is used. Views FTP client view Default command level...
  • Page 95: Quit

    Examples # Display the current directory on the FTP server. [ftp] cd servertemp [ftp] pwd 257 "/servertemp" is current directory. The output shows you are in the servertemp folder under the FTP root directory. quit Use quit to disconnect the FTP client from the FTP server and exit to user view. Syntax quit Views...
  • Page 96 SYST STAT* HELP NOOP* XCUP XCWD XMKD XPWD XRMD 214 Direct comments to H3C company. # Display the syntax of the user command. [ftp] remotehelp user 214 Syntax: USER <sp> <username>. [ftp] Table 12 Command output Field Description USER Username.
  • Page 97: Rmdir

    Field Description 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 CDUP. XCWD Extension command, the same meaning as CWD. XMKD Extension command, the same meaning as MKD. XPWD Extension command, the same meaning as PWD.
  • Page 98: User

    user Use user to switch to another user account. Syntax user username [ password ] Views FTP client view Default command level 3: Manage level Parameters username: Login username. password: Login password. Usage guidelines The user account to switch to must have been configured on the FTP server. You can enter the password in either of the following ways after entering the username: Press the space bar and then enter the password in the same line.
  • Page 99 Default The display of detailed prompt information is enabled. Views FTP client view Default command level 3: Manage level Examples # Enable displaying detailed prompt information. [ftp] verbose FTP: verbose is on # Disable displaying detailed prompt information and perform a Get operation. [ftp] undo verbose FTP: verbose is off [ftp] get startup.cfg bb.cfg...
  • Page 100: Tftp Configuration Commands

    TFTP configuration commands In R1808P12 and later versions, the device supports the FIPS mode that complies with NIST FIPS 140-2 requirements. Support for features, commands, and parameters might differ in FIPS mode and non-FIPS mode. For more information about FIPS mode, see Security Configuration Guide. TFTP is not supported in FIPS mode.
  • Page 101: Tftp

    Syntax tftp-server [ ipv6 ] acl acl-number undo tftp-server [ ipv6 ] acl Default No ACL is used to control the device's access to a TFTP server. Views System view Default command 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 of 2000 to 2999.
  • Page 102: Tftp Client Dscp

    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. If this argument is not specified, the file uses the source file name and is saved in the directory where the user performed the TFTP operation.
  • Page 103: Tftp Client Ipv6 Dscp

    Default IPv4 uses the DSCP value 0 for outgoing TFTP packets on a TFTP client. Views System view Default command level 2: System level Parameters dscp-value: Specifies a DSCP value in the range of 0 to 63. Examples # Set the DSCP value for IPv4 to use for outgoing TFTP packets to 30 on a TFTP client. <Sysname>...
  • Page 104: Tftp Ipv6

    Default The primary IP address of the output interface is used as the source IP address for outgoing TFTP packets. Views System view Default command level 2: System level Parameters interface interface-type interface-number: Specifies a source interface for outgoing TFTP packets. ip source-ip-address: Specifies a source IP address for outgoing TFTP packets.
  • Page 105 Default command level 3: Manage level Parameters tftp-ipv6-server: IPv6 address or host name of a TFTP server, a string of 1 to 46 characters. -i interface-type interface-number: Specifies an output 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 output interface has a link local address.
  • Page 106: File System Management Commands

    File system management commands In the examples in this chapter, the current working directory refers to the root directory of the storage medium on the device. For information about the qualified file name formats, see Fundamental Configuration Guide. Use cd to change the current working directory. Syntax cd { directory | ..
  • Page 107: Crypto-Digest

    Default command level 3: Manage level Parameters fileurl-source: Specifies the name of the source file. fileurl-dest: Specifies the name of the target file or folder. Usage guidelines If you specify a target folder, the system will copy the file to the specified folder and use the name of the source file as the file name.
  • Page 108: Delete

    delete Use delete file-url to temporarily delete a file. Use delete /unreserved file-url to permanently delete a file. Syntax delete [ /unreserved ] file-url Views User view Default command level 3: Manage level Parameters /unreserved: Permanently deletes the specified file, and the deleted file can never be restored. file-url: Specifies the name of the file to be deleted.
  • Page 109: Dir

    Use dir to display files or folders. Syntax dir [ /all ] [ file-url | /all-filesystems ] Views User view Default command level 3: Manage level Parameters /all: Displays all files and folders in the current directory, including hidden files, hidden folders, and files moved from the current directory to the recycle bin.
  • Page 110 -rw- JAN 26 2012 12:09:25 patchstate -rw- 12955373 JAN 10 2012 15:12:31 s5800-b95sp.bin -rw- 551510 JAN 26 2012 12:49:44 cmdtree.txt -rw- JAN 26 2012 12:07:42 system.xml -rw- 2550 JAN 26 2012 12:07:46 startup.cfg -rw- 478132 JAN 26 2012 12:03:35 s5800_504.btm -rw- 469772 JAN 26 2012 20:31:33...
  • Page 111: Display Nandflash File-Location

    Field Description Directory. This field is not displayed for a file. The file or directory is readable. The file or directory is writable. The file or directory is hidden. The file is in the recycle bin. display nandflash file-location Use display nandflash file-location to display the location of the specified file in the NAND Flash memory.
  • Page 112: Display Nandflash Badblock-Location

    Table 14 Command output Field Description Logic Chunk Serial number of the logical pages. Physical Page Serial number of the physical pages. The first logical page of this file corresponds to the 31009th physical chunk(0) 31009 page on the device. display nandflash badblock-location Use display nandflash badblock-location to display the number and location of bad blocks in the NAND Flash memory.
  • Page 113: Display Nandflash Page-Data

    50 31 32 0D 0A 23 0D 0A 20 73 79 73 6E 61 6D 65 P12..#.. sysname 0030: 20 48 33 43 0D 0A 23 0D 0A 20 69 72 66 20 6D 61 H3C..#.. irf ma execute Use execute to execute a batch file. Syntax...
  • Page 114: File Prompt

    Views System view Default command level 2: System level Parameters filename: Specifies the name of a batch file. A batch file can use any extension, such as .bat or .txt. Usage guidelines A batch file contains a set of commands. Executing a batch file is to execute the commands in the file. Do not include invisible characters in a batch file.
  • Page 115: Fixdisk

    <Sysname> system-view [Sysname] file prompt alert fixdisk Use fixdisk to examine a storage medium for damage and repair any damage. Syntax fixdisk device Views User view Default command level 3: Manage level Parameters device: Specifies the storage medium name. Usage guidelines Use this command to fix a storage medium when the medium becomes unavailable or cannot operate normally.
  • Page 116: Mkdir

    All data on flash: will be lost, proceed with format? [Y/N]:y %Format flash: completed. mkdir Use mkdir to create a folder under a directory on the storage medium. Syntax mkdir directory Views User view Default command level 3: Manage level Parameters directory: Specifies the path information and the folder name.
  • Page 117: Move

    Pressing Enter displays the next line. Pressing Space displays the next screen. Pressing Ctrl+C or any other key exits the display. This command is valid only for text files. Examples # Display the contents of file testcfg.cfg on a subordinate device (with the member ID 2). <Sysname>...
  • Page 118: Pwd

    Use pwd to display the current path. Syntax Views User view Default command level 3: Manage level Examples # Display the current path. <Sysname> pwd flash: rename Use rename to rename a file or folder. The target file name must be unique in the current path. Syntax rename fileurl-source fileurl-dest Views...
  • Page 119 Default command level 3: Manage level Parameters /force: Deletes all files in the recycle bin, including files that cannot be deleted by the command without the /force keyword. Usage guidelines If a file is corrupted, you might not be able to delete the file using the reset recycle-bin command. Use the reset recycle-bin /force command to delete the corrupted file in the recycle bin forcibly.
  • Page 120 64389 KB total (3323 KB free) //The output shows that the current directory is flash:, and there are two files a.cfg and b.cfg 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.
  • Page 121: Rmdir

    rmdir Use rmdir to remove a folder. Syntax rmdir directory Views User view Default command level 3: Manage level Parameters directory: Specifies the name of the folder. Usage guidelines The folder must be an empty one. If not, delete all files and subfolders under it using the delete command. After you execute the rmdir command successfully, the files in the recycle bin in the folder will be automatically deleted.
  • Page 122 ..%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. <Sysname> cd test <Sysname> undelete b.cfg Undelete flash:/test/b.cfg?[Y/N]:y ..%Undeleted file flash:/test/b.cfg.
  • Page 123: Configuration File Management Commands

    Configuration file management commands In R1808P12 and later versions, the device supports the FIPS mode that complies with NIST FIPS 140-2 requirements. Support for features, commands, and parameters might differ in FIPS mode and non-FIPS mode. For more information about FIPS mode, see Security Configuration Guide. archive configuration Use archive configuration to manually archive the running configuration to the configuration archive directory.
  • Page 124: Archive Configuration Interval

    archive configuration interval Use archive configuration interval to enable automatic running-configuration archiving and set the archiving interval. Use undo archive configuration interval to restore the default. Syntax archive configuration interval minutes undo archive configuration interval Default The system does not automatically archive the running configuration. Views System view Default command level...
  • Page 125: Archive Configuration Location

    archive configuration location Use archive configuration location to configure the directory and file name prefix for archiving the running configuration. Use undo archive configuration location to restore the default. Syntax archive configuration location directory filename-prefix filename-prefix undo archive configuration location Default No configuration archive directory or configuration archive file name prefix has been set.
  • Page 126: Archive Configuration Max

    Examples # To configure the configuration archive directory and archive file name prefix as flash:/archive/ and my_archive: Create the directory on the master. <Sysname> mkdir archive %Created dir flash:/archive. Create the directory on IRF member 2. (Repeat this step to create the directory on all IRF members.) <Sysname>...
  • Page 127: Backup Startup-Configuration

    configuration archives have been saved before the archive limit is set to four. When saving a new configuration archive, the system first deletes the oldest four (7 – 4 + 1) archives. If you execute the undo archive configuration location command, the default archive limit is restored. Examples # Set the maximum number of configuration archives to 10.
  • Page 128: Display Archive Configuration

    Syntax configuration replace file filename Views System view Default command level 3: Manage level Parameters filename: Specifies the name of the replacement configuration file for configuration rollback. Usage guidelines To replace the running configuration with the configuration in a configuration file without rebooting the device, use the configuration rollback function.
  • Page 129: Display Current-Configuration

    exclude: Displays all lines that do not match the specified regular expression. include: Displays all lines that match the specified regular expression. regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters. Examples # Display configuration archive information. <Sysname>...
  • Page 130 Parameters configuration [ configuration ]: Displays feature configuration. The configuration argument specifies a feature module. If no feature module is specified, this command displays all feature settings you have made. Available feature modules depend on your configuration. interface [ interface-type [ interface-number ] ]: Displays interface configuration, where the interface-type argument represents the interface type and the interface-number argument represents the interface number.
  • Page 131: Display Default-Configuration

    undo snmp-agent trap enable ospf 100 Related commands • display saved-configuration reset saved-configuration • • save display default-configuration Use display default-configuration to display the factory defaults. Syntax display default-configuration [ | { begin | exclude | include } regular-expression ] Views Any view Default command level...
  • Page 132: Display Saved-Configuration

    idle-cut disable self-service-url disable interface NULL0 interface Vlan-interface1 ip address dhcp-alloc client-identifier mac Vlan-interface1 interface GigabitEthernet1/0/1 interface GigabitEthernet1/0/2 ---- More ---- Related commands display current-configuration • display saved-configuration • display saved-configuration Use display saved-configuration to display the contents of the configuration file for the next system startup.
  • Page 133 If both the main and backup startup configuration files are not available, this command displays the • error message "The config file does not exist!". Examples # Display the contents of the configuration file for the next system startup. <Sysname> display saved-configuration version 5.20, Release 1808P12 sysname Sysname irf mac-address persistent timer...
  • Page 134: Display Startup

    vlan 1 domain system access-limit enable 60 state active idle-cut disable self-service-url disable ---- More ---- Related commands display current-configuration • • reset saved-configuration save • display startup Use display startup to display the names of the current startup configuration file and the next-startup configuration files.
  • Page 135: Display This

    MainBoard: Current startup saved-configuration file: flash:/startup.cfg Next main startup saved-configuration file: flash:/startup.cfg Next backup startup saved-configuration file: NULL Table 17 Command output Field Description MainBoard Displays the startup configuration files on the IRF master. Current Startup saved-configuration file Configuration file that the device has started up with. Next main startup saved-configuration file Main configuration file to be used at the next startup.
  • Page 136: Reset Saved-Configuration

    Executed in any user interface view, this command displays the running configuration of all user view interfaces. Executed in any VLAN view, this command displays the running configuration of all VLANs. Examples # Display the running configuration on interface GigabitEthernet 1/0/1. <Sysname>...
  • Page 137: Restore Startup-Configuration

    You can delete the main, the backup, or both. To delete a file that is set as both main and backup next-startup configuration files, you must execute both the reset saved-configuration backup command and the reset saved-configuration main command. Using only one of the commands sets the specified file attribute to NULL instead of deleting the file. If no configuration file attribute is specified, the reset saved-configuration command deletes the main startup configuration file.
  • Page 138: Save

    This command provides an easy method for configuration file restoration by automatically performing all operations required for restoring the next-startup configuration file. It downloads the configuration file to the root directory of the flash memory on each member device and specifies the file as the next-startup configuration file.
  • Page 139 within 30 seconds, the system automatically aborts the operation. If you enter Y within the time limit, you can continue the save process and change the next-startup configuration file during this process. Usage guidelines If the file specified for file-url does not exist, the system creates the file before saving the configuration. If neither the all keyword nor a member device is specified, the system saves the configuration to the master.
  • Page 140 Next main startup saved-configuration file: flash:/startup.cfg Next backup startup saved-configuration file: NULL // The output shows that the main next-startup configuration file has changed from aa.cfg to startup.cfg on each member device. # Save the running configuration to the configuration file startup.cfg in the root directory of the storage media on each member device, and specify the file as the next-startup configuration file: Display the main next-startup configuration file on each member device.
  • Page 141 Y or y, the running configuration is saved to a new configuration file and the old configuration file is overwritten. H3C recommends that you enter Y or y and manually copy the backup file _config_bak.cfg on the master to the Flash of that device.
  • Page 142: Slave Auto-Update Config

    To ensure configuration consistency across the IRF fabric, H3C recommends that you enable the function. The save command executed with only the file-url argument saves the running configuration only to the specified path, regardless of whether the configuration auto-update function has been enabled.
  • Page 143 Use undo startup saved-configuration to configure all IRF member devices to start up with the factory defaults at the next startup. Syntax startup saved-configuration cfgfile [ backup | main ] undo startup saved-configuration Views User view Default command level 3: Manage level Parameters cfgfile: Specifies a configuration file name with the extension .cfg.
  • Page 144: Software Upgrade Commands

    Software upgrade commands boot-loader Use boot-loader to specify a startup system software image for a member device or all member devices. Syntax boot-loader file file-url slot { all | slot-number } { main | backup } Views User view Default command level 3: Manage level Parameters file file-url: Specifies a file path, a string of 1 to 63 characters.
  • Page 145: Boot-Loader Update File

    Examples # Specify test.bin as the main startup system software image file for the master (member ID 1). This example assumes that this file has been saved in the root directory of the storage medium on the master. <Sysname> boot-loader file test.bin slot 1 main This command will set the boot file of the specified board.
  • Page 146: Bootrom

    In FIPS mode, the system checks the signature of the startup software image for invalidity. If the startup software image does not pass the check, specifying the startup software image fails. Examples # Specify a file as the main startup system software image file for all IRF member devices. <Sysname>...
  • Page 147: Bootrom-Update Security-Check Enable

    # Use the a.btm file to upgrade Boot ROM on IRF member device 2 (a subordinate device). This example assumes that the upgrade file has been saved in the root directory of the storage medium on the subordinate device. (The command output varies with devices.) <Sysname>...
  • Page 148: Display Patch

    Parameters slot slot-number: Specifies the member ID of an IRF member device. If no member device is specified, this command displays the system software images on each IRF member device. |: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.
  • Page 149: Display Patch Information

    exclude: Displays all lines that do not match the specified regular expression. include: Displays all lines that match the specified regular expression. regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters. Usage guidelines If a patch file is loaded from a patch package file, this command also displays the package file version. Examples # Display patch files that have been installed.
  • Page 150: Patch Active

    regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters. Examples # Display hotfix information. (The command output varies with devices.) <Sysname> display patch information The location of patches: flash:/ Slot Version Temporary Common Current Active Running Start-Address ---------------------------------------------------------------------- XXX002...
  • Page 151: Patch Deactive

    Parameters patch-number: Specifies the sequence number of a patch. Values available for this argument depend on the patch file that has been loaded. If no sequence number is specified, this command validates all INACTIVE patches. If a sequence number is specified, this command activates the specified patch and all its previous INACTIVE patches.
  • Page 152: Patch Delete

    [Sysname] patch deactive slot 1 patch delete Use patch delete to remove patches from the patch memory area. Syntax patch delete [ patch-number ] slot slot-number Views System view Default command level 3: Manage level Parameters patch-number: Specifies the sequence number of a patch. Values available for this argument depend on the patch file that has been loaded.
  • Page 153: Patch Load

    Parameters patch-location: Specifies the patch file path, a string of 1 to 64 characters. Provide this argument if the patch file is not packaged in a patch package file, and make sure the file name is correct. By default, the system patch file name is patch_mpu.bin and the auxiliary CPU patch file name is patch_lpu.bin.
  • Page 154: Patch Location

    Default The system loads patches from the Flash memory. Views System view Default command level 3: Manage level Parameters slot slot-number: Specifies an IRF member device by its member ID. file filename: Specifies a patch package file name. If no package file is specified, the system loads patch files from Flash memory.
  • Page 155: Patch Run

    If you save the patch files to other storage media except the Flash on the device, you need to specify the directory where the patch files locate with the patch-location argument. Then the system loads the appropriate patch files in the specified directory. If the device has only one storage medium, the patch file is saved to a specific location and you do not need to execute this command.
  • Page 156: Issu Commands

    ISSU commands display issu rollback-timer Use display issu rollback-timer to display information about the ISSU rollback timer. Syntax display issu rollback-timer [ | { begin | exclude | include } regular-expression ] Views Any view Default command level 1: Monitor level Parameters |: Filters command output by specifying a regular expression.
  • Page 157: Display Issu State

    Field Description Remaining time in minutes before the rollback timer expires. This field is Left displayed only when the rollback timer is started. Related commands issu rollback-timer display issu state Use display issu state to display the ISSU state, including whether the new system software image is compatible with the current one and the adopted ISSU upgrade method.
  • Page 158: Display Version Comp-Matrix

    Upgrade boot file is flash:/soft-version2.bin Table 22 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 and the rollback timer is running. • Switchover—The master has been rebooted with the issu run ISSU state switchover command.
  • Page 159 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 H3C S5800-32C-PWR Running Version: version1 Version Compatibility List: (Compatible) # View the version compatibility information between the current boot file and the new boot file bootfile.bin after executing the issu load command.
  • Page 160: Issu Accept

    Matrix for H3C S5800-32C-PWR Running Version: version1 Version Compatibility List: version2 (Compatible) Table 23 Command output Field Description Number of Matrices in Table Number of product versions contained in the current IRF fabric. Matrix for xx Product version of the xx series devices.
  • Page 161: Issu Commit

    issu commit Use issu commit to upgrade the specified member switch that is not upgraded. Syntax issu commit slot slot-number Views System view Default command level 2: System level Parameters slot slot-number: Specifies the ID of a member switch that is not upgraded. Usage guidelines Executing the issu commit command completes the ISSU upgrade process, and you cannot perform a version rollback operation with the issu rollback command.
  • Page 162: Issu Rollback

    file name If you enter a relative path in the format , the system automatically converts it to an absolute drive file name path in the format [ . 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 system software image.
  • Page 163: Issu Rollback-Timer

    Examples # 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 system software image 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.
  • Page 164 Syntax issu run switchover slot slot-number Views System view Default command level 2: System level Parameters 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. Usage guidelines During compatible ISSU upgrade, after you execute the issu run switchover command, if you do not upgrade the un-upgraded IRF member switches with the issu accept command or you do not disable the...
  • Page 165: Device Management Commands

    Device management commands clock datetime Use clock datetime to set the system time and date. Syntax clock datetime time date Views User view Default command level 3: Manage level Parameters time: Specifies a 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.
  • Page 166: Clock Summer-Time Repeating

    Default Daylight saving time is disabled and the UTC time zone applies. Views System view Default command level 3: Manage level Parameters zone-name: Specifies a daylight saving time schedule by a zone name, a case-sensitive string of 1 to 32 characters.
  • Page 167 Syntax clock summer-time zone-name repeating start-time start-date end-time end-date add-time undo clock summer-time Default Daylight saving time is disabled and UTC time zone applies. Views System view Default command level 3: Manage level Parameters zone-name: Specifies a daylight saving time schedule by a zone name, a case-sensitive string of 1 to 32 characters.
  • Page 168: Clock Timezone

    Examples # Set the system time ahead one hour every year after 201 1 (inclusive) for the period from August 1 at 06:00:00 to September 1 at 06:00:00. <Sysname> system-view [Sysname] clock summer-time abc2 repeating 06:00:00 08/01/2011 06:00:00 09/01/2011 01:00:00 Related commands clock datetime •...
  • Page 169: Copyright-Info Enable

    When a Telnet user logs in, the following statement appears: • ************************************************************************** * Copyright (c) 2004-2014 Hangzhou H3C Tech. Co., Ltd. All rights reserved.* * Without the owner's prior written consent, * no decompiling or reverse-engineering shall be allowed. **************************************************************************** <Sysname>...
  • Page 170: Display Alarm

    # Disable displaying the copyright statement. <Sysname> system-view [Sysname] undo copyright-info enable When a Telnet user logs in, the user view prompt appears: • <Sysname> When a console user quits user view, the following message appears: • User interface aux0 is available. Please press ENTER.
  • Page 171: Display Clock

    Table 24 Command output Field Description Member switch ID. Slot Alarm severity level: • ERROR • Level WARNING • NOTICE • INFO The board in slot n is faulty. Member switch n is faulty. The member switch might be starting up or faulty. display clock Use display clock to display the system time and date.
  • Page 172: Display Copyright

    display copyright Use display copyright to display the software and hardware copyright statements. Syntax display copyright [ | { begin | exclude | include } regular-expression ] Views Any view Default command level 1: Monitor level Parameters |: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.
  • Page 173 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.
  • Page 174: Display Cpu-Usage History

    Actual Stat. Cycle : 0x0(CPU Tick High) 0x95030517(CPU Tick Low) ===== CPU usage info (no: idx: 57) ===== CPU Usage Stat. Cycle: 60 (Second) CPU Usage : 3% CPU Usage Stat. Time : 2006-07-10 10:55:55 CPU Usage Stat. Tick : 0x1d9c(CPU Tick High) 0xa50e5351(CPU Tick Low) Actual Stat.
  • Page 175 Views Any view Default command level 1: Monitor level Parameters task task-id: Displays the historical CPU usage statistics for the specified task, where the task-id argument represents the task number. If the task-id argument is not provided, this command displays the historical CPU usage statistics for the entire system (the CPU usage rates of the entire system is the sum of CPU usage rates of all tasks).
  • Page 176 65%| 60%| 55%| 50%| 45%| 40%| 35%| 30%| 25%| 20%| 15%| 10%| ######## ------------------------------------------------------------ (minutes) cpu-usage last 60 minutes(SYSTEM) The output shows the historical CPU usage statistics (with the task name SYSTEM) in the last 60 minutes: 5%: 12 minutes ago •...
  • Page 177: Display Device

    ------------------------------------------------------------ (minutes) cpu-usage last 60 minutes(T03M) The output shows the historical CPU usage statistics 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 Use display device to display device information.
  • Page 178: Display Device Manuinfo

    Ver.B NULL NULL LSW1XP4P0 Normal The output shows that the IRF fabric comprises two member devices, each of which has 28 Ethernet interfaces and is configured with two 10 GE physical IRF ports. Table 26 Command output Field Description Slot 1 Information about IRF member device 1.
  • Page 179: Display Device Manuinfo Fan

    # Display electrical label information. <Sysname> display device manuinfo slot 1 DEVICE_NAME : 3CRS48G-24-91 DEVICE_SERIAL_NUMBER : 9S4F9PLBC3111 MAC_ADDRESS : 001C-C5BC-3111 MANUFACTURING_DATE : 2012-05-08 VENDOR_NAME : H3C slot 2 DEVICE_NAME : S5800-54S DEVICE_SERIAL_NUMBER : 210235A252A079000140 MAC_ADDRESS : 000F-E269-46D1 MANUFACTURING_DATE : 2007-09-26 VENDOR_NAME : H3C display device manuinfo fan Use display device manuinfo fan to display the electronic label data for the specified fan tray.
  • Page 180: Display Device Manuinfo Power

    : NONE MANUFACTURING_DATE : 2010-01-20 VENDOR_NAME : H3C display device manuinfo power Use display device manuinfo power to display the electronic label data for the specified power supply. Syntax display device manuinfo slot slot-number power power-id [ | { begin | exclude | include }...
  • Page 181: Display Diagnostic-Information

    VENDOR_NAME : H3C display diagnostic-information Use display diagnostic-information to display or save running status data for multiple feature modules. Syntax display diagnostic-information [ | { begin | exclude | include } regular-expression ] Views Any view Default command level 1: Monitor level Parameters |: Filters command output by specifying a regular expression.
  • Page 182: Display Environment

    … display environment Use display environment to display temperature information, including the current temperature and temperature thresholds. Syntax display environment [ slot slot-number ] [ | { begin | exclude | include } regular-expression ] Views Any view Default command level 1: Monitor level Parameters slot slot-number: Displays temperature information for an IRF member device.
  • Page 183: Display Fan

    Field Description LowerLimit Temperature lower limit. WarningLimit Warning temperature threshold. AlarmLimit Alarming temperature threshold. Shutdown temperature threshold. When the sensor temperature reaches this limit, the ShutdownLimit system shuts down automatically. Related commands temperature-limit display fan Use display fan to display the operating states of fan trays. Syntax display fan [ slot slot-number [ fan-id ] ] [ | { begin | exclude | include } regular-expression ] Views...
  • Page 184: Display Job

    Wind Direction :Power-to-Port Prefer Wind Direction :Power-to-Port # Display the operating states of all fan trays on switches except for S5800-54S and S5820X-26S switches. <Sysname> display fan Slot 1 State : Normal Table 28 Command output Field Description FanDirectionFault The air flow direction is not as expected. Related commands fan prefer-direction display job...
  • Page 185: Display Memory

    The output shows that the current configuration will be automatically saved to the configuration file 1.cfg in 40 minutes. Table 29 Command output Field Description Job name Name of the scheduled job. Specified view View containing the commands in the job. Time timeID Execution time of each command in the job.
  • Page 186: Display Power

    <Sysname> display memory System Total Memory(bytes): 785239520 Total Used Memory(bytes): 129757852 Used Rate: 16% System Total Memory(bytes): 337495520 Total Used Memory(bytes): 108441564 Used Rate: 32% Table 30 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...
  • Page 187: Display Reboot-Type

    Table 31 Command output Field Description Slot 1 Power supply information of the IRF member device 1. Power Power supply number. Power supply state: • Normal. State • Absent. • Fault. Power supply type: • Type • display reboot-type Use display reboot-type to display the mode of the last reboot. Syntax display reboot-type [ slot slot-number ] [ | { begin | exclude | include } regular-expression ] Views...
  • Page 188: Display Rps

    display rps Use display rps to display RPS status. Syntax display rps [ slot slot-number [ rps-id ] ] [ | { begin | exclude | include } regular-expression ] Views Any view Default command level 1: Monitor level Parameters slot slot-number: Displays the RPS status of an IRF member device.
  • Page 189: Display Schedule Job

    Table 33 Command output on switches except for S5800-32C and S5800-56C Field Description RPS status: • Normal—The DC cable is correctly connected, and the RPS is supplying power. State • Absent—The RPS is not supplying power. • Fault—The DC cable is correctly connected, but the RPS has a problem. display schedule job Use display schedule job to display the job configured by using the schedule job command.
  • Page 190: Display Schedule Reboot

    Related commands schedule job display schedule reboot Use display schedule reboot to display the reboot schedule. Syntax display schedule reboot [ | { begin | exclude | include } regular-expression ] Views Any view Default command level 3: Manage level Parameters |: Filters command output by specifying a regular expression.
  • Page 191: Display Transceiver

    # Display the key parameters of the transceiver module in interface GigabitEthernet 2/0/3. <Sysname> display transceiver interface gigabitethernet 2/0/3 GigabitEthernet2/0/3 transceiver information: Transceiver Type : 1000_BASE_SX_SFP Connector Type : LC Wavelength(nm) : 850 Transfer Distance(m) : 550(50um),270(62.5um) Digital Diagnostic Monitoring : YES Vendor Name : H3C Ordering Name : SFP-GE-SX-MM850...
  • Page 192: Display Transceiver Alarm

    Table 35 Command output Field Description transceiver information Transceiver module information. Transceiver Type Transceiver module type. Connector type options: • SC—Fiber connector developed by NTT. • Connector Type LC—1.25 mm/RJ-45 fiber connector developed by Lucent. • RJ-45. • CX 4. •...
  • Page 193 Parameters interface [ interface-type interface-number ]: Displays the alarms that are present on the transceiver module in an interface. The interface-type interface-number argument specifies an interface by its type and number. If no interface is specified, this command displays alarm information for the transceiver modules in all interfaces.
  • Page 194: Display Transceiver Diagnosis

    RX loss of signal RX power low Table 37 Command output Field Description transceiver current alarm information Alarms present on the transceiver module. RX loss of signal Incoming (RX) signal is lost. RX power low Incoming (RX) power level is low. display transceiver diagnosis Use display transceiver diagnosis to display the measured values of the digital diagnosis parameters for transceiver modules.
  • Page 195: Display Transceiver Manuinfo

    Table 38 Command output Field Description Digital diagnosis information of the transceiver in the transceiver diagnostic information interface. Current diagnostic parameters Current diagnostic parameters. Digital diagnosis parameter-temperature, in °C, with the Temp.(°C) precision to 1°C. Digital diagnosis parameter-voltage, in V, with the Voltage(V) precision to 0.01 V.
  • Page 196: Display Version

    # Display system version information. <Sysname> display version H3C Comware Platform Software Comware Software, Version 5.20, Release 1808P12 Copyright (c) 2004-2014 Hangzhou H3C Tech. Co., Ltd. All rights reserved. H3C S5800-32C-PWR uptime is 0 week, 0 day, 9 hours, 39 minutes...
  • Page 197: Display Version-Update-Record

    Copyright (c) 2004-2014 Hangzhou H3C Copyright statement of the switch Tech. Co., Ltd. All rights reserved. H3C S5800-32C-PWR uptime is 0 week, 0 Time duration for which the switch has been running since the day, 8 hours, 25 minutes last reboot...
  • Page 198: Fan Prefer-Direction (Available Only On S5800-54S And S5820X-26S Switches)

    regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters. Usage guidelines The system records the system software version at each reboot. If the software is updated while the switch is running, the system records the update time and new software version. The number of update records that can be stored depends on your device model.
  • Page 199: Header

    Related commands display fan header Use header to create a banner. Use undo header to clear a banner. Syntax header { incoming | legal | login | motd | shell } text undo header { incoming | legal | login | motd | shell } Views System view Default command level...
  • Page 200: Job

    # Verify the configuration by using Telnet. (The login authentication is not configured.) ****************************************************************************** * Copyright (c) 2004-2014 Hangzhou H3C Tech. Co., Ltd. All rights reserved. * Without the owner's prior written consent, * no decompiling or reverse-engineering shall be allowed.
  • Page 201: Password-Recovery Enable

    Syntax job job-name undo job job-name Default No job is created. Views System view Default command level 3: Manage level Parameters job-name: Specifies the name for a job, a string of 1 to 32 characters. Usage guidelines You can add commands in job view to execute at certain times. You can use the job command to create multiple jobs.
  • Page 202: Reboot

    To enhance system security, disable password recovery capability. Examples # Disable password recovery capability. <Sysname> system-view [Sysname] undo password-recovery enable reboot Use reboot to reboot an IRF member device. Syntax reboot [ slot slot-number ] Views User view Default command level 3: Manage level Parameters slot slot-number: Specifies an IRF member device.
  • Page 203: Reset Version-Update-Record

    Default command level 1: Monitor level Usage guidelines A confirmation is required when you execute this command. The command will not run if you enter N to cancel the operation or fail to make a confirmation within 30 seconds. Examples # Clear unused 16-bit interface indexes.
  • Page 204 Parameters at time1 [ date ]: Specifies the time and/or date to execute a command. time1: Sets time to execute the command, in the hh:mm format. The hh value ranges from 0 to 23, • and the mm value ranges from 0 to 59. •...
  • Page 205: Schedule Reboot At

    Examples # Schedule a job to execute the batch file 1.bat in system view in 60 minutes (assuming that the current time is 1 1: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).
  • Page 206: Schedule Reboot Delay

    The device supports only one device reboot schedule. If you configure the schedule reboot at command multiple times, the last configuration takes effect. The schedule reboot at command and the schedule reboot delay command overwrite each other, and whichever is configured last takes effect. The alert "REBOOT IN ONE MINUTE"...
  • Page 207: Shutdown-Interval

    CAUTION: Device reboot can interrupt network services. • Changing any clock setting can cancel the reboot schedule. • The reboot delay cannot exceed 30 x 24 x 60 minutes, or 30 days. The device supports only one device reboot schedule. If you configure the schedule reboot delay command multiple times, the last configuration takes effect.
  • Page 208: Sysname

    Use sysname to set the device name. Use undo sysname to restore the default. Syntax sysname sysname undo sysname Default The device name is H3C. Views System view Default command level 2: System level Parameters sysname: Name of the device, which is a string of 1 to 30 characters.
  • Page 209: System-Failure

    [R2000] system-failure Use system-failure to configure the exception handling method for the master switch. Use undo system-failure to restore the default. Syntax system-failure { maintain | reboot } undo system-failure Default The master switch adopt the reboot method to handle exceptions. Views System view Default command level...
  • Page 210: Time At

    hotspot: Specifies a hotspot sensor, which is used for temperature monitoring and is typically placed near the chip that generates a great amount. inflow: Specifies an intake sensor, which is placed near the air inlet for temperature monitoring. sensor-number: Specifies the sensor number. It is an integer starting from 1, each number representing a temperature sensor of a device.
  • Page 211 one-off: Specifies that the specified command is executed for once. repeating: Specifies a recurring time schedule. date: Specifies an execution 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. The specified execution date must be ahead of the current date.
  • Page 212: Time Delay

    Command Description time timeid repeating at time week-day Schedules a command to run at a specific time in a specific day week-daylist command command or days every week. Examples # Schedule a job to save the configuration file a.cfg at 3:00 on May 18, 2009. <Sysname>...
  • Page 213 Syntax time time-id { one-off | repeating } delay time command command undo time time-id Views Job view Default command level 3: Manage level Parameters time timeid: Time setting entry, an integer that ranges from 1 to 10. one-off: Specifies that the specified command is executed for once. repeating: Specifies a recurring time schedule.
  • Page 214: Usb Disable

    [Sysname] job saveconfig [Sysname-job-saveconfig] view monitor [Sysname-job-saveconfig] time 1 repeating delay 5 command save a.cfg Related commands • view • usb disable Use usb disable to disable the USB ports on the switch. Use undo usb disable to enable the USB ports on the switch. Syntax usb disable undo usb disable...
  • Page 215 Parameters view-name: Specifies a view in which commands in the job run. A view name is a string of 1 to 90 characters. Usage guidelines Every job can have only one view. If you specify multiple views, the one specified the last takes effect. Enter a view name in its complete form and make sure the view name is available on the device.
  • Page 216: Index

    Index A B C D E F G H I J L M O P Q R S T U V W acl (user interface view),13 databits,20 activation-key,14 debugging,66 archive configuration,109 delete,67 archive configuration interval,1 10 delete,94 archive configuration location,1 1 1 dir,95 archive configuration max,1 12...
  • Page 217 display nandflash file-location,97 ftp server dscp,60 display nandflash page-data,99 ftp server enable,61 display patch,134 timeout,61 display patch information,135 update,62 display power,172 display reboot-type,173 get,74 display rps,174 display saved-configuration,1 18 display schedule job,175 header,185 display schedule reboot,176 history-command max-size,30 display startup,120 hotkey,6 display system-failure,176...
  • Page 218 open ipv6,78 speed (user interface view),45 startup saved-configuration,128 stopbits,45 parity,39 super,9 passive,79 super authentication-mode,10 password-recovery enable,187 super password,1 1 patch active,136 sysname,194 patch deactive,137 system-failure,195 patch delete,138 system-view,12 patch install,138 patch load,139 patch location,140 telnet,46 patch run,141 telnet client dscp,47 protocol inbound,40 telnet client ipv6...

This manual is also suitable for:

S5800 series

Table of Contents