Table of Contents

Chapter 1 Basic Configurations. 1-1

1.1 Basic Configurations. 1-1

1.1.1 Entering/Exiting System View. 1-1

1.1.2 Configuring the Device Name. 1-2

1.1.3 Configuring the System Clock. 1-2

1.1.4 Configuring a Banner 1-2

1.1.5 Configuring CLI Hotkeys. 1-4

1.1.6 Configuring User Levels and Command Levels. 1-5

1.1.7 Displaying and Maintaining Basic Configurations. 1-7

1.2 CLI Features. 1-8

1.2.1 Online Help with Command Lines. 1-8

1.2.2 Display Features. 1-10

1.2.3 History Command. 1-11

1.2.4 Command Line Error Information. 1-11

1.2.5 Edit Features. 1-12

 

Chapter 1  Basic Configurations

While performing basic configurations of the system, go to these sections for information you are interested in:

l           Basic Configurations

l           CLI Features

1.1  Basic Configurations

This section covers the following topics:

l           Entering/Exiting System View

l           Configuring the Device Name

l           Configuring the System Clock

l           Configuring a Banner

l           Configuring CLI Hotkeys

l           Configuring User Levels and Command Levels

l           Displaying and Maintaining Basic Configurations

1.1.1  Entering/Exiting System View

To do…	Use the command…	Remarks
Enter system view from user view	system-view	—
Return to user view from system view	quit	—

 

 

1.1.2  Configuring the Device Name

To do…	Use the command…	Remarks
Enter system view	system-view	—
Configure the device name	sysname sysname	Optional The default device name is H3C.

 

1.1.3  Configuring the System Clock

To do…	Use the command…	Remarks
Set the standard time	clock datetime time date	Optional
Set the time zone	clock timezone zone-name { add | minus } time	Optional
Set a daylight summer time scheme	clock summer-time zone-name { one-off | repeating } start-time start-date end-time end-date offset-time	Optional

 

1.1.4  Configuring a Banner

I. Introduction to banners

Banners are prompt information displayed by the system when users are connected to the device, perform login authentication, and start interactive configuration. The administrator can set corresponding banners as needed.

At present, the system supports the following four kinds of welcome information.

l           shell banner, also called session banner, displayed when a non TTY Modem user enters user view.

l           incoming banner, also called user interface banner, displayed when a user interface is activated by a TTY Modem user.

l           login banner, welcome information at login authentications, displayed when password and scheme authentications are configured.

l           legal banner, also called authorization information. The system displays some copyright or authorization information, and then displays the legal banner before a user logs in, waiting for the user to confirm whether to continue the authentication or login. If entering Y or pressing the Enter key, the user enters the authentication or login process; if entering N, the user quits the authentication or login process. Y and N are case insensitive.

II. Configuring a banner

When you configure a banner, the system supports two input modes. One is to input all the banner information right after the command keywords. The start and end characters of the input text must be the same but are not part of the banner information. In this case, the input text, together with the command keywords, cannot exceed 510 characters. The other is to input all the banner information in multiple lines by pressing the Enter key. In this case, up to 2000 characters can be input.

The latter input mode can be achieved in the following three ways:

l           Press the Enter key directly after the command keywords, and end the setting with the % character. The Enter and % characters are not part of the banner information.

l           Input a character after the command keywords at the first line, and then press the Enter key. End the setting with the character input at the first line. The character at the first line and the end character are not part of the banner information.

l           Input multiple characters after the command keywords at the first line (with the first and last characters being different), then press the Enter key. End the setting with the first character at the first line. The first character at the first line and the end character are not part of the banner information.

Follow these steps to configure a banner:

To do…	Use the command…	Remarks
Enter system view	system-view	—
Configure the banner to be displayed at login (TTY Modem login)	header incoming text	Optional
Configure the authorization information before login	header legal text	Optional
Configure the banner to be displayed at login authentication	header login text	Optional
Configure the banner to be displayed when a user enters user view (Non-TTY Modem login)	header shell text	Optional

 

1.1.5  Configuring CLI Hotkeys

To do…	Use the command…	Remarks
Enter system view	system-view	—
Configure CLI hotkeys	hotkey { CTRL_G | CTRL_L | CTRL_O | CTRL_T | CTRL_U } command	Optional The <Ctrl+G>, <Ctrl+L> and <Ctrl+O> hotkeys are specified with command lines by default.
Display hotkeys	display hotkey	Available in any view. Refer to Table 1-1 for hotkeys reserved by the system.

 

 

