Vous êtes sur la page 1sur 68

User Manual - Command Reference (Volume 1) Versatile Routing Platform

Table of Contents

Table of Contents
Chapter 1 EXEC Interface Commands................................................................................. 1-1 1.1 configure.................................................................................................................. 1-1 1.2 controller e1.............................................................................................................. 1-1 1.3 crypto....................................................................................................................... 1-2 1.4 disable ..................................................................................................................... 1-3 1.5 enable...................................................................................................................... 1-3 1.6 end .......................................................................................................................... 1-4 1.7 exit .......................................................................................................................... 1-4 1.8 help.......................................................................................................................... 1-5 1.9 interface................................................................................................................... 1-6 1.10 language ................................................................................................................ 1-7 1.11 logic-channel .......................................................................................................... 1-8 1.12 route-map............................................................................................................... 1-8 1.13 router ..................................................................................................................... 1-9 1.14 vpdn-group........................................................................................................... 1-10 1.15 show history ......................................................................................................... 1-11 Chapter 2 System Management Commands........................................................................ 2-1 2.1 File Management Commands .................................................................................... 2-1 2.1.1 configfile......................................................................................................... 2-1 2.1.2 copy ............................................................................................................... 2-2 2.1.3 download config .............................................................................................. 2-3 2.1.4 erase.............................................................................................................. 2-4 2.1.5 first-config....................................................................................................... 2-5 2.1.6 get ................................................................................................................. 2-6 2.1.7 write............................................................................................................... 2-8 2.1.8 show configfile................................................................................................ 2-8 2.1.9 show running-config ........................................................................................ 2-9 2.1.10 show startup-config ..................................................................................... 2-10 2.2 FTP Server Configuration Commands ...................................................................... 2-10 2.2.1 ftp-server config-name................................................................................... 2-10 2.2.2 ftp-server enable ........................................................................................... 2-11 2.2.3 ftp-server system-name ................................................................................. 2-11 2.2.4 ftp-server timeout .......................................................................................... 2-12 2.2.5 show ftp-server ............................................................................................ 2-13 2.3 Basic System Management Commands ................................................................... 2-13 2.3.1 clock set....................................................................................................... 2-13 2.3.2 hostname ..................................................................................................... 2-14 2.3.3 reboot........................................................................................................... 2-15 2.3.4 setup............................................................................................................ 2-15 2.3.5 show clock.................................................................................................... 2-17 2.3.6 show hostname............................................................................................. 2-17 2.3.7 show queueing.............................................................................................. 2-17 2.3.8 show version................................................................................................. 2-19 Chapter 3 Terminal Service Configuration Commands........................................................ 3-1 3.1 Terminal Service Attribute Configuration Commands................................................... 3-1 3.1.1 exec-timeout ................................................................................................... 3-1 3.2 Telnet Service Configuration Commands .................................................................... 3-1 3.2.1 terminal telnet refuse-negotiation...................................................................... 3-1 3.2.2 telnet .............................................................................................................. 3-2 3.2.3 show client...................................................................................................... 3-3 3.3 Terminal Server Configuration Commands ................................................................. 3-3
i

User Manual - Command Reference (Volume 1) Versatile Routing Platform

Table of Contents

3.3.1 async mode tty ............................................................................................... 3-4 3.3.2 autocommand................................................................................................. 3-4 3.3.3 tty logo-print.................................................................................................... 3-5 3.3.4 tty menu-key ................................................................................................... 3-6 3.3.5 tty-server app.................................................................................................. 3-6 3.3.6 tty-server enable ............................................................................................. 3-7 3.3.7 tty-server source-ip.......................................................................................... 3-8 3.3.8 tty test-key...................................................................................................... 3-9 3.3.9 show tty.......................................................................................................... 3-9 3.3.10 show tty-server............................................................................................ 3-10 3.4 PRI Terminal Configuration Commands.................................................................... 3-10 3.4.1 pri-interactive ................................................................................................ 3-11 3.4.2 pri-autocommand.......................................................................................... 3-11 3.5 X.25 PAD configuration commands .......................................................................... 3-12 3.5.1 login pad....................................................................................................... 3-12 3.5.2 pad............................................................................................................... 3-13 3.5.3 x29 inviteclear-time ....................................................................................... 3-14 3.5.4 show x25 pad................................................................................................ 3-14 3.5.5 debug pad .................................................................................................... 3-15 3.6 Rlogin configuration command................................................................................. 3-16 3.6.1 rlogin............................................................................................................ 3-16 Chapter 4 SNMP Configuration Commands......................................................................... 4-1 4.1 SNMP Configuration Commands ............................................................................... 4-1 4.1.1 snmp-server community .................................................................................. 4-1 4.1.2 snmp-server contact........................................................................................ 4-2 4.1.3 snmp-server enable traps ................................................................................ 4-2 4.1.4 snmp-server host ............................................................................................ 4-3 4.1.5 snmp-server location....................................................................................... 4-3 4.1.6 snmp-server trap-authentication snmpv1 .......................................................... 4-4 4.1.7 show snmp..................................................................................................... 4-5 4.2 RMON configuration command .................................................................................. 4-6 4.2.1 rmon promiscuous.......................................................................................... 4-6 4.2.2 clear rmon statistics ........................................................................................ 4-6 4.2.3 show rmon statistics........................................................................................ 4-7 Chapter 5 Maintenance and Debugging Tool Commands.................................................... 5-1 5.1 System Debugging Commands.................................................................................. 5-1 5.1.1 debug............................................................................................................. 5-1 5.1.2 show debugging.............................................................................................. 5-2 5.2 Network Test Tool Commands ................................................................................... 5-3 5.2.1 ping................................................................................................................ 5-3 5.2.2 ping ipx........................................................................................................... 5-4 5.2.3 tracert............................................................................................................. 5-5 5.3 Log Commands ........................................................................................................ 5-7 5.3.1 logging on....................................................................................................... 5-7 5.3.2 logging console............................................................................................... 5-8 5.3.3 logging buffered.............................................................................................. 5-9 5.3.4 logging monitor ............................................................................................... 5-9 5.3.5 logging host.................................................................................................. 5-10 5.3.6 show logging................................................................................................. 5-11

ii

User Manual - Command Reference (Volume 1) Versatile Routing Platform

Chapter 1
EXEC Interface Commands

Chapter 1 EXEC Interface Commands


EXEC interface commands include: l l l l l l l l l l l l l l configure controller e1 crypto disable enable exit help interface language logic-channel route-map router show history vpdn-group

1.1 configure
Use the configure command to enter the global configuration mode from the privileged user mode. configure

Command Mode
Privileged user mode

Example
! Enter the global configuration mode. Quidway#configure ! Enter configuration commands, one per line. End with command exit. Quidway(config)#

Related Command
exit

1.2 controller e1
Use the controller e1 command to enter the cE1/PRI interface configuration mode from the global configuration mode. controller e1 number

1-1

User Manual - Command Reference (Volume 1) Versatile Routing Platform

Chapter 1
EXEC Interface Commands

Syntax Description
number Interface number of cE1/PRI, increasing from 0 in order.

Command Mode
Global configuration mode

Example
! Enter the cE1/PRI interface configuration mode. Quidway(config)# controller e1 0 Quidway(config-if-E0)#

Related Command
exit

1.3 crypto
Use the crypto command to create and enter the corresponding security configuration. Use the no form of this command to delete the corresponding security configuration. crypto { ike policy policy-number | ipsec transform transform-name | map mapname } no crypto { ike policy policy-number | ipsec transform transform-name | map mapname }

Syntax Description
ike policy policy-number Enter IKE policy configuration mode. ipsec transform transform-name Enter IPSec transform configuration mode. map map-name Enter crypto map configuration mode.

Command Mode
Global configuration mode

Usage Guideline
The crypto configuration command is used to create and enter the corresponding encryption configuration. For its specific use and parameters, consult the reference for the IKE and IPSec configuration commands.

Example
Example 1: ! Enter the IKE policy configuration mode whose IKE policy number is 10. Quidway(config)# crypto ike policy 10
Quidway(config-crypto-ike-policy-10)#

1-2

User Manual - Command Reference (Volume 1) Versatile Routing Platform

Chapter 1
EXEC Interface Commands

Example 2: ! Enter the crypto map configuration mode whose name is map1 and sequence number is 100, and that negotiates via isakmp. Quidway(config)# crypto map map1 100 isakmp
Quidway(config-crypto-map-map1-100)#

Example 3: ! Enter the IPSec transform-set configuration whose name is trans1. Quidway(config)# crypto ipsec transform trans1
Quidway(config-crypto-transform-trans1)#

Related Command
exit

1.4 disable
Use the disable command to return from the privileged user mode to user mode. disable

Command Mode
Privileged user mode

Usage Guideline
When a privileged user is to be away from the terminal for a long time, he should execute the disable command to restore user mode, or execute the exit command to exit so as to prevent unauthorized access. For the same reason, if you have not made any input from the keyboard in 10 minutes, the system will automatically disconnect with you.

Example
! Return from the privileged user mode to user mode. Quidway#disable Quidway>

Related Command
enable , exit

1.5 enable
Use the enable command to enter the privileged user mode from the user mode. enable

1-3

User Manual - Command Reference (Volume 1) Versatile Routing Platform

Chapter 1
EXEC Interface Commands

Command Mode
User mode

Usage Guideline
To prevent unauthorized access, it is necessary to authenticate the user before he enters the privileged user mode from the user mode, that is, he needs to enter the privileged user password. In order to prevent the password input by you from being displayed on the screen for sake of security, if you input the correct password in three attempts, you will enter the privileged user mode; otherwise the original command mode will remain unchanged.

Example
! Enter the privileged user mode from the user mode. Quidway>enable
Password:

Quidway#

Related Command
disable, exit

1.6 end
To return from the current mode (excluding user mode and privileged user mode) to privileged user mode, use the end command. end

Command Mode
Any command mode except user mode and privileged user mode

Usage Guideline
The end command is used to return from the current mode (excluding user mode and privileged user mode) to privileged user mode. It has the same function as the combination key <Ctrl+Z> .

Example
! Return from Ethernet interface configuration mode to the privileged user mode. Quidway(config-if-Ethernet0)# end
Quidway#

1.7 exit
Use the exit command to return to a lower-level mode from the current mode. If you are in user mode and privileged user mode, then you would exit the configuration.

1-4

User Manual - Command Reference (Volume 1) Versatile Routing Platform

Chapter 1
EXEC Interface Commands

exit

Command Mode
User mode, privileged user mode, global configuration mode, routing protocol configuration mode, interface configuration mode, logic channel configuration mode, virtual interface configuration mode, VPDN group configuration mode, etc.

Usage Guideline
There are four levels of command mode, which respectively are, from low to high: User mode, Privileged user mode, global configuration mode, routing protocol configuration mode, interface configuration mode, logic channel configuration mode, virtual interface configuration mode, and VPDN configuration mode. By executing the exit command, you can return to a lower-level user mode from a higher-level command mode. Switching is allowed between configuration modes of the same level. In addition, you can directly return to the privileged user mode from two higher-level command modes.

Example
! Return from the Ethernet Interface configuration mode to the global configuration mode. Quidway(config-if-ethernet0)# exit Quidway(config)#

Related Command
configure , router, interface , controller, logical-channel, vpdn-group, router-map

1.8 help
Use the help command to show the help information. help

Command Mode
User mode, privileged user mode, global configuration mode, routing protocol configuration mode, interface configuration mode, logic channel configuration mode, virtual interface configuration mode, VPDN group configuration mode, etc.

Usage Guideline
VRP1.4 provides online help at any point. And the help command shows the information about the whole help system, including full help and partial help. You can enter a question mark ? to obtain online help.

