3com 4007 Command Reference Manual

http://www.3com.com/

Switch 4007

Command Reference Guide

Part No. 10013693

Published May 2000

3Com Corporation

5400 Bayfront Plaza

Santa Clara, California

95052-8145

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 CoreBuilder are registered trademarks of 3Com Corporation. The 3Com logo is a trademark of

3Com Corporation. 3Com Facts is a service mark of 3Com Corporation.

PostScript is a registered trademark of Adobe Systems, Inc. AppleTalk is a registered trademark of Apple

Computer, Incorporated. Banyan and VINES are registered trademarks of Banyan Worldwide. DEC, DECnet,

and PATHWORKS are registered trademarks of Compaq Computer Corporation. OpenView is a registered

trademark of Hewlett-Packard Company. AIX, IBM, and NetView are registered trademarks and NetBIOS is a

trademark of International Business Machines Corporation. Internet Explorer, Microsoft, MS-DOS, Windows,

and Windows NT are registered trademarks of Microsoft Corporation. Netscape, Netscape Navigator, and the

Netscape N and Ship’s Wheel logos are registered trademarks of Netscape Communications Corporation in the

United States and other countries. IPX, Novell, and NetWare are registered trademarks of Novell, Inc. Sun and

SunNet Manager are trademarks of Sun Microsystems, Inc. Xerox and XNS are trademarks of Xerox

Corporation. UNIX is a registered trademark in the United States and other countries, licensed exclusively

through X/Open Company, Ltd.

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

associated.

C

ONTENTS

A

BOUT

T

HIS

G

UIDE

Scope of this Guide 15

Audience 16

Using This Book 16

Finding Information 16

Command Information 19

Conventions 20

Documentation Comments 21

Year 2000 Compliance 21

1

A

DMINISTRATION

O

VERVIEW

System Management Overview 24

Management and Data Channels 24

Management Module Summary 25

Management Interface Options 25

CLI of the Management Module 25

Menu-driven CLI of Switching Modules 26

Web Management 26

Accessing the Administration Console 27

Access Privileges on Modules 27

Password Access Levels 28

Administration Console Menus 29

Using Menus to Perform Tasks 30

Selecting Menu Options 31

Navigating Through the Menus 31

Entering a Command String 32

Entering Abbreviated Commands 32

Understanding the Values Presented 33

Including Values in Command Strings 33

2

A

DMINISTRATION

C

ONSOLE

C

OMMAND

S

UMMARY

3

M

ODULE

E

NVIRONMENT

Menu Structure 52

module display 53

module snapshot summary 54

module snapshot detail 55

module baseline display 56

module baseline set 57

module baseline requestedState 58

module name 59

module time 60

module screenHeight 61

module nvData reset 62

module nvData emergencyDownload 63

module nvData displayDownload 64

module nvData staging 65

module clearDiagBlock 66

module reboot 67

disconnect 68

4

S

IMPLE

N

ETWORK

M

ANAGEMENT

P

ROTOCOL

(SNMP)

Menu Structure 70

snmp display 71

snmp trap display 72

snmp trap addModify 73

snmp trap remove 74

snmp trap flush 75

snmp rmonConfiguration 76

snmp writeDisable 77

5

E

THERNET

P

ORTS

Menu Structure 80

ethernet summary 81

ethernet detail 84

ethernet autoNegotiation 89

ethernet portMode 90

ethernet flowControl 92

ethernet paceAccess 94

ethernet paceInteractiveAccess 95

ethernet label 96

ethernet portState 97

ethernet monitoring summary 98

ethernet monitoring mode 99

6

B

RIDGE

-

WIDE

P

ARAMETERS

Menu Structure 102

bridge display 103

bridge ipFragmentation 106

bridge ipxSnapTranslation 107

bridge addressThreshold 108

bridge agingTime 109

bridge spanningTree stpState 110

bridge spanningTree stpPriority 111

bridge spanningTree stpMaxAge 112

bridge spanningTree stpHelloTime 113

bridge spanningTree stpForwardDelay 114

bridge spanningTree stpGroupAddress 115

bridge gvrpState 116

bridge cos enable 117

bridge cos summary 118

bridge cos modify 119

bridge multicast igmp summary 120

bridge multicast igmp snoopMode 121

bridge multicast igmp queryMode 122

bridge multicast igmp queryIpAddress 123

bridge multicast igmp vlans 124