Table 1-1 Hotkeys reserved by the system

Hotkey	Function
<Ctrl+A>	Moves the cursor to the beginning of the current line.
<Ctrl+B>	Moves the cursor one character to the left.
<Ctrl+C>	Stops performing a command.
<Ctrl+D>	Deletes the character at the current cursor position.
<Ctrl+E>	Moves the cursor to the end of the current line.
<Ctrl+F>	Moves the cursor one character to the right.
<Ctrl+H>	Deletes the character to the left of the cursor.
<Ctrl+K>	Terminates an outgoing connection.
<Ctrl+N>	Displays the next command in the history command buffer.
<Ctrl+P>	Displays the previous command in the history command buffer.
<Ctrl+R>	Redisplays the current line information.
<Ctrl+V>	Pastes the content in the clipboard.
<Ctrl+W>	Deletes all the characters in a continuous string to the left of the cursor.
<Ctrl+X>	Deletes all the characters to the left of the cursor.
<Ctrl+Y>	Deletes all the characters to the right of the cursor.
<Ctrl+Z>	Exits to user view.
<Ctrl+]>	Terminates an incoming connection or a redirect connection.
<Esc+B>	Moves the cursor to the leading character of the continuous string to the left.
<Esc+D>	Deletes all the characters of the continuous string at the current cursor position and to the right of the cursor.
<Esc+F>	Moves the cursor to the front of the next continuous string to the right.
<Esc+N>	Moves the cursor down by one line (available before you press the Enter key)
<Esc+P>	Moves the cursor up by one line (available before you press the Enter key)
<Esc+<>	Specifies the cursor as the beginning of the clipboard.
<Esc+>>	Specifies the cursor as the ending of the clipboard.

 

 

1.1.6  Configuring User Levels and Command Levels

All the commands are defaulted to different views and categorized into four levels: visit, monitor, system, and manage, identified respectively by 0 through 3. If you want to acquire a higher privilege, you must switch to a higher user level, and it requires password to do so for AUX and VTY user interfaces for the security’s sake.

The following table describes the default level of the commands.

Table 1-2 Default command levels

Level	Privilege	Command
0	Visit	ping, tracert, telnet
1	Monitor	refresh, reset, send
2	System	All configuration commands except for those at manage level
3	Manage	FTP, TFTP, XMODEM, and file system operation commands

 

Follow these steps to configure user level and command level:

To do…	Use the command…	Remarks
Switch the user level	super [ level ]	Optional
Enter system view	system-view	—
Configure the password for switching the user level	super password [ level user-level ] { simple | cipher } password	Optional By default, no password is needed for switching the user level.
Configure the command level in system view	command-privilege level level view view command	Optional

 

 

 

1.1.7  Displaying and Maintaining Basic Configurations

To do…	Use the command…	Remarks
Display information on system version	display version	Available in any view
Display information on the system clock	display clock
Display information on terminal users	display users [ all ]
Display the configuration files saved in the device storage medium.	display saved-configuration [ by-linenum ]
Display the current configurations	display current-configuration [ interface [ interface-type [ interface-number ] ] | configuration [ configuration ] | [ by-linenum ] | [ | { begin | exclude | include } regular-expression ] ] *
Display debugging information	display debugging [ interface interface-type interface-number ] [ module-name ]
Display the valid configuration under current view	display this [ by-linenum ]
Display clipboard information	display clipboard
Display and save statistics of each module’s running status	display diagnostic-information
Display the usage of the current system memory	display memory

 

During daily maintenance or when the system is operating abnormally, you need to view each module’s running status to find the problem. Therefore, you are required to execute the corresponding display commands one by one. To collect more information one time, you can execute the display diagnostic-information command in any view to display statistics of each module’s running status. Use the display diagnostic-information command to collect at one time the information displayed by each of the following commands:

l           display clock

l           display version

l           display device

l           display current-configuration

l           display saved-configuration

l           display interface

l           display controller

l           display fib

l           display ip interface

l           display ip statistics

l           display memory

l           display logbuffer

l           display history all

 

 

1.2  CLI Features

This section covers the following topics:

l           Online Help with Command Lines