Example
Quidway(config)# help
Help may be requested at any point in a command by entering

1-5

User Manual - Command Reference (Volume 1) Versatile Routing Platform

Chapter 1
EXEC Interface Commands

a question mark '?'. If nothing matches, the help list will be empty. Two styles of help are provided: 1. Full help is available when you are ready to enter a command argument ( e.g. 'show ?' ) and describes each possible argument. 2. Partial help is provided when an abbreviated argument is entered and you want to know what arguments match the input ( e.g. 'show sn?' ).

1.9 interface
Use the interface command to enter the interface configuration mode or create the sub-interfaceof the real physical interface. Use the no form of this command to delete some customized logic interfaces or sub-interfaces of the real physical interface. interface { interface-type interface-number | interface-name } no interface { interface-type interface-number | interface-name }

Syntax Description
1) l l l l l l l l Interface type Async Ethernet Serial Bri Dialer Tunnel Vpntunnel Virtual-template

VRP1.4 now supports the following types:

Async, Ethernet, Serial and Bri are all physical interfaces, and Dialer, Tunnel, Virtual-template , and Vpntunnel are logic interfaces. Serial interfaces include async serial interfaces, sync serial interfaces, and cE1/PRI channel interfaces (channel-group and pri-group). Some of the physical interfaces support sub-interfaces. 2) l Interface-number The above five types are numbered respectively, each beginning from 0: On different models of routers, physical routers have their own numbers. As for the channel-group cE1/PRI interface, its number is e1-interface-number : channelgroup-number; l As for the pri-group cE1/PRI interface, its number is e1-interface-number : 15; l As for other logic interfaces like Dialer or Virtual-template, they are numbered based on the order where they have been created; l As for a sub-interface, its number is physical-interface-number. Sub-interfacenumber. 3) Interface-name After learning the interface numbering rules, you can know interface naming. The format for an interface name: interface type plus interface number. For example, Ethernet0 stands for the Ethernet interface numbered as 0; Serial0.1 stands for subinterface number 1 of Serial0; Serial3: 2 stands for channel-group 2 in cE1/PRI interface 3. To make input easy for you, interface types can be abbreviated (only a few beginning letters are used abbreviations as long as they do not conflict with other interface types),

1-6

User Manual - Command Reference (Volume 1) Versatile Routing Platform

Chapter 1
EXEC Interface Commands

for example, Ethernet0 can be abbreviated as e0, and Serial0.1 can be abbreviated as s0.1.

Command Mode
Global configuration mode, routing protocol configuration mode, interface configuration mode, logic channel configuration mode, virtual interface configuration mode and VPDN group configuration mode etc.

Usage Guideline
The interface command can be executed to enter the real physical interface configuration mode, or create logic interfaces according to user requirements. In all the configurations at the same level as the interface configuration mode, the interface command can be used to switch to the corresponding interface configuration mode. Notice that no interface { interface-type interface-number | interface-name } is used to delete some customized logic interfaces (like Dialer, Tunnel, Vpntunnel and Virtualtemplate) and the sub-interfaces of the physical interface.

Example
Example 1: ! Enter the Ethernet interface configuration mode from the global configuration mode. Quidway(config)# interface ethernet 0
Quidway(config-if-Ethernet0)#

Example 2: ! Enter the Serial0.1 configuration from the Ethernet0 configuration. Quidway(config-if-Ethernet0)# interface serial0.1
Quidway(config-if-Serial0.1)#

Related Command
exit

1.10 language
Switch the language mode of command line interface language

Default
English

Command Mode
Privileged user mode

1-7

User Manual - Command Reference (Volume 1) Versatile Routing Platform

Chapter 1
EXEC Interface Commands

Usage Guideline
For the convenience of demestic users, VRP EXEC mode interface supports not only English mode but also Chinese mode.

Exmaple
! Switch English mode to Chinese mode. Quidway(config)# language
Current Language : English Will You switch language mode ?(Y/N)y You have changed the language mode .

1.11 logic-channel
Use the logic-channel command to enter the related logic channel configuration mode. logic-channel logic-channel-number

Syntax Description
logic-channel-number Logic channel number, ranging 1 to 255.

Command Mode
Global configuration mode, routing protocol configuration mode, interface configuration mode, logic channel configuration mode, virtual interface configuration mode, VPDN group configuration mode, etc.

Usage Guideline
Logic channels are mainly used in the backup center. The logic channels in the VRP1.4 backup center include X.25 and frame relay virtual circuits, or even a Dialer Map at the dialup interface. Logic channels can serve as main interfaces or backup interfaces for the backup center.

Example
! Enter the configuration on logic channel 0. Quidway(config)# logic-channel 0 Quidway(config-logic-channel0)#

Related Command
exit, dialer map, x25 map, frame-relay map

1.12 route-map
To create a route-map or enter the router-map configuration, use the route-map command. Use the no form of this command to delete corresponding route-map. route-map route-map-name { permit | deny } seq-number
1-8

User Manual - Command Reference (Volume 1) Versatile Routing Platform

Chapter 1
EXEC Interface Commands

no route-map route-map-name { permit | deny } seq-number

Syntax Description
route-map-name Route map name. seq-number Sequence number.

Command Mode
Global configuration mode

Example
Quidway(config)# route-map test permit10

1.13 router
Use the router command to enter the corresponding dynamic routing protocol configuration mdoe. Use the no form of this command to disable the corresponding dynamic routing protocol and exit the corresponding protocol configuration mode. router { rip | igrp | eigrp as-number | ospf [ enable ] | bgp as-number } no { rip | igrp | eigrp as-number | ospf | bgp as-number }

Syntax Description
rip Enable RIP and enter RIP protocol configuration mode. igrp Enable IGRP and enter IGRP protocol configuration mode. eigrp as-number Enable EIGRP and enter EIGRP protocol configuration mode. ospf [ enable ] Enable OSPF and enter OSPF protocol configuration mode. bgp as-number Enable BGP and enter BGP protocol configuration mode. as-number Autonomous system number, ranging from 1 to 65535.

Default
No dynamic routing protocol enabled.

Command Mode
Global configuration mode, routing protocol configuration mode, interface configuration mode, logic channel configuration mode, virtual interface configuration mode and VPDN group configuration mode etc.

Usage Guideline
Executing the router ospf command can only help you enter OSPF configuration mode. While executing the router ospf enable command can activate OSPF and enter OSPF configuration mode at the same time.

1-9

User Manual - Command Reference (Volume 1) Versatile Routing Platform

Chapter 1
EXEC Interface Commands

Example
! Enter OSPF configuration mode in global configuration mode. Quidway(config)# router ospf Quidway(config-router-ospf)#

Related Command
exit

1.14 vpdn-group
To create a VPDN group or enter the VPDN group configuration, use the vpdn-group command. Use the no form of this command to delete the corresponding VPDN group. vpdn-group group-number no vpdn-group [ group-number ]

Syntax Description
group-number VPDN group number, ranging 1 to 3000.

Default
No VPDN group created.

Command Mode
Global configuration mode, routing protocol configuration mode, interface configuration mode, logic channel configuration mode, virtual interface configuration mode, VPDN group configuration mode, etc.

Usage Guideline
The VPDN group is used for the VPN and L2TP configurations. In this mode, the Tunnel working parameter can be configured.

Example
! Create VPDN group 1 and enter its configuration. Quidway(config)# vpdn-group 1 Quidway(config-vpdn-group1)#

Related Command
exit

1-10

User Manual - Command Reference (Volume 1) Versatile Routing Platform

Chapter 1
EXEC Interface Commands

1.15 show history


To show the history command input by the current user, use the show history command. show history

Command Mode
Privileged user mode

Usage Guideline
VRP1.4 saves 10 history commands at maximum. You can access them through the Up and Down keys on the keyboard.

Example
! Show the history command input by the current user. Quidway# show history
enable configure interface serial 0 ip address 129.102.0.1 255.255.0.0 exit exit

1-11

User Manual - Command Reference (Volume 1) Versatile Routing Platform

Chapter 2
System Management Commands

Chapter 2 System Management Commands


2.1 File Management Commands
File management commands include: l l l l l l l l l l configfile copy download config erase first-config get write show configfile show running-config show startup-config

2.1.1 configfile
To select the storage media for the current configuration file, use the configfile command. configfile { flash | nvram }

Syntax Description
flash Storage media for the current configuration file is Flash. nvram Storage media for the current configuration file is NVRAM.

Default
NVRAM as the default storage media when Flash and NVRAM co-exist.

Command Mode
Global configuration mode

Usage Guideline
The Quidway series of routers has Flash and NVRAM for saving configuration files, so the configfile command is used to select one of them as the currently valid media. The Related Command for read/write configuration files are intended for operations on the storage media currently selected. For example, after the configfile NVRAM command is executed, the write command is executed; now the configuration file will be saved to NVRAM instead of Flash. Before saving or erasing the configuration file, you can use the show configfile command to show the storage media for the current configuration file.

2-1

User Manual - Command Reference (Volume 1) Versatile Routing Platform

Chapter 2
System Management Commands

Example
! Select NVRAM as the storage media for configuration file. Quidway(config)# configfile NVRAM

Related Command
erase , download config, show running-config, show startup-config, show configfile.

2.1.2 copy
To download the configuration file from the local router to the TFTP server, use the copy command. copy tftp_server_ip_address file_name

Syntax Description
tftp_server_ip_address The IP address of the TFTP server, in the format of A.B.C.D. file_name Filename, in the format of 8.3.

Command Mode
Privileged user mode

Usage Guideline
This command is used to download the configuration file by the filename of file_name in the local routers Flash or NVRAM to the TFTP server whose address is tftp_server_ip_address. Error numbers returned by this command indicate the results of the command execution, which are explained as follows: 0x00: successful. 0x01: memory insufficient. 0x02: setup request packet failed. 0x03: setup socket failed. 0x04: bundle socket failed. 0x05: transmission invalid. 0x06: partial file transferred. 0x10: error packet received. 0x07: the operation of sending file to the server failed 0x0b: socket setup failed 0x0c: the operation of reading file failed 0x0d: host name resolution failed

2-2

User Manual - Command Reference (Volume 1) Versatile Routing Platform

Chapter 2
System Management Commands

0x0e: the operation of opening local file failed 0x0f: parameter invalid 0x10: error packet received 0x11: synchronization failed. 0x12: the operation of writing configuration file failed. 0x13: the operation of reading configuration file failed. 0x14: config file written by two or more users simultaneously 0x15: memory allocation failed. 0x16: file oversize 0x18: the operation of writing file failed

Example
! Download the configuration file from the local router to the TFTP server. Quidway# copy 10.110.1.1 sys.cfg
start uploading config file... Errno=0x0 end uploading.

In the above information, Errno stands for the result of command execution. For example, 0x0 means success, otherwise, failure.

Related Command
get

2.1.3 download config


To download configuration file via the Console of the router, use the download config command. download config

Command Mode
Privileged user mode

Usage Guideline
This command should be used under the guidance of a technical support engineer, and the configuration file of the router should be edited off-line by technical people or senior maintenance personnel. While editing the configuration file, please note: The configuration file for the router is composed of commands. Pressing the Enter key or adding a new line sign indicates the end of a command. Do not press the Enter key or add a new line sign in the middle of a command line.

2-3

User Manual - Command Reference (Volume 1) Versatile Routing Platform

Chapter 2
System Management Commands

l l

An explanatory line can be inserted between two command lines and begins with !. A whole configuration file uses End as its terminator.

