3com 3C13616 Command Reference Manual

3Com Router

Command Reference Guide — V1.00

http://www.3com.com/

Part No.

Published August 2003

3Com Corporation

350 Campus Drive

Marlborough, MA

01752-3064

to make any derivative work (such as translation, transformation, or adaptation) without written permission from 3Com Corporation.

3Com Corporation reserves the right to revise this documentation and to make changes in content from time to time without obligation on the

part of 3Com Corporation to provide notification of such revision or change.

3Com Corporation provides this documentation without warranty, term, or condition of any kind, either implied or expressed, including, but not

limited to, the implied warranties, terms or conditions of merchantability, satisfactory quality, and fitness for a particular purpose. 3Com may make

improvements or changes in the product(s) and/or the program(s) described in this documentation at any time.

If there is any software on removable media described in this documentation, it is furnished under a license agreement included with the product

as a separate document, in the hard copy documentation, or on the removable media in a directory file named LICENSE.TXT or !LICENSE.TXT. If

you are unable to locate a copy, please contact 3Com and a copy will be provided to you.

UNITED STATES GOVERNMENT LEGEND

If you are a United States government agency, then this documentation and the software described herein are

provided to you subject to the following:

All technical data and computer software are commercial in nature and developed solely at private expense. Software is delivered as “Commercial

Computer Software” as defined in DFARS 252.227-7014 (June 1995) or as a “commercial item” as defined in FAR 2.101(a) and as such is provided

with only such rights as are provided in 3Com’s standard commercial license for the Software. Technical data is provided with limited rights only as

provided in DFAR 252.227-7015 (Nov 1995) or FAR 52.227-14 (June 1987), whichever is applicable. You agree not to remove or deface any

portion of any legend provided on any licensed program or documentation contained in, or delivered to you in conjunction with, this User Guide.

Unless otherwise indicated, 3Com registered trademarks are registered in the United States and may or may not be registered in other countries.

3Com and the 3Com logo are registered trademarks of 3Com Corporation.

Intel and Pentium are registered trademarks of Intel Corporation. Microsoft, MS-DOS, Windows, and Windows NT are registered trademarks of

Microsoft Corporation. Novell and NetWare are registered trademarks of Novell, Inc.

All other company and product names may be trademarks of the respective companies with which they are associated.

Getting Started

Chapter 1 Command Line Interface Commands........................................................................... 2

1.1 Command Line Interface Commands................................................................................... 2

1.1.1 display history-command ........................................................................................... 2

1.1.2 language..................................................................................................................... 3

1.1.3 quit.............................................................................................................................. 3

1.1.4 return.......................................................................................................................... 4

1.2 Basic System Management and Configuration Commands................................................. 4

1.2.1 clock........................................................................................................................... 4

1.2.2 display base-information............................................................................................ 5

1.2.3 display clock............................................................................................................... 6

1.2.4 display duration..........................................................................................................7

1.2.5 display processes cpu................................................................................................ 7

1.2.6 display processes memory......................................................................................... 8

1.2.7 display reboot............................................................................................................. 9

1.2.8 display sysname....................................................................................................... 10

1.2.9 display version.......................................................................................................... 10

1.2.10 reboot..................................................................................................................... 11

1.2.11 setup....................................................................................................................... 12

1.2.12 sysname................................................................................................................. 13

1

3Com Router Command Reference Guide — V1.00

Chapter 1 Command Line Interface Commands

1.1 Command Line Interface Commands

1.1.1 display history-command

Syntax

display history-command

View

All views

Parameter

None

Description

Using the display history-command command, you can view the history of

commands input by the current user.

By default, the operating system saves a maximum of 10 commands. You can access

them through the Up and Down keys on the keyboard.

Example

# Display the command history input by the current user.

[3Com] display history-command

No 1. interface ethernet 0

No 2. ip address 10.110.28.2 255.255.192.0

No 3. down

No 4. up

No 5. quit

No 6. rip

No 7. network 10.0.0.0

No 8. network 20. 0.0.0

No 9. quit

No10. display history-command

2

Getting Started

1.1.2 language

Syntax

language

View

System view

Parameter

None

Description

Using the language command, you can switch the language mode of the command

line interface.

By default, the language mode of command line interface is English.

Example

None

1.1.3 quit

Syntax

quit

View

All views

Parameter

None

Description

Using the quit command, you can return to the previous view from the current view.

In addition, you can return directly to the system view from the current view by

entering Ctrl+Q.

3

3Com Router Command Reference Guide — V1.00

Example

