3com Router 3031 Command Reference Manual

http://www.3com.com/

3Com Router Command

Reference Guide

3Com Router 3000 DSL Family

3Com Router 5000 Family

3Com Router 6000 Family

Part No. 10014369

Published June 2004

3Com Corporation

350 Campus Drive

Marlborough, MA

01752-3064

reproduced in any form or by any means or used 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.

CONTENTS

ABOUT THIS GUIDE

Conventions 7

Related Documentation 8

1 CONFIGURATION COMMANDS

Basic Configuration Commands 9

2 SYSTEM MAINTENANCE & MANAGEMENT COMMANDS

debugging 23

Information Processing Commands 31

System Operating Management Commands - AR46 Series 48

File Management Commands 55

FTP Server Configuration Commands 65

FTP client module commands 69

TFTP Configuration Commands 79

Configuration Files Management Commands 81

User Interface Configuration Commands 86

debugging ntp-service 102

SNMP Configuration Commands 115

Terminal Service Commands 134

SSH Configuration Commands 136

3 INTERFACE MANAGEMENT COMMANDS

Interface Management Commands 149

Fundamental Ethernet Interface Configuration Commands 154

Fundamental WAN Interface Configuration Commands 158

Fundamental CE1/PRI Interface Configuration Commands 165

Fundamental CT1/PRI Interface Configuration Commands 172

E1-F Interface Configuration Commands 178

T1-F Interface Configuration Commands 183

Fundamental CE3 Interface Configuration Commands 188

Fundamental CT3 Interface Configuration Commands 196

ATM E3/T3 Interface Configuration Commands 205

ATM 25M Interface Configuration Commands 209

ATM OC-3c/STM-1 Interface Configuration Commands 210

G.SHDSL Interface Configuration Commands 213

ADSL Interface Configuration Commands 219

Fundamental Logical Interface Configuration Commands 227

Logic-Channel Interface 229

Configuration Command of Virtual Template and Virtual Access Interface 230

MP-group Interface Configuration Command 232

Virtual Ethernet Interface Configuration Command 234

Configuration Command of Loopback Interface and Null Interface 236

4 LINK LAYER PROTOCOL

PPP and MP Configuration Commands 239

PPPoE Server Configuration Commands 253

PPPoE Client Configuration Commands 256

VLAN Configuration Commands 260

ISDN Configuration Commands 264

SLIP Configuration Commands 288

HDLC Configuration Commands 289

Frame Relay Configuration Commands 291

ATM Configuration Commands 324

LAPB and X.25 Configuration Commands 350

5 NETWORK PROTOCOL

IP Address Configuration Commands 397

ARP Configuration Commands 401

Static Domain Name Resolution 404

DHCP Public Configuration Commands 405

DHCP Server Configuration Commands 408

DHCP Client Configuration Commands 433

DHCP Relay Configuration Commands 436

IP Performance Configuration Commands 440

NAT Configuration Commands 460

IP Unicast Policy Routing Configuration Commands 467

IP Multicast Policy Routing Configuration Commands 474

IPX Configuration Commands 479

DLSw Configuration Commands 506

6 ROUTING PROTOCOL

Display Commands of the Routing Table 533

Static Route Configuration Commands 543

RIP Configuration Commands 545

OSPF Configuration Commands 560

Integrated IS-IS Configuration Commands 599

BGP Configuration Commands 626

MBGP Configuration Commands 664

IP Routing Policy Configuration Commands 667

Route Capacity Configuration Commands 681

7 MULTICAST COMMON CONFIGURATION COMMANDS

Multicast Common Configuration Commands 687

IGMP Configuration Commands 697

PIM Configuration Commands 708

MSDP Configuration Commands 725

MBGP Multicast Extension Configuration Commands 740

Multicast Static Route Configuration Commands 753

8 MPLS BASIC CONFIGURATION COMMANDS

Basic Configuration Commands 759

LDP Configuration Commands 769

BGP/MPLS VPN Configuration Commands 780

MPLS L2VPN CCC Configuration Commands 802

SVC MPLS L2VPN Configuration Commands 807

Martini MPLS L2VPN Configuration Commands 808

Kompella MPLS L2VPN Configuration Commands 809

MPLS TE Configuration Commands 815

Conventions 7

ABOUT THIS GUIDE

This guide describes the 3Com

®

Router Commands as implemeted through the

Command Line Interface (CLI) of the router.