You load the configuration file via the Send Binary File function of the terminal simulator. Before sending a configuration file to the router, please make sure: Execute the download config command, and the router is waiting for loading. Now in the terminal simulators window, you can see that the router regularly sends the C character to the terminal simulator. l Xmodem/CRC is set as the binary transmission protocol for the terminal simulator. l The correct configuration file transfer has been selected. After loaded successfully, the configuration file can not take effect immediately; it takes effect only after the router is rebooted. If you have downloaded the wrong configuration file, the system will initialize via the default parameters after the rebooting. You can erase the wrong configuration file with the erase command or just reload the file. In the Quidway series of routers, the configuration file loaded will be stored in the media specified by the configfile command, NVRAM by default.

Example
!Download configuration file via the Console of the router. Quidway# download config
Do you want really download the config.ini?(Y/N)y Change protocol to Xmodem then send the selected file. Downloading... Download completed. Writing to flash memory... Write completed, please reboot the router.

Related Command
write, erase , show running-config, show startup-config

2.1.4 erase
Use the erase command to erase the routers configuration file in Flash or NVRAM. erase

Command Mode
Privileged user mode

Usage Guideline
Be careful when executing this command. Youd better execute it under the guidance of a technical support engineer. This command is normally used in the following situations: When the router software has been upgraded, the configuration file in Flash may not match the new-version software. Now you can erase the old configuration file with the erase command.

2-4

User Manual - Command Reference (Volume 1) Versatile Routing Platform

Chapter 2
System Management Commands

A used router is applied in a new environment, and the existing configuration file does not meet the new environment requirement. Now it is necessary to re-configure the router. You can make the reconfiguration after erasing the original configuration file. In the Quidway series of routers, the configuration file stored in the media specified by the configfile command will be erased. When the router is powered on and initializing, if the system detects no configuration file in Flash, then it will initialize the router via the default parameters.

Example
! Erase the routers configuration file in Flash or NVRAM. Quidway# erase
This will erase the configuration in the flash memory. The router configurations will be erased to reconfigure! Are you sure?[Y/N]y

Related Command
first-config, write, download config, show running-config, show startup-config

2.1.5 first-config
Set the flag bit to enter the initial setup. first-config { set | clear }

Syntax Description
set: set the flag bit. clear: delete the flag bit.

Command Mode
Privileged user mode

Usage Guideline
first-config set is used to set the flag bit of the initial setup. After the flag bit is set, the router will delete the config files in Flash or NVRAM before the system enters setup mode in case of power off and reset. The operation is similar to erase command. first-config clear is used to cancel the setting of the flag bit. Do not use this command before write command, which also cancels the setting of the flag bit. Use this command cautiously, preferably under the guidance of technical support personnel.

Example
! set the flag bit to enter setup. Quidway# first-config set

2-5

User Manual - Command Reference (Volume 1) Versatile Routing Platform

Chapter 2
System Management Commands

! Reset the router to enter setup mode. Quidway# reboot


WARNING: System will REBOOT! Continue ?[Y/N]y System is now rebooting, please wait

****************************************** * * * Quidway Series Router Bootrom, V4.25 * * * ****************************************** Copyright(C) 1999-2001 by HUAWEI TECH CO., LTD. Compiled at 09:06:32 , Jun 13 2001. Now testing memory...OK! 32M bytes DRAM 8192k bytes flash memory Press ENTER key to get start when you see ATS0=1. System now is starting... ATS0=1 Quidway>setup --- System Configuration Dialog --Default settings are in square brackets '[]', if you do not change the default settings, you may input enter. And Ctrl-C can cancel at any time without saving. Continue with configuration dialog? [yes]:

Related Command
erase write show running-configshow startup-config

2.1.6 get
Use the get command to download the configuration file in the TFTP server to Flash or NVRAM in the local router. get tftp_server_ip_address file_name

Syntax Description
tftp_server_ip_address The IP address of the TFTP server, in the format of A.B.C.D. file_name Filename, in the format of 8.3.

Command Mode
Privileged user mode

Usage Guideline
This command is used to download the configuration by the name of file_name in the TFTP whose address is tftp_server_ip_address to the local routers Flash or NVRAM.

2-6

User Manual - Command Reference (Volume 1) Versatile Routing Platform

Chapter 2
System Management Commands

Error numbers returned by this command indicate the results of the command execution, which are explained as follows: 0x00: successful. 0x01: memory insufficient. 0x02: setup request packet failed. 0x03: setup socket failed. 0x04: bundle socket failed. 0x05: transmission invalid. 0x06: partial file transferred. 0x10: error packet received. 0x07: the operation of sending file to the server failed 0x0b: socket setup failed 0x0c: the operation of reading file failed 0x0d: host name resolution failed 0x0e: the operation of opening local file failed 0x0f: parameter invalid 0x10: error packet received 0x11: synchronization failed. 0x12: the operation of writing configuration file failed. 0x13: the operation of reading configuration file failed. 0x14: config file written by two or more users simultaneously 0x15: memory allocation failed. 0x16: file oversize 0x18: the operation of writing file failed

Example
! Download the configuration file in the TFTP server to the local router. Quidway # get 10.110.1.1 sys.cfg
start downloading config file... errno=0x0 end downloading.

In the above information, Errno stands for the result of command execution. For example, 0x0 stands for success, otherwise, failure.

Related Command
copy

2-7

User Manual - Command Reference (Volume 1) Versatile Routing Platform

Chapter 2
System Management Commands

2.1.7 write
Use the write command to save (write) the current configuration file to Flash or NVRAM. write

Command Mode
Privileged user mode

Usage Guideline
When a set of configurations have been completed and have implemented the intended functions, the current configuration files should be saved to Flash or NVRAM (in he Quidway series of routers, they will be saved to the storage media specified by the configfile command).

Example
! Write the current configuration file to Flash or NVRAM. Quidway# write

Related Command
erase , download config, show running-config, show startup-config

2.1.8 show configfile


Use the show configfile command to show the storage media type for the current configuration file. show configfile

Command Mode
Privileged user mode

Usage Guideline
This command is used to show the storage media type for the current configuration file operation.

Example
! Show the storage media type for the current configuration file. Quidway(config)# show configfile
flash

Related Command
erase , download config, show running-config, show startup-config, configfile.

2-8

User Manual - Command Reference (Volume 1) Versatile Routing Platform

Chapter 2
System Management Commands

2.1.9 show running-config


To show the currently valid configuration parameters of the router, use the show running-config command. show running-config

Command Mode
Privileged user mode

Usage Guideline
When you have completed a set of configurations, it is necessary to check if they are correct. You can execute the show running-config command to check the currently valid parameter. If some parameters you already configured are not yet valid, they will not be shown. For example, if X.25 is encapsulated at a certain interface link layer, then you can now configure the PPP parameter at this interface. But when executing the show running-config command, you will not see any PPP configuration information at this interface. Some currently valid configuration parameters that are the same as the default running parameters will not be shown.

Example
! Show the currently valid configuration parameters of the router. Quidway# show running-config
! loghost 129.9.191.240 firewall enable snmp-server contact Mr.Wang-Tel:3306 snmp-server traps enable snmp-server host 129.102.149.23 snmp-server location telephone-closet,3rd-flood host liuzhenhua 129.102.157.55 host server 129.102.157.55 ! interface Ethernet0 ip address 129.102.100.141 255.255.0.0 ! interface Serial0 baudrate 9600 encapsulation ppp ppp chap host quidway ppp pap sent-username quidway password ! interface Serial1 encapsulation ppp ppp chap host quidway ppp pap sent-username quidway password ! interface Serial2 flowcontrol normal encapsulation ppp ppp chap host quidway ppp pap sent-username quidway password ! end

quidway

quidway

quidway

2-9

User Manual - Command Reference (Volume 1) Versatile Routing Platform

Chapter 2
System Management Commands

Related Command
write, erase , download config, show startup-config

2.1.10 show startup-config


Use the show startup-config command to show the routers startup configuration file in Flash, that is, the configuration file used when the router is powered on and rebooted next time. show startup-config

Command Mode
Privileged user mode

Usage Guideline
If the router fails to work normally after powered on, you can execute the show startup-config command to check the routers startup configuration file (in the Quidway series of routers, the startup configuration file is stored in the media specified by the configfile command).

Example
! Show the routers startup configuration file in Flash. Quidway# show startup-config

Related Command
write, erase , download config, show running-config

2.2 FTP Server Configuration Commands


FTP server configuration commands include: l l l l l ftp-server config-name ftp-server enable ftp-server system-name ftp-server timeout show ftp

2.2.1 ftp-server config-name


To set the configuration filename, use the ftp-server config-name command. ftp-server config-name config-name

Syntax Description
config-name Configuration filename.

2-10

User Manual - Command Reference (Volume 1) Versatile Routing Platform

Chapter 2
System Management Commands

Default
config

Command Mode
Global configuration mode

Usage Guideline
The configuration filename is set for uploading the configuration file. Only when the name of the configuration file to be uploaded is the same as that set in the router can it be correctly uploaded.

Example
! Specify the name of the configuration file as quidway. Quidway(config)# ftp-server config-name quidway

2.2.2 ftp-server enable


To enable the FTP server, use the ftp-server enable command. Use the no form of this command to disable the FTP server. ftp-server enable no ftp-server enable

Default
Ftp server disabled.

Command Mode
Global configuration mode

Usage Guideline
This command can be used to enable or disable the FTP server easily so as to safeguard the router against attack by any unknown user.

Example
! Disable the FTP server. Quidway(config)# no ftp-server enable

2.2.3 ftp-server system-name


To set the name of the system program file, use the ftp-server system-name command. ftp-server system-name system-name

2-11

User Manual - Command Reference (Volume 1) Versatile Routing Platform

Chapter 2
System Management Commands

Syntax Description
system-name System program filename.

Default
system

Command Mode
Global configuration mode

Usage Guideline
The system program filename is set to upload the system program file. Only when the name of the system program file to be uploaded is the same as that set in the router, can it be uploaded correctly.

Example
! Set the system program filename to program. Quidway(config)# ftp-server config-name program

2.2.4 ftp-server timeout


To set the connection timeout, use the ftp-server timeout command. ftp-server timeout second

Syntax Description
second Timeout value, in seconds.

Default
600 seconds.

Command Mode
Global configuration mode

Usage Guideline
When you logs into the FTP server, you set up a connection with it. If the connection is disconnected abnormally or you disconnect abnormally, the FTP will not be able to know this, so it still maintains the connection. Therefore the connection timeout is used to avoid such a situation. When the connection has not carried out any command exchange in a certain period of time, the FTP server will deem the connection as failed, and then disconnect the connection.

Example
! Set the connection timeout to 500 seconds. Quidway(config)# ftp-server timeout 500
2-12

User Manual - Command Reference (Volume 1) Versatile Routing Platform

Chapter 2
System Management Commands

2.2.5 show ftp-server


Use the show ftp-server command to show the parameters of the current FTP server. show ftp-server

Command Mode
Privileged user mode

Usage Guideline
When the FTP server parameters have been set, this command can be used to show the results.

Example
! Show the results of FTP server parameter settings. Quidway(config)# show ftp-server
ConfigName SystemName TimeOut config system 600

2.3 Basic System Management Commands


Basic system management commands include: l l l l l l l l clock set hostname reboot setup show clock show hostname show queue show version

2.3.1 clock set


Use the clock set command to set the current date and clock of the router. clock set hour:minute:second day month year

Syntax Description
hour:minute:second Current clock. hour, ranging 1 to 24; minute and second, ranging 1 to 60. year/month/day Current date. year, ranging 1997 to 2097, month, ranging 1 to 12, day, ranging 1 to 31.