# Return from the Ethernet interface view to the system view.

[3Com-Ethernet0] quit

[3Com]

1.1.4 return

Syntax

return

View

All views

Parameter

None

Description

Using the return command, you can return to the system view from the current view.

In addition, you can directly return to the system view from the current view by

entering Ctrl+Q.

Example

# Return from the Ethernet interface view to the system view.

[3Com-Ethernet0] return

[3Com]

1.2 Basic System Management and Configuration

Commands

1.2.1 clock

Syntax

clock hour:minute:second day month year

View

System view

4

Getting Started

Parameter

hour:minute:second: Current clock. hour, ranging from 0 to 23; minute and second,

ranging from 0 to 59.

year/month/day: Current date. year, ranging from 1997 to 2097, month, ranging from

1 to 12, day, ranging from 1 to 31.

Description

Using the clock command, you can set the current date and clock of the router.

If the router is not yet equipped with a hardware real-time clock, the default clock

value is 0:0:0 1/1/1998 when the system is booted. If the router is equipped with a

real-time clock, the system will read the clock value when booted, and use it for

setting the system time.

When powered off, the routers stop keeping time, so it is necessary to reset the

current date and time for the router in a rigorous application environment.

For related commands, see display clock.

Example

# Set the current date and clock of the router to 0:0:0 Jan. 2nd, 2001.

[3Com] clock 0:0:0 2 1 2001

1.2.2 display base-information

Syntax

display base-information [ page ]

View

All views

Parameter

page: Display in pages.

Description

Using the display base-information command, you can view the basic information

of the system, including the information on version, current configuration, interface,

memory and traffic on the interface. This information helps the network administrator

and technical assistance engineers to learn the overall condition of the router.

5

3Com Router Command Reference Guide — V1.00

Example

# Display the basic system information.

[3Com] display base- information

……

---------------------Display Version-------------------

……

-------------------Display RunningConfig----------------

……

--------------------Display Interfaces------------------

……

-------------------Display Memory Detail------------------

……

--------------------Display Ip Traffic--------------------

……

-------------------Display Ip Interface-------------------

……

1.2.3 display clock

Syntax

display clock

View

All views

Parameter

None

Description

Using the display clock command, you can view the current date and time of the

system.

You can execute this command to find out if the system time is correct. If the system

time is incorrect, you can adjust it.

For related commands, see clock.

Example

# Display the current date and clock of the system.

6

Getting Started

[3Com] display clock

Current router time:05:46:04 Oct 10 2000

1.2.4 display duration

Syntax

display duration

View

All views

Parameter

None

Description

Using the display duration command, you can view the time duration from booting

of the router to executing of this command.

Example

# Display the time duration from booting of the router to executing this command.

[3Com] display duration

3Com R5640 uptime is 0 days 1 hours 38 minutes 4 seconds.

1.2.5 display processes cpu

Syntax

display processes cpu

View

All views

Parameter

None

Description

Using the display processes cpu command, you can view the occupation rate of

CPU in the current system.

7

3Com Router Command Reference Guide — V1.00

Example

# Display the occupation rate of CPU in the current system.

[3Com] display processes cpu

Current CPU load: 5%

1.2.6 display processes memory

Syntax

display processes memory { all | blksize size } [ detail ]

View

All views

Parameter

all: Display utilization of all memory.

blksize size: Display the utilization status of the memory block with specified size.

The optional size can be 32, 64, 128, 512, 1024, 2048, 4096 and 8192.

detail: Display the details of all memory slices (including memory block address, the

utilized length of the memory slice).

Description

Using the display processes memory command, you can view the utilization of

memory in the current system.

This command displays all the statistics information about memory, such as the size

of the memory, the size of each memory raw slice, the size of free memory and the

size of the memory utilized.

Example

# Display the utilization of all memory in the system.

[3Com] display processes memory all

Total: 19029120 Slice: 1300992 RawSlice: 1706596 Free: 16021532

--------------------------------------------------------------------

Slice Memory Usage:

Block Size 32 Free 1419 Used 420 Total 1839

Block Size 64 Free 5 Used 86 Total 91

Block Size 128 Free 1 Used 315 Total 316

Block Size 256 Free 4 Used 338 Total 342

8

Getting Started

Block Size 512 Free 2 Used 20 Total 22

Block Size 1024 Free 2 Used 27 Total 29

Block Size 2048 Free 35 Used 350 Total 385

Block Size 4096 Free 8 Used 31 Total 39

----------------------- Slice memory summary -----------------------Used(Byte)

1027456 Free 1476 Used 1587 Total 3063

