3Com 5104M-FIB User Manual

CoreBuilder® 5000

®

Distributed Management Module
Commands Guide

Software Version v6.0

http://www.3com.com/

Part No. 10012823
Published November 1999

3Com Corporation
5400 Bayfront Plaza Santa
Clara, California 95052-8145

Copyright © 1999, 3Com Corporation. All rights reserved. No part of this documentation may be
reproduced in any form or by any means or used to make any derivative work (such as translation,
transformation, or adaptation) without 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 for 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.277-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.277-7015 (Nov 1995) or FAR 52.277-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.

Federal Communications Commission Notice

This equipment was tested and found to comply with the limits for a Class A digital device, pursuant to Part
15 of the FCC Rules. These limits are designed to provide reasonable protection against harmful interference
when the equipment is operated in a commercial environment. This equipment generates, uses, and can
radiate radio frequency energy and, if not installed and used in accordance with the instruction manual, may
cause harmful interference to radio communications. Operation of this equipment in a residential area is
likely to cause harmful interference, in which case you must correct the interference at your own expense.

Canadian Emissions Requirements

This Class A digital apparatus meets all requirements of the Canadian Interference-Causing Equipment
Regulations.

Cet appareil numérique de la classe A respecte toutes les exigences du Règlement sur le matériel brouilleur
du Canada.

EMC Directive Compliance

This equipment was tested and conforms to the Council Directive 89/336/EEC for electromagnetic
compatibility. Conformity with this directive is based upon compliance with the following harmonized
standards:

EN 55022 – Limits and Methods of Measurement of Radio Interference

EN 50082-1 – Electromagnetic Compatibility Generic Immunity Standard: Residential, Commercial, and
Light Industry

Warning: This is a Class A product. In a domestic environment, this product may cause radio interference, in
which case you may be required to take adequate measures.

Compliance with this directive depends on the use of shielded cables.

Low Voltage Directive Compliance

This equipment was tested and conforms to the Council Directive 72/23/EEC for safety of electrical
equipment. Conformity with this directive is based upon compliance with the following harmonized
standard:

EN 60950 – Safety of Information Technology Equipment

VCCI Class A Compliance

This is a Class A product based on the standard of the Voluntary Control Council for Interference by
Information Technology Equipment (VCCI). If this equipment is used in a domestic environment, radio
disturbance may arise When such trouble occurs, the user may be required to take corrective actions.

Trademarks

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

3Com, the 3Com logo, CoreBuilder, LANsentry, ONsemble, PACE, and Transcend are registered trademarks
of 3Com Corporation. ONline and TriChannel are trademarks of 3Com Corporation. 3Com Facts is a service
mark of 3Com Corporation.

Sun is a registered trademark of Sun Microsystems, Inc. UNIX is a registered trademark in the United States
and other countries, licensed exclusively through X/Open Company, Ltd.

DEC and DEC net are registered trademarks of Compaq Computer Corporation.

IPX and Novell are registered trademarks of Novell, Inc.

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

C

ONTENTS

BOUT THIS GUIDE

A

Introduction 13
Audience 13
How to Use This Guide 13
Conventions 13
Related Documents 14

NTRODUCTION

I

Management Command Conventions 1-1
Management Commands 1-2

ANAGEMENT COMMANDS

M

?2-2
BOOTP 2-3
CLEAR ATM 2-4
CLEAR BOOTP 2-5
CLEAR BPORT_LEC ELAN_NAME 2-6
CLEAR BPORT_LEC LECS_ATM_ADDRESS 2-7
CLEAR BPORT_LEC LES_ATM_ADDRESS 2-8
CLEAR BRIDGE_PORT NAME 2-9
CLEAR COMMUNITY 2-10
CLEAR COUNTER 2-11
CLEAR EVENT SCRIPT 2-13
CLEAR GROUP 2-14
CLEAR HOST 2-15
CLEAR IP 2-16
CLEAR IP ARP_CACHE 2-17
CLEAR LOG 2-18
CLEAR LOG MODULE EVENT_LOG 2-19
CLEAR LOGIN 2-20
CLEAR PROTOCOLS 2-21
CLEAR RMON 2-22
CLEAR SCHEDULE 2-23
CLEAR SCRIPT 2-24
CLEAR SECURITY AUTOLEARN 2-25
CLEAR SECURITY INTRUDER_LIST 2-26
CLEAR SECURITY PORT 2-27
CLEAR TFTP RESULT 2-28
CLEAR TR_SURROGATE 2-29
CLEAR VBRIDGE 2-30
CLEAR VBRIDGE IGMP_SNOOPING 2-31