This guide is intended for the system or network administrator who is responsible

for configuring, using, and managing the routers. It assumes a working

knowledge of wide area network (WAN) operations and familiarity with

communication protocols that are used to interconnect WANs.

Always download the Release Notes for your product from the 3Com World Wide

Web site for the latest updates to product documentation:

http://www.3com.com

Conventions Table 1 and Table 2 list conventions that are used throughout this guide.

Table 1 Notice Icons

Table 2 Text Conventions

Icon Notice Type Description

Information note Information that describes important features or

instructions.

Caution Information that alerts you to potential loss of data

or potential damage to an application, system, or

device.

Warning Information that alerts you to potential personal

injury.

Convention Description

Screen

displays

This typeface represents information as it appears on the screen.

Keyboard key

names

If you must press two or more keys simultaneously, the key names are

linked with a plus sign (+), for example:

Press Ctrl+Alt+Del

The words “enter”

and type”

When you see the word “enter” in this guide, you must type

something, and then press Return or Enter. Do not press Return or

Enter when an instruction simply says “type.”

8 CHAPTER : ABOUT THIS GUIDE

The following manuals offer additional information necessary for managing your

3Com Router:

■ 3Com Router 3000 DSL, 3Com Router 5000, and 3Com Router 6000 Family

Installation Guides — Provides detailed descriptions of each of the individual

router families and specific information on installing the routers.

■ 3Com Router Configuration Guide— Describes how to configure your Router

6000 using the supported protocols and CLI commands.

■ Release Notes — Contains the latest information about your product. If

information in this guide differs from information in the release notes, use the

information in the Release Notes.

These documents are available in Adobe Acrobat Reader Portable Document

Format (PDF) on the CD-ROM that accompanies your router or on the 3Com

World Wide Web site:

http://www.3com.com/

Words in italics Italics are used to:

Emphasize a point.

Denote a new term at the place where it is defined in the text.

Identify menu names, menu commands, and software button names.

Examples:

From the Help menu, select Contents.

Click OK.

Words in bold Boldface type is used to highlight command names in text. For

example, “Use the display user-interface command to...”

1

CONFIGURATION COMMANDS

This chapter describes how to use the following commands:

Basic Configuration Commands

■ Clock Summer Times

■ clock datetime

■ clock timezone

■ command-privilege

■ display clipboard

■ display clock

■ display history-command

■ display version

■ header3Com

■ hotkey

■ language-mode

■ lock

■ quit

■ Reboot

■ return

■ super

■ super password

■ sysname

■ system-view

Basic Configuration

Commands

Clock Summer Times Syntax

clock summer-time zone_name { absolute | recurring } HH:MM:SS

YYYY/MM/DD HH:MM:SS YYYY/MM/DD HH:MM:SS

undo clock summer-time

View

User view

10 CHAPTER 1: CONFIGURATION COMMANDS

Parameter

zone_name: Name of the summer time, which is a character string of 1

to 32 characters.

absolute: Only sets the summer time of some year.

recurring: Sets the summer time of every year starting from some

year.

HH:MM:SS: Time (hour/minute/second).

YYYY/MM/DD: Date (year/month/day).

Description

■ Using the clock summer-time command, you can set the name, starting and

ending time of the summer time. Using the undo clock summer-time

command, you can remove the configuration of the summer time.

■ After the configuration takes effect, you can use the display clock command

to make the verification. Besides, the time of the log or debug information will

be the local time on which the adjustment of the time zone and summer time

has been made.

For related command, see clock timezone.

Example

Add one hour to the clock for the summer time z2 that starts at 06:00:00 on

2002/06/08 and ends at 06:00:00 on 2002/09/01.

<3Com> clock summer-time z2 absolute 06:00:00 2002/06/08 06:00:00

2002/09/01 01:00:00

# Add one hour to the clock each year starting from 2002 for the

summer time z2 that starts at 06:00:00 on 08/06 and ends at 06:00:00

on 01/09.

<3Com> clock summer-time z2 recurring 06:00:00 2002/06/08 06:00:00

2002/09/01 01:00:00

clock datetime Syntax

clock datetime HH:MM:SS YYYY/MM/DD

View

User view

Parameter

HH:MM:SS: Time (hour/minute/second).

YYYY/MM/DD: Date (year/month/day) in the range of 1993 to 2035.

Description

Using the clock datetime command, you can set the time and date.

After the configuration takes effect, you can verify it by executing the display