Raw Slice Memory Usage:

Total Size: 1662960 Num: 64

------------------ RawSlice detailed information ------------------

(0x00700606*27) (0x02200000*1) (0x02402421*1) (0x02402429*1)

(0x02402428*1) (0x02402427*1) (0x02402426*1) (0x02402425*1)

(0x02402424*1) (0x02402423*1) (0x12012001*3) (0x05005009*3)

(0x0DD0DC0D*1) (0x0DD0DC0C*1) (0x0DD0DC0B*1) (0x0DD0DC0A*1)

(0x0DD0DC09*1) (0x0DD0DC06*1) (0x0DD0DC05*1) (0x05005007*2)

(0x0FE00104*2) (0x0B40B408*1) (0x00D1D101*1) (0x00D0D003*1)

(0x00D0D002*1) (0x00D0D001*2) (0x0B20B201*2) (0x12345670*1)

(0x12345679*1) (0x12345678*1)

1.2.7 display reboot

Syntax

display reboot

View

All views

Parameter

None

Description

Using the display reboot command, you can view the plan for rebooting the router.

For related commands, see reboot.

Example

# Display the plan for rebooting the router.

[3Com] display reboot

[10:06:17 May 7 2002] Reboot scheduled for [23:59:59 May 7 2002] by [Console]

The above information shows that the router is to be rebooted at 23:59:59, May 7

th

,

2002.

9

3Com Router Command Reference Guide — V1.00

1.2.8 display sysname

Syntax

display sysname

View

All views

Parameter

None

Description

Using the display sysname command, you can view the sysname of the router.

For related commands, see sysname.

Example

# Display the router name.

[3Com] display sysname

3Com

1.2.9 display version

Syntax

display version

View

All views

Parameter

None

Description

Using the display version command, you can view information on the version of the

system.

Different versions have different functions. By viewing the version information, you

can learn the features supported by the software.

10

Getting Started

Example

# Display the version information of the system software.

[3Com] display version

3Com Versatile Routing Platform Software

ROS (R) software, Version 1.72 RELEASE 002

3Com R5640 uptime is 0 days 4 hours 36 minutes 1 seconds,

System returned to ROM by power-on.

3Com R5640 with 1 MPC 8240 Processor

Router serial number is 00E0FC050FBC546E

32M

8192K bytes Flash Memory

128K

Config Register points to NVRAM

Hardware Version is MTR 1.1

CPLD Version is CPLD 2.0

Bootrom Version is 4.33

[AUX ] AUX Hardware Version is 1.0, Driver Version is 1.0

[Slot 0] 2cE1 Hardware Version is 1.0, Driver Version is 1.0

[Slot 1] 8AS Hardware Version is 1.0, Driver Version is 1.2

[Slot 2] RTB12FE Hardware Version is 1.0, Driver Version is 1.0

1.2.10 reboot

Syntax

reboot [ mode { interval { hh:mm | time } | time { hh:mm [ dd/mm/yy ] } }

reason-string ] [ reason reason-string ] [ cancel ]

View

System view

Parameter

mode: The timed reboot mode, which can either be a specified time interval or a

specified time.

interval { hh:mm | time }: Specifies a time interval for the timed reboot, which can be

represented either by time (hh:mm) or a number (time). When the latter approach is

adopted, the number ranges from 0 to 5999 minutes.

11

3Com Router Command Reference Guide — V1.00

time hh:mm [ dd/mm/yy ]: Specify a time for timed reboot. If no date is specified, it

defaults to the current day.

reason-string: Describes the reboot reason.

cancel: Cancel the timed reboot settings that have been set.

Description

Using the reboot command, you can reboot the router.

The function of this command is similar to first powering off the router and then

restarting it. When the router is maintained remotely, it is not necessary to reboot the

router at where the router is located; instead, you can reboot it remotely.

Using the reboot command with parameters, you can set timed reboot. This is helpful

for online version upgrade and configuration modification/maintenance. If you do not

reboot the router after upgrading a version online, the new version will not be

available. In most cases, however, an administrator cannot reboot the router

immediately after maintenance of the router if such undertakings may affect the

ongoing activities. By setting timed reboot, the administrator can set the router to

automatically reboot at a time that minimizes the impact on the ongoing activities.

When rebooting the router, you need to check if the router configuration files need to

be saved.

Example

# Reboot the router.

[3Com] reboot

WARNING: System will REBOOT! Continue?[Y/N]y

System is now rebooting, please wait.

1.2.11 setup

Syntax

setup

View

system view

Parameter