Default
If the router is not yet equipped with a hardware real-time clock, the default clock is 0:0:0 1/1/1997 when the system is booted. If equipped with a real-time clock, the system will read the clock value when booted, and use it for setting the system time.

2-13

User Manual - Command Reference (Volume 1) Versatile Routing Platform

Chapter 2
System Management Commands

Command Mode
Privileged user mode

Usage Guideline
When powered off, the Quidway series of routers can not continue to keep clock, so it is necessary to set the current date and clock for the router in a rigorous application environment requiring the absolute clock and date.

Example
! Set the current date and clock of the router to 0:0:0 Jan. 1st, 2000. Quidway# clock set 0:0:0 1 1 2000

Related Command
show clock

2.3.2 hostname
Use the hostname command to set the hostname of the router. hostname hostname

Syntax Description
hostname Hostname of the router, represented in a character string.

Default
Quidway

Command Mode
Global configuration mode

Usage Guideline
Modifying the hostname of the router will affect the prompts at the command line interface. If the routers hostname is Quidway, then its prompt in privileged user mode is Quidway#.

Example
! Set the hostname of the router to QuidwayR2501. Quidway# hostname QuidwayR2501 QuidwayR2501#

Related Command
show hostname

2-14

User Manual - Command Reference (Volume 1) Versatile Routing Platform

Chapter 2
System Management Commands

2.3.3 reboot
Use the reboot command to reboot the router. reboot

Command Mode
Privileged user mode

Usage Guideline
The function of this command is similar to first powering off the router and then restarting it. But when the router is maintained remotely, it is not necessary to reboot the router where the router is located; instead, you can directly reboot it remotely. Generally, do not use this command, for it will lead to network failure in a short time. In addition, it is necessary to ensure if the routers configuration file needs to be saved.

Example
! Reboot the router. Quidway# reboot
warnings: System will REBOOT! Continue?[Y/N]y System is now rebooting, please wait.

2.3.4 setup
Use the setup command to guide you interactively to configure the basic parameters necessary for the running of the router. setup

Default
When a certain parameter is to be configured, if this parameter is found already configured, then its current value is shown as a default value. And you can directly press Enter without modifying it.

Command Mode
Privileged user mode

Usage Guideline
When you power on and boots the router for the first time, the system will automatically execute the setup command to guide you in configuring the parameters necessary for the running of the router. These parameters include: l l l l l Routers hostname Privileged user password SNMP parameter Selecting such network protocols as IP and IPX IP addresses and IPX network numbers at the interfaces

In addition, the privileged user can execute the setup command at any point.

2-15

User Manual - Command Reference (Volume 1) Versatile Routing Platform

Chapter 2
System Management Commands

Example
Quidway# setup
--- System Configuration Dialog --Default settings are in square brackets '[]', if you do not change the default settings, you may input enter. And Ctrl-C can cancel at any time without saving. Continue with configuration dialog? [yes]:y Firstly, would you like to see the current interface summary? [yes]:y Interface IP-Address Ethernet0 129.102.100.141 Serial0 Serial1 Serial2 Configuring global parameters: Enter host name [Quidway]: Enter enable password []: Configure SNMP Network Management? Community string []:public Configure IP? [yes]: Configure IPX? [NO]:y OK? yes yes yes yes Status down up up up Protocol up down down down

[YES]:

Configuring interface Ethernet0: Is this interface in use? [YES]: Configure IP on this interface? [YES]: IP address for this interface [129.102.100.141]: Netmask [255.255.0.0]: Class B network is 129.102.0.0. IP address is 129.102.100.141, netmask is 255.255.0.0. Configure IPX on this interface? [NO]:y IPX network number for this interface [1]: Configuring interface Serial0: Is this interface in use? [YES]: Configure IP on this interface? [NO]: Configure IPX on this interface? [NO]: Configuring interface Serial1: Is this interface in use? [YES]: Configure IP on this interface? [NO]: Configure IPX on this interface? [NO]: Configuring interface Serial2: Is this interface in use? [YES]: Configure IP on this interface? [NO]: Configure IPX on this interface? [NO]: The following configuration was created: hostname Quidway enable password snmp-server community ro ipx routing interface Ethernet0 no shutdown ip address 129.102.100.141 255.255.0.0 ipx network 1 interface Serial0 no shutdown no ip address no ipx network interface Serial1 no shutdown no ip address no ipx network

2-16

User Manual - Command Reference (Volume 1) Versatile Routing Platform

Chapter 2
System Management Commands

interface Serial2 no shutdown no ip address no ipx network end Use this configuration? [yes/no]: Now writing the configuration to flash memory. Write the running config to flash memory successfully. Please reboot the router.

2.3.5 show clock


To show the current date and clock of the system, use the show clock command. show clock

Command Mode
Privileged user mode

Usage Guideline
You can execute this command to find out if the system time is correct. If the system time is incorrect, you can adjust it.

Example
Quidway# show clock
8:18:28 Jan 6 1999

Related Command
clock set

2.3.6 show hostname


To show the routers hostname, use the show hostname command. show hostname

Command Mode
User mode and Privileged user mode

Example
Quidway# show hostname
Quidway

Related Command
hostname

2.3.7 show queueing


To show the queue in the system, use the show queue command.
2-17

User Manual - Command Reference (Volume 1) Versatile Routing Platform

Chapter 2
System Management Commands

show queueing

Command Mode
Privileged user mode

Usage Guideline
This command shows the current length, limit length, dropped packets, queue head and tail, etc. of receive and send queues, IP receive queue, ARP receive queue, and IPX receive queue, at the interfaces. This command can be generally used by the technical support engineer in fault diagnosis.

Example
Quidway# show queueing
Interface Dialer1: Send queue: Current length : 0, Queue limit length 75 , Drops Queue head --> 0x0, Queue tail --> 0x0 Receive queue: Current length : 0, Queue limit length 75 , Drops Queue head --> 0x0, Queue tail --> 0x0 Interface Ethernet0: Send queue: Current length : 0, Queue limit length 75 , Drops Queue head --> 0x0, Queue tail --> 0x0 Receive queue: Current length : 2, Queue limit length 75 , Drops Queue head --> 0x7de480, Queue tail --> 0x7de400 Interface LoopBack0: Send queue: Current length : 0, Queue limit length 75 , Drops Queue head --> 0x0, Queue tail --> 0x0 Receive queue: Current length : 0, Queue limit length 75 , Drops Queue head --> 0x0, Queue tail --> 0x0 Interface Serial0: Send queue: Current length : 0, Queue limit length 75 , Drops Queue head --> 0x0, Queue tail --> 0x0 Receive queue: Current length : 0, Queue limit length 75 , Drops Queue head --> 0x0, Queue tail --> 0x0 Interface Serial1: Send queue: Current length : 0, Queue limit length 75 , Drops Queue head --> 0x0, Queue tail --> 0x0 Receive queue: Current length : 0, Queue limit length 75 , Drops Queue head --> 0x0, Queue tail --> 0x0 Interface Serial2: Send queue: Current length : 0, Queue limit length 75 , Drops Queue head --> 0x0, Queue tail --> 0x0 Receive queue: Current length : 0, Queue limit length 75 , Drops Queue head --> 0x0, Queue tail --> 0x0 ip receive queue: Current length : 0, Queue limit length 75 , Drops Queue head --> 0x0, Queue tail --> 0x0 arp receive queue: Current length : 0, Queue limit length 50 , Drops Queue head --> 0x0, Queue tail --> 0x0 : 0

: 0

: 0

: 0

: 0

: 0

: 0

: 0

: 0

: 0

: 0

: 0

: 0

: 0

2-18

User Manual - Command Reference (Volume 1) Versatile Routing Platform

Chapter 2
System Management Commands

ipx receive queue: Current length : 0, Queue limit length 75 , Drops : 0 Queue head --> 0x0, Queue tail --> 0x0

Related Command
ifquelen ip, ifquelen arp

2.3.8 show version


To show the system version information, use the show version command. show version

Command Mode
Privileged user mode and User mode

Usage Guideline
Different versions have different functions. By querying the version information, you will know the features supported by the software.

Example
Quidway# show version
Quidway Router Software Version 3.0-Mar 17 1999-03:31:59 Copyright (c) 1997-2000 SHENZHEN HUAWEI TECH CO.,LTD.hardware version is 1.0

2-19

User Manual - Command Reference (Volume 1) Versatile Routing Platform

Chapter 3
Terminal Service Configuration Commands

Chapter 3 Terminal Service Configuration Commands


3.1 Terminal Service Attribute Configuration Commands
Terminal service attribute configuration commands include: l exec-timeout

3.1.1 exec-timeout
To start the function of the timed disconnection with the terminal client, use the exectimeout command. Use the no form of this command to shut down the function. exec-timeout no EXEC-timeout

Default
Timed disconnection enabled.

Command Mode
Privileged user mode

Usage Guideline
For a Console client, the disconnection timeout is 3 minutes. For a dummy client, the disconnection timeout is 10 minutes. You can shut down this function via the no exec-timeout command so the terminal client will never be disconnected.

Example
! Shut down the function of timed disconnection with the terminal user. Quidway# no exec-timeout

3.2 Telnet Service Configuration Commands


Telnet service configuration commands include: l l l terminal telnet refuse-negotiation telnet show client

3.2.1 terminal telnet refuse-negotiation


To disable the telnet client negotiation function, use the terminal telnet refusenegotiation command. Use the no form of this command to enable this function.

3-1

User Manual - Command Reference (Volume 1) Versatile Routing Platform

Chapter 3
Terminal Service Configuration Commands

terminal telnet refuse-negotiation no terminal telnet refuse-negotiation

Default
Telnet client negotiation disabled.

Command Mode
Global configuration mode

Usage Guideline
For the routers Reverse Telnet terminal service, it is sometimes necessary to set up a connection via the TCP client. And the client data are directly transparently transferred to the router via the transmission layer interface to communicate directly with the asynchronous port corresponding to the port specified by the TCP connection. You can disable the telnet negotiation function for Reverse Telnet terminal service via the terminal telnet refuse-negotiation command. This command is only effective for QuidwayR1600/2500/2500E/4000/4000E series of routers.

Example
! Disable the telnet negotiation function for the Reverse Telnet terminal. Quidway(config)# terminal telnet refuse-negotiation

3.2.2 telnet
To log onto other routers from the current router via the Telnet tool, use the telnet command. telnet host-ip-address [ service-port ]

Syntax Description
host-ip-address IP address of the remote router, in the dotted decimal format. service-port TCP port number via which the router provides the Telnet service. Ranging 0 to 65535.

Default
Default Telnet port number is 23.

Command Mode
User mode and Privileged user mode

Usage Guideline
By executing the telnet command, you can easily log from a router onto another for remote management.

3-2

User Manual - Command Reference (Volume 1) Versatile Routing Platform

Chapter 3
Terminal Service Configuration Commands

If the destination IP address is the IP address of the local router, and the specified port number is 2000+n (n is the sequence number of the asynchronous interface), then you can communicate with the external device (like an external Modem) via the corresponding asynchronous port.

Example
! Log from the current router Quidway1 to another router Quidway2 (IP address: 129.102.0.1) Quidway# telnet 129.102.0.1
Trying hostaddress... Service port is 23 Connected to hostaddress Quidway2>

Related Command
show client, show tcp brief

3.2.3 show client


To show all the clients of the router, use the show client command. show client

Command Mode
Privileged user mode

Usage Guideline
If the router suddenly starts to work abnormally or its working parameters are modified, now this command can be used to show if other privileged clients are modifying the system configuration. The information shown via this command includes the user ID allocated by the system and the IP address for this client.

Example
! Show all the clients of the router. Quidway# show client
Client ID 2555904 IP Address 129.102.1.92