bridge multicast igmp groups 125

bridge multicast igmp desQuerier 126

bridge multicast igmp rPorts 127

bridge multicast igmp qPort 128

7

B

RIDGE

P

ORT

P

ARAMETERS

Menu Structure 130

bridge port summary 131

bridge port detail 133

bridge port multicastLimit 138

bridge port stpState 139

bridge port stpCost 140

bridge port stpPriority 141

bridge port gvrpState 142

bridge port address list 143

bridge port address add 144

bridge port address remove 145

bridge port address find 146

bridge port address flushAll 147

bridge port address flushDynamic 148

8

T

RUNKING

(L

INK

A

GGREGATION

)

Menu Structure 150

bridge trunk autoMap summary 151

bridge trunk autoMap enable/disable 152

bridge trunk autoMap test 153

bridge trunk summary 154

bridge trunk detail 155

bridge trunk define 157

bridge trunk modify 160

bridge trunk remove 162

9

R

ESILIENT

L

INKS

Menu Structure 164

bridge link summary 165

bridge link detail 166

bridge link define 167

bridge link linkState 169

bridge link activePort 170

bridge link modify 171

bridge link remove 173

10

V

IRTUAL

LAN

S

(VLAN

S

)

Menu Structure 176

bridge vlan summary 177

bridge vlan detail 180

bridge vlan define 184

bridge vlan define 190

bridge vlan modify 193

bridge vlan modify 196

bridge vlan remove 198

bridge vlan mode 199

bridge vlan stpMode 200

bridge vlan vlanAwareMode 201

11

P

ACKET

F

ILTERS

Menu Structure 204

bridge packetFilter list 205

bridge packetFilter display 206

bridge packetFilter create portGroup 207

bridge packetFilter create custom 208

bridge packetFilter delete 209

bridge packetFilter edit 210

bridge packetFilter load 211

bridge packetFilter assign 214

bridge packetFilter unassign 216

bridge packetFilter portGroup list 217

bridge packetFilter portGroup display 218

bridge packetFilter portGroup create 219

bridge packetFilter portGroup delete 220

bridge packetFilter portGroup addPort 221

bridge packetFilter portGroup removePort 222

12

I

NTERNET

P

ROTOCOL

(IP)

Menu Structure 224

ip interface summary 226

ip interface detail 228

ip interface define 230

ip interface define 232

ip interface modify 233

ip interface remove 234

ip interface arpProxy 235

ip interface broadcastAddress 236

ip interface directedBroadcast 237

ip interface icmpRedirect 238

ip interface icmpRouterDiscovery 240

ip interface statistics 242

ip route display 244

ip route static 246

ip route remove 247

ip route flush 248

ip route default 249

ip route noDefault 250

ip route findRoute 251

ip arp display 252

ip arp static 253

ip arp remove 254

ip arp flushAll 255

ip arp flushDynamic 256

ip arp age 257

ip arp statistics 258

ip dns display 260

ip dns domainName 261

ip dns define 262

ip dns modify 263

ip dns remove 264

ip dns nslookup 265

ip udpHelper display 266

ip udpHelper define 267

ip udpHelper remove 268

ip udpHelper hopCountLimit 269

ip udpHelper threshold 270

ip udpHelper interface first 271

ip udpHelper interface even 272

ip udpHelper interface sequential 273

ip routing 274

ip rip display 275

ip rip mode 277

ip rip compatibilityMode 278

ip rip cost 279

ip rip poisonReverse 280

ip rip routeAggregation Mode 281

ip rip password 282

ip rip addAdvertisement 283

ip rip remove Advertisement 284

ip rip policy summary 285

ip rip policy detail 286

ip rip policy define 287

ip rip policy modify 291

ip rip policy remove 293

ip rip statistics 294

ip ping 295

ip advancedPing 296

ip traceRoute 298

ip advancedTraceRoute 300

ip statistics 302

13

V

IRTUAL

R

OUTER

R

EDUNDANCY

(VRRP)

Menu Structure 306

ip vrrp summary 307

ip vrrp detail 309

ip vrrp define 312

ip vrrp modify 315

ip vrrp remove 318

ip vrrp mode 319

ip vrrp neighbor 320

ip vrrp statistics 321

14

IP M

ULTICAST

Menu Structure 324

ip multicast dvmrp interface summary 325

ip multicast dvmrp interface detail 326