COPY SCRIPT 2-32
DOWNLOAD FROM_DEVICE 2-33
DOWNLOAD IN_BAND 2-34
DOWNLOAD OUT_OF_BAND 2-37
LOGOUT 2-39
MAINTAIN 2-40
MONITOR 2-41
PING 2-43
RESET DEVICE 2-44
RESET HUB 2-45
RESET MASTERSHIP 2-46
RESET MODULE 2-47
REVERT 2-48
RUN SCRIPT 2-49
SAVE 2-50
SET 2-52
SET ALERT 2-53
SET ATM ILMI 2-55
SET ATM LEARP_QUIET_TIME 2-56
SET ATM NEIGHBOR IF_NAME 2-57
SET ATM NEIGHBOR IP_ADDRESS 2-58
SET ATM NUM_LECS 2-59
SET ATM NUM_VCCS 2-60
SET ATM Q93B 2-61
SET ATM QSAAL 2-63
SET ATM SIGNAL 2-65
SET ATM UNI_VERSION 2-66
SET ATM VPI_VCI_BITS 2-67
SET BOOTP MODULE 2-68
SET BOOTP POWER_UP_MODE 2-69
SET BOOTP SERVER_IP_ADDRESS 2-70
SET BPORT_LEC BUS_RATE_LIMIT 2-71
SET BPORT_LEC CONFIG_MODE 2-72
SET BPORT_LEC ELAN_NAME 2-73
SET BPORT_LEC ELAN_TYPE 2-74
SET BPORT_LEC FRAME 2-75
SET BPORT_LEC LEC_DEFAULTS 2-76
SET BPORT_LEC LECS_ATM_ADDRESS 2-77
SET BPORT_LEC LES_ATM_ADDRESS 2-78
SET BPORT_LEC LINK_TRAP 2-79
SET BPORT_LEC MODE 2-80
SET BPORT_LEC MAX_RETRY_COUNT 2-81
SET BPORT_LEC TIME 2-82
SET BPORT_LEC NUM_ELAN_VCCS 2-84
SET BPORT_MAU ALERT_FILTER 2-85
SET BPORT_MAU AUTO_NEGOTIATE 2-86
SET BPORT_MAU AUTO_POLARITY 2-87
SET BPORT_MAU CONFIGURATION 2-88
SET BPORT_MAU DUPLEX_MODE 2-89
SET BPORT_MAU HIGH_POWER 2-90
SET BPORT_MAU LINK_INTEGRITY 2-91
SET BPORT_MAU PACE_MODE 2-92
SET BPORT_MAU MODE 2-93
SET BPORT_MAU REMOTE_DIAGNOSTICS 2-95
SET BPORT_MAU RESET_MODE 2-96
SET BPORT_MAU SQUELCH 2-97

SET BRIDGE_PORT INTERFACE 2-98
SET BRIDGE_PORT MONITOR 2-99
SET BRIDGE_PORT NAME 2-100
SET BRIDGE_PORT SMT 2-101
SET BRIDGE_PORT STP BRIDGE_MODE 2-102
SET BRIDGE_PORT STP PATH_COST 2-103
SET BRIDGE_PORT STP PRIORITY 2-104
SET BRIDGE_PORT VBRIDGE 2-105
SET CLOCK 2-106
SET COMMUNITY 2-107
SET DEVICE CONTACT 2-108
SET DEVICE DIAGNOSTICS 2-109
SET DEVICE DIP_CONFIGURATION 2-110
SET DEVICE LOCATION 2-111
SET DEVICE MAC_ADDR_ORDER 2-112
SET DEVICE NAME 2-113
SET DEVICE RESET_MASTERSHIP 2-114
SET DEVICE TRAP_RECEIVE 2-115
SET GROUP MODE 2-116
SET GROUP NAME 2-117
SET GROUP NETWORK 2-118
SET GROUP PORT 2-119
SET HOST 2-120
SET INVENTORY NOTEPAD 2-121
SET IP ACTIVE_DEFAULT_GATEWAY 2-122
SET IP DEFAULT_GATEWAY 2-123
SET IP IP_ADDRESS 2-124
SET IP SUBNET_MASK 2-126
SET LOGIN 2-127
SET MODULE ANALYZER 2-130
SET MODULE ARP_RESOLVE_METHOD 2-131
SET MODULE AUTOPARTITION_THRESHOLD 2-132
SET MODULE BCN_THRESHOLD 2-133
SET MODULE CABLE_IMPEDANCE 2-134
SET MODULE CONNECTOR_NETWORK 2-135
SET MODULE CROSSOVER 2-136
SET MODULE DLM_MODE 2-137
SET MODULE DOT5_GROUP 2-138
SET MODULE EARLY_TOKEN_RELEASE 2-139
SET MODULE EXTERNAL_WRAP 2-140
SET MODULE FIFO_FILL_LEVEL 2-141
SET MODULE HOST_STATISTICS 2-142
SET MODULE IGMP_SNOOPING 2-143
SET MODULE INTERFACE 2-144
SET MODULE INTERNAL_WRAP 2-145
SET MODULE LOCALLY_ADMINISTERED_ADDRESS 2-146
SET MODULE LOW_LIGHT_WARNING 2-147
SET MODULE MAC_ADDRESS_TYPE 2-148
SET MODULE MAC_PATH 2-149
SET MODULE MASTERSHIP_PRIORITY 2-150
SET MODULE MAXIMUM_VBRIDGE 2-151
SET MODULE MEMORY_MODEL 2-152
SET MODULE MODULE_BYPASS 2-153
SET MODULE MONITOR_CONTENTION 2-154
SET MODULE NETWORK 2-155
SET MODULE PER_ PORT_COUNTERS_ CONNECTOR 2-157