None

12

Getting Started

Description

Using the setup command, you can interactively configure the basic parameters

necessary for the running of the router.

When a certain parameter is to be configured, and if this parameter is found already

configured, then its current value is shown as a default value. You can press Enter

without modifying it.

When you power on and boot the router for the first time, the system will

automatically execute the setup command to guide you in configuring the parameters

necessary for running the router. These parameters include:

 Router domain name

 User password

 SNMP parameter

 Selection of network protocols such as IP and IPX

 IP addresses and IPX network numbers at the interfaces

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

Example

# Guide the user in configuring the basic parameters of the router.

[3Com] setup

1.2.12 sysname

Syntax

sysname sysname

View

All views

Parameter

sysname: Name of the router, in the format of 1 to 20 characters.

Description

Using the sysname command, you can configure or change the router name that is

shown in the view prompt.

By default, the sysname is "3Com".

For related commands, see display sysname.

13

3Com Router Command Reference Guide — V1.00

Example

# Set the sysname of the router to “Corporate”.

[3Com] sysname Corporate

[Corporate]

14

System Management

System Management Commands

Chapter 1 System Management Commands ................................................................................. 4

1.1 System Management Commands ........................................................................................ 4

1.1.1 configfile ..................................................................................................................... 4

1.1.2 delete.......................................................................................................................... 5

1.1.3 display configfile......................................................................................................... 6

1.1.4 display current-configuration...................................................................................... 6

1.1.5 display saved-configuration........................................................................................ 8

1.1.6 download config ......................................................................................................... 9

1.1.7 first-config................................................................................................................. 10

1.1.8 save.......................................................................................................................... 11

1.1.9 update ...................................................................................................................... 12

1.2 FTP Configuration Commands........................................................................................... 13

1.2.1 display ftp-server...................................................................................................... 13

1.2.2 ftp-server config-name ............................................................................................. 14

1.2.3 ftp-server enable ...................................................................................................... 14

1.2.4 ftp-server system-name............................................................................................ 15

1.2.5 ftp-server timeout ..................................................................................................... 16

1.2.6 ftp-server update...................................................................................................... 17

1.2.7 kill ftp ........................................................................................................................ 17

1.3 TFTP Commands................................................................................................................ 18

1.3.1 copy.......................................................................................................................... 18

1.3.2 get............................................................................................................................. 20

Chapter 2 Terminal Service Configuration Commands.............................................................. 22

2.1 Terminal Service Attribute Configuration Commands ........................................................ 22

2.1.1 idle-timeout............................................................................................................... 22

2.2 Commands for Terminal Message Service Configuration.................................................. 23

2.2.1 send.......................................................................................................................... 23

2.2.2 send status...............................................................................................................24

2.2.3 send switch...............................................................................................................24

2.3 Dumb Terminal Service Configuration Commands............................................................ 25

2.3.1 auto-execute command............................................................................................ 25

2.4 Telnet Service Configuration Commands........................................................................... 26

2.4.1 display client............................................................................................................. 26

2.4.2 kill telnet ................................................................................................................... 27

2.4.3 reverse-telnet disconnect......................................................................................... 28

2.4.4 reverse-telnet listenport............................................................................................ 28

2.4.5 reverse-telnet return-deal......................................................................................... 29

1

3Com Router Command Reference Guide — V1.00

2.4.6 reverse-telnet timeout............................................................................................... 30

2.4.7 telnet......................................................................................................................... 31

2.4.8 terminal telnet break-on-ip ....................................................................................... 32

2.4.9 terminal telnet refuse-negotiation............................................................................. 33

2.5 Rlogin configuration command........................................................................................... 34

2.5.1 rlogin......................................................................................................................... 34

2.6 X.25 PAD Configuration Commands.................................................................................. 35

2.6.1 debugging pad.......................................................................................................... 35

2.6.2 display x25 pad ........................................................................................................ 36

2.6.3 login pad................................................................................................................... 37

2.6.4 pad............................................................................................................................ 38

2.6.5 x29 inviteclear-time .................................................................................................. 38

Chapter 3 Network Management Configuration Commands..................................................... 40

3.1 SNMP Configuration Commands........................................................................................ 40

3.1.1 debugging snmp-agent ............................................................................................ 40

3.1.2 display snmp-agent community................................................................................ 41

3.1.3 display snmp-agent group........................................................................................ 42

3.1.4 display snmp-agent local-engineid........................................................................... 42

3.1.5 display snmp-agent mib-view................................................................................... 43

3.1.6 display snmp-agent statistics................................................................................... 44

