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
license for the Software. Technical data is provided with limited rights only as provided in DFAR 252.227-7015 (Nov
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.
ntel and Pentium are registered trademarks of Intel Corporation. Microsoft, MS-DOS, Windows, and Windows NT are
registered trademarks of Microsoft
registered trademark in the United States and other countries, licensed exclusively through X/Open Company, Ltd.
IEEE and 802 are registered trademarks of the Institute of Electrical and Electronics Engineers, Inc.
All other company and product names may be trademarks of the respective companies with which they are associated.
ENVIRONMENTAL STATEMENT
It is the policy of 3Com Corporation to be environmentally friendly in all operations. To uphold our policy, we are committed
to:
Establishing environmental performance standards that comply with national legislation and regulations.
Conserving energy, materials and natural resources in all operations.
Reducing the waste generated by all operations. Ensuring that all waste conforms to recognized environmental standards.
Maximizing the recyclable and reusable content of all products.
Ensuring that all products can be recycled, reused and disposed of safely.
Ensuring that all products are labelled according to recognized environmental standards.
Improving our environmental record on a continual basis.
End of Life Statement
3Com processes allow for the recovery, reclamation and safe disposal of all end-of-life electronic components.
Regulated Materials Statement
3Com products do not contain any hazardous or ozone-depleting material.
Environmental Statement about the Documentation
The documentation for this product is printed on paper that comes from sustainable, managed forests; it is fully
biodegradable and recyclable, and is completely chlorine-free. The varnish is environmentally friendly, and the inks are
vegetable-based with a low heavy-metal content.
2.101(a) and as such is provided with only such rights as are provided in 3Com’s standard commercial
Corporation. Novell and NetWare are registered trademarks of Novell, Inc. UNIX is a
1995) or
Page 3
ABOUT THIS GUIDE
This guide describes the command line interface (CLI) configuration commands
®
used to control the 3Com
3Com Router 5000 Family and Router 6000 Familyof
routers.
About This Software
Version
The software in the 3Com® 3Com Router 5000 Family and Router 6000 Familyis a
subset of that used in some other 3Com products. Depending on the capabilities
of your hardware platform, some commands described in this guide may not be
available on your Switch, although the unavailable commands may still display on
the command line interface (CLI). If you try to use an unavailable command, an
error message displays.
CAUTION: Any command that displays on the CLI, but is not described in this
guide, is not supported in Version #.# software. 3Com only supports the
commands described in this guide. Other commands may result in the loss of data,
and are entered at the user’s risk.
Organization of the
Manual
The 3Com® 3Com Router 5000 Family and Router 6000 FamilyCommand
Reference Guide lists all commands in alphabetical order. A index of commands
organized by function is provided at the end of this document.
Intended ReadershipThe manual is intended for the following readers:
■ Network administrators
■ Network engineers
■ Users who are familiar with the basics of networking
Conventions This manual uses the following conventions:
Tabl e 1 Icons
IconNotice TypeDescription
Information note Information that describes important features or instructions.
CautionInformation 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.
Page 4
4 ● 3Com Router 5000 Family and Router 6000 Family
Command Reference
Table 2 Text conventions
ConventionDescription
Screen displays This typeface represents text 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”
Fixed command
text
Variable
command text
{ x | y | ... }Alternative items, one of which must be entered, are grouped in braces
[ ]
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.”
This typeface indicates the fixed part of a command text. You must type
the command, or this part of the command, exactly as shown, and press
Return or Enter when you are ready to enter the command.
Example: The command display history-command must be entered
exactly as shown.
This typeface indicates the variable part of a command text. You must type
a value here, and press Return or Enter when you are ready to enter the
command.
Example: in the command super level, a value in the range 0 to 3 must
be entered in the position indicated by level
and separated by vertical bars. You must select and enter one of the items.
Example: in the command flow-control {hardware | none | software}, the braces and the vertical bars combined indicate that you
must enter one of the parameters. Enter either hardware, or none, or software.
Items shown in square brackets [ ] are optional.
Example 1: in the command
indicate that the parameter
with or without this parameter.
Example 2: in the command user-interface [type] first-number
[last-number] the square brackets indicate that the parameters [type]
and [last-number] are both optional. You can enter a value in place of
one, both or neither of these parameters.
Alternative items, one of which can optionally be entered, are grouped in
square brackets and separated by vertical bars.
Example 3: in the command header
text, the square brackets indicate that the parameters shell,
incoming and login
one of the parameters is allowed.
display users [all], the square brackets
all is optional. You can enter the command
[shell | incoming | login]
are all optional. The vertical bars indicate that only
Related ManualsThe 3Com Router 5000 Family and Router 6000 FamilyGetting Started Guide provides
information about installation.
The 3Com Router 5000 Family and Router 6000 FamilyConfiguration Guide provides
information about configuring your network using the commands described in this
guide.
Copyright Notice:SK_VSIR_NAME crea
All rights reserved (Sep 13 2004).rule 1 de icmp ?create...
3Com-3Com Versatile Routing Platform Software
VRP(R) software, Version 3.40, Release 0001SP03
Copyright (c) 2003-2004 Hangzhou 3Com-3Com Tech. Co.,Ltd. All rights
reserved
.
Copyright (c) 2000-2003 3Com Tech. Co.,Ltd. All rights reserved.
3Com Series Router 5000 uptime is 0 week, 0 day, 0 hour, 22 minutes
Rpu’s version information:
Router 5000 with 1 PowerPC 750 Processor
256M bytes SDRAM
32M bytes FLASH
512K bytes NVRAM
Pcb Version : RTM1RPUA.1
RPE Logic Version : RPE3.4
SBG Logic Version : 012
Small BootROM Version : 3.04
Big BootROM Version : 5.03
Config Register points to FLASH
*********************************************************
* All rights reserved (1997-2005) *
* Without the owner’s prior written consent, *
*no decompiling or reverse-engineering shall be allowed.*
*********************************************************
[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.
Page 31
●
IPULFZ
$PN3PVUFS'BNJMZBOE3PVUFS'BNJMZ
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.
ESC_< Specify the beginning of clipboard.
ESC_> Specify the end of clipboard.
<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
3Com Router 5000 Family and Router 6000 Familyaccounting commands ● 9
Command Reference
accounting commands
PurposeUse the accounting commands command to enable the system to start
per-command accounting for terminal users logged into the user interface.
Use the undo accounting commands command to stop per-command
accounting for terminal users.
Syntaxaccounting commands scheme
undo accounting commands scheme
Parametersscheme
Implements per-command accounting using the
scheme specified by the scheme command, which can
only be the terminal access controller access control
system (TACACS) scheme currently.
DefaultBy default, per-command accounting is not configured.
ExamplePerform per-command accounting on the VTY 0 user interface.
ViewThis command can be used in the following views:
■ User Interface view
DescriptionAt present, per-command accounting for terminal users is available with the
HWTACACS protocol only.
After this function is enabled on a user interface, a command statistics packet is sent
to a TACACS accounting server for statistics and accounting each time a login
terminal user executes a command.
When the TACACS accounting server becomes unavailable, the terminal user can
execute commands normally but with per-command accounting stopped. The system,
however, does not record or inform the terminal user of this event.
Page 53
10 ● acl3Com Router 5000 Family and Router 6000 Family
Command Reference
acl
PurposeUse the acl command to reference an ACL to control call-in and call-out of VTY
(Telnet and SSH) users.
Use the undo acl command to remove the ACL.
Syntaxacl acl-number { inbound | outbound }
undo acl { inbound | outbound }
Parametersacl-number
inbound
outbound
Address access control list number. Valid values are
2000 to 3999.
Controls call-in.
Controls call-out.
DefaultBy default, call-in and call-out of VTY users are not restricted.
ExampleRemove the restriction on outgoing Telnet calls.
[3Com-ui-vty0] undo acl outbound
ViewThis command can be used in the following views:
■ User Interface view
Page 54
3Com Router 5000 Family and Router 6000 Familyactivation-key ● 11
Command Reference
activation-key
PurposeUse the activation-key command to define a shortcut key or key combination
for starting a terminal session.
Use the undo activation-key command to remove the shortcut key or key
combination used to start terminal sessions.
Syntaxactivation-key character
undo activation-key
Parameterscharacter
Shortcut key or key combination for starting terminal
sessions, consisting of a string from 1 to 3 characters
or their corresponding ASCII code values in the range 0
to 127.
ExampleUse character s as the shortcut key for starting terminal sessions.
[3Com] user-interface console 0
[3Com-ui-console0] activation-key s
To verify the configuration, do the following:
Exit the terminal session on the console port, and enter <s> at the prompt of “Please
press ENTER”.
*********************************************************************
* All rights reserved (1997-2005) *
* Without the owner’s prior written consent, *
*no decompiling or reverse-engineering shall be allowed. *
*********************************************************************
User interface con0 is available.
Please press ENTER.
<3Com>
%Mar 2 18:40:27:981 2005 3Com SHELL/5/LOGIN: Console login from con0el
If the prompt for user view, <3Com> for example, appears after you
press <s>, the configuration is valid.
ViewThis command can be used in the following views:
■ User Interface view
Page 55
12 ● adv-factor3Com Router 5000 Family and Router 6000 Family
Command Reference
adv-factor
PurposeUse the adv-factor command to configure the advantage factor which is used to
count Mos and ICPIF value in a jitter voice test.
Use the undo adv-factor command to restore the default.
Syntaxadv-factor adv-number
undo adv-factor
Parametersadv-number
This command applies only to jitter voice test.
Advantage factor, used to count Mos and ICPIF value
in a jitter voice test. Valid valuds are 0 to 20.
If no value is specified, the default is 0.
ExampleConfigure advantage factor to 10.
[3Com-hwping-1-1] adv-factor 10
ViewThis command can be used in the following views:
■ HWPing test group view
Page 56
3Com Router 5000 Family and Router 6000 Familyasync mode padpos ● 13
Command Reference
async mode padpos
PurposeUse the async mode padpos command to configure a POSPAD access port.
Use the undo async mode padpos command to remove the POSPAD access port
setting.
Syntaxasync mode padpos pos-number
undo async mode padpos
Parameterspos-number
Number for the POSPAD access port. Valid values are 0
to 255.
ExampleConfigure Async1/0/0 as POSPAD access port 200.
ViewThis command can be used in the following views:
■ Asynchronous Serial Interface view
■ AUX Interface view
DescriptionAfter a POSPAD access port is configured, the access router simulates the POSPAD
device to receive packets from the connected POS terminal and sends them to the
POSPAD concentrator by performing PAD tasks.
Related Commands ■ async mode protocol
■ undo detect dsr-dtr
Page 57
14 ● async mode pos3Com Router 5000 Family and Router 6000 Family
Command Reference
async mode pos
PurposeUse the async mode pos pos-number command to create a POS access port in
nontransparent transmission and permanent TCP connection mode.
Use the async mode pos pos-numberapp ip-address port-number
command to create a POS access port in transparent transmission mode. In this mode,
the router cannot identify the POS application to which a packet belongs by resolving
the packet as it would in nontransparent mode. Therefore, when you configure a POS
access port, you must specify its corresponding POS application.
Number for the POS access interface. Valid values are 0
to 255.
ip-address
port-number
permanent
temporary
IP address of the front end processor (FEP).
Port number of the FEP.
Specifies the permanent TCP connection mode.
Specifies the temporary TCP connection mode.
ExampleConfigure Async1/0/0 as POS access port 1.
[Router-Async1/0/0] async mode pos 1
ViewThis command can be used in the following views:
■ Asynchronous Serial Interface view
■ AM Interface view
■ FCM Interface view
■ AUX Interface view
DescriptionFor the async mode pospos-number app ip-address port-number [
permanent | temporary ] command, permanent TCP connection is adopted by
default. The function of the async mode pospos-number app ip-address
port-number permanent command is the same as that of the async mode pos
pos-number app ip-address port-number command.
To accommodate to the FEP program requiring temporary TCP connection, you may
configure the async mode pos pos-number appip-address port-number
temporary command.
Page 58
3Com Router 5000 Family and Router 6000 Familyasync mode pos ● 15
Command Reference
As asynchronous and FCM interfaces operate in protocol mode by default, no POS
access port is configured by default.
An interface can receive POS packets only after it is configured as a POS access port
with POS access server enabled.
The async mode pos command has no undo form. T o cancel the command, use the
async mode protocol command.
Page 59
16 ● async mode posapp3Com Router 5000 Family and Router 6000 Family
Command Reference
async mode posapp
PurposeUse the async mode posapp command to configure the interface to operate in
POS application mode.
Use the undo async mode posapp command to disable the interface to operate
in POS application mode.
Syntaxasync mode posapp app-number
undo async mode posapp
Parametersapp-number
Number for a POS application. Valid values are 0 to 31.
A router can be configured with up to 32 POS
applications.
DefaultBy default, the interface operates in protocol mode.
ExampleConfigure asynchronous interface async1/0/0 to operate in POS application mode.
[Router-Async1/0/0] async mode posapp 1
ViewThis command can be used in the following views:
■ Asynchronous Serial Interface view
■ AUX Interface view
DescriptionFor an asynchronous interface to receive POS packets, you must configure it to
operate in POS application mode.
Page 60
3Com Router 5000 Family and Router 6000 Familyascii ● 17
Command Reference
ascii
PurposeUse the ascii command to set the type of the transmitted data to ASCII.
Syntaxascii
ParametersNone
DefaultBy default, the data type is ASCII.
ExampleSet the type of the transmitted data to ASCII.
[ftp] ascii
200 Type set to A.
ViewThis command can be used in the following views:
■ FTP C l ien t vi e w
Page 61
18 ● authentication-mode3Com Router 5000 Family and Router 6000 Family
Command Reference
authentication-mode
PurposeUse the authentication-mode command to set the authentication mode at
login.
Use the authentication-mode none command to set the authentication mode
to none, that is, no authentication at login.
Use the undo authentication-mode command to restore the default.
Performs command line authorization. HWTACACS
allows per-command authorization. An input
command is executed only after it passes
authorization.
Sets domain name of the applied AAA domain. Valid
values are a string of 1 to 24 characters.
Performs no authentication.
DefaultBy default, the authentication mode is password for TTY (asynchronous interface),
VTY, and AUX user interfaces and is none for other user interfaces.
ExampleEnable local password authentication.
[3Com-ui0] authentication-mode password
ViewThis command can be used in the following views:
■ User Interface view
DescriptionIf the domain domain-name command is configured on a VTY or Console port, all
users who log onto the router through VTY or Console port will use the configured
domain to perform AAA. The default domain and the domain name information in
the username entered at login will become invalid. The configuration of this domain
Page 62
3Com Router 5000 Family and Router 6000 Familyauthentication-mode ● 19
Command Reference
is optional. Without this configuration, the login mode of the users using the original
version of VRP does not change.
Domain configuration is valid on both VTY and Console users, while the banner
message is only valid for Telnet and Terminal users. This is because SSH client can be
provided by the third party and the interaction mode of the client cannot be
modified.
Related Commandset authentication password
Page 63
20 ● auto-config3Com Router 5000 Family and Router 6000 Family
Command Reference
auto-config
PurposeUse the auto-config command to implement the auto-config operation.
Syntaxauto-config
ParametersNone
ExampleStart the auto-config operation.
[3Com] auto-config
ViewThis command can be used in the following views:
■ System view
DescriptionEnabling auto-config is equivalent to executing commands in batch.
CAUTION:
The auto-config command is usually used at initial boot to execute commands in
batch. As this changes the current configurations and no undo form is available, you
must take caution when using it on a network where configuration is completed.
Although the auto-config function is available with vrpcfg.def, the default
configuration file, you cannot save the configuration of the auto-config
command.
The auto-config command runs these commands:
1. Enabling FTP and configuring the VTY (Telnet) and TTY (through AM interface)
users to adopt local authentication
ftp server enable
user-interface vty 0 4
authentication-mode scheme
user-interface tty user-interface-number
modem call-in
authentication-mode scheme
2. Configuring the default user name and password, enabling Telnet, FTP, and
terminal services for the default user
local-user admin password cipher admin
Page 64
3Com Router 5000 Family and Router 6000 Familyauto-config ● 21
Command Reference
level 3
service-type ftp
service-type terminal telnet
By default, the user name and password are both “admin”.
3. Detecting all the controller interfaces, including E1/T1/E3/T3 interfaces, setting
their operating status to non-channelized, generating the corresponding serial
interfaces. On the T1 interface, use the channel-set command to bundle all
the timeslots into one serial interface.
using e1
using e3
using t3
channel-set 0 timeslot-list 1-24
4. Detecting all the serial interfaces (including the logical interfaces generated by the
controller interface), encapsulating the interfaces with PPP, using PPP negotiation
to get IP addresses, and setting the interface state to UP.
link-protocol ppp
ip address ppp-negotiate
undo shutdown
5. Detecting all the Ethernet interfaces, enabling the dhcp client function, and
setting the interface state to UP.
ip address dhcp-alloc
undo shutdown
6. Detecting all the AM interfaces, setting the operating mode to flow, configuring
modem coding format (setting CountryCode to UK if there is an E1/E3 module
and if otherwise to US), and setting the interface state to UP.
async mode flow
country-code { united-kingdom | united-states }
undo shutdown
Related Commandauto-config enable
Page 65
22 ● auto-execute command3Com Router 5000 Family and Router 6000 Family
Command Reference
auto-execute command
PurposeUse the auto-execute command command to set a command to be
automatically executed.
Use the undo auto-execute command command to disable command
auto-execution.
Syntaxauto-execute command command
undo auto-execute command
Parameterscommand
Command to be automatically executed.
DefaultBy default, command auto-execution is disabled.
ExampleAllow the system to execute the telnet 10.110.100.1 command automatically
ViewThis command can be used in the following views:
■ User Interface view
DescriptionYou should be aware of the following restrictions before using the auto-execute
command command:
■ You cannot execute the auto-execute command command on the console
port.
■ When the AUX port on your router functions as the console port, you cannot
execute the auto-execute command on it.
■ These restrictions do not apply to other types of user interfaces.
When the user logs on from this interface, the system automatically executes the
command configured using the auto-execute command command and
disconnects the user connection after completing execution.
A good example is configuring the auto-execute command telnet command
to have users telnet to the specified host automatically.
Page 66
3Com Router 5000 Family and Router 6000 Familyauto-execute command ● 23
Command Reference
Take caution when using this command on a user interface. It disables you to
configure the system on the user interface.
CAUTION:
Before configuring the auto-execute command command and saving it with the
save command, make sure that means exist that allow you to access the system to
remove the configuration.
Page 67
24 ● auto-config enable3Com Router 5000 Family and Router 6000 Family
Command Reference
auto-config enable
PurposeUse the auto-config enable command to enable auto-config.
Use the undo auto-config command to disable auto-config.
Syntaxauto-config enable
undo auto-config
ParametersNone
ExampleEnable auto-config.
[3Com] auto-config enable
Disable auto-config.
[3Com] undo auto-config
ViewThis command can be used in the following views:
■ System view
DescriptionBy default, auto-config is enabled. Use the display auto-config command
to check if auto-config is enabled.
Related Commanddisplay auto-config
Page 68
3Com Router 5000 Family and Router 6000 Familybims boot request ● 25
Command Reference
bims boot request
PurposeUse the bims boot request command to enable the BIMS device to access the
branch intelligent management system (BIMS) center at startup.
Use the undo bims boot request command to disable the BIMS device to
access the BIMS center automatically at startup.
Syntaxbims boot request
undo bims boot request
DefaultBy default, the BIMS device does not access the BIMS center at startup.
ExampleConfigure the BIMS device to access the BIMS center at startup.
[3Com] bims boot request
ViewThis command can be used in the following views:
■ System view
DescriptionIf a user forcibly disables the BIMS device to access the BIMS center at startup, when
the device is restarted, it will not send messages to BIMS server. Therefore BIMS
center cannot detect that the device is restarted and the waiting for restart message
will be displayed on the interface.
Related Commandbims request
Page 69
Page 70
3Com Router 5000 Family and Router 6000 Familybims enable ● 27
Command Reference
bims enable
PurposeUse the bims enable command to enable BIMS.
Use the undo bims enable command to disable BIMS.
Syntaxbims enable
undo bims enable
DefaultBy default, BIMS is not enabled.
ExampleEnable BIMS.
[3Com] bims enable
bims is enable
ViewThis command can be used in the following views:
■ System view
Page 71
28 ● bims interval3Com Router 5000 Family and Router 6000 Family
Command Reference
bims interval
PurposeUse the bims interval command to configure the interval for accessing the BIMS
center. When the interval is set to 0, the BIMS device does not access the BIMS center
regularly.
Use the undo bims interval command to delete the interval specified for
accessing the BIMS center.
Syntaxbims interval number
undo bims interval
Parametersnumber
Interval for accessing the BIMS center (in minutes).
Valid values are 10 to 10080.
DefaultBy default, no BIMS center accessing interval is set.
ExampleSet the interval for accessing the BIMS center to 120 minutes.
[3Com] bims interval 120
ViewThis command can be used in the following views:
■ System view
Page 72
3Com Router 5000 Family and Router 6000 Familybims ip address ● 29
Command Reference
bims ip address
PurposeUse the bims ip address command to configure the IP address and port number
of the BIMS center.
Use the undo bims ip address command to delete the configuration.
Syntaxbims ip address ip-address [ port portnumber ]
undo bims ip address
Parametersip-address
portnumber
IP address of the BIMS center.
Port number used by the BIMS center.
DefaultBy default, the IP address of the BIMS center is not configured. If you do not specify a
port number when configuring the IP address of the BIMS center, port 80 applies by
default.
ExampleSet the IP address and port number of the BIMS center to 129.33.72.66 and 81
respectively.
[3Com] bims ip address 129.33.72.66 port 81
ViewThis command can be used in the following views:
■ System view
Related Commandbims interval
Page 73
30 ● bims request3Com Router 5000 Family and Router 6000 Family
Command Reference
bims request
PurposeUse the bims request command to have the BIMS device access the BIMS center.
Syntaxbims request
ExampleAccess the BIMS center.
[3Com] bims request
ViewThis command can be used in the following views:
■ System view
Related Commandbims boot request
Page 74
3Com Router 5000 Family and Router 6000 Familybims sharekey ● 31
Command Reference
bims sharekey
PurposeUse the bims sharekey command to configure the shared key between the BIMS
device and the BIMS center.
Use the undo bims sharekey command to delete the shared key.
Syntaxbims sharekey {simple | cipher } sharekey
undo bims sharekey
Parameterssharekey
simple
cipher
Shared Key between the BIMS device and the BIMS
center. The Shared Key is 16 bits long.
Displays the shared key in clear text.
Displays the shared key in ciphertext.
ExampleSet the shared key between the BIMS device and the BIMS center to
1234567812345678. It is to be displayed in clear text.
[3Com] bims sharekey simple 1234567812345678
ViewThis command can be used in the following views:
■ System view
Related Commandbims ip address
Page 75
32 ● bims source ip-address3Com Router 5000 Family and Router 6000 Family
Command Reference
bims source ip-address
PurposeUse the bims source ip-address command to specify a source IP address for
the packets sent by the BIMS device. It can be the IP address of a port on the router.
Use the undo bims source ip-address command to delete the source IP
address configured for the BIMS device.
Syntaxbims source ip-address ip-address
undo bims source ip-address
Parametersip-address
Source IP address in the packets sent by the BIMS
device.
DefaultBy default, no source IP address is configured for the BIMS device.
ExampleOn the BIMS device set the source IP address to 10.153.72.66.
[3Com] bims source ip-address 10.153.72.66
ViewThis command can be used in the following views:
■ System view
Page 76
3Com Router 5000 Family and Router 6000 Familybims specify-time ● 33
Command Reference
bims specify-time
PurposeUse the bims specify-time command to configure the BIMS device to access the
BIMS center at the specified time and if desired, configure the device to access the
BIMS center at regular intervals from then on during a specified period.
Use the undo bims specify-time command to delete the setting.
Syntaxbims specify-time hh:mm yyyy/mm/dd [ [ hh:mm yyyy/mm/dd ] period
numberdays ]
undo bims specify-time
Parametershh:mm yyyy/mm/dd
numberdays
The first and second hh:mm yyyy/mm/dd arguments
respectively specify the start time and end time for
accessing the BIMS center. If only the first argument is
specified, the BIMS device accesses the BIMS center at
that time once.
Period in days for accessing the BIMS center.
ExampleConfigure the router to access the BIMS center at 01:01 on December 12, 2004, and
from then on, to access the BIMS center at seven-day intervals until December 12,
2005 01:01. If the current time has not reached the specified start time, after the
above configuration, the router will access the BIMS center at 01:01 on December 12,
2004 and at 01:01 on December 19, 2004 after a 7*24 hours interval for the next
time.
[3Com] bims specify-time 01:01 2004/12/12 01:01 2005/12/12 period 7
ViewThis command can be used in the following views:
■ System view
DescriptionThe precision of the timer is one minute. The device will access BIMS center in one
minute after the specified time.
Page 77
34 ● binary3Com Router 5000 Family and Router 6000 Family
Command Reference
binary
PurposeUse the binary command to set data type to binary for file transfer.
Syntaxbinary
ParametersNone
ExampleEnable file transfer in binary mode.
[ftp] binary
200 Type set to B.
ViewThis command can be used in the following views:
■ FTP C l ien t vi e w
Page 78
3Com Router 5000 Family and Router 6000 Familybootfile backup ● 35
Command Reference
bootfile backup
PurposeUse the bootfile backup command to specify the backup boot file.
Syntaxbootfile backup backup-bootfile-name
Parametersbackup-bootfile-name
ExampleSpecify a backup boot file.
[3Com]bootfile backup router.bin
Set backup boot file successfully!
View information on the boot files in the Flash to verify that the backup boot file has
been successfully specified.
[3Com] bootfile dir
Available boot file(s):
’M’ = MAIN, ’B’ = BACKUP, ’S’ = SECURE
40 ● bootfile main3Com Router 5000 Family and Router 6000 Family
Command Reference
ViewThis command can be used in the following views:
■ System view
DescriptionOn a router supporting the dual image function (a Flash larger than 8 MB must be
available), three boot files are defined in the system by default: main boot file, backup
boot file, and secure boot file. The system uses them in the following order:
■ Main boot file, with the default name being main.bin and file type being M, is the
default file for system boot;
■ Backup boot file, with the default name being backup.bin and file type being B, is
the boot file used in case of the boot failure using the main boot file;
■ Secure boot file, with the default name being secure.bin and file type being S, is
the boot file used in case of the boot failure using the backup boot file. If the boot
attempts using all these files fail, the system prompts the boot failure.
This command is only available with the routers that support the dual image function.
Related Commands■ dir
■ bootfile dir
■ bootfile backup
Page 84
3Com Router 5000 Family and Router 6000 Familybye ● 41
Command Reference
bye
PurposeUse the bye command to terminate the connection to the remote SFTP server and
exit to system view as you would with the exit and quit commands.
Syntaxbye
ParametersNone
ExampleTerminate the connection to the remote SFTP server.
sftp-client> bye
[3Com]
ViewThis command can be used in the following views:
■ SFTP Client view
Page 85
42 ● bye3Com Router 5000 Family and Router 6000 Family
Command Reference
bye
PurposeUse the bye command to disconnect from the remote FTP server and exit to user
view.
Syntaxbye
ParametersNone
ExampleTerminate the connection with the remote FTP server and exit to user view.
[ftp] bye
<3Com>
ViewThis command can be used in the following views:
■ FTP C l ien t vi e w
Page 86
3Com Router 5000 Family and Router 6000 Familycd ● 43
Command Reference
cd
PurposeUse the cd command to change the current working directory of the user to the
specified directory.
Syntaxcd directory
Parametersdirectory
Name of the target directory.
DefaultThe default path for working directory is flash
ExampleChange the current working directory on the router to test.
<3Com> pwd
flash:
<3Com> cd test
<3Com> pwd
flash:/test
Change the current working directory to cflash.
<3Com> pwd
flash:
<3Com> cd clash:
<3Com> pwd
cflash:
ViewThis command can be used in the following views:
■ User view
Page 87
44 ● cd3Com Router 5000 Family and Router 6000 Family
Command Reference
cd
PurposeUse the cd command to change the current working directory path on the remote
FTP server.
Syntaxcd pathname
Parameterspathname
Path name.
ExampleChange the current working directory path to d:/temp.
[ftp] cd d:/temp
ViewThis command can be used in the following views:
■ FTP C l ien t vi e w
DescriptionYou can use this command for accessing another directory on the FTP server.
Page 88
3Com Router 5000 Family and Router 6000 Familycd ● 45
Command Reference
cd
PurposeUse the cd command to change the current path on the SFTP server. If you do not
specify the remote-path argument, the current path is displayed.
Syntaxcd [remote-path ]
Parametersremote-path
Name of a path on the server.
ExampleChange current path to d:/temp.
sftp-client> cd d:/temp
ViewThis command can be used in the following views:
■ SFTP Client view
Page 89
46 ● cdup3Com Router 5000 Family and Router 6000 Family
Command Reference
cdup
PurposeUse the cdup command to quit to the upper directory.
Syntaxcdup
ParametersNone
ExampleExit to the upper directory.
sftp-client> cdup
ViewThis command can be used in the following views:
■ SFTP Client view
Page 90
3Com Router 5000 Family and Router 6000 Familycdup ● 47
Command Reference
cdup
PurposeUse the cdup command to return from the current working directory path to the
upper directory.
Syntaxcdup
ParametersNone
ExampleChange the current working directory path to the upper directory.
[ftp] cdup
ViewThis command can be used in the following views:
■ FTP C l ien t vi e w
Page 91
48 ● close3Com Router 5000 Family and Router 6000 Family
Command Reference
close
PurposeUse the close command to terminate the connection to the remote FTP server, but
remain in FTP client view.
Syntaxclose
ParametersNone
ExampleTerminate the connection to the remote FTP server but remain in FTP client view.
[ftp] close
[ftp]
ViewThis command can be used in the following views:
■ FTP C l ien t vi e w
DescriptionThis command terminates both control connection and data connection to the
remote FTP server.
Page 92
3Com Router 5000 Family and Router 6000 Familycopy ● 49
Command Reference
copy
PurposeUse the copy command to copy a file.
Syntaxcopy filename-source filename-dest
Parametersfilename-source
filename-dest
Example<3Com> pwd
flash:
<3Com> dir
Directory of flash:/
0 -rw- 7654528 Oct 10 2002 10:10:10 system
1 -rw- 4 Aug 23 2052 15:44:54 snmpboots
2 -rw- 300 Aug 23 2052 15:45:58 vrpcfg.cfg
15621 KB total (8140 KB free)
Copy the file vrpcfg.cfg from Flash memory to the backup directory that has been
created.
<3Com> copy vrpcfg.cfg backup
Copy flash:/vrpcfg.txt to flash:/backup/vrpcfg.cfg ?[Y/N]:y
% Copied file flash:/vrpcfg.cfg to flash:/backup/vrpcfg.cfg
<3Com> dir
Directory of flash:/backup/
Name of the source file.
Name of the target file or directory.
0 -rw- 300 Aug 23 2052 15:57:46 vrpcfg.cfg
15621 KB total (8137 KB free)
Copy file tt from the Flash to the CF card.
<3Com> copy flash:/tt cflash:
ViewThis command can be used in the following views:
■ User view
DescriptionIf the name of the target file is the same with an existing directory name, the target
file is copied to the directory. If the name of the target file is the same with the name
of the existing file, the system asks whether to overwrite the exiting file.
Page 93
50 ● count3Com Router 5000 Family and Router 6000 Family
Command Reference
count
PurposeUse the count command to configure the number of packets to be sent for each
test.
Use the undo count command to restore the default.
Syntaxcount times
undo count
Parameterstimes
Number of the test packets to be transmitted. Valid
values are1 to 15.
If no value is specified, the default is 1.
ExampleSend ten packets for each test.
[Router-administrator-icmp] count 10
ViewThis command can be used in the following views:
■ HWPing Test Group view
DescriptionA test timer starts when the system sends the first test packet. In the event that the
times argument is set greater than one, the system continues to send the second one
upon receipt of the reply to the first one. If receiving no reply upon expiry of the timer,
the system sends the second and all the remaining packets likewise.
Related Commandfrequency
Page 94
3Com Router 5000 Family and Router 6000 Familydatabits ● 51
Command Reference
databits
PurposeUse the databits command to set data bits on the user interface.
Use the undo databits command to restore the default.
Syntaxdatabits { 5 | 6 | 7 | 8 }
undo databits
Parameters5
6
7
8
Five data bits.
Six data bits.
Seven data bits.
Eight data bits, which is the default.
ExampleSet data bits to 5.
[3Com-ui-aux0] databits 5
ViewThis command can be used in the following views:
■ User Interface view
DescriptionThe configuration can take effect only when the serial interface works in the
asynchronous flow mode.
Page 95
52 ● datafill3Com Router 5000 Family and Router 6000 Family
Command Reference
datafill
PurposeUse the datafill command to configure the data for padding test packets.
Use the undo datafill command to restore the default.
Syntaxdatafill string
undo datafill
Parametersstring
Data for padding test packets. Valid values are any
string less than 230 characters long. By default, test
packets are padded with characters in the range of 0
to 255 cyclically.
ExampleConfigure a packet padding string “abcd”.
[Router-administrator-icmp] datafill abcd
ViewThis command can be used in the following views:
■ HWPing Test Group view
DescriptionYou can pad HWPing test packets with any character string. If the size of a test packet
is smaller than that of the configured padding string, only a portion of the data is
used. If the size of the packet is larger, the string is used cyclically for padding.
Suppose a padding string, “abcd” is configured. If the test packet size is 3, only
“abc” is used; if it is 6, the string “abcdab" is used.
Page 96
3Com Router 5000 Family and Router 6000 Familydatasize ● 53
Command Reference
datasize
PurposeUse the datasize command to configure the size of test packets.
Use the undo datasize command to restore the default.
Syntaxdatasize size
undo datasize
Parameterssize
Table 2 Test packet size of HWPing
Test TypeCodeRangeDefault value
JitterNone68-810068
JitterG.711 A-Law16-1500172
JitterG.711 U-Law16-1500172
JitterG.729 A-Law16-150032
ICMPNone4-810056
UDPNone4-8100100
OtherNone4-81000
The configuration of packet size is only supported by ICMP, UDP and jitter tests. The
configuration voids other test types.
Test packet size in bytes, the range of which depends
on test type.
DescriptionUse the datasize command to configure the size of test packets.
Use the undo datasize command to restore the default.
ExampleSet the size of ICMP test packets to 50.
[Router-hwping-administrator-icmp] datasize 50
Page 97
54 ● debugging3Com Router 5000 Family and Router 6000 Family
Command Reference
debugging
PurposeUse the debugging command to enable system debugging.
Use the undo debugging command to disable system debugging
The duration that the debugging all command
takes effect (in minutes). Valid values are 1 to 1440.
Module name.
Debugging option.
DefaultBy default, the system disables all debugging switches.
ExampleEnable IP packet debugging.
<3Com> debugging ip packet
IP packet debugging switch is on.
ViewThis command can be used in the following views:
■ User view
DescriptionThe router provides rich debugging functions for troubleshooting networks.
Enabling debugging generates a large amount of debugging information resulting in
decreased efficiency, especially when the debugging all command is executed.
An aftermath of doing so is system crash. For these reasons, you are not encouraged
to use the debugging all command. The undo debugging all command, on
the contrary, is helpful when you want to disable all debugging switches at a time.
Related Commanddisplay debugging
Page 98
3Com Router 5000 Family and Router 6000 Familydebugging ● 55
Command Reference
debugging
PurposeUse the debugging command to enable debugging.
Use the undo debugging command to disable debugging.
Syntaxdebugging
undo debugging
ParametersNone
DefaultBy default, FTP client debugging is disabled.
ExampleEnable debugging.
[ftp] debugging
ViewThis command can be used in the following views:
■ FTP C l ien t vi e w
Page 99
56 ● debugging bims all3Com Router 5000 Family and Router 6000 Family
Command Reference
debugging bims all
PurposeUse the debugging bims all command to enable BIMS debugging.
Use the undo debugging bims all command to disable BIMS debugging.
Syntaxdebugging bims all
undo debugging bims all
DefaultBy default, BIMS debugging is disabled.
ExampleEnable BIMS debugging.
<3Com> debugging bims all
<3Com> system-view
[3Com] bims request
Now start visit the bims server .
*0.1252374 3Com BIMS/8/debug2:
The host name is:10.153.21.96, the Path is:/bims/service, Port:80
HTC_SendMessage req msg action!
[3Com]
[3Com]
*0.1253285 3Com BIMS/8/debug2:
HTC_SendMessage req msg action,ulRet = 0
*0.1253286 3Com BIMS/8/debug2:
Msgid = 2
*0.1253287 3Com BIMS/8/debug2:
The return code string is: 0
*0.1253287 3Com BIMS/8/debug2:
FileID is = 12
*0.1253288 3Com BIMS/8/debug2:
FileType is cfg
*0.1253289 3Com BIMS/8/debug2:
FileSize = 775
*0.1253289 3Com BIMS/8/debug2:
Digest = 90 1b b6 c9 2f e7 4e ec 8d 8f 5a d6 13 0d 55 3e
*0.1253290 3Com BIMS/8/debug2:
The length of the cfg file is 775
*0.1253291 3Com BIMS/8/debug2:
Come into BIMS_ExcuteDownCfg!
[3Com]
[3Com]
% FTP server has been started
[3Com]
[3Com]
% Unrecognized command found at ’^’ position.
[3Com]
bims is enable
Ready to save current build run info! ........
Current configuration has been saved to the device successfully.
*0.1271100 3Com BIMS/8/debug2:
Ok,success to deal with the download config file!
*0.1271101 3Com BIMS/8/debug2:
Page 100
3Com Router 5000 Family and Router 6000 Familydebugging bims all ● 57
Command Reference
The host name is:10.153.21.96, the Path is:/bims/service, Port:80
<3Com>
*0.1271553 3Com BIMS/8/debug2:
Have send file confirm request message,ulRet = 0
*0.1271553 3Com BIMS/8/debug2:
Msgid = 6
*0.1271554 3Com BIMS/8/debug2:
The return code string is: 0
*0.1271555 3Com BIMS/8/debug2:
Parse the Xml file Ret = 0
Table 3 Description on the fields of the debugging bims all command
FieldDescription
The host name is:10.153.21.111, the Path
is:/bims/service, Port:80
HTC_SendMessage req msg action,ulRet = The router sent a request to the BIMS center and the
Msgid = 2Type of the message from the BIMS center
The return code string is: 0The return code from the BIMS center
FileID is = 1File ID delivered by the BIMS center
FileType is cfgFile type delivered by the BIMS center
FileSize = 561File size delivered by the BIMS center
Digest = 68 65 1a e2 51 3b 3d 7e b2 b5 49
4b 7a 83 c5 2e
The length of the cfg file is 561Size of the parsed file
Come into BIMS_ExcuteDownCfg!Begin to execute the commands in the configuration