SET MODULE PHY_AUTOMATIC_FAILOVER 2-158
SET MODULE PHY_SELECTION 2-159
SET MODULE PROBE_MODE 2-160
SET MODULE RING_SPEED 2-161
SET MODULE RMON_

statistics group

2-162
SET MODULE RMON_GROUP 2-163
SET MODULE SPEED_THRESHOLD 2-164
SET MODULE SURROGATE_GROUP 2-165
SET MODULE SYSTEM_ANALYZER 2-166
SET NETWORK TOKEN_RING BCN_RECOVERY 2-167
SET NETWORK TOKEN_RING MISMATCH_RESOLUTION 2-168
SET NETWORK TOKEN_RING MODE 2-169
SET NETWORK TOKEN_ RING PURGE_ON_INSERT 2-171
SET NETWORK TOKEN_RING RING_SPEED 2-172
SET PORT ACTIVE_CONNECTOR 2-173
SET PORT ALERT_FILTER 2-174
SET PORT AUTO_POLARITY 2-175
SET PORT AUTOSENSE 2-176
SET PORT COLLISION 2-177
SET PORT FAN_OUT_MODE 2-178
SET PORT FORCE_CONFIGURATION 2-179
SET PORT HALF_STEP 2-180
SET PORT HIGH_POWER 2-181
SET PORT LINK_INTEGRITY 2-182
SET PORT LOW_LIGHT_WARNING 2-183
SET PORT MODE 2-184
SET PORT MODE LOCAL/REMOTE 2-185
SET PORT MODE REDUNDANT/NON_REDUNDANT 2-186
SET PORT MODE DIAGNOSTICS 2-187
SET PORT MODE REMOTE_FAILURE_SIGNALING 2-188
SET PORT MODE SHUTDOWN 2-189
SET PORT NETWORK 2-190
SET PORT PERSONALITY 2-192
SET PORT RECEIVE_JABBER 2-193
SET PORT RING_SPEED 2-194
SET PORT SPEED_DETECT 2-195
SET PORT SQE_TEST 2-196
SET PORT SQUELCH 2-197
SET PORT STATIC_SWITCH 2-198
SET PORT STATION_TYPE 2-199
SET PORT TYPE 2-200
SET POWER MODE 2-201
SET POWER MODULE POWER_REQUIREMENTS 2-202
SET POWER OVERHEAT_AUTO_POWER_DOWN MODE 2-203
SET POWER SLOT CLASS 2-204
SET POWER SLOT MODE 2-205
SET PROTOCOLS FORWARDING 2-206
SET PROTOCOLS RATE_LIMIT_THRESHOLD 2-208
SET PROTOCOLS TRANSLATION 2-209
SET RMON ALARM 2-210
SET RMON EVENT 2-212
SET RMON HISTORY 2-213
SET RMON HOST INTERFACE 2-214
SET RMON MATRIX 2-215
SET RMON STATISTICS 2-216
SET RMON TOPN_HOSTS 2-217

SET SCHEDULE 2-219
SET SCHEDULE HOLIDAY 2-221
SET SCHEDULE STARTUP_REPLAY_TIME 2-222
SET SCHEDULE WEEKDAY 2-223
SET SCHEDULE WEEKEND 2-224
SET SCRIPT DELETE 2-225
SET SCRIPT INSERT 2-226
SET SCRIPT NAME 2-227
SET SCRIPT OVERWRITE 2-228
SET SCRIPT RUN_ON_EVENT 2-229
SET SECURITY AUTOLEARN CAPTURE 2-230
SET SECURITY AUTOLEARN DOWNLOAD 2-231
SET SECURITY AUTOLEARN MAC_ADDRESS 2-233
SET SECURITY AUTOLEARN MASK 2-234
SET SECURITY PORT ACTION_ON_INTRUSION 2-235
SET SECURITY PORT MAC_ADDRESS 2-236
SET SECURITY PORT MODE 2-237
SET SECURITY_ADVANCED ADDRESS_TABLE ADDRESS 2-238
SET SECURITY_ADVANCED INTRUDER_TABLE DELETE 2-239
SET SECURITY_ADVANCED NETWORK AUTOLEARNING 2-240
SET SECURITY_ADVANCED NETWORK EAVESDROP_PROTECTION 2-241
SET SECURITY_ADVANCED NETWORK INTRUDER_JAMMING 2-242
SET SECURITY_ADVANCED NETWORK INTRUDER_PORT_DISABLING 2-243
SET SECURITY_ADVANCED NETWORK INTRUDER_REPORTING 2-244
SET SECURITY_ADVANCED NETWORK MODE 2-245
SET SECURITY_ADVANCED NETWORK SOURCE_ADDRESS_CHECKING 2-246
SET SECURITY_ADVANCED NETWORK SOURCE_PORT_CHECKING 2-247
SET SECURITY_ADVANCED PORT AUTOLEARN 2-248
SET SECURITY_ADVANCED PORT FAILSAFE 2-249
SET SECURITY_ADVANCED PORT GROUP_CODE_(A,B) 2-250
SET SECURITY_ADVANCED PORT INTRUDER_CHECKING 2-251
SET SECURITY_ADVANCED PORT JAMMING 2-252
SET SONET CLOCK_SOURCE 2-253
SET TERMINAL BAUD 2-254
SET TERMINAL DATA_BITS 2-255
SET TERMINAL HANGUP 2-256
SET TERMINAL MODE 2-257
SET TERMINAL PARITY 2-258
SET TERMINAL PROMPT 2-259
SET TERMINAL STOP_BITS 2-260
SET TERMINAL TERMINAL_TYPE 2-261
SET TERMINAL TIMEOUT 2-262
SET TFTP FILE_NAME 2-263
SET TFTP SERVER_IP_ADDRESS 2-264
SET TR_SURROGATE CRS_STATION 2-265
SET TR_SURROGATE CRS_STATUS 2-266
SET TR_SURROGATE REM_STATUS 2-267
SET TR_SURROGATE SURR_STATUS 2-269
SET TRUNK CABLE_MONITOR 2-270
SET TRUNK COMPATIBILITY_MODE 2-271
SET TRUNK EXTERNAL_BEACON_RECOVERY 2-272
SET TRUNK MODE 2-273
SET TRUNK NETWORK 2-274
SET TRUNK NETWORK_MAP 2-275
SET TRUNK STATIC_SWITCH 2-276
SET VBRIDGE AFT AGING_TIME 2-277