ip multicast dvmrp interface mode 327

ip multicast dvmrp interface metric 328

ip multicast dvmrp interface defaultRoute 329

ip multicast dvmrp tunnels summary 331

ip multicast dvmrp tunnels define 333

ip multicast dvmrp tunnels remove 335

ip multicast dvmrp tunnels address 336

ip multicast dvmrp tunnels threshold 337

ip multicast dvmrp tunnels metric 338

ip multicast dvmrp tunnels defaultRoute 339

ip multicast dvmrp routeDisplay 341

ip multicast dvmrp cache 342

ip multicast igmp interface summary 344

ip multicast igmp interface detail 345

ip multicast igmp interface TTL 346

ip multicast igmp snooping 347

ip multicast igmp querying 348

ip multicast cache 349

ip multicast traceRoute 350

15

O

PEN

S

HORTEST

P

ATH

F

IRST

(OSPF)

Menu Structure 351

ip ospf areas display 353

ip ospf areas defineArea 354

ip ospf areas modifyArea 355

ip ospf areas removeArea 356

ip ospf areas addRange 357

ip ospf areas modifyRange 358

ip ospf areas removeRange 359

ip ospf defaultRouteMetric display 360

ip ospf defaultRouteMetric define 361

ip ospf defaultRouteMetric remove 362

ip ospf interface summary 363

ip ospf interface detail 364

ip ospf interface statistics 366

ip ospf interface mode 370

ip ospf interface priority 371

ip ospf interface areaID 372

ip ospf interface cost 373

ip ospf interface delay 374

ip ospf interface hello 375

ip ospf interface retransmit 376

ip ospf interface dead 377

ip ospf interface password 378

ip ospf linkStateData databaseSummary 379

ip ospf linkStateData router 380

ip ospf linkStateData network 382

ip ospf linkStateData summary 383

ip ospf linkStateData external 385

ip ospf neighbors display 386

ip ospf neighbors add 387

ip ospf neighbors remove 388

ip ospf routerID 389

ip ospf partition display 391

ip ospf partition modify 392

ip ospf stubDefaultMetric display 393

ip ospf stubDefaultMetric define 394

ip ospf stubDefaultMetric remove 395

ip ospf virtualLinks summary 396

ip ospf virtualLinks detail 397

ip ospf virtualLinks statistics 399

ip ospf virtualLinks define 403

ip ospf virtualLinks remove 404

ip ospf virtualLinks areaID 405

ip ospf virtualLinks router 406

ip ospf virtualLinks delay 407

ip ospf virtualLinks hello 408

ip ospf virtualLinks retransmit 409

ip ospf virtualLinks dead 410

ip ospf virtualLinks password 411

ip ospf policy summary 412

ip ospf policy detail 413

ip ospf policy define 415

ip ospf policy modify 419

ip ospf policy remove 423

ip ospf statistics 424

16

I

NTERNET

P

ACKET

E

XCHANGE

(IPX)

Menu Structure 426

ipx interface display 427

ipx interface define 428

ipx interface modify 430

ipx interface remove 432

ipx interface SAPadvertising 433

ipx interface RIPadvertising 434

ipx route display 435

ipx route secondary 437

ipx route static 438

ipx route remove 439

ipx route flush 440

ipx server display 441

ipx server static 443

ipx server remove 444

ipx server flush 445

ipx server secondary 446

ipx forwarding 447

ipx rip mode 448

ipx rip triggered 449

ipx rip policy summary 450

ipx rip policy define 451

ipx rip policy modify 453

ipx rip policy remove 455

ipx sap mode 456

ipx sap triggered 457

ipx sap policy summary 458

ipx sap policy detail 459

ipx sap policy define 460

ipx sap policy modify 462

ipx sap policy remove 464

ipx output-delay 465

ipx statistics summary 466

ipx statistics rip 467

ipx statistics sap 468

ipx statistics forwarding 469

ipx statistics interface 471

ipx oddLengthPadding 473

ipx NetBIOS 474

ipx secondary 475

17

A

PPLE

T

ALK

Menu Structure 478

appletalk interface summary 479

appletalk interface detail 480

appletalk interface define 481

appletalk interface modify 483

appletalk interface remove 485

appletalk interface statistics 486

appletalk route display 488

appletalk route flush 489

appletalk aarp display 490

appletalk aarp remove 491

appletalk aarp flush 492