l           Display Features

l           History Command

l           Command Line Error Information

l           Edit Features

1.2.1  Online Help with Command Lines

The following are the types of online help available with the CLI:

l           Full help

l           Fuzzy help

To obtain the desired help information, you can:

1)         Enter <?> in any view to access all the commands in this view and brief description about them as well.

<Sysname> ?

User view commands:

  backup             Backup next startup-configuration file to TFTP server

  boot-loader        Set boot loader

  bootrom            Update/read/backup/restore bootrom

  cd                 Change current directory

  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

  dir                List files on a file system

  display            Display current system information

..<omitted>

2)         Enter a command and a <?> separated by a space. If <?> is at the position of a keyword, all the keywords are given with a brief description.

<Sysname> terminal ?

  debugging  Send debug information to terminal

  logging    Send log information to terminal

  monitor    Send information output to current terminal

  trapping   Send trap information to terminal

3)         Enter a command and a <?> separated by a space. If <?> is at the position of a parameter, the description about this parameter is given.

<Sysname> system-view

[Sysname] interface vlan-interface ?

  <1-4094>  VLAN interface number

<1-4094> indicates that you need to input a VLAN interface number at this position. The VLAN interface is in the range 1 to 4094.

[Sysname] interface vlan-interface 1 ?

  <cr>

[Sysname] interface vlan-interface 1

<cr> indicates that there is no parameter at this position. The command is then repeated in the next command line and executed if you press <Enter>.

[Sysname] sysname ?

  TEXT  Host name (1 to 30 characters)

TEXT indicates that you need to input a string whose type is TEXT at this position. The string is in the range 1 to 30 characters.

[sysname-mpls-ldp] md5-password cipher 1.1.1.1 ?

  STRING<1-16>   Enter the Secret password

  STRING<24-24>  Enter the secret encrypted password

STRING<1-16> indicates that you need to input a string whose type is STRING at this position. The string is in the range 1 to 16 characters.

 

 

4)         Enter a character string followed by a <?>. All the commands starting with this string are displayed.

<Sysname> pi?

   ping

5)         Enter a command followed by a character string and a <?>. All the keywords starting with this string are listed.

<Sysname> display ver?

   version

6)         Press <Tab> after entering the first several letters of a keyword to display the complete keyword, provided these letters can uniquely identify the keyword in this command.

1.2.2  Display Features

CLI offers the following feature:

When the information displayed exceeds one screen, you can pause using one of the methods shown in Table 1-3.

Table 1-3 Display functions

Action	Function
Enter <Ctrl+C> when information display pauses	Stops the display and the command execution.
Press <Space> when information display pauses	Continues to display information of the next screen page.
Press <Enter> when information display pauses	Continues to display information of the next line.
<Ctrl+E>	Moves the cursor to the end of the current line.

 

1.2.3  History Command

The CLI can automatically save the commands that have been used. You can invoke and repeatedly execute them as needed. By default, the CLI can save up to ten commands for each user. You can use the history-command max-size command to set the capacity of the history commands log buffer for the current user interface (For the detailed description of the history-command max-size command, refer to User Interface Commands in the System Volume). The following table lists the operations that you can perform.

Follow these steps to access history commands:

To do…	Use the key/command…	Result
View the history commands	display history-command	Displays the commands that you have entered
Access the previous history command	Up-arrow key or <Ctrl+P>	Displays the earlier history command, if there is any.
Access the next history command	Down-arrow key or <Ctrl+N>	Displays the next history command, if there is any.

 

 

1.2.4  Command Line Error Information

The commands are executed only if they have no syntax error. Otherwise, error information is reported. Table 1-4 lists some common errors.

Table 1-4 Common command line errors

Error information	Cause
Unrecognized command	The command was not found.
	The keyword was not found.
	Parameter type error
	The parameter value is beyond the allowed range.
Incomplete command	Incomplete command
Ambiguous command	Ambiguous command
Too many parameters	Too many parameters
Wrong parameter	Wrong parameter

 

1.2.5  Edit Features

The CLI provides the basic command edit functions and supports multi-line editing. The maximum length of each command is 256 characters. Table 1-5 lists these functions.

Table 1-5 Edit functions

Key	Function
Common keys	If the editing buffer is not full, insert the character at the position of the cursor and move the cursor to the right.
<Backspace> key