SET VBRIDGE AFT ALL 2-278
SET VBRIDGE AFT BRIDGE_PORT 2-279
SET VBRIDGE AFT MAC 2-281
SET VBRIDGE IGMP_SNOOPING MODE 2-283
SET VBRIDGE IGMP_SNOOPING GROUP AGE_TIME 2-284
SET VBRIDGE IGMP_SNOOPING PORT AGE_TIME 2-285
SET VBRIDGE IGMP_SNOOPING QUERY_INTERVAL 2-286
SET VBRIDGE IGMP_SNOOPING QUERY LISTEN_TIME 2-287
SET VBRIDGE IGMP_SNOOPING QUERY MODE 2-288
SET VBRIDGE IGMP_SNOOPING QUERY RESET_TO_DEFAULT 2-289
SET VBRIDGE IGMP_SNOOPING ROUTER_PORT 2-290
SET VBRIDGE INTERFACE 2-291
SET VBRIDGE NAME 2-292
SET VBRIDGE STP BRIDGE_FORWARD_DELAY 2-293
SET VBRIDGE STP BRIDGE_HELLO_TIME 2-294
SET VBRIDGE STP BRIDGE_MAX_AGE 2-295
SET VBRIDGE STP MODE 2-296
SET VBRIDGE STP PRIORITY 2-297
SET VBRIDGE STP RESET_TO_DEFAULT 2-298
SHOW ALERT 2-299
SHOW ALERT BRIDGE_PORT 2-300
SHOW ATM INTERFACE 2-301
SHOW ATM ILMI_CONFIGURATION 2-302
SHOW ATM Q93B 2-303
SHOW ATM QSAAL 2-304
SHOW ATM SIGNAL_CONFIGURATION 2-305
SHOW ATM STATISTICS 2-306
SHOW ATM TRAFFIC_DESCRIPTOR 2-307
SHOW ATM VCC 2-308
SHOW BACKPLANE_PATHS 2-309
SHOW BOOTP 2-312
SHOW BPORT_LEC CONFIGURATION 2-313
SHOW BPORT_LEC LEARP_TABLE 2-315
SHOW BPORT_LEC SERVER_CIRCUITS 2-316
SHOW BPORT_LEC STATISTICS 2-317
SHOW BPORT_LEC STATUS 2-318
SHOW BPORT_MAU 2-319
SHOW BRIDGE_PORT 2-320
SHOW CLOCK 2-321
SHOW COMMUNITY 2-322
SHOW COUNTER 2-323
SHOW DEVICE 2-334
SHOW DLM 2-335
SHOW GROUP 2-336
SHOW HOST 2-337
SHOW HUB 2-338
SHOW IGMP_SNOOPING 2-340
SHOW INTERFACE 2-341
SHOW INVENTORY 2-342
SHOW IP 2-344
SHOW LOG EVENT_LOG 2-346
SHOW LOG MODULE EVENT_LOG 2-347
SHOW LOG TRAP_LOG 2-348
SHOW LOGIN 2-349
SHOW MODULE 2-350
SHOW NETWORK 2-354

SHOW PORT 2-358
SHOW POWER 2-362