Related Command
telnet, show tcp brief

3.3 Terminal Server Configuration Commands


Terminal server configuration commands include: l l async mode tty autocommand
3-3

User Manual - Command Reference (Volume 1) Versatile Routing Platform

Chapter 3
Terminal Service Configuration Commands

l l l l l l l l

tty logo-print tty menu-key tty-server app tty-server enable tty-server source-ip tty test-key show tty show tty-server

3.3.1 async mode tty


To configure the physical terminal and virtual terminal of the access server of dumb terminal, use the async mode tty command. Use the no form of this command to cancel the existing configurations. async mode tty tty-number vty-number app-number no async mode tty [ vty-number ]

Syntax Description
tty-number Physical terminal number. vty-number Virtual terminal number on the physical terminal. app-number Application program number.

Command Mode
Asynchronous serial interface configuration mode

Usage Guideline
The physical terminal number corresponds with the asynchronous serial port on the router. The access server of dumb terminal numbers all the physical terminals connected the computer in unification. On the access server of dumb terminal, a maximum of 4 virtual terminals can be configured for each physical terminal. The virtual terminal corresponds with the application program of the host computer to be connected.

Example
! Set the physical terminal number of the access server of dumb terminal corresponding with the asynchronous serial interface Async 1 to 1. Set the virtual terminal number to 0 and the application program number of the UNIX program used to 0. Quidway(config-if-Async1)# async mode tty 1 0 0

3.3.2 autocommand
Use the autocommand command to enable the automatic execution of the command when the interface operates in the interactive mode. Use the no form of this command to disable the automatic execution of the command. autocommand command

3-4

User Manual - Command Reference (Volume 1) Versatile Routing Platform

Chapter 3
Terminal Service Configuration Commands

no autocommand command

Syntax Description
command A valid command string.

Command Mode
Asynchronous serial interface configuration mode

Usage Guideline
After the user logs in to the router through dumb terminal mode, some of the specified commands will be executed automatically and the user will enter into the given operating mode.

Example
! Enable automatic execution of telnet command on the asynchronous serial interface Async 1. Quidway(config-if-Async1)# autocommand telnet 10.110.164.44

Related Command
async mode interactive

3.3.3 tty logo-print


To display the logo image of terminal server, use the tty logo-print command. Use the no form of this command to cancel display. tty logo-print no tty logo-print

Default
The system will not display the logo image of Huawei terminal server.

Command Mode
Asynchronous serial interface configuration mode

Usage Guideline
You can choose to display or not display the logo image of the Huawei terminal server by this command. This command can be configured, when and only when the asynchronous serial port configured has started the terminal server function.

Example
! Set up the asynchronous serial interface Async 0 to display the logo image of Huawei terminal server. Quidway(config-if-Async0)# tty logo-print

3-5

User Manual - Command Reference (Volume 1) Versatile Routing Platform

Chapter 3
Terminal Service Configuration Commands

3.3.4 tty menu-key


Use the tty menu-key command to set up the hot key to be used to start up the menu function of the dumb terminal server. Use the no form of this command to cancel the setup. tty menu-key ascii-code no tty menu-key

Syntax Description
ascii-code The ASCII value corresponded with the hot key. The hot key is used to activate the menu.

Default
No hot key will be set up.

Command Mode
Asynchronous serial interface configuration mode

Usage Guideline
After one asynchronous serial interface has started up the function of the access server of dumb terminal, you can define the hot key to activate the menu with this command, to start up the function of the menu of the dumb terminal server. Moreover, you can use the hot key to conduct dynamic switchover between multiple application programs. After the hot key to activate the function of menu of the dumb terminal is set up, the operation of the terminal is likely to be abnormal, since the ASCII value of the hot key set up is probably same as the uplink data of some of the terminals. In this case, you need to re-specify the ASCII value of the hot key or cancel the setup of the hot key.

Example
! Set up the key to activate the menu to XXX on the asynchronous serial interface Async 0. Quidway(config-if-async0)# tty menu-key XXX

3.3.5 tty-server app


To specify the application program on the UNIX host computer end, use the tty-server app command. Use the no form of this command to cancel the appointment. tty-server app app-number ip-address port [ app-name ] no tty-server app app-number

Syntax Description
app-number Number of the application program on the UNIX host computer end. One access server of dumb terminal can be configured with a maximum of 4 application programs. Moreover any of the number of the application program should duplicate.

3-6

User Manual - Command Reference (Volume 1) Versatile Routing Platform

Chapter 3
Terminal Service Configuration Commands

ip-address The IP address of the UNIX host computer where the application program is on. port TCP port number of the application program on the UNIX host computer, ranging 1024 to 65535. app-name Name of the application program, with no more than 18 English letters.

Command Mode
Global configuration mode

Usage Guideline
The uplink of the access server of dumb terminal corresponds with the application program of UNIX host computer. Multiple application programs can be one on UNIX host computer or distribute over multiple UNIX host computers. The access server of dumb terminal can number all the application programs in unification and multiplex to one TCP link the data flow of all the dumb terminals to one application program. All the settings of the virtue terminals corresponding with the application program will be canceled automatically, once the specification of the application program of the host computer is cancelled.

Example
! Specify the application program counter. Its number is 0, so the IP address on the UNIX host computer is 1.1.1.1 and the TCP port number is 2000. Quidway(config)# tty-server app 0 1.1.1.1 2000 counter

Related Command
async mode tty, show tty-server

3.3.6 tty-server enable


To enable the access server of dumb terminal, use the tty-server enable command. Use the no form of this command to shut down the access server of dumb terminal. tty-server enable no tty-server enable

Command Mode
Global configuration mode

Usage Guideline
Please enable it before you use and configure the access server of dumb terminal. When the access server of dumb terminal is enabled, and the application program of the host computer, physical terminal and the virtual terminal are correctly configured, the corresponding asynchronous port on the router will change to UP state, after the dumb terminal is powered on. And the access server of dumb terminal will establish TCP connection with the application program of the host computer automatically, and

3-7

User Manual - Command Reference (Volume 1) Versatile Routing Platform

Chapter 3
Terminal Service Configuration Commands

the dumb terminal will enter into the log-on interface of the application program. After the access server of dumb terminal is shut down, the configuration of the application of the host computer, physical terminal and virtual terminal will be retained, not be canceled automatically.

Example
! Enable the access server of dumb terminal. Quidway(config)# tty-server enable

Related Command
show tty-server

3.3.7 tty-server source-ip


To bind TCP source address, use the tty-server source-ip command. Use the no form of this command to cancel the binding of TCP source address. tty-server source-ip app-number ip-address no tty-server source-ip app-number

Syntax Description
app-number Number of the application program, used to identify the IP address of TCP connection to be bounds. ip-address IP address to be bound.

Command Mode
Global configuration mode

Usage Guideline
Sometimes when multiple dumb terminals multiplex one TCP connection to establish relationships with the application programs of the host computer by the access server of dumb terminal, the real IP address in the TCP connection of the uplink of the access server of dumb terminal needs to be hidden up and set up to other IP address as required, out of consideration of security and other things. Generally, the binding of source address chooses the interface not used of the router, such as dial interface. In addition, the binding of TCP source address should be set up before the TCP connection is established. Otherwise, its invalid.

Example
! Bind the TCP source address of the application program 0 to 27.222.48.73. Quidway(config)# tty-server source-ip 0 27.222.48.73

Related Command
show tty-server

3-8

User Manual - Command Reference (Volume 1) Versatile Routing Platform

Chapter 3
Terminal Service Configuration Commands

3.3.8 tty test-key


Use the tty test-key command to activate test function of terminal. Use the no form of this command to cancel the test function of the terminal. tty test-key ascii-code no tty test-key

Syntax Description
ascii-code The ASCII value corresponding with the hot key. The hot key is used to activate test of the terminal.

Command Mode
Asynchronous serial interface configuration mode

Usage Guideline
After the hot key of terminal test is configured on one asynchronous serial port, you can press hot key on the terminal and Terminal test OK! will be displayed on the dumb terminal, if the connection between the dumb terminal and the router is correct. After the test function of the terminal is activated, the operation of the terminal is likely to be abnormal, since the ASCII value of the hot key is probably same as the uplink data of some of the terminals. In this case, you need to re-specify the ASCII value of the hot key or cancel the test function of the terminal.

Example
! On the asynchronous serial interface Async 0, set up the key to activate terminal test to XXX. Quidway(config-if-async0)# tty test-key XXX

3.3.9 show tty


To show the relevant information of the physical terminal and virtual terminal, use the show tty command. show tty

Command Mode
Privileged user mode

Usage Guideline
By using this command, the state information of the physical terminal and the virtual terminal can be shown on the access server of the dumb terminal, thus you can monitor and maintain the access server of the dumb terminal.

Example
! Show information of physical terminal and virtual terminal.

3-9

User Manual - Command Reference (Volume 1) Versatile Routing Platform

Chapter 3
Terminal Service Configuration Commands

Quidway# show tty


INTERFACE Async0 TTY_ID 0 VTY_ID 0 APP_ID 0 TTY_STATE ok VTY_STATE set

The explanation of the information shown is as follows: The number of the physical terminal configured on the asynchronous serial port Async 0 is 0. The number of the virtual terminal configured on the physical terminal is 0. The number of the application program of the host computer corresponding with the virtual terminal is 0. The physical terminal is powered on and is connected with the access server of the dumb terminal. The virtual terminal is configured.

Related Command
async mode tty, tty-server app, tty-server enable, show tty-server

3.3.10 show tty-server


To show the relevant information of the application program on the UNIX host computer side, use the show tty-server command. show tty-server

Command Mode
Privileged user mode

Usage Guideline
With this command, the state and configuration information of the application program of the host computer, the physical terminal and the virtual terminal can be displayed on the access server of the dumb terminal, thus you can monitor and maintain the access server of the dumb terminal.

Example
! Show the information of the application program. Quidway# show tty-server
APP_ID 0 HOST_IP 1.1.1.1 PORT 2000 STATE linked APP_NAME counter

The explanation of the information shown is as follows: The application program numbered 0 of the UNIX host computer is on the UNIX host computer whose IP address is 1.1.1.1; the number of the TCP port selected and used is 2000; the access server of dumb terminal has established TCP connection with the program; the name of the application program is counter.

Related Command
tty-server app, tty-server enable, tty-server source-ip, show tty

3.4 PRI Terminal Configuration Commands


PRI Terminal configuration commands include:

3-10

User Manual - Command Reference (Volume 1) Versatile Routing Platform

Chapter 3
Terminal Service Configuration Commands

l l

pri-interactive pri-autocommand

3.4.1 pri-interactive
To enable the PRI terminal functions, use the pri-interactive command. Use the no form of this command to disable the PRI terminal function. pri-interactive no pri-interactive

Command Mode
PRI interface configuration mode

Default
PRI terminal function disabled.

Usage Guideline
Before using this command, please first use the pri-group command at the cE1/PRI interface to bind the time slots. This command is only effective for QuidwayR4000/4000E series of routers,

Example
! Enable the PRI terminal functions at the interface Serail2:15. Quidway(config-if-Serial2:15)# pri-interactive

Related Command
pri-group, pri-autocommand

3.4.2 pri-autocommand
To configure a command so that it can be automatically executed after the login of the PRI terminal client, use the pri-autocommand command. Use the no form of this command to cancel the configuration of automatic execution of commands. pri-autocommand { command } [ parameters ] ... no pri-autocommand { command } [ parameters ] ...

Syntax Description
command Any executable command of the router. parameters Command parameters, which can be many.

Default
No automatically executed commands configured.

3-11

User Manual - Command Reference (Volume 1) Versatile Routing Platform