clock command. The time applied to the log and debug information has been

adjusted.

Basic Configuration Commands 11

Example

Set the current system time to 10:20:55 2003/04/05.

<3Com> clock datetime 10:20:55 2003/04/05

clock timezone Syntax

clock timezone zone_name { add | minus } HH:MM:SS

undo clock timezone

View

User view

Parameter

zone_name: Timezone name, which is a string of 1 to 32 characters.

add: Adds the time on the basis of Universal Time Coordinated (UTC)

timezone.

minus: Reduces the time on the basis of UTC timezone.

HH:MM:SS: Time (hour/minute/second).

Description

Using the clock timezone command, you can set information of the local

timezone. Using the undo clock timezone command, you can restore the local

timezone to the default UTC timezone.

After the configuration takes effect, you can view it by executing the display

clock command. The time applied to the log and debug information has been

adjusted according to the involved timezone and summer time.

For related command, see clock summer-time.

Example

Set the local timezone name to Z5 and set Z5 to be five hours faster than UTC

time.

<3Com> clock timezone z5 add 05:00:00

command-privilege Syntax

command-privilege level level view view command-key

undo command-privilege view view command-key

View

System view

Parameter

level level: Command priority ranging from 0 to 3.

view view: View. The command line provides the following views:

1shell: View of current user level.

2system: System view

3 Routing protocol view: Include ospf (OSPF view), rip (RIP view), bgp (BGP view),

isis (IS-IS view), etc.

12 CHAPTER 1: CONFIGURATION COMMANDS

4 Interface view: Include ethernet (FE), gigabitethernet (GE), serial (serial

interface), ce1 (cE1 interface), ce3 (E3 interface), ct1 (cT1 interface), atm (ATM

interface), pos (POS interface), virtual-template (virtual interface template),

virtual-ethernet (virtual Ethernet interface), loopback (Loopback interface), null

(Null interface), tunnel (Tunnel interface).

5 user-interface: User view

6 l2tp-group: System view of L2TP group.

7 route-policy: Route map view

Refer to "Command Line Views" section in the Operation Manual for more

details.

commandkey: Command to be set.

Description

Using the command-privilege command, you can set the command level in the

specified view. Using the undo command-privilege view command, you can

remove current settings.

Command priority fall into such 4 levels as access, monitor, configure and manage

that are identified with 0 to 3. The administrator can grant certain rights to a user

on its demand so that the user can operate in the related view. When the user

logging in, the system can set the command operation rights for it either

according to the rights corresponding to the user name, or based on the rights of

the user-interface. If the two sets of rights conflict, the minimum rights will be

adopted.

By default, the command level of the ping, tracert and telnet commands is

access (level 0), the command level of the display and debugging commands is

monitor (level 1), that of configuration commands is configure (level 2), and the

commands for user key setting, FTP, XMODEM, TFTP and file system operation fit

into commands of manage-level (level 3).

Example

Set the priority of the “interface” command to 0.

[3Com] command-privilege level 0 view system interface

display clipboard Syntax

display clipboard

View

Any view

Parameter

None

Description

Using the display clipboard command, you can display the contents of

clipboard.

Basic Configuration Commands 13

Example

Display the contents of clipboard.

<3Com> display clipboard

-----------------clipboard -----------------

ip route 10.1.0.0 255.0.0.0 eth 0

display clock Syntax

display clock

View

Any view

Parameter

None

Description

Using the display clock command, you can display the clock status and the

configuration information.

Example

Display the current time.

<3Com> display clock

19:22:03 UTC Sat 2054/03/07

display

history-command

Syntax

display history-command

View

Any view

Parameter

None

Description

Using the display history-command command, you can browse the history

commands.

The terminal will automatically save the history commands typed by the user, that

is, completely record the user's input (via keyboard) separated by "Enter".

For the related command, see history-command size.

Example

Display history commands.

<3Com> display history-command

show interface

14 CHAPTER 1: CONFIGURATION COMMANDS

show interface e 1/0/0

c

in e 1/0/0

display version Syntax

display version

View

Any view

Parameter

None

Description

Using the display version command, you can browse system version information.

Through viewing system version information, you will learn about the software

version in use, rack type and the information related to the main processing board

and interface cards.

Example

Display system version information of a 3Com R1760 router.

<3Com> display version

3Com Versatile Routing Platform Software

VRP(tm) software, Version 3.30

3Com Serial Router R1760