SHOW PROTOCOLS 2-364
SHOW RING_MAP 2-366
SHOW RMON CONTROL 2-369
SHOW RMON DISTRIBUTION ETHERNET DATA 2-371
SHOW RMON HISTORY DATA 2-372
SHOW RMON HOST DATA 2-374
SHOW RMON MATRIX DATA 2-375
SHOW RMON STATISTICS 2-376
SHOW RMON TOPN_HOSTS DATA 2-377
SHOW ROVING_ANALYSIS_PORT 2-378
SHOW SCHEDULE 2-380
SHOW SCRIPT 2-381
SHOW SECURITY AUTOLEARN 2-382
SHOW SECURITY ETHERNET_MAP 2-383
SHOW SECURITY INTRUDER_LIST 2-384
SHOW SECURITY PORT 2-385
SHOW SECURITY_ADVANCED ADDRESS_TABLE 2-386
SHOW SECURITY_ADVANCED INTRUDER_TABLE 2-387
SHOW SECURITY_ADVANCED NETWORK 2-388
SHOW SECURITY_ADVANCED PORT 2-389
SHOW SECURITY ETHERNET_MAP 2-390
SHOW SONET STATISTICS 2-391
SHOW SONET STATUS 2-394
SHOW TERMINAL 2-395
SHOW TFTP 2-396
SHOW TR_SURROGATE CRS_STATION 2-398
SHOW TR_SURROGATE CRS_STATUS 2-400
SHOW TR_SURROGATE REM_ERROR_MAC_FRAME 2-401
SHOW TR_SURROGATE REM_ISOLATING 2-402
SHOW TR_SURROGATE REM_LAST_BEACON 2-403
SHOW TR_SURROGATE REM_LAST_SOFT_ERROR 2-405
SHOW TR_SURROGATE REM_SOFT_ERROR 2-407
SHOW TR_SURROGATE REM_STATUS 2-408
SHOW TR_SURROGATE REM_THRESHOLD_EXCD 2-409
SHOW TR_SURROGATE SURR_STATUS 2-410
SHOW TRUNK 2-412
SHOW VBRIDGE AFT 2-413
SHOW VBRIDGE CONFIGURATION 2-415
SHOW VBRIDGE IGMP_SNOOPING BRIDGE_PORT 2-416
SHOW VBRIDGE IGMP_SNOOPING IP 2-417
SHOW VBRIDGE IGMP_SNOOPING IP ALL 2-418
SHOW VBRIDGE IGMP_SNOOPING IP BRIDGE_PORT 2-419
SHOW VBRIDGE IGMP_SNOOPING MAC 2-420
SHOW VBRIDGE IGMP_SNOOPING MAC ALL 2-421
SHOW VBRIDGE IGMP_SNOOPING ROUTER_PORTS 2-422
SHOW VBRIDGE IGMP_SNOOPING STATUS 2-423
TELNET 2-424
UPLOAD IN_BAND DEVICE CONFIGURATION 2-425

ECHNICAL SUPPORT

T

Online Technical Services A-1
Support from Your Network Supplier A-2
Support from 3Com A-3
Returning Products for Repair A-4

3COM C

ORPORATION LIMITED WARRANTY

A

BOUT

T

HIS

G

UIDE

Introduction

Audience

How to Use This Guide

This guide describes the commands used to manage 3Com devices in the 3Com
CoreBuilder
Distributed Management Module (DMM) interface. Use this guide to find specific
information about hub management commands available from the DMM
command-line parser. Refer to the CoreBuilder 5000 Distributed Management
Module User Guide for instructions on installing, configuring, and using the
module.

If the information in the release notes shipped with your product differs from the
information in this guide, follow the release note instructions.

This guide is intended for the following people at your site:

■

Network manager or administrator

■

Trained hardware installer or service personnel

Table 1 shows the location of specific information.

Ta b le 1

If you are looking for Turn to

An overview of the DMM command line parser Chapter 1

A comprehensive list of commands available for managing hubs
using the DMM command line interface

Instructions for contacting the 3Com technical support
organization and for accessing other product support services

®

5000 Integrated System Hub, using the CoreBuilder 5000

How to Use This Guide

Chapter 2

Appendix A

Conventions

Table 2 and Table 3 list conventions used throughout this guide.

Ta b le 2

Icon Notice Type Alerts you to

Graphic Conventions

Information note Important features or instructions

Caution Risk of personal safety, system damage, or loss of data

Warning Risk of severe personal injury

14

A

BOUT THIS GUIDE

Related Documents

3Com Documents

Ta b le 3

Convention Description

“Enter” vs. “Type” When the word “enter” is used in this guide, it means type something,

Text represented as

screen display

Text represented as

commands

Italics Italics are used to denote new terms or emphasis. In command

Text Conventions

then press the Return or Enter key. Do not press the Return or Enter key
when an instruction simply says “type.”

This ty pe fac e

terminal screen. For example:

NetLogin:
This ty pe fac e

example:

SETDefault !0 -IP NETaddr = 0.0.0.0

“Format” sections, italics denote variables for which you provide one of
the allowed values.

is used to represent displays that appear on your

is used to represent commands that you enter. For

This section provides information on supporting documentation, including:

■

3Com Documents

■

Reference Documents

The following document provide additional information on 3Com products:

Reference Documents

■

CoreBuilder 5000 Quick Start and Reference Guide — Provides information on
the installation, operation, and configuration of the CoreBuilder 5000 hub.
This guide also describes the principle features of the CoreBuilder 5000
Fault-Tolerant Controller Module.