Chapter 3
Terminal Service Configuration Commands

Command Mode
PRI interface configuration mode

Usage Guideline
This command will not take effect until the pri-interactive command is used to enable the PRI mute terminal functions. This command is only effective for QuidwayR4000/4000E series of routers.

Example
! Specify the telnet 192.168.0.1 command automatically executed at the Interface Serial2:15. Quidway(config-if-Serial2:15)# pri-autocommand telnet 192.168.0.1

Related Command
pri-interactive

3.5 X.25 PAD configuration commands


X.25 PAD configuration commands include: l l l l l login pad pad x29 invite clear-time show x25 pad debug pad

3.5.1 login pad


To start the AAA authentication of the X.25 PAD Server end, use the login pad command. To cancel the authentication, use the no form of this command. login pad no login pad

Default
By default, AAA authentication of the Server end is not set.

Command Mode
Global configuration mode

Usage Guideline
When X.25 PAD is used for remote configuration, if it is necessary to authenticate the user efficiency, the user command can be used to set the valid X.25 PAD remote login user at the Server end. Then this command is used to start the AAA authentication at the Server end.

3-12

User Manual - Command Reference (Volume 1) Versatile Routing Platform

Chapter 3
Terminal Service Configuration Commands

As to the detailed description of the meaning, parameter and usage of the user command, please refer to the Security Configuration part of this manual.

Example
! The following example sets an X.25 PAD remote user at the local end. Quidway(config)# user paduser service-type exec password 7 padpass ! The following example starts the AAA authentication of the local end to the X.25 PAD user. Quidway(config)# login pad

Related Command
user, pad

3.5.2 pad
To initiate the X.25 PAD calling to the Server end with specified X.121 address, use the pad command. pad x.121-address

Parameter Description
x.121-address The X.121 address of the Server end of X.25 PAD. Please refer to ITU-T Recommendation X.121 and related RFC files for the X.121 address format.

Command Mode
Common user mode, privileged mode

Usage Guideline
On the router interconnected through the X.25 network, this command can be used to initiate the X.25 PAD calling to log in the remote Server end. Then the remote router can be configured. It must be ensured that both ends support the X.25 PAD features. Otherwise the calling cannot succeed. After successful calling, the party initiating the calling (Client end) will enter the configuration interface of the called party (Server end).

Example
! The following example initiates the X.25 PAD calling to QuidwayB at the Server end with the X.121 address of 123456 from QuidwayA. After successful calling, log in QuidwayB. QuidwayA# pad 123456 Trying 123456...Open QuidwayB#

Related Command
login pad, show x25 pad, debug pad
3-13

User Manual - Command Reference (Volume 1) Versatile Routing Platform

Chapter 3
Terminal Service Configuration Commands

3.5.3 x29 inviteclear-time


To set the response time of the Server end of X.25 PAD to X.29 Invite Clear messages, use the x29 inviteclear-time command. x29 inviteclear-time time

Parameter Description
time Response time in second, and the value ranges from 5 to 2147483.

Command Mode
Global configuration mode

Usage Guideline
When the Server end of X.25 PAD for some reason (For example: the Client end sends the exit request or it is needed to release link resources etc.) sends link clearance message Invite Clear to the Client end, the Server end will wait for the response from the Client end. If the Client end fails to respond within the specified time, the Server end will clear the link positively.

Example
! The following example sets the response time of the local end to the X.29 Invite Clear message to 1000 seconds. Quidway(config)# x29 inviteclear-time 1000

3.5.4 show x25 pad


To display the related information of X.25 PAD, use the show x25 pad command. show x25 pad

Command Mode
Privileged mode

Usage Guideline
This command can be used to display such information as message transmission of X.25 PAD and X.3 parameter setting etc., so as to maintain X.25 PAD and perform fault diagnosis and troubleshooting.

Example
! The following example displays the related information of the local X.25 PAD. Quidway# show x25 pad
connection 1 to host 123456 PAD0: Total input: 12, control 3, bytes 35, QueuedIn: 1 of 56. Total output: 10, control 3, bytes 64, QueuedOut: 2 of 56. State: 3, Last error: 1 ParamsIn: 1:0, 2:0, 3:0, 4:0, 5:0, 6:0, 7:0, 8:0, 9:0, 10:0, 11:0, 12:0, 13:0, 14:0, 15:0,

3-14

User Manual - Command Reference (Volume 1) Versatile Routing Platform

Chapter 3
Terminal Service Configuration Commands

16:0, 17:0, 18:0, 19:0, 20:0, 21:0, 22:0, ParamsOut: 1:1, 2:0, 3:2, 4:1, 5:1, 6:0, 7:21, 8:0, 9:1, 10:0, 11:14, 12:1, 13:0, 14:0, 15:0, 16:127, 17:21, 18:18, 19:0, 20:0, 21:0, 22:0,

The above displayed information includes: message transmission information Total input/output, QueuedIn/Out, State, Last error and X.3 parameter setting information (Paramsln/out). The Paramsln information refers to the X.3 parameter information received by the local end, and the ParamsOut information refers to the X.3 information issued by the local end.

Related Command
pad

3.5.5 debug pad


To enable the debugging at all levels, use the debug pad command. To disable the level-corresponding debugging, use the no form of this command. debug pad [ packet | error | all ] no debug pad [ packet | error | all ]

Parameter Description
packet Enable the packet debugging. error Enable the error debugging. all Enable all the debugging.

Default
By default, the debugging is disabled.

Command Mode
Privileged user mode

Usage Guideline
This command can be used to enable the X.25 PAD debugging at all levels. The X.25 PAD related information will be displayed along with the configuration information of the end being configured (Server end). Based on this information, the user can monitor and maintain X.25 PAD as well as performing fault diagnosis and troubleshooting.

& Note: Please use this command under the guidance of the technical supporting personnel.

Related Command
pad
3-15

User Manual - Command Reference (Volume 1) Versatile Routing Platform

Chapter 3
Terminal Service Configuration Commands

3.6 Rlogin configuration command


Rlogin configuration includes the following command: l rlogin

3.6.1 rlogin
To set up Rlogin connection, use the rlogin command. To shut down Rlogin connection, use the exit command. rlogin host-ip-address [{-l | / user} username ] [ debug [ debug-level ] ] exit

Command Mode
Privileged user mode

Parameter Description
host-ip-address The IP address of the UNIX host to be logged in. -l Specify the remote login user name to come into compatibility with standard BSD UNIX Rlogin. If the keyword is not used, the system will adopt the routers local user as the login user name. / user Specify remote login user name. If the keyword parameter is not used, the system will adopt the routers local user as the login user name. username The remote login user name. This user must have registered on the UNIX host, otherwise the remote login will fail. debug Turn on the debugging information switch of the Rlogin protocol of the system. debug-level Specify the output level of the debugging information. The value range is 0~4. The larger the value, the higher will the level be. When debug-level=4, the system will display all the debugging information.

Usage Guideline
Rlogin (Client) function can make the digital or analogue user terminal that has logged in the router via the dummy terminal access function log in the UNIX host by using Rlogin protocol. This command can be used to establish the Rlogin connection to the UNIX host.

Example
! The following example establishes user root on the router. After authentication, the user can log on the UNIX host legally. Quidway# rlogin 1.1.254.78 -l root
Trying 1.1.254.78 ... Password: Last successful login for root: Thu Sep 06 15:14:15 2001 on ttyp0 Last unsuccessful login for root: Thu Sep 06 14:22:35 2001 on ttyp0 SCO OpenServer(TM) Release 5 (C) 1976-1998 The Santa Cruz Operation, Inc. 1980-1994 Microsoft Corporation rights reserved.

(C) All

3-16

User Manual - Command Reference (Volume 1) Versatile Routing Platform

Chapter 3
Terminal Service Configuration Commands

For complete copyright credits, enter "copyrights" at the command prompt. you have mail Terminal type is vt100 # If the exit command is inputted now, the Rlogin connection can be shut down. # exit connection closed

3-17

User Manual - Command Reference (Volume 1) Versatile Routing Platform

Chapter 4
SNMP Configuration Commands

Chapter 4 SNMP Configuration Commands


4.1 SNMP Configuration Commands
SNMP configuration commands include: l l l l l l l snmp-server community snmp-server contact snmp-server enable traps snmp-server host snmp-server location snmp-server trap-authentication snmpv1 show snmp

4.1.1 snmp-server community


To set the community name and access authority, use the snmp-server community command. snmp-server community {ro | rw } community-name Use the no form of this command to restore the default community name according to different access authority. no snmp-server community { ro | rw }

Syntax Description
community-name Communication name, represented in a string. ro and rw Access authority: read-only and read-write.

Default
The system deems the community name with read-only authority as public, and the community name with read-write authority as private.

Command Mode
Global configuration mode

Usage Guideline
SNMP V1 adopts the community name-based authentication scheme: the SNMP packets not matching the community name recognized by the device. Different communities can have either of read-only access authority and read-write access authority. Communities with read-only authority can query device information, and those with write and read authority can make configurations for the device.

4-1

User Manual - Command Reference (Volume 1) Versatile Routing Platform

Chapter 4
SNMP Configuration Commands

Example
! Set the public community as a community with read-only authority, and the private community as a community with read-write authority. Quidway(config)# snmp-server community ro public Quidway(config)# snmp-server community rw private

4.1.2 snmp-server contact


To set the IDs and contact methods of the network administrators, use the snmpserver contact command. Use the no form of this command to restore the default ID and contact method. snmp-server contact sysContact no snmp-server location

Syntax Description
syscontact The IDs and contact methods of network administrators, represented in a character string.

Default
SysAdmin

Command Mode
Global configuration mode

Usage Guideline
When there is trouble with the network, you can contact the network administrator according to this information.

Example
! Set the IDs and contact sysadmin:XXX(Tel:1234). methods of the network administrators as

Quidway(config)# snmp-server contact sysadmin:XXX(Tel:1234)

4.1.3 snmp-server enable traps


To enable SNMP Trap, use the snmp-server enable traps command. Use the no form of this command to disable SNMP Trap. snmp-server enable traps no snmp-server enable traps

Default
snmp-server enable traps is disabled.

4-2

User Manual - Command Reference (Volume 1) Versatile Routing Platform

Chapter 4
SNMP Configuration Commands

Command Mode
Global configuration mode

Usage Guideline
SNMP Trap is information not requested that the managed equipment initiate to send to the NMS for reporting some urgent, important events.

Example
! Disable snmp-server enable traps. Quidway(config)# no snmp-server enable traps

Related Command
snmp-server host

4.1.4 snmp-server host


To set the IP address of the destination host for SNMP Trap, use the snmp-server host command. snmp-server host host-ip-address

Syntax Description
host-ip-address IP address of the destination host for SNMP Trap, in the dotted decimal format.

Command Mode
Global configuration mode

Usage Guideline
After the system is enabled to send SNMP Trap, you should specify the IP address of the destination host.

Example
! Set the IP address of the destination host for SNMP Trap to 129.102.0.1. Quidway(config)# snmp-server host 129.102.0.1

Related Command
snmp-server enable traps

4.1.5 snmp-server location


To set the location of the router, use the snmp-server location command. Use the no form of this command to restore the default location.

4-3

User Manual - Command Reference (Volume 1) Versatile Routing Platform

Chapter 4
SNMP Configuration Commands

snmp-server location syslocation no snmp-server location

Syntax Description
syslocation Location of the router, represented as a character string.

default
Beijin

Command Mode
Global configuration mode

Usage Guideline
To locate the router quickly, network administrators can use this command to show the location of the router.

Example
! Set the location of the router. Quidway(config)# snmp-server location beijing-huawei-401