appletalk zone display network 493

appletalk zone display zone 494

appletalk forwarding 495

appletalk checksum 496

appletalk sourceSocket 497

appletalk ping 498

appletalk statistics ddp 499

appletalk statistics rtmp 500

appletalk statistics zip 501

appletalk statistics nbp 502

18

Q

UALITY

OF

S

ERVICE

(Q

O

S)

AND

R

ESOURCE

R

ESERVATION

P

ROTOCOL

(RSVP)

Menu Structure 504

qos classifier summary 505

qos classifier detail 506

qos classifier define 508

qos classifier modify 514

qos classifier remove 519

qos control summary 520

qos control detail 521

qos control define 523

qos control modify 530

qos control remove 535

qos rsvp summary 536

qos rsvp detail 537

qos rsvp enable 538

qos rsvp disable 540

qos bandwidth display 541

qos bandwidth modify 542

qos excessTagging display 543

qos excessTagging enable 544

qos excessTagging disable 545

qos statistics interval 546

qos statistics receive 547

qos statistics transmit 549

19

R

OVING

A

NALYSIS

Menu Structure 554

analyzer display 555

analyzer add 556

analyzer remove 558

analyzer start 559

analyzer stop 560

A

T

ECHNICAL

S

UPPORT

Online Technical Services 561

World Wide Web Site 561

3Com Knowledgebase Web Services 561

3Com FTP Site 562

3Com Bulletin Board Service 562

3Com Facts Automated Fax Service 563

Support from Your Network Supplier 563

Support from 3Com 563

Returning Products for Repair 565

I

NDEX

A

BOUT

T

HIS

G

UIDE

This

Switch 4007 Command Reference Guide

provides information about

the commands that you use to configure and manage switching modules

in the Switch 4007 system. These commands pertain to the menu-driven

command line interface that is included in each module’s software. This

interface is called the Administration Console.

For information about the Management Module (also known as the

Enterprise Management Engine, or EME),its CLI commands, how to log

into the system, or how to connect to a switching module, see the

Switch 4007 Implementation Guide

.

Scope of this Guide

The commands in this guide pertain to Release 3.0.5 software.

Switch 4007 modules are pre-loaded with software at the factory.

However, the software that was loaded on the components that you

received may be an earlier release. Connect to each module and use the

module display

command to determine what release is loaded. Go to

the 3Com Web site (

http://support.3com.com

) to download the latest

software.

If the information in the release notes that correspond with the software

on your modules differs from the information in this guide, follow the

instructions in the release notes.

This

Switch 4007 Command Reference Guide

functions as a companion

document to the

Switch 4007 Implementation Guide.

Before you use either of these guides, you should have already consulted

documents such as the

Switch 4007 Getting Started Guide

and individual

module

Quick Start

guides for physical installation information and basic

connectivity.

16

A

BOUT

T

HIS

G

UIDE

Audience

This guide is intended for the network administrator who is responsible

for configuring, using, and managing the Switch 4007 system. It assumes

a working knowledge of local area network (LAN) operations and

familiarity with communications protocols that are used on

interconnected LANs.

Using This Book

This guide contains information for every command for the platforms

listed at the beginning of this chapter. It includes specific information

about command syntax, field descriptions, default values, and the

possible range of values. Some command descriptions include a section

called “Important Considerations” that contains additional information

to be aware of when using the command. Where appropriate, examples

help you to understand the commands.

This guide does not contain troubleshooting information or instructional

material about why or when to use a particular feature. For information

about feature concepts and guidelines for using the features, see the

Switch 4007 Implementation Guide

.

Finding Information

Use this chart to help you find information about specific tasks:

If you are looking for information about Turn to

The purpose of this book

Sending feedback on this book

Year 2000 compliance information

About This Guide

Switch 4007 management architecture

Administration Console menus

Entering full and abbreviated commands

Chapter 1:

Administration

Overview

A matrix of which commands apply to Layer 2 Switching

modules vs. Multilayer Switching Modules

Chapter 2:

Command Summary

Obtaining a summary configuration for all module options

Gathering statistics from a baseline

Configuring parameters, such as name, date/time, and

screen height

Viewing a log of diagnostic errors

Saving, restoring, and resetting nonvolatile data

Chapter 3:

Module Environment

Using This Book

17

Configuring and displaying SNMP settings on switching

modules, including trap reporting