■

CoreBuilder 5000 Distributed Management Module User Guide — Provides
information on the CoreBuilder 5000 Distributed Management Module’s
operation, installation, and configuration. This guide also describes the
software commands associated with the Distributed Management Module.

For a complete list of 3Com documents, contact your 3Com representative.

The following documents supply related background information:

Case, J., Fedor, M., Scoffstall, M., and J. Davin

, The Simple Network

Management Protocol, RFC 1157, University of Tennessee at Knoxville,

Performance Systems International and the MIT Laboratory for Computer Science,
May 1990.

Rose, M., and K. McCloghrie

, Structure and Identification of Management

Information for TCP/IP-based Internets, RFC 1155, Performance Systems

International and Hughes LAN Systems, May 1990.

1

I

NTRODUCTION

This chapter contains the following sections:

■

Management Command Conventions

■

Management Commands

Management
Command
Conventions

Understanding

Command Conventions

Using Terminal

Keystrokes

Table 4 describes the command conventions used in this document.

Ta b le 4

Convention Definition and Example

System Output

Terminal Prompt System prompt is shown as

User Defined Input Indicated by

You manage the CoreBuilder
entering commands at the management prompt on the terminal console, or
remotely using TELNET. Commands are not case-sensitive (that is, you can use
uppercase and lowercase characters with equal effect), with the exception of the
SET COMMUNITY command.

In addition to alphanumeric characters, terminal input for the DMM includes basic
keyboard functions and control sequences. For example, you can correct typing
mistakes by pressing the Delete key or the Backspace key. Pressing Enter in the
middle of a command entry when an argument is expected causes the DMM to
prompt you for additional information. Terminal keystrokes and their functions are
outlined in Table 5.

Ta b le 5

Command Conventions

Courier

Keystroke Functions

typeface

CB5000>

bold cour ie r te xt

®

5000 Distributed Management Module (DMM) by

Keystroke Function

Backspace Moves the cursor back one character and deletes that character.

Ctrl+C Terminates the current command and returns to a blank command line at any

time.

Ctrl+D Closes a TELNET session.

Ctrl+R Retypes the previous command string on the command line.

Delete Same as Backspace.

Enter Enters the command.

spacebar Completes a command through command completion (refer to next section).

? Displays the available command options.

C

2

HAPTER

1: I

NTRODUCTION

Using the Command

Completion Feature

Management Commands

Command completion allows the DMM interface to accept abbreviated command
input. When using command completion, you need only enter a minimum
number of characters to distinguish the command from other acceptable choices
and press Space to complete the command. For example, if you type:

sa

Press the spacebar and the command is completed as follows:

save

If the characters entered are not sufficient to determine a unique command, the
DMM waits for more characters to be entered. For example, entering the letter s
and pressing the spacebar is not sufficient for the DMM to determine which
command to issue because commands other than SAVE start with the letter s (for
example, SET, SHOW).

Chapter 2 provides an alphabetized list of Distributed Management Module
(DMM) commands.

Each description includes:

■

One or more examples outlining the proper syntax for the command

■

Parameter options

Entering Management

Commands

Entering Parameters

■

Corresponding terminal responses

Enter management commands at the management prompt. By default, the
management prompt is

CB5000>

. Refer to the SET TERMINAL PROMPT
command in Chapter 2 for information about customizing the default
management prompt.

The DMM management software has an intelligent parser that recognizes
modules.

■

If you enter an invalid parameter for a module type:

The parser backspaces over the invalid parameter.

■

The DMM waits for you to complete the command line with a valid

■

parameter.

■

If you attempt to set a parameter to the same setting it is currently configured
for:

A message is displayed that reiterates the setting.

■

The parser sends a

■

Command aborted

message.

2

M

ANAGEMENT

This section provides an alphabetized list of CoreBuilder® 5000 Distributed
Management Module (DMM) commands.

Each description includes:

■

Format for the command, including parameter options

■

Examples, including corresponding terminal responses

■

Related commands

For information on CoreBuilder 5000 Switched FastModules, refer to the

CoreBuilder 5000 FastModule User Guide.

For information on CoreBuilder 5000 SwitchModules, refer to the

CoreBuilder 5000 SwitchModule User Guide.

C

OMMANDS

2-2

?

?

Use the ? command to list available command choices and parameter options.

Format

Example

any command

To view the available management commands, use the following command

?

after you log in using the administrator password:

CB5000> ?

Possible completions:

bootp
clear
copy
download
logout
maintain
monitor
ping
reset
revert
run
save
set
show
telnet
upload

The ? character does not appear on the screen after you enter it.

BOOTP

bootp

2-3

BOOTP

Related Commands

Format

Example

Use the BOOTP command to download configuration information from the
bootptab file on a BootP server to a DMM. BootP (Bootstrap Protocol) is a UDP/
IP-based protocol (User Datagram Protocol/Internet Protocol) that allows a device
to configure itself dynamically without user intervention.

The following command initiates the BootP function on the DMM:

CB5000 > bootp