System has kept running 0weeks, 0days, 0hours, 15minutes

CPU type Powerpc8241 166Mhz

64M bytes SDRAM

8M bytes Flash Memory

Pcb Version:001

Logic Version:001

BootROM Version:0.0

Slot0: WAN (pcb)001 (software)000 (logic)001

header3Com Syntax

header [ shell | incoming | login ] text

undo header [ shell | incoming | login ]

View

System view

Parameter

login: Greeting information when login.

shell: Greeting information of the creation of a user session.

incoming: Greeting information when login to the user view.

Basic Configuration Commands 15

text

: Content of greeting information.

Description

Using the header command, you can set the greeting information to be displayed.

Using the undo header command, you can remove the preset greeting

information.

When a user is logging on to a router via a terminal line, the router prompts

related information through setting title attribute. After activating the terminal

connection, the router sends the login title to the terminal. If the user log on to

the router successfully, the shell greeting information will be displayed.

text takes the first English character as the start and end characters. After the end

character is input, the system will quit the interactive process automatically.

If you do not want to start the interactive process, make sure that the first and last

characters of the text are the same English character and press <Enter> directly.

Example

Configure a session creation title.

[3Com] header shell %

Enter TEXT message. End with the character '%'.

SHELL : Hello! Welcome use 3Com R1760.%

# Test the configuration.

[3Com] quit

<3Com> quit

Press RETURN to get started

SHELL : Hello! Welcome use 3Com R1760.

<3Com>

hotkey Syntax

hotkey [ CTRL_G | CTRL_L | CTRL_O | CTRL_T | CTRL_U ] command_text

undo hotkey [ CTRL_G | CTRL_L | CTRL_O | CTRL_T | CTRL_U ]

View

System view

Parameter

CTRL_G: Specify a command for the hotkey <CTRL+G>.

CTRL_L: Specify a command for the hotkey <CTRL+L>.

CTRL_O: Specify a command for the hotkey <CTRL+O>.

CTRL_T: Specify a command for the hotkey <CTRL+T>.

CTRL_U: Specify a command for the hotkey <CTRL+U>.

command_text: The command line correlated with the hotkey.

16 CHAPTER 1: CONFIGURATION COMMANDS

Description

Using the hotkey command, you can correlate a command line with a hotkey.

Using the undo hotkey command, you can recover the default value of the system.

By default, CTRL_G, CTRL_L and CTRL_O correspond to the following

commands respectively:

display current-configuration (display current configuration);

display ip routing-table (display routing table information);

undo debugging all (disable the overall debugging function, that is,

disable the output of all debugging information).

You can change the definitions on your demand. The default values for the other

hotkeys are null.

Example

Correlate the display tcp status command with the hotkey CTRL_T.

[3Com] hotkey ctrl_t display tcp status

[3Com] display hotkey

----------------- HOTKEY -----------------

=Defined hotkeys=

Hotkeys Command

CTRL_G display current-configuration

CTRL_L display ip routing-table

CTRL_O undo debug all

CTRL_T display tcp status

=Undefined hotkeys=

Hotkeys Command

CTRL_U NULL

=System hotkeys=

Hotkeys Function

CTRL_A Move the cursor to the beginning of the current line.

CTRL_B Move the cursor one character left.

CTRL_C Stop current command function.

CTRL_D Erase current character.

CTRL_E Move the cursor to the end of the current line.

CTRL_F Move the cursor one character right.

CTRL_H Erase the character left of the cursor.

CTRL_K Kill outgoing connection.

CTRL_N Display the next command from the history buffer.

CTRL_P Display the previous command from the history buffer.

CTRL_R Redisplay the current line.

CTRL_V Paste text from the clipboard.

CTRL_W Delete the word left of the cursor.

CTRL_X Delete all characters up to the cursor.

CTRL_Y Delete all characters after the cursor.

CTRL_Z Return to the user view.

CTRL_] Kill incoming connection or redirect connection.

ESC_B Move the cursor one word back.

ESC_D Delete remainder of word.

ESC_F Move the cursor forward one word.

ESC_N Move the cursor down a line.

ESC_P Move the cursor up a line.

Basic Configuration Commands 17

ESC_< Specify the beginning of clipboard.

ESC_> Specify the end of clipboard.

language-mode Syntax

language-mode { chinese | english }

View

User view

Parameter

None

Description

Using the language-mode command, you can switch between different language

modes of command line interface.

By default, the language mode is English.