4.1.6 snmp-server trap-authentication snmpv1


To enable the router to send Authentication Trap, use the snmp-server trapauthentication snmpv1 command. Use the no form of this command to make the router stop sending Authentication Trap. snmp-server trap-authentication snmpv1 no snmp-server trap-authentication snmpv1

Default
Authentication Trap sending disabled.

Command Mode
Global configuration mode

Usage Guideline
Authentication Trap is one kind of SNMP Trap. If Authentication Trap sending is enabled, then when the managed equipment receives a request containing an incorrect community name, it can send Authentication Trap to the NMS.

Example
! Disable the Authentication Trap sending. Quidway(config)# no snmp-server trap-authentication snmpv1

4-4

User Manual - Command Reference (Volume 1) Versatile Routing Platform

Chapter 4
SNMP Configuration Commands

Related Command
snmp-server enable traps, snmp-server host

4.1.7 show snmp


Use the show snmp command to show the statistics about the SNMP Agent packets input and output. show snmp

Command Mode
User mode and Privileged user mode

Usage Guideline
The following table shows the meanings of the fields in SNMP Agent packets input and output. Table FC-4-1 Statistics about SNMP packets
Information shown Unknown community name Illegal operation for community name supplied Encoding errors Get-request PDUs Get-next PDUs Set-request PDUs Too big errors No such name errors Bad values errors General errors Get-response PDUs SNMP trap PDUs Meaning Unidentifiable community name Illegal operation Encoding errors Get-request PDUs Get-next PDUs Set-request PDUs Errors too big to generate any response PDU Specified name errors not existing Errors with bad values General errors Get-response PDUs SNMP trap PDUs

Example
! Show the statistics about the SNMP Agent packets input and output. Quidway# show snmp
70 SNMP packets input. 0 Unknown community name. 0 Illegal operation for community name supplied. 0 Encoding errors. 10 Get-request PDUs. 60 Get-next PDUs. 0 Set-request PDUs. 73 SNMP packets output. 0 Too big errors. 4 No such name errors. 0 Bad values errors. 0 General errors. 70 Get-response PDUs. 3 SNMP trap PDUs.

4-5

User Manual - Command Reference (Volume 1) Versatile Routing Platform

Chapter 4
SNMP Configuration Commands

4.2 RMON configuration command


RMON configuration commands include: l l l rmon promiscuous clear rmon statistics show rmon statistics

4.2.1 rmon promiscuous


To enable the RMON statistics function of the Ethernet interface, use the no form of this command to disable the RMON statistics function. rmon promiscuous no rmon promiscuous

Default
Disable the RMON statistics function.

Command Mode
Ethernet interface configuration mode

Usage Guideline
The router can collect the original data needed by RMON only when RMON statistics function at the Ethernet interface is enabled. Otherwise the statistics data can not be viewed via RMON.MIB. If the Ethernet interface is configured with Bridge protocol, the router can provide RMON with the statistic of the frame whose destination is another router.

Example
! Enable the RMON statistics function Quidway(config-if-Ethernet0)# rmon promiscuous

Related Command
clear rmon statistics show rmon statistics

4.2.2 clear rmon statistics


To clear the entire RMON statistic data of the Ethernet interface, use the clear rmon statistics command. clear rmon statistics

Command Mode
Privileged user mode

4-6

User Manual - Command Reference (Volume 1) Versatile Routing Platform

Chapter 4
SNMP Configuration Commands

Usage Guideline
This command is used to delete the statistical data after RMON statistics function of the Ethernet interface is enabled.

Example
! Clear all the RMON statistical data of the Ethernet interface. Quidway# clear rmon statistics

Related Command
rmon promiscuous show rmon statistics

4.2.3 show rmon statistics


To show the RMON statistical results of Ethernet interface, use show rmon statistics command. show rmon statistics

Command Mode
Privileged user mode

Usage Guideline
This command is used to show RMON statistical results of the Ethernet interface with enabled RMON statistics function.

Example
! Show RMON statistical results of the Ethernet interface. Quidway#show rmon statistics

Related Command
rmon promiscuous, clear rmon statistics

4-7

User Manual - Command Reference (Volume 1) Versatile Routing Platform

Chapter 5
Maintenance and Debugging Tool Commands

Chapter 5 Maintenance and Debugging Tool Commands


5.1 System Debugging Commands
System debug commands include: l l debug show debugging

5.1.1 debug
Use the debug command to turn on the system debug switch. Use the no form of this command to turn off this switch. debug { all | { protocol-name | function-name } [ debug-option ] } no debug { all | { protocol-name | function-name } [ debug-option ] }

Syntax Description
all Turning on/off all debug switches.

Default
All debug switches turned off.

Command Mode
Privileged user mode

Usage Guideline
VRP1.4 provides a vast array of debug functions, which are generally intended for technical support engineers and senior maintenance personnel. When the debug switch is turned on, a large volume of debug information will be generated, leading to deterioration of system efficiency. In particular, when the debug all command is executed to turn on all the debug switches, this may result in collapse in the network system. So the debug all command is not recommended. On the contrary, the no debug all command will greatly convenience you, for it enables you to turn off all the debug switches at one single time, and you do not have to turn them off on a one-by-one basis. In addition, any terminal user turning on or off debug switches will affect the output of debug information at the other user terminals. As for the link-layer protocols, their debug switches can be controlled based on their interfaces. This effectively avoids the interference from a large amount of redundant information and expedites network fault diagnosis and location.

5-1

User Manual - Command Reference (Volume 1) Versatile Routing Platform

Chapter 5
Maintenance and Debugging Tool Commands

In VRP1.3 and the subsequent versions, the output debug information and other various prompt information is managed via Syslog in a unified manner. So we will not provide the monitor and the unmonitored. In their stead, you need to turn on the corresponding Syslog switch for debug information. First, you must use the logging on command to start the Syslog function; then, according to the terminal types you used currently, use the logging console or logging monitor command to turn on the debug information output switch. On the Console, please use the logging console debugging command; at the Telnet terminal or dummy terminal, please use the logging monitor debugging command. For detail, please consult the Syslog configuration part.

Example
Example 1: ! Enable the IP Packet debugging. Quidway# debug ip packet
IP packet debugging switch is on.

Example 2: ! Enable the PPP packet debugging at serial0. Quidway# debug ppp packet interface serial0
PPP packet debugging switch is on.

Related Command
show debugging, logging on, logging console, logging monitor

5.1.2 show debugging


To show the debug switches already turned on, use the show debugging command. show debugging

Command Mode
Privileged user mode

Usage Guideline
To check which debug switches have been turned on, you can execute the show debugging command. Debug switches are shown in two parts: a) link-layer debug switches already turned on that are shown according to the order of the interfaces, which are valid to interfaces only; b) global debug switches.

Example
! Show the debug switches already turned on. Quidway#show debugging
interface serial0: PPP packet debugging switch is on. global debugging switch : ip packet debugging switch is on

5-2

User Manual - Command Reference (Volume 1) Versatile Routing Platform

Chapter 5
Maintenance and Debugging Tool Commands

Related Command
debug

5.2 Network Test Tool Commands


Network test tool commands include: l l l ping ping ipx tracert

5.2.1 ping
To check if the IP network connection and host are reachable, use the ping command. ping [ ip ] [ -R ] [ -d ] [ -n ] [ -q ] [ -r ] [ -v ] [ -c count ] [ -p pattern] [ -s packetsize ] [ -t timeout ] host

Syntax Description
-c Count of times that the ICMP ECHO-REQUEST packets is sent, ranging 1~4294967295. -d Set socket to DEBUG mode. -n Use the host parameter as the IP address without domain name resolution. -p Pattern, ICMP ECHO-REQUEST packet filling bit, in the hex format. For example, -p ff fills all packets with ff. -q No other detailed information but statistics is shown. -R Recording routes. -r Transmitting Echo-Request packets directly to the connected network without route selection. - s The size of the ECHO-REQUEST packet (exclusive of the IP and ICMP headers), counting in bytes. -t Timeout after the ECHO-REQUEST is sent, the timeout waiting for ECHORESPONSE , counting in ms. -v Showing other non-ECHO-RESPONSE ICMP packets. host Name or IP address of the destination host.

Default
If not specified, the above parameters are as follows: l l l l l l Count of times that the ECHO-REQUEST packet is sent: 5 times. Socket: non-DEBUG mode. Host: regarded as an IP address first; if it is not an IP address, then it needs to undergo domain name resolution. Filling method: starting from 0x01, and gradually increasing until 0x09; then repeat. All information including statistics are shown. No route recorded.

5-3

User Manual - Command Reference (Volume 1) Versatile Routing Platform

Chapter 5
Maintenance and Debugging Tool Commands

l l l l

ECHO-REQUEST is sent through route selection. The packet size of the ECHO-REQUEST packet is 56 bytes. The timeout for waiting for the ECHO-RESPONSE packet is 2000ms. Non-ECHO-RESPONSE ICMP packets not shown.

Command Mode
User mode and Privileged user mode

Usage Guideline
While the ping is executed, the ICMP ECHO-REQUEST packet is sent to the destination. If network connection to the destination works normally, then after the destination host receives the ICMP ECHO-REQUEST, it will acknowledge receipt of the ICMP ECHO-REPLY packet to the source host. The ping command is used to test if network connection is faulty or if the network has line quality trouble. Its output information includes: l Reply of the destination host to every ECHO-REQUEST packet. If no reply packet is received within the timeout limit, Request timeout will be output, otherwise the system will show the count of bytes, sequence number, TTL reply time, etc. of the reply packet. Final statistics, including the count of packets sent, count of reply packet received, percentage of packets unanswered, and minimum, maximum and average values of the reply time.

If the network transmits at a low speed, the reply packet timeout value can be increased appropriately.

Example
! Check if the host whose IP address is 202.38.160.244 is reachable. Quidway# ping 202.38.160.244
ping 202.38.160.244 : 56 data bytes Reply from 202.38.160.244 : bytes=56 Reply from 202.38.160.244 : bytes=56 Reply from 202.38.160.244 : bytes=56 Reply from 202.38.160.244 : bytes=56 Reply from 202.38.160.244 : bytes=56 --202.38.160.244 ping statistics-5 packets transmitted 5 packets received 0% packet loss round-trip min/avg/max = 1/2/3 ms sequence=1 sequence=2 sequence=3 sequence=4 sequence=5 ttl=255 ttl=255 ttl=255 ttl=255 ttl=255 time time time time time = = = = = 1ms 2ms 1ms 3ms 2ms

Related Command
tracert

5.2.2 ping ipx


To check if IPX network connection and host are reachable, use the ping ipx command. ping ipx [ -n ] [ -v ] N.H.H.H [ count [ , timeout [ , pscketsize ] ] ]

5-4

User Manual - Command Reference (Volume 1) Versatile Routing Platform

Chapter 5
Maintenance and Debugging Tool Commands

Syntax Description
-n Standard Novell reply mode used. -v Showing detailed information. N.H.H.H Network address of the remote host. count Times that the IPX ping request packet is sent. timeout Timeout value waiting for the IPX ping reply packet, counting in seconds. packetsize Size of the IPX ping request packet.

Default
If not specified, the above parameters are as follows: l l l Count of times that the IPX ping request packet is sent: 5 times. Timeout for the IPX ping reply packet: 2s. The size of the IPX ping request packet: 100 bytes.

Command Mode
User mode and Privileged user mode

Usage Guideline
The ping ipx command can be used to test if the IPX network is faulty. The output information includes: l l Reply to each IPX ping request packet from the destination. If no reply packet is received within the timeout limit, then ! is output, otherwise . is shown. Final statistics, including the count of packets sent, count of reply packets received, percentage of packets unanswered, the minimum, maximum and average values.