CLEAR BOOTP
SET BOOTP MODULE
SET BOOTP POWER_UP_MODE
SET BOOTP SERVER_IP_ADDRESS
SHOW BOOTP

2-4

CLEAR ATM

CLEAR ATM

Related Commands

Format

Example

Use the CLEAR ATM command to clear the ATM’s if_Name (interface name) for
the ATM-layer interface.

clear atm

slot Identifies the slot for this operation. slot (1 through 17) is the slot

name Use up to 63 characters for the ifName.

slot

number.

if_name

name

The following command clears the ATM if_name (Test) from the ATM module in
slot 4.

CB5000> cl ear atm 4 if_na me Test

Slot 04 parameter cleared.

SET ATM NEIGHBOR IF_NAME
SHOW ATM INTERFACE

CLEAR BOOTP

clear bootp

module

result

2-5

CLEAR BOOTP

Related Commands

Format

Example

Use the CLEAR BOOTP command to clear current BootP settings.

module

result

Clears any setting made using the SET BOOTP MODULE
command.

Clears the result stored for the last BootP operation.

The following command clears BootP configuration settings from the DMM:

CB5000 > clear bootp module
BootP module configurations cleared.

BOOTP
SET BOOTP MODULE
SET BOOTP POWER_UP_MODE
SET BOOTP SERVER_IP_ADDRESS
SHOW BOOTP

CLEAR BPORT_LEC ELAN_NAME

2-6

CLEAR BPORT_LEC
ELAN_NAME

Format

Use the CLEAR BPORT_LEC ELAN_NAME command to clear the name of the
configured LAN (ELAN) associated with the LAN Emulation Client (LEC).

The value of the ELAN name may or may not be taken into account by the LAN
Emulation Configuration Server (LECS) and LAN Emulation Server (LES),
depending on the policy configured on those servers.

BPORT is an abbreviation for Bridge Port.

LEC ports are logical ports, all of which overlay one physical ATM/Synchronous
Optical Network (SONET) port.

clear bport_lec elan_name

slot.lec Identifies the slot and lec for this operation.

slot (1 through 17) is the slot number and

Emulation Clients defined as logical ports for the ATM Backbone
SwitchModule. For example, to identify LEC 32 on the ATM Backbone
SwitchModule in slot 4, enter

name Specifies the name (up to 63 characters) of the LAN associated with the

LEC.

slot.lec

4.32

name

lec is one of up to 64 LAN

Example

Related Commands

The following command clears the name of the LEC in slot 4, port 1 to Main:

CB5000> cl ear bport_lec 4.1 elan_name Main
Bridge Port 04.01 parameter cleared.

SET BPORT_LEC ELAN_NAME
SHOW BPORT_LEC CONFIGURATION

CLEAR BPORT_LEC LECS_ATM_ADDRESS

clear bport_lec lecs_atm_address

ATM address

slot. lec

2-7

CLEAR BPORT_LEC
LECS_ATM_ADDRESS

Format

Use the CLEAR BPORT_LEC LECS_ATM_ADDRESS command to clear the
configured ATM address of the LAN Emulation Configuration Server

(

LECS).

The ATM address is 20 hexadecimal numbers separated by periods. Each
number can range from 0 to FF. However, the following addresses are illegal:

■

0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0

■

F F. F F. F F. F F. F F. F F. F F. F F. F F. F F. F F. F F. F F. F F. F F. F F. F F. F F. F F. F F

BPORT is an abbreviation for Bridge Port.

LEC ports are logical ports, all of which overlay one physical ATM/Synchronous
Optical Network (SONET) port.

slot.lec Identifies the slot and LEC for this operation.

slot (1 through 17) is the slot number and

Emulation Clients defined as logical ports for the ATM Backbone
SwitchModule. For example, to identify LEC 32 on the ATM Backbone
SwitchModule in slot 4, enter

ATM address Specifies the ATM address of the LAN Emulation Configuration Server

(LECS).

4.32

lec is one of up to 64 LAN

Example

Related Commands

The following command clears the ATM address of the LECS in slot 4, port 1:

CB5000> clear bport_lec 4.1 lecs_a tm_address

39.99.99.99.ac.00.00.00.

00.99.99.01.02.03.04.05.06.07.08.00

Bridge Port 04.01 parameter cleared.

SET BPORT_LEC LECS_ATM_ADDRESS
SHOW BPORT_LEC CONFIGURATION

CLEAR BPORT_LEC LES_ATM_ADDRESS

2-8

CLEAR BPORT_LEC
LES_ATM_ADDRESS

Format

Use the CLEAR BPORT_LEC LES_ATM_ADDRESS command to clear the
configured LAN Emulation Server (LES) ATM address.

The ATM address is 20 hexadecimal numbers separated by periods. Each
number can range from 0 to FF. However, the following addresses are illegal:

■

0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0

■

FF.FF.FF.FF.FF.FF.FF.FF.FF.FF.FF.FF.FF.FF.FF.FF.FF.FF.FF.FF

BPORT is an abbreviation for Bridge Port.

LEC ports are logical ports, all of which overlay one physical ATM/Synchronous
Optical Network (SONET) port.