Chapter 4:

Simple Network

Management Protocol

Administering Ethernet port options such as setting the

port speed and duplex mode or labeling ports

Displaying statistics for Ethernet ports

Chapter 5:

Ethernet Ports

Displaying the summary bridge configuration

Configuring bridging options such as the aging interval, IP

fragmentation, IPX SNAP translation, bridge-wide GVRP,

and bridge-wide STP

Setting Class of Service priorities

Filtering IP multicast packets using the Internet Group

Management Protocol (IGMP) functions called snooping

and querying

Chapter 6:

Bridge-Wide

Parameters

Configuring STP options on individual bridge ports

Configuring GVRP on individual bridge ports

Listing, adding, or removing information from the address

table

Setting broadcast and multicast forwarding limits on

individual bridge ports

Chapter 7:

Bridge Port Parameters

Increasing point-to-point bandwidth and resiliency by

trunking multiple ports together into one logical port

Chapter 8:

Trunking (Link

Aggregation)

Increasing point-to-point resiliency with resilient link pairs Chapter 9:

Resilient Links

Creating and administering virtual LANs (VLANs) Chapter 10: VLANs

Configuring port groups and packet filters Chatper 11:

Packet Filters

Configuring IP interfaces and IP protocol parameters Chapter 12: IP

Configuring Virtual Router Redundancy Protocol (VRRP) Chapter 13: VRRP

Configuring IP Multicast routing Chapter 14:

IP Multicast

Configuring Open Shortest Path First (OSPF) routing Chapter 15: OSPF

Configuring Internet Packet Exchange (IPX) routing Chapter 16: IPX

Configuring AppleTalk routing Chapter 17: AppleTalk

If you are looking for information about Turn to

18

A

BOUT

T

HIS

G

UIDE

Controlling traffic flows with Quality of Service (QoS)

options such as classifiers, controls, Resource Reservation

Protocol (RSVP), bandwidth, and excess tagging

Viewing statistics

Chapter 18:

QoS and RSVP

Administering roving analysis Chapter 19:

Roving Analysis

Technical support Appendix A

Locating information on tasks and topics quickly Index

If you are looking for information about Turn to

Command Information

19

Command

Information

Each software command has its own description in this guide. Each

command description begins at the top of a page. A command

description begins with these items:

■

The complete text of a command

■

Type of modules on which this command is valid, as indicated by

check marks (

✓

)

■

A short description of the purpose of the command

■

The command description continues with one or more of the

following sections:

■

Valid Minimum Abbreviation

— This section lists the shortest

number of characters that you can type to issue the command.

■

Important Considerations

— These usage notes identify

potential issues or requirements. For a complete list or discussion of

issues, see the

Switch 4007 Implementation Guide

.

■

Options

— If the command begins a configuration process or

other procedure, this section presents each prompt that you see, its

description, the possible values that you can enter, and the default

value.

■

Fields

— If the command prompts the module to display

information, this section lists the display parameters and their

definitions.

■

Procedure

— Numbered steps walk you through complex

commands.

■

Example

— Examples show the interactive display when it

provides additional useful information.

The Switch 4007 software and management interfaces are built from

CoreBuilder

®

9000 switch technology. In Switch 4007 software

releases 3.0.0 and 3.0.5, the prompts and displays in all interfaces may

indicate this heritage.

20

A

BOUT

T

HIS

G

UIDE

Conventions

Table 1 and Table 2 list icon and text conventions that are used

throughout this guide.

Ta b l e 1

Notice Icons

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

Ta b l e 2

Text Conventions

Convention Description

Screen displays

This typeface represents information as it appears on the

screen.

Command

The word “command” means that you enter the command

exactly as shown in the text and then press Return or Enter.

Commands appear in bold. Example:

To set flow control, enter the following command:

ethernet flowControl

This guide always gives the full form of a command.

However, you can abbreviate commands by entering just

enough characters to distinguish one command from

another similar command, as shown in “

Valid Minimum

Abbreviations

” under each command description.

Commands are not case sensitive.

The words “enter”

and “type”

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

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

press Return or Enter when an instruction simply says

“type.”

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

names are linked with a plus sign (+). Example:

Press Ctrl+C.

Words in

italics

Italics are used to:

■

Emphasize a point

■

Denote a new term when it is defined in text

Page is loading ...

3com 4007 Command Reference Manual

Related papers

Other documents