Example
! Check if the host whose IPX address is 2.0.0c91.f61f is reachable. Quidway# ping ipx 2.0.0c91.f61f
Press CTRL_C to break Sending 5, 100-byte IPX Echoes to 2.0.0c91.f61f, timeout is 2 seconds !!!!! --2.0.0c91.f61f IPX ping statistics-5 packets transmitted 5 packets received 0% packet loss round-trip min/avg/max = 1/2/3 ms

5.2.3 tracert
To test if the gateways through which a data packet goes from the source host to the destination host are unreachable, use the tracert command. tracert [ -f first_TTL ] [ -m max_TTL ] [ -p port ] [ -q nqueries ] [ -w timeout ] host

Syntax Description
-f To test if the f switch is correct. first_TTL Specifies the first TTL, ranging 0 to maximum TTL.
5-5

User Manual - Command Reference (Volume 1) Versatile Routing Platform

Chapter 5
Maintenance and Debugging Tool Commands

-m To test if the m switch is correct. max_TTL Specifies a maximum TTL, which is more than the initial TTL. -p To test if the p switch is correct. port The port number of the destination host, which is an integer. Generally, you does not have to modify this item. -q To test if the q switch is correct. nqueries The count of test data packets sent each time, which is an integer and more than 0. -w To test if the wf switch is correct. timeout Specifies the timeout value for the IP packet in the second, which is an integer and more than 0. host IP address of the destination host.

Default
If not specified, the parameters are as follows: l l l l l first_TTL: 1. max_TTL: 30. port: 33434. nqueries: 3. timeout: 5s.

Command Mode
User mode and Privileged user mode

Usage Guideline
Process of executing the tracert command is as follows. First, send a data packet whose TTL is 1 , so the first hop feeds back a ICMP error message indicating that this data packet can not be sent (for TTL timeout). Then this data packet is retransmitted with TTL as 2, again the second hop feeds a TTL timeout message. This process goes on and on until the packet reaches the destination. The purpose of executing these processes is to record the source address for each ICMP TTL timeout message, providing the path through which an IP packet goes before reaching the destination. After identifying a fault with the network through the ping command, you can locate the fault via the tracert command. The information output through the tracert command includes the IP addresses of all the gateways through which an IP packet goes before reaching the destination. If a gateway is timeout, then output ***. It is mainly used to check if network connection is reachable, and analyze where the network is faulty.

Example
! Test if the gateways through which a data packet goes from the source host to the destination host whose IP address is 18.26.0.115 are unreachable.

5-6

User Manual - Command Reference (Volume 1) Versatile Routing Platform

Chapter 5
Maintenance and Debugging Tool Commands

Quidway# tracert 18.26.0.115


traceroute to allspice.lcs.mit.edu (18.26.0.115), 30 hops max 1 helios.ee.lbl.gov (128.3.112.1) 0 ms 0 ms 0 ms 2 lilac-dmc.Berkeley.EDU (128.32.216.1) 19 ms 19 ms 19 ms 3 lilac-dmc.Berkeley.EDU (128.32.216.1) 39 ms 19 ms 19 ms 4 ccngw-ner-cc.Berkeley.EDU (128.32.136.23) 19 ms 39 ms 39 ms 5 ccn-nerif22.Berkeley.EDU (128.32.168.22) 20 ms 39 ms 39 ms 6 128.32.197.4 (128.32.197.4) 59 ms 119 ms 39 ms 7 131.119.2.5 (131.119.2.5) 59 ms 59 ms 39 ms 8 129.140.70.13 (129.140.70.13) 80 ms 79 ms 99 ms 9 129.140.71.6 (129.140.71.6) 139 ms 139 ms 159 ms 10 129.140.81.7 (129.140.81.7) 199 ms 180 ms 300 ms 11 129.140.72.17 (129.140.72.17) 300 ms 239 ms 239 ms 12 * * * 13 128.121.54.72 (128.121.54.72) 259 ms 499 ms 279 ms 14 * * * 15 * * * 16 * * * 17 * * * 18 ALLSPICE.LCS.MIT.EDU (18.26.0.115) 339 ms 279 ms 279 ms

5.3 Log Commands


Log commands include: l l l l l l logging on logging console logging buffered logging monitor logging host show logging

5.3.1 logging on
To start the log function, use the logging on command. Use the no form of this command to shut down the log function. logging on no logging on

Default
Log function shut down.

Command Mode
Global configuration mode

Usage Guideline
Only after the log system is started via this log command can log information be output to the Console, Telnet terminal, dummy terminal, buffer in the router, and log host.

Example
! Shut down the log function. Quidway(config)# no logging on

5-7

User Manual - Command Reference (Volume 1) Versatile Routing Platform

Chapter 5
Maintenance and Debugging Tool Commands

Related Command
show logging

5.3.2 logging console


To turn on the log output switch in the Console direction, use the logging console command. Use the no form of this command to shut down the log output in the Console direction. logging console [ English | Chinese ] [ emergencies | alerts | critical | errors | warnings | notifications | informational | debugging ] [ filter [ facility1 facility2 ]] no logging console [ English | Chinese ] [ emergencies | alerts | critical | errors | warnings | notifications | informational | debugging ] [ filter [ facility1 facility2 ]]

Default
The language for display is English and, The seriousness-level threshold is informational and information is not filtered based on the module.

Command Mode
Global configuration mode

Usage Guideline
This command is used to start (or close) log output in the Console direction and set the corresponding control parameter.

Example
Example 1: ! Enable output of log information, where the seriousness level of the PPP module ranges from emergencies to debugging. Quidway(config)# logging console Chinese debugging filter ppp Example 2: !Disable the module-based filter function, that is, enable output of log information from all the modules. Quidway(config)# no logging console filter

Related Command
show logging, show running-config

5-8

User Manual - Command Reference (Volume 1) Versatile Routing Platform

Chapter 5
Maintenance and Debugging Tool Commands

5.3.3 logging buffered


To turn on the log output switch in the buffer direction, use the logging buffered command. Use the no form of this command to disable log output in the buffer direction. logging buffered [ size ] [ English | Chinese ] [ emergencies | alerts | critical | errors | warnings | notifications | informational | debugging ] [ filter [ facility1 facility2 ]] no logging buffered [ size ] [ English | Chinese ] [ emergencies | alerts | critical | errors | warnings | notifications | informational | debugging ] [ filter [ facility1 facility2 ]]

Default
The buffer size is 200, language for display is English, seriousness-level threshold is informational, and no information filtering based on the module.

Command Mode
Global configuration mode

Usage Guideline
A buffer is allocated in the Quidway router to save a certain amount of log information. When the count of logs exceeds the buffer size, the initial part of log information will be covered.

Example
! Configure the log parameter in the buffer direction, only enabling the saving of log information whose seriousness levels range from emergencies to errors in the buffer. Quidway(config)# logging buffered errors

Related Command
show logging , show running-config

5.3.4 logging monitor


To turn off the log output switch in the Console direction, use the logging monitor command. Use the no form of this command to disable the log output in the Console direction. logging monitor [ all ] [ English | Chinese] [ emergencies | alerts | critical | errors | warnings | notifications | informational | debugging ] [ filter [ facility1 facility2 ]] no logging monitor [ all ] [ English | Chinese] [ emergencies | alerts | critical | errors | warnings | notifications | informational | debugging ] [ filter [ facility1 facility2 ]]

Default
The language for display is English.

5-9

User Manual - Command Reference (Volume 1) Versatile Routing Platform

Chapter 5
Maintenance and Debugging Tool Commands

The seriousness-level threshold is informational. Information is not filtered based on the module.

Command Mode
Global configuration mode

Usage Guideline
This command is used to configure log output to the remote Telnet terminal, which can be used for remote debug. The parameter all is used in no logging monitor all only, indicating that the log system is disabled to send log information to any Telnet or dummy terminal. no logging monitor indicates that the log system is disabled to send log information to the local terminal.

Example
Example 1: ! Enable output of hdlc module information from the current telnet terminal or dummy terminal. Quidway(config)# logging monitor filter hdlc Chinese Example 2: ! Disable log output in the telnet or dummy terminal. Quidway(config)# no logging monitor all

Related Command
show logging , show running-config

5.3.5 logging host


To turn on the log output switch in the log host direction, use the logging host command. Use the no form of this command to disable the log output in the log host direction. logging host < 0-9 > ip-address [ local0 | | local7 ] [ English | Chinese ] [ emergencies | alerts | critical | errors | warnings | notifications | informational | debugging ] [ filter [ facility1 facility2 ]] no logging host < 0-9 > ip-address [ local0 | | local7 ] [ English | Chinese ] [ emergencies | alerts | critical | errors | warnings | notifications | informational | debugging ] [ filter [ facility1 facility2 ]]

Default
The facility name is local7. The language for display is English. The seriousness-level threshold is informational. Information is not filtered based on the module.

5-10

User Manual - Command Reference (Volume 1) Versatile Routing Platform

Chapter 5
Maintenance and Debugging Tool Commands

Command Mode
Global configuration mode

Usage Guideline
This command is used to configure the log host. The log system can send log packets to the hosts according to the configuration list, with a protocol number of 514. While using this command, try not to configure too many log hosts so as to avoid affecting the routers performance negatively.

Example
! Use a computer whose IP address is 10.110.200.200, and turn on the switch outputting log information to it. Quidway(config)# logging host 0 10.110.200.200 filter hdlc English informational

Related Command
show logging, show running-config

5.3.6 show logging


To show the configuration information for the log system or recording the information in the buffer in the router, use the show logging command. show logging [ buffered ]

Command Mode
Privileged user mode and global configuration mode

Usage Guideline
show logging is used to show the control parameter of the log system and the statistics of log packets sent. show logging buffered is used to show the log information saved in the buffer in the router.

Example
Example 1: ! Show the current log configuration information. Quidway(config)# show logging
Syslog logging: enable(0 messages logged,0 messages dropped). Console logging: level debugging,language English,filter off,0 messages logged. Monitor logging: level informational,language English,filter off,0 messages logged. Host logging: HostName IPAddress Facility Severity Filter Language Logged host0 10.110.201.103 local7 informational off English 0 Buffer logging: size 200,level informational,language English,filter off,0 messages logged.

Example 2:

5-11

User Manual - Command Reference (Volume 1) Versatile Routing Platform

Chapter 5
Maintenance and Debugging Tool Commands

! Show the log information saved in the buffer in the router. Quidway(config)# show logging buffered
%01:19:38-PPP-6-DEBUG: Serial2:0 PPP O LCP(c021) Pkt, Len 18 State starting, code ConfReq(01), id 21, len 14 MRU(1), len 4, val 05dc MagicNumber(5), len 6, val 322a0100 % Interface Serial2:0 changed state to UP %01:19:40-PPP-6-DEBUG: Serial2:0 PPP I LCP(c021) Pkt, Len 18 State reqsent, code ConfReq(01), id 6, len 14 MRU(1), len 4, val 05dc MagicNumber(5), len 6, val 0000d32d %01:19:41-PPP-6-DEBUG: Serial2:0 PPP O LCP(c021) Pkt, Len 18 State reqsent, code ConfAck(02), id 6, len 14 MRU(1), len 4, val 05dc MagicNumber(5), len 6, val 0000d32d % Line protocol ip on interface Serial2:0, changed state to UP %01:19:41-PPP-6-DEBUG: Serial2:0 PPP O LCP(c021) Pkt, Len 18 State acksent, code ConfReq(01), id 22, len 14 MRU(1), len 4, val 05dc MagicNumber(5), len 6, val 85670100

Related Command
show running-config

5-12