3.1.7 display snmp-agent sys-info contact........................................................................ 45

3.1.8 display snmp-agent sys-info location....................................................................... 46

3.1.9 display snmp-agent usm-user.................................................................................. 46

3.1.10 snmp-agent ............................................................................................................ 47

3.1.11 snmp-agent community.......................................................................................... 48

3.1.12 snmp-agent group.................................................................................................. 49

3.1.13 snmp-agent local-engineid..................................................................................... 51

3.1.14 snmp-agent mib-view............................................................................................. 51

3.1.15 snmp-agent packet max-size................................................................................. 53

3.1.16 snmp-agent sys-info contact.................................................................................. 53

3.1.17 snmp-agent sys-info location ................................................................................. 54

3.1.18 snmp-agent sys-info version.................................................................................. 55

3.1.19 snmp-agent target-host.......................................................................................... 56

3.1.20 snmp-agent trap enable......................................................................................... 57

3.1.21 snmp-agent trap life................................................................................................ 59

3.1.22 snmp-agent trap queue-size .................................................................................. 59

3.1.23 snmp-agent trap source......................................................................................... 60

3.1.24 snmp-agent usm-user............................................................................................ 61

3.2 RMON Configuration Command......................................................................................... 63

3.2.1 display rmon statistics.............................................................................................. 63

3.2.2 reset rmon statistics ................................................................................................. 63

3.2.3 rmon promiscuous.................................................................................................... 64

2

System Management

Chapter 4 Maintenance and Debugging Tool Commands ......................................................... 66

4.1 System Debugging Commands.......................................................................................... 66

4.1.1 debugging.................................................................................................................66

4.1.2 display debugging .................................................................................................... 67

4.2 Network Test Tool Commands........................................................................................... 68

4.2.1 ping........................................................................................................................... 68

4.2.2 ping ipx..................................................................................................................... 70

4.2.3 tracert ....................................................................................................................... 71

4.3 Log Commands................................................................................................................... 74

4.3.1 display info-center.................................................................................................... 74

4.3.2 info-center console................................................................................................... 75

4.3.3 info-center enable..................................................................................................... 77

4.3.4 info-center logbuffer ................................................................................................. 77

4.3.5 info-center loghost.................................................................................................... 79

4.3.6 info-center monitor ................................................................................................... 81

Chapter 5 POS Terminal Access Service Configuration Commands....................................... 83

5.1 POS Terminal Access Service Configuration Commands.................................................. 83

5.1.1 async mode pos....................................................................................................... 83

5.1.2 async mode posapp................................................................................................. 83

5.1.3 debugging pos-app................................................................................................... 84

5.1.4 debugging pos-interface........................................................................................... 85

5.1.5 display fcm ...............................................................................................................85

5.1.6 display pos-app........................................................................................................ 86

5.1.7 display pos-interface ................................................................................................ 87

5.1.8 pos-server app flow.................................................................................................. 88

5.1.9 pos-server app tcp.................................................................................................... 89

5.1.10 pos-server enable................................................................................................... 90

5.1.11 pos-server fcm........................................................................................................ 90

5.1.12 pos-server map ...................................................................................................... 92

5.1.13 pos-server source-ip............................................................................................... 93

5.1.14 reset fcm................................................................................................................. 94

5.1.15 reset pos................................................................................................................. 94

3

3Com Router Command Reference Guide — V1.00

Chapter 1 System Management Commands

1.1 System Management Commands

1.1.1 configfile

Syntax

configfile { flash | nvram }

View

System view

Parameter

flash: Storage media Flash memory is used for the current configuration.

nvram: Storage media NVRM is used for the current configuration.

Description

Using the configfile command, you can select the storage media used for saving the

current configuration file.

NVRAM is the default storage media when Flash memory and NVRAM co-exist.

The 3Com series of routers use Flash memory and NVRAM for saving configuration

files. Normally, the configuration files are reserved in NVRAM. The configfile

command is used to select one of them as the currently valid media. For example,

after the configfile NVRAM command is executed, the SAVE command is executed;

the configuration file will then be saved to NVRAM instead of Flash memory. Before

saving or erasing the configuration file, you can use the display configfile command

to display the storage media used for saving the current configuration file.

For related commands, see delete, download config, display

current-configuration, display saved-configuration, display configfile.

Example

# Select Flash memory as the storage media for saving the configuration file.

[3Com] configfile flash

4

Page is loading ...

3com 3C13616, 3C13612, 3C13613, 3C13618 Command Reference Manual

Related papers

Other documents