clear bport_lec les_atm_address

slot.lec Identifies the slot and LEC for this operation.

ATM address Specifies the ATM address of the LES.

slot.lec

slot (1 through 17) is the slot number and

Emulation Clients defined as logical ports for the ATM Backbone
SwitchModule. For example, to identify LEC 32 on the ATM Backbone
SwitchModule in slot 4, enter

4.32

lec is one of up to 64 LAN

ATM address

Example

Related Commands

The following command clears the ATM address of the LES in slot 4, port 1:

CB5000> clear bpo rt_lec 4.1 les_atm_ad dress 39.00.99.99.99.99.ac.

00.99.99.99.99.99.99.99.99.99.99.99.99

Bridge Port 04.01 parameter cleared.

SET BPORT_LEC LES_ATM_ADDRESS
SHOW BPORT_LEC CONFIGURATION

CLEAR BRIDGE_PORT NAME

clear bridge_port name

slot.port

name

slot.

all

2-9

CLEAR BRIDGE_PORT
NAME

Format

Example

Related Command

Use the CLEAR BRIDGE_PORT NAME command to clear a bridge port name.
When you enter this command, you can specify one bridge port name or all
bridge port names.

slot.port Identifies the port for this operation.

slot is the slot number (1 through 17) and port is the port number. For

example, to identify port 4 on the module in slot 6, enter

slot.

all

name Specifies the name (up to 32 characters) you want to identify this port.

Clears all bridge port names in a particular slot.

6.4

The following command clears the name finance_1 to port 3 on the
SwitchModule in slot 5:

CB5000 > c lear bridge_port 5.3 name finance_1

SET BRIDGE_PORT NAME

2-10

CLEAR COMMUNITY

CLEAR COMMUNITY

Format

Example

Related Commands

Use the CLEAR COMMUNITY command to delete an entry from the community
table. Community tables establish groups of stations that can exchange
information with the DMM agent.

clear community

all

1...10

all

1...10 Clears just the entry you specify. For example, if you enter CLEAR COMMUNITY

Clears all community table entries.

2, the management hub clears community table entry #2. Use the SHOW
COMMUNITY command to display a list of numbered entries.

The following command clears community table entry #5:

CB5000> clear community 5
Community 5 cleared.

SET COMMUNITY
SHOW COMMUNITY

CLEAR COUNTER

clear counter

aft

ethernet

token_ring

repeater

rmon

all

ring_station

tr_mac_layer

tr_promiscuous

tr_source_routing

network

module

slot

network

port

slot.port

fast_ethernet

interface

ip_fragmentation

bridge_port

slot.port

slot

.all

ethernet

fddi_mac

fddi_port

interface

peak_rates

all

igmp_snooping

1 or 2

packet_channel

network

network

network

module

module

100BASE_X

2-11

CLEAR COUNTER

Use the CLEAR COUNTER command to reset to zero DMM counters or a specific
group of DMM counters.

The CLEAR COUNTER command does not affect counters reported by SNMP,
which are always stored as absolute values, as specified in the SNMP standard.

Format

network Any of the active available backplane or isolated Ethernet or Fast

slot.port Selects a port to clear counters for. slot is the slot number (slot 1

module.slot Specifies the module and the slot number in the hub.

Ethernet or Token Ring networks.

through slot 17) and port is the port number (port 1 through port 4).
For example, to specify port 4 on the module in slot 6, enter

6.4

2-12

CLEAR COUNTER

Example 1

Example 2

Related Command

The following command clears Ethernet counters on Ethernet network 1:

CB5000> clear counter ethernet ethernet_1
Ethernet Statistics for ETHERNET_1 cleared.

The following command clears repeater counters on port 3, Fast Ethernet
network 1:

CB5000> clear c ounter repeater fast_ethern et_1 port 3.1
Repeater Statistics for Port 3.1 on FAST_ETHER_1 cleared.

SHOW COUNTER

CLEAR EVENT SCRIPT

clear event

all

index

script

all

index

2-13

CLEAR EVENT SCRIPT

Format

Example

Related Commands

Use the CLEAR EVENT SCRIPT command to clear assignments for scripts to run
when a specified RMON event occurs.

all

index Specifies the index number of the RMON event that triggers the script.

Clears all script-to-event assignments.

Use the SHOW RMON EVENT CONTROL command to view events listed by
index number. Use the SHOW EVENT command to view script-to-event
assignments listed by index number.

The following command clears the assignment of script 1 to RMON event 3:

CB5000> clear event 3 script 1
Event Index 3 cleared.

SET EVENT SCRIPT
SHOW EVENT
SHOW RMON EVENT CONTROL
SHOW SCRIPT

2-14

CLEAR GROUP

CLEAR GROUP

Related Command

Format

Example

Use the CLEAR GROUP command to remove all groups or individual groups
from the indicated port.

clear

group

group number

port

all

group number Removes the specified group from the port.

port Removes all the groups from the specified port (1 through 40)

The following command clears the group from port 1:

CB5000> cl ear group group 1 1

CLEAR COUNTER BRIDGE_PORT IGMP_SNOOPING