The command line interface of the system also supports Chinese mode to fit into

domestic users in China.

Example

Switch from English mode to Chinese mode.

<3Com> language-mode chinese

Change language mode, confirm? [Y/N]y

% Switch to Chinese mode.

lock Syntax

lock

View

User view

Parameter

None

Description

Using the lock command, you can lock the active user interface to prevent

unauthorized user from operating the interface.

A user interface includes CON port, AUX port and VTY, etc.

After inputting the lock command, the user is prompted to enter the screensaver's

password and confirm the password. If the two passwords are the same, the

interface will be successfully locked. To enter the system once again, you must

press <Enter> first, and enter the preset password following the prompt.

Example

Log in from the CON port and lock the active user interface.

18 CHAPTER 1: CONFIGURATION COMMANDS

<3Com> lock

Password:

Again:

quit Syntax

quit

View

Any view

Parameter

None

Description

Using the quit command, you can quit from the active view to a lower-level view

(if the active view is user view, you will exit the system).

Views fall into three levels that are, in ascending order:

■ User view (with user level as 0)

■ System view (with user level as 3)

■ Configuration view (routing protocol view, interface view, VPDN group view,

etc)

For the related command, see return.

Example

Switch from Ethernet1/0/0 interface view to system view, and then to user view.

[3Com-Ethernet1/0/0] quit

[3Com] quit

<3Com>

Reboot Syntax

reboot

View

User view

Parameter

None

Description

Using the reboot command, you can reboot the device.

This command produces the same effect as the power is turned on and then on,

but provides the user with a convenient method of rebooting the device from a

remote site.

Basic Configuration Commands 19

The operation of this command will render the network unusable for a short

period of time. So it should be used with caution. Before rebooting the Router,

remember to save the configuration file if necessary,

Example

Reboot the device.

<3Com> reboot

System will reboot! Continue?[Y/N]

return Syntax

return

View

Any view, except user view

Parameter

None

Description

Using the return command, you can return to user view from any other views. The

combination key <Ctrl+Z> performs the same function as the return command.

For the related command, see quit.

Example

Return to user view from system view.

[3Com] return

<3Com>

super Syntax

super [ level ]

View

User view

Parameter

Level: User level ranging from 0 to 3.

Description

Using the super command, you can switch from current user level to a specified

level.

User level refers to the class of a login user. There are 4 user levels corresponding

to 4 command levels. After a user of certain level logs in, it can only use the

commands of the same or lower level.

There are 4 command levels, namely access, monitor, configure and manage, as

follows:

20 CHAPTER 1: CONFIGURATION COMMANDS

■ Access: Include the network diagnosis tool commands (ping, tracert),

commands for accessing an external device from local device (including Telnet

client, SSH client, RLOGIN), etc. Commands of this level cannot perform

configuration file saving operation.

■ Monitor: Commands used for system maintenance, service fault diagnosis and

so on, including the display and debugging commands. Commands of this

level cannot perform configuration file saving operation.

■ Configure: Service configuration commands, including routing commands and

commands of various network layers. Commands of this level provide direct

network services for users.

■ Manage: Commands related to basic system running and system support

modules. These commands provide support for various services. Commands of

this level include file system, FTP, TFTP, Xmodem download and configuration

file switchover commands, power control commands, standby board control

commands, user management commands, level setting commands, system

internal parameter setting commands (not being provided in protocols or RFC

documentation), etc.

To prevent unauthorized users from intruding the system, you must pass the

authentication when you are trying to switch from current user to a higher-level

user. This means that you must enter the password of the higher-level user (if

the super password [ level user-level ] { simple | cipher } line command is

configured). For the sake of security, your entered password is not directly

displayed on the screen. If you enter the correct password within three times,

you will be able to switch to the higher-level user, or you will stay at current

level.

For the related command, see super password.

Example

<3Com> super 3

Password:

User privilege changes to 3 level, just equal or less this level's

commands can be used.

Privilege note: 0-VISIT, 1-MONITOR, 2-SYSTEM, 3-MANAGE

super password Syntax

super password [ level user-level ] { simple | cipher } password

undo super password [ level user-level ]

View

System view

Parameter

user-level: User level ranging from 0 to 3.

simple: Configure simple text password.

cipher: Configure cipher text password.

Page is loading ...

3com Router 3031, Router 3000 DSL Series, Router 5000 Series, Router 6000 Series Command Reference Manual

Related papers

Other documents