Kontron AT890X CLI User Manual

AT8901/2/3 CLI Reference Manual

AdvancedTCA

M5301_TECH_2 Manual ID

1.3 Revision Index

26 April, 2006 Date of Issue

AT8901/2/3 Preface

Revision History

Publication Title: AT8901/2/3 CLI Reference Manual

ID Number: M5301_TECH_2

Rev.

Index

1.0 Preliminary Initial Issue 2005-07-15

1.1 Change Chapter 9 2005-08-16

1.2 Change structure, include LVL7 4.3.7 doc upgrade, add commands

chapter 16

1.3 Change structure, add LVL7 4.4 commands, review 2006-04-10

Brief Description of Changes Date of Issue

2006-01-12

Imprint

Kontron may be contacted via the following:

Kontron Canada, Inc. Kontron Modular Computers GmbH
616 Curé-Boivin Sudetenstrasse 7
Boisbriand, Québec 87600 Kaufbeuren
Canada J7G 2A7 Germany
Tel: [phone] Tel: [phone]

[phone]
Fax: [phone] Fax: [phone]
E-mail: [e-mail] E-mail: [e-mail]

For further information about Kontron, our products or services, please visit our Internet web
site: www.kontron.com

Disclaimer

Copyright © 2006 Kontron AG. All rights reserved. All data is for information purposes only and
not guaranteed for legal purposes. Information has been carefully checked and is believed to
be accurate; however, no responsibility is assumed for inaccuracies. Kontron and the Kontron
logo and all other trademarks or registered trademarks are the property of their respective own­ers and are recognized. Specifications are subject to change without notice.

Page ii AT8901/2/3 CLI Reference Manual

AT8901/2/3 Preface

About This Book

This document describes configuration commands for FASTPATH® software. The commands
can be accessed from the CLI.

Why the Document was Created

This document was created primarily for system administrators configuring and operating a
system using FASTPATH software. It is intended to provide an understanding of the
configuration options of FASTPATH software.

In addition, software engineers who will be integrating FASTPATH software into their router
or switch product can benefit from a description of the configuration options.

It is assumed that the reader has an understanding of the FASTPATH software base and has
read the appropriate specification for the relevant networking device platform. It is also
assumed that the reader has a basic knowledge of Ethernet and networking concepts.

How to Use This Document

• Chapter 1 “” details the procedure to quickly become acquainted with the FASTPATH
software.

Proprietary Note

This document contains information proprietary to Kontron Modular Computers GmbH. It may
not be copied or transmitted by any means, disclosed to others, or stored in any retrieval system
or media without the prior written consent of Kontron Modular Computers GmbH or one of its
authorized agents.

The information contained in this document is, to the best of our knowledge, entirely correct.
However, Kontron Modular Computers GmbH cannot accept liability for any inaccuracies or
the consequences thereof, or for any liability arising from the use or application of any circuit,
product, or example shown in this document.

Kontron Modular Computers GmbH reserves the right to change, modify, or improve this
document or the product described herein, as seen fit by Kontron Modular Computers GmbH
without further notice.

Note

Refer to the release notes for the FASTPATH application level code. The
release notes detail the platform specific functionality of the Switching, Rout­ing, SNMP, Config, Management, and Bandwidth Provisioning packages. The
suite of features supported by the FASTPATH packages are not available on
all the platforms to which FASTPATH has been ported.

P R E L I M I N A R Y

Trademarks

© 2005 LVL7 Systems, Inc. All rights reserved. FASTPATH® and MasterDriver® are
registered trademarks, and LVL7™ and the LVL7 logo are trademarks of LVL7 Systems, Inc.
All other trademarks are the property of their respective owners.

Kontron Modular Computers GmbH and the Kontron Logo are trade marks owned by Kontron
Modular Computers GmbH, Kaufbeuren (Germany). In addition, this document may include

Page iii AT8901/2/3 CLI Reference Manual

Preface AT8901/2/3

names, company logos and trademarks, which are registered trademarks and, therefore,
proprietary to their respective owners.

Environmental Protection Statement

This product has been manufactured to satisfy environmental protection requirements where
possible. Many of the components used (structural parts, printed circuit boards, connectors,
batteries, etc.) are capable of being recycled.

Final disposition of this product after its service life must be accomplished in accordance with
applicable country, state, or local laws or regulations.

Explanation of Symbols

CE Conformity

This symbol indicates that the product described in this manual is in com­pliance with all applied CE standards. Please refer also to the section
“Applied Standards” in this manual.

P R E L I M I N A R Y

Caution, Electric Shock!

This symbol and title warn of hazards due to electrical shocks (> 60V)
when touching products or parts of them. Failure to observe the precautions
indicated and/or prescribed by the law may endanger your life/health and/or
result in damage to your material.

Please refer also to the section “High Voltage Safety Instructions” on the
following page.

Warning, ESD Sensitive Device!

This symbol and title inform that electronic boards and their components
are sensitive to static electricity. Therefore, care must be taken during all
handling operations and inspections of this product, in order to ensure prod­uct integrity at all times.

Please read also the section “Special Handling and Unpacking Instructions”
on the following page.

Warning!

This symbol and title emphasize points which, if not fully understood and
taken into consideration by the reader, may endanger your health and/or
result in damage to your material.

Note...

This symbol and title emphasize aspects the reader should read through
carefully for his or her own advantage.

For Your Safety

AT8901/2/3 CLI Reference Manual Page iv

AT8901/2/3 Preface

Your new Kontron product was developed and tested carefully to provide all features necessary
to ensure its compliance with electrical safety requirements. It was also designed for a long
fault-free life. However, the life expectancy of your product can be drastically reduced by
improper treatment during unpacking and installation. Therefore, in the interest of your own
safety and of the correct operation of your new Kontron product, you are requested to conform
with the following guidelines.

High Voltage Safety Instructions

Warning!

All operations on this device must be carried out by sufficiently skilled per­sonnel only.

Caution, Electric Shock!

Indicates that you must enter a value in place of the brackets and text inside
them. Before installing your new Kontron product into a system always
ensure that your mains power is switched off. This applies also to the
installation of piggybacks.

Serious electrical shock hazards can exist during all installation, repair and
maintenance operations with this product. Therefore, always unplug the
power cable and any other cables which provide external voltages before
performing work.

Special Handling and Unpacking Instructions

ESD Sensitive Device!

Electronic boards and their components are sensitive to static electricity.
Therefore, care must be taken during all handling operations and inspec­tions of this product, in order to ensure product integrity at all times.

Do not handle this product out of its protective enclosure while it is not used for operational
purposes unless it is otherwise protected.

Whenever possible, unpack or pack this product only at EOS/ESD safe work stations. Where a
safe work station is not guaranteed, it is important for the user to be electrically discharged
before touching the product with his/her hands or tools. This is most easily done by touching a
metal part of your system housing.

It is particularly important to observe standard anti-static precautions when changing
piggybacks, ROM devices, jumper settings etc. If the product contains batteries for RTC or
memory back-up, ensure that the board is not placed on conductive surfaces, including anti­static plastics or sponges. They can cause short circuits and damage the batteries or conductive
circuits on the board.

General Instructions on Usage

P R E L I M I N A R Y

Page v AT8901/2/3 CLI Reference Manual

Preface AT8901/2/3

In order to maintain Kontron’s product warranty, this product must not be altered or modified in
any way. Changes or modifications to the device, which are not explicitly approved by Kontron
Modular Computers GmbH and described in this manual or received from Kontron’s Technical
Support as a special handling instruction, will void your warranty.

This device should only be installed in or connected to systems that fulfill all necessary
technical and specific environmental requirements. This applies also to the operational
temperature range of the specific board version, which must not be exceeded. If batteries are
present their temperature restrictions must be taken into account.

In performing all necessary installation and application operations, please follow only the
instructions supplied by the present manual.

Keep all the original packaging material for future storage or warranty shipments. If it is
necessary to store or ship the board please re-pack it as nearly as possible in the manner in
which it was delivered.

Special care is necessary when handling or unpacking the product. Please, consult the special
handling and unpacking instruction on the previous page of this manual.

P R E L I M I N A R Y

Two Year Warranty

Kontron Modular Computers GmbH grants the original purchaser of Kontron’s products a two
year limited hardware warranty as described in the following. However, no other warranties
that may be granted or implied by anyone on behalf of Kontron are valid unless the consumer
has the express written consent of Kontron Modular Computers GmbH.

Kontron Modular Computers GmbH warrants their own products, excluding software, to be
free from manufacturing and material defects for a period of 24 consecutive months from the
date of purchase. This warranty is not transferable nor extendible to cover any other users or
long-term storage of the product. It does not cover products which have been modified, altered
or repaired by any other party than Kontron Modular Computers GmbH or their authorized
agents. Furthermore, any product which has been, or is suspected of being damaged as a result
of negligence, improper use, incorrect handling, servicing or maintenance, or which has been
damaged as a result of excessive current/voltage or temperature, or which has had its serial
number(s), any other markings or parts thereof altered, defaced or removed will also be
excluded from this warranty.

If the customer’s eligibility for warranty has not been voided, in the event of any claim, he may
return the product at the earliest possible convenience to the original place of purchase, together
with a copy of the original document of purchase, a full description of the application the
product is used on and a description of the defect. Pack the product in such a way as to ensure
safe transportation (see our safety instructions).

Kontron provides for repair or replacement of any part, assembly or sub-assembly at their own
discretion, or to refund the original cost of purchase, if appropriate. In the event of repair,
refunding or replacement of any part, the ownership of the removed or replaced parts reverts to
Kontron Modular Computers GmbH, and the remaining part of the original guarantee, or any
new guarantee to cover the repaired or replaced items, will be transferred to cover the new or
repaired items. Any extensions to the original guarantee are considered gestures of goodwill,
and will be defined in the “Repair Report” issued by Kontron with the repaired or replaced
item.

Kontron Modular Computers GmbH will not accept liability for any further claims resulting
directly or indirectly from any warranty claim, other than the above specified repair,
replacement or refunding. In particular, all claims for damage to any system or process in which
the product was employed, or any loss incurred as a result of the product not functioning at any

AT8901/2/3 CLI Reference Manual Page vi

AT8901/2/3 Preface

given time, are excluded. The extent of Kontron Modular Computers GmbH liability to the
customer shall not exceed the original purchase price of the item for which the claim exists.

Kontron Modular Computers GmbH issues no warranty or representation, either explicit or
implicit, with respect to its products’ reliability, fitness, quality, marketability or ability to fulfil
any particular application or purpose. As a result, the products are sold “as is,” and the
responsibility to ensure their suitability for any given task remains that of the purchaser. In no
event will Kontron be liable for direct, indirect or consequential damages resulting from the use
of our hardware or software products, or documentation, even if Kontron were advised of the
possibility of such claims prior to the purchase of the product or during any period since the
date of its purchase.

Please remember that no Kontron Modular Computers GmbH employee, dealer or agent is
authorized to make any modification or addition to the above specified terms, either verbally or
in any other form, written or electronically transmitted, without the company’s consent.

P R E L I M I N A R Y

Page vii AT8901/2/3 CLI Reference Manual

Preface AT8901/2/3

P R E L I M I N A R Y

AT8901/2/3 CLI Reference Manual Page viii

AT8901/2/3

Chapter

1. Using the Command-Line Interface ............................................................. 1 - 2

1.1 Command Syntax .................................................................................... 1 - 2

1.2 Command Conventions ........................................................................... 1 - 2

1.2.1 Common Parameter Values ........................................................... 1 - 3

1.3 Slot/Port Naming Convention .................................................................. 1 - 4

1.4 Using the “No” Form of a Command ....................................................... 1 - 5

1.5 Command Modes .................................................................................... 1 - 5

1.5.1 Command Completion and Abbreviation ........................................ 1 - 8

1.5.2 CLI Error Messages ........................................................................ 1 - 8

1.5.3 CLI Line-Editing Conventions ......................................................... 1 - 8

1.6 Using CLI Help ........................................................................................ 1 - 9

1.7 Accessing the CLI ................................................................................. 1 - 10

Chapter

1

2

2. Switching Commands .................................................................................. 2 - 2

2.1 Port Configuration Commands ................................................................ 2 - 2

2.1.1 interface .......................................................................................... 2 - 2

2.1.2 auto-negotiate ................................................................................. 2 - 2

2.1.3 auto-negotiate all ............................................................................ 2 - 3

2.1.4 description ...................................................................................... 2 - 3

2.1.5 mtu .................................................................................................. 2 - 3

2.1.6 shutdown ........................................................................................ 2 - 4

2.1.7 shutdown all .................................................................................... 2 - 4

2.1.8 speed .............................................................................................. 2 - 4

2.1.9 speed all ......................................................................................... 2 - 5

2.1.10 show port ........................................................................................ 2 - 5

2.1.11 show port protocol .......................................................................... 2 - 5

2.2 Spanning Tree Protocol (STP) Commands ............................................. 2 - 6

2.2.1 spanning-tree .................................................................................. 2 - 6

2.2.2 spanning-tree bpdumigrationcheck ................................................. 2 - 6

2.2.3 spanning-tree configuration name .................................................. 2 - 7

2.2.4 spanning-tree configuration revision ............................................... 2 - 7

2.2.5 spanning-tree edgeport ................................................................... 2 - 7

2.2.6 spanning-tree forceversion ............................................................. 2 - 8

2.2.7 spanning-tree forward-time ............................................................. 2 - 8

Page 0 - 1 AT8901/2/3 CLI Reference Manual

AT8901/2/3

2.2.8 spanning-tree hello-time ..................................................................2 - 8

2.2.9 spanning-tree max-age ...................................................................2 - 9

2.2.10 spanning-tree max-hops .................................................................2 - 9

2.2.11 spanning-tree mst ...........................................................................2 - 9

2.2.12 spanning-tree mst instance ...........................................................2 - 10

2.2.13 spanning-tree mst priority ..............................................................2 - 11

2.2.14 spanning-tree mst vlan ..................................................................2 - 11

2.2.15 spanning-tree port mode ...............................................................2 - 12

2.2.16 spanning-tree port mode all ..........................................................2 - 12

2.2.17 show spanning-tree .......................................................................2 - 12

2.2.18 show spanning-tree brief ...............................................................2 - 13

2.2.19 show spanning-tree interface ........................................................2 - 14

2.2.20 show spanning-tree mst port detailed ...........................................2 - 14

2.2.21 show spanning-tree mst port summary .........................................2 - 16

2.2.22 show spanning-tree mst summary ................................................2 - 16

2.2.23 show spanning-tree summary .......................................................2 - 16

2.2.24 show spanning-tree vlan ...............................................................2 - 17

2.3 VLAN Commands ..................................................................................2 - 17

2.3.1 vlan database ................................................................................2 - 17

2.3.2 network mgmt_vlan .......................................................................2 - 17

2.3.3 vlan ................................................................................................2 - 18

2.3.4 vlan acceptframe ...........................................................................2 - 18

2.3.5 vlan ingressfilter ............................................................................2 - 18

2.3.6 vlan makestatic .............................................................................2 - 19

2.3.7 vlan name ......................................................................................2 - 19

2.3.8 vlan participation ...........................................................................2 - 19

2.3.9 vlan participation all .......................................................................2 - 20

2.3.10 vlan port acceptframe all ...............................................................2 - 20

2.3.11 vlan port ingressfilter all ................................................................2 - 20

2.3.12 vlan port pvid all ............................................................................2 - 21

2.3.13 vlan port tagging all .......................................................................2 - 21

2.3.14 vlan protocol group ........................................................................2 - 22

2.3.15 vlan protocol group add protocol ...................................................2 - 22

2.3.16 vlan protocol group remove ...........................................................2 - 22

2.3.17 protocol group ...............................................................................2 - 22

2.3.18 protocol vlan group ........................................................................2 - 23

2.3.19 protocol vlan group all ...................................................................2 - 23

2.3.20 vlan pvid ........................................................................................2 - 24

2.3.21 vlan tagging ...................................................................................2 - 24

2.3.22 vlan association subnet .................................................................2 - 24

2.3.23 vlan association mac .....................................................................2 - 24

2.3.24 show vlan ......................................................................................2 - 25

2.3.25 show vlan brief ..............................................................................2 - 26

2.3.26 show vlan port ...............................................................................2 - 26

2.3.27 show vlan association subnet .......................................................2 - 27

2.3.28 show vlan association mac ...........................................................2 - 27

AT8901/2/3 CLI Reference Manual Page 0 - 2

AT8901/2/3

2.4 Double VLAN Commands ..................................................................... 2 - 27

2.4.1 dvlan-tunnel ethertype .................................................................. 2 - 27

2.4.2 mode dot1q-tunnel ........................................................................ 2 - 28

2.4.3 mode dvlan-tunnel ........................................................................ 2 - 28

2.4.4 show dot1q-tunnel ........................................................................ 2 - 28

2.4.5 show dvlan-tunnel ......................................................................... 2 - 29

2.5 Provisioning (IEEE 802.1p) Commands ................................................ 2 - 29

2.5.1 vlan port priority all ........................................................................ 2 - 29

2.5.2 vlan priority ................................................................................... 2 - 30

2.6 Protected Ports Commands .................................................................. 2 - 30

2.6.1 switchport protected (Global Config) ............................................ 2 - 30

2.6.2 switchport protected (Interface Config) ......................................... 2 - 31

2.6.3 show switchport protected ............................................................ 2 - 31

2.6.4 show interfaces switchport ............................................................ 2 - 31

2.7 GARP Commands ................................................................................. 2 - 32

2.7.1 set garp timer join ......................................................................... 2 - 32

2.7.2 set garp timer leave ...................................................................... 2 - 32

2.7.3 set garp timer leaveall ................................................................... 2 - 33

2.7.4 show garp ..................................................................................... 2 - 33

2.8 GVRP Commands ................................................................................. 2 - 33

2.8.1 set gvrp adminmode ..................................................................... 2 - 34

2.8.2 set gvrp interfacemode ................................................................. 2 - 34

2.8.3 show gvrp configuration ................................................................ 2 - 34

2.9 GMRP Commands ................................................................................ 2 - 35

2.9.1 set gmrp adminmode .................................................................... 2 - 35

2.9.2 set gmrp interfacemode ................................................................ 2 - 36

2.9.3 show gmrp configuration ............................................................... 2 - 36

2.9.4 show mac-address-table gmrp ..................................................... 2 - 37

2.10 Port-Based Network Access Control Commands ................................. 2 - 37

2.10.1 authentication login ....................................................................... 2 - 37

2.10.2 clear dot1x statistics ..................................................................... 2 - 38

2.10.3 clear radius statistics .................................................................... 2 - 38

2.10.4 dot1x defaultlogin .......................................................................... 2 - 38

2.10.5 dot1x initialize ............................................................................... 2 - 39

2.10.6 dot1x login .................................................................................... 2 - 39

2.10.7 dot1x max-req ............................................................................... 2 - 39

2.10.8 dot1x port-control .......................................................................... 2 - 39

2.10.9 dot1x port-control all ..................................................................... 2 - 40

2.10.10 dot1x re-authenticate .................................................................... 2 - 40

2.10.11 dot1x re-authentication ................................................................. 2 - 40

2.10.12 dot1x system-auth-control ............................................................ 2 - 41

2.10.13 dot1x timeout ................................................................................ 2 - 41

2.10.14 dot1x user ..................................................................................... 2 - 42

2.10.15 users defaultlogin .......................................................................... 2 - 42

Page 0 - 3 AT8901/2/3 CLI Reference Manual

AT8901/2/3

2.10.16 users login .....................................................................................2 - 42

2.10.17 show authentication ......................................................................2 - 43

2.10.18 show authentication users .............................................................2 - 43

2.10.19 show dot1x ....................................................................................2 - 43

2.10.20 show dot1x users ..........................................................................2 - 45

2.10.21 show users authentication .............................................................2 - 46

2.11 Storm-Control Commands .....................................................................2 - 46

2.11.1 storm-control broadcast ................................................................2 - 46

2.11.2 storm-control broadcast level ........................................................2 - 46

2.11.3 storm-control broadcast all ............................................................2 - 47

2.11.4 storm-control broadcast all level ...................................................2 - 47

2.11.5 storm-control multicast ..................................................................2 - 48

2.11.6 storm-control multicast level ..........................................................2 - 48

2.11.7 storm-control multicast all .............................................................2 - 48

2.11.8 storm-control multicast all level .....................................................2 - 49

2.11.9 storm-control unicast .....................................................................2 - 49

2.11.10 storm-control unicast level ............................................................2 - 50

2.11.11 storm-control unicast all ................................................................2 - 50

2.11.12 storm-control unicast all level ........................................................2 - 50

2.11.13 storm-control flowcontrol ...............................................................2 - 51

2.11.14 show storm-control ........................................................................2 - 51

2.12 Port-Channel/LAG (802.3ad) Commands ..............................................2 - 52

2.12.1 port-channel ..................................................................................2 - 52

2.12.2 addport ..........................................................................................2 - 52

2.12.3 deleteport (Interface Config) .........................................................2 - 53

2.12.4 deleteport (Global Config) .............................................................2 - 53

2.12.5 port-channel static .........................................................................2 - 53

2.12.6 port lacpmode ...............................................................................2 - 53

2.12.7 port lacpmode all ...........................................................................2 - 54

2.12.8 port-channel adminmode ..............................................................2 - 54

2.12.9 port-channel linktrap ......................................................................2 - 54

2.12.10 port-channel name ........................................................................2 - 55

2.12.11 show port-channel brief .................................................................2 - 55

2.12.12 show port-channel .........................................................................2 - 55

2.13 Port Mirroring .........................................................................................2 - 56

2.13.1 monitor session .............................................................................2 - 56

2.13.2 no monitor .....................................................................................2 - 57

2.13.3 show monitor session ....................................................................2 - 57

2.14 Static MAC Filtering ...............................................................................2 - 57

2.14.1 macfilter .........................................................................................2 - 57

2.14.2 macfilter addsrc .............................................................................2 - 58

2.14.3 macfilter addsrc all ........................................................................2 - 58

2.14.4 show mac-address-table static ......................................................2 - 59

2.14.5 show mac-address-table staticfiltering ..........................................2 - 59

2.15 IGMP Snooping Configuration Commands ............................................2 - 59

AT8901/2/3 CLI Reference Manual Page 0 - 4

AT8901/2/3

2.15.1 set igmp ........................................................................................ 2 - 59

2.15.2 set igmp interfacemode ................................................................ 2 - 60

2.15.3 set igmp fast-leave ........................................................................ 2 - 60

2.15.4 set igmp groupmembership-interval ............................................. 2 - 61

2.15.5 set igmp maxresponse .................................................................. 2 - 61

2.15.6 set igmp mcrtexpiretime ................................................................ 2 - 62

2.15.7 set igmp mrouter ........................................................................... 2 - 62

2.15.8 set igmp mrouter interface ............................................................ 2 - 63

2.15.9 show igmpsnooping ...................................................................... 2 - 63

2.15.10 show igmpsnooping mrouter interface .......................................... 2 - 64

2.15.11 show igmpsnooping mrouter vlan ................................................. 2 - 64

2.15.12 show mac-address-table igmpsnooping ....................................... 2 - 64

2.16 Port Security Commands ...................................................................... 2 - 65

2.16.1 port-security .................................................................................. 2 - 65

2.16.2 port-security max-dynamic ............................................................ 2 - 65

2.16.3 port-security max-static ................................................................. 2 - 66

2.16.4 port-security mac-address ............................................................ 2 - 66

2.16.5 port-security mac-address move .................................................. 2 - 66

2.16.6 show port-security ......................................................................... 2 - 66

2.16.7 show port-security dynamic .......................................................... 2 - 67

2.16.8 show port-security static ............................................................... 2 - 67

2.16.9 show port-security violation .......................................................... 2 - 67

2.17 LLDP (802.1AB) Commands ................................................................. 2 - 67

2.17.1 lldp transmit .................................................................................. 2 - 67

2.17.2 lldp receive .................................................................................... 2 - 68

2.17.3 lldp timers ..................................................................................... 2 - 68

2.17.4 lldp transmit-tlv .............................................................................. 2 - 68

2.17.5 lldp transmit-mgmt ........................................................................ 2 - 69

2.17.6 lldp notification .............................................................................. 2 - 69

2.17.7 lldp notification-interval ................................................................. 2 - 69

2.17.8 clear lldp statistics ......................................................................... 2 - 70

2.17.9 clear lldp remote-data ................................................................... 2 - 70

2.17.10 show lldp ....................................................................................... 2 - 70

2.17.11 show lldp interface ........................................................................ 2 - 70

2.17.12 show lldp statistics ........................................................................ 2 - 71

2.17.13 show lldp remote-device ............................................................... 2 - 71

2.17.14 show lldp remote-device detail ..................................................... 2 - 72

2.17.15 show lldp local-device ................................................................... 2 - 72

2.17.16 show lldp local-device detail ......................................................... 2 - 73

2.18 Denial of Service Commands ................................................................ 2 - 73

2.18.1 dos-control sipdip .......................................................................... 2 - 73

2.18.2 dos-control firstfrag ....................................................................... 2 - 74

2.18.3 dos-control tcpfrag ........................................................................ 2 - 74

2.18.4 dos-control tcpflag ........................................................................ 2 - 75

2.18.5 dos-control l4port .......................................................................... 2 - 75

Page 0 - 5 AT8901/2/3 CLI Reference Manual

AT8901/2/3

2.18.6 dos-control icmp ............................................................................2 - 75

2.18.7 show dos-control ...........................................................................2 - 76

2.19 MAC Database Commands ...................................................................2 - 76

2.19.1 bridge aging-time ..........................................................................2 - 76

2.19.2 show forwardingdb agetime ..........................................................2 - 76

2.19.3 show mac-address-table multicast ................................................2 - 77

2.19.4 show mac-address-table stats ......................................................2 - 77

Chapter

3. Routing Commands .....................................................................................3 - 2

3.1 Address Resolution Protocol (ARP) Commands .....................................3 - 2

3.1.1 arp ...................................................................................................3 - 2

3.1.2 ip proxy-arp .....................................................................................3 - 3

3.1.3 arp cachesize ..................................................................................3 - 3

3.1.4 arp dynamicrenew ...........................................................................3 - 3

3.1.5 arp purge .........................................................................................3 - 4

3.1.6 arp resptime ....................................................................................3 - 4

3.1.7 arp retries ........................................................................................3 - 4

3.1.8 arp timeout ......................................................................................3 - 4

3.1.9 clear arp-cache ...............................................................................3 - 5

3.1.10 show arp ..........................................................................................3 - 5

3.1.11 show arp brief ..................................................................................3 - 6

3.1.12 show arp switch ...............................................................................3 - 6

3.2 IP Routing Commands .............................................................................3 - 6

3.2.1 routing .............................................................................................3 - 7

3.2.2 ip routing .........................................................................................3 - 7

3.2.3 ip address ........................................................................................3 - 7

3.2.4 ip route ............................................................................................3 - 8

3.2.5 ip route default ................................................................................3 - 8

3.2.6 ip route distance ..............................................................................3 - 9

3.2.7 ip forwarding ....................................................................................3 - 9

3.2.8 ip netdirbcast ...................................................................................3 - 9

3.2.9 ip mtu ............................................................................................3 - 10

3.2.10 encapsulation ................................................................................3 - 10

3.2.11 show ip brief ..................................................................................3 - 11

3.2.12 show ip interface ...........................................................................3 - 11

3.2.13 show ip interface brief ...................................................................3 - 12

3.2.14 show ip route .................................................................................3 - 12

3.2.15 show ip route summary .................................................................3 - 13

3.2.16 show ip route preferences .............................................................3 - 13

3.2.17 show ip stats .................................................................................3 - 14

3

3.3 Router Discovery Protocol Commands ..................................................3 - 14

AT8901/2/3 CLI Reference Manual Page 0 - 6

AT8901/2/3

3.3.1 ip irdp ............................................................................................ 3 - 14

3.3.2 ip irdp address .............................................................................. 3 - 14

3.3.3 ip irdp holdtime ............................................................................. 3 - 15

3.3.4 ip irdp maxadvertinterval ............................................................... 3 - 15

3.3.5 ip irdp minadvertinterval ................................................................ 3 - 15

3.3.6 ip irdp preference .......................................................................... 3 - 16

3.3.7 show ip irdp ................................................................................... 3 - 16

3.4 Virtual LAN Routing Commands ........................................................... 3 - 17

3.4.1 vlan routing ................................................................................... 3 - 17

3.4.2 show ip vlan .................................................................................. 3 - 17

3.5 Virtual Router Redundancy Protocol Commands ................................. 3 - 17

3.5.1 ip vrrp ............................................................................................ 3 - 17

3.5.2 ip vrrp mode .................................................................................. 3 - 18

3.5.3 ip vrrp ip ........................................................................................ 3 - 18

3.5.4 ip vrrp authentication .................................................................... 3 - 19

3.5.5 ip vrrp preempt .............................................................................. 3 - 19

3.5.6 ip vrrp priority ................................................................................ 3 - 19

3.5.7 ip vrrp timers advertise ................................................................. 3 - 20

3.5.8 show ip vrrp interface stats ........................................................... 3 - 20

3.5.9 show ip vrrp .................................................................................. 3 - 21

3.5.10 show ip vrrp interface .................................................................... 3 - 21

3.5.11 show ip vrrp interface brief ............................................................ 3 - 22

3.6 DHCP and BOOTP Relay Commands .................................................. 3 - 22

3.6.1 bootpdhcprelay cidoptmode .......................................................... 3 - 22

3.6.2 bootpdhcprelay enable ................................................................. 3 - 22

3.6.3 bootpdhcprelay maxhopcount ....................................................... 3 - 23

3.6.4 bootpdhcprelay minwaittime ......................................................... 3 - 23

3.6.5 bootpdhcprelay serverip ............................................................... 3 - 24

3.6.6 show bootpdhcprelay .................................................................... 3 - 24

3.7 Open Shortest Path First (OSPF) Commands ...................................... 3 - 24

3.7.1 router ospf ..................................................................................... 3 - 24

3.7.2 enable (OSPF) .............................................................................. 3 - 24

3.7.3 ip ospf ........................................................................................... 3 - 25

3.7.4 1583compatibility .......................................................................... 3 - 25

3.7.5 area default-cost (OSPF) .............................................................. 3 - 25

3.7.6 area nssa (OSPF) ......................................................................... 3 - 26

3.7.7 area nssa default-info-originate (OSPF) ....................................... 3 - 26

3.7.8 area nssa no-redistribute (OSPF) ................................................. 3 - 26

3.7.9 area nssa no-summary (OSPF) .................................................... 3 - 26

3.7.10 area nssa translator-role (OSPF) .................................................. 3 - 26

3.7.11 area nssa translator-stab-intv (OSPF) .......................................... 3 - 27

3.7.12 area range (OSPF) ....................................................................... 3 - 27

3.7.13 area stub (OSPF) .......................................................................... 3 - 27

3.7.14 area stub no-summary (OSPF) ..................................................... 3 - 27

3.7.15 area virtual-link (OSPF) ................................................................ 3 - 28

Page 0 - 7 AT8901/2/3 CLI Reference Manual

AT8901/2/3

3.7.16 area virtual-link authentication ......................................................3 - 28

3.7.17 area virtual-link dead-interval (OSPF) ...........................................3 - 29

3.7.18 area virtual-link hello-interval (OSPF) ...........................................3 - 29

3.7.19 area virtual-link retransmit-interval (OSPF) ...................................3 - 29

3.7.20 area virtual-link transmit-delay (OSPF) .........................................3 - 30

3.7.21 default-information originate (OSPF) ............................................3 - 30

3.7.22 default-metric (OSPF) ...................................................................3 - 30

3.7.23 distance ospf (OSPF) ....................................................................3 - 31

3.7.24 distribute-list out (OSPF) ...............................................................3 - 31

3.7.25 exit-overflow-interval (OSPF) ........................................................3 - 31

3.7.26 external-lsdb-limit (OSPF) .............................................................3 - 32

3.7.27 ip ospf areaid .................................................................................3 - 32

3.7.28 ip ospf authentication ....................................................................3 - 32

3.7.29 ip ospf cost ....................................................................................3 - 33

3.7.30 ip ospf dead-interval ......................................................................3 - 33

3.7.31 ip ospf hello-interval ......................................................................3 - 34

3.7.32 ip ospf priority ................................................................................3 - 34

3.7.33 ip ospf retransmit-interval ..............................................................3 - 34

3.7.34 ip ospf transmit-delay ....................................................................3 - 35

3.7.35 ip ospf mtu-ignore .........................................................................3 - 35

3.7.36 router-id (OSPF) ............................................................................3 - 35

3.7.37 redistribute (OSPF) .......................................................................3 - 35

3.7.38 maximum-paths (OSPF) ...............................................................3 - 36

3.7.39 timers spf .......................................................................................3 - 36

3.7.40 trapflags (OSPF) ...........................................................................3 - 36

3.7.41 show ip ospf ..................................................................................3 - 37

3.7.42 show ip ospf area ..........................................................................3 - 38

3.7.43 show ip ospf border-routers ..........................................................3 - 39

3.7.44 show ip ospf database ..................................................................3 - 39

3.7.45 show ip ospf database database-summary ...................................3 - 40

3.7.46 show ip ospf interface ...................................................................3 - 41

3.7.47 show ip ospf interface brief ...........................................................3 - 42

3.7.48 show ip ospf interface stats ...........................................................3 - 42

3.7.49 show ip ospf neighbor ...................................................................3 - 43

3.7.50 show ip ospf range ........................................................................3 - 44

3.7.51 show ip ospf statistics ...................................................................3 - 45

3.7.52 show ip ospf stub table ..................................................................3 - 45

3.7.53 show ip ospf virtual-link .................................................................3 - 45

3.7.54 show ip ospf virtual-link brief .........................................................3 - 46

3.8 Routing Information Protocol (RIP) Commands ....................................3 - 46

3.8.1 router rip ........................................................................................3 - 46

3.8.2 enable (RIP) ..................................................................................3 - 46

3.8.3 ip rip ..............................................................................................3 - 47

3.8.4 auto-summary ...............................................................................3 - 47

3.8.5 default-information originate (RIP) ................................................3 - 47

3.8.6 default-metric (RIP) .......................................................................3 - 48

AT8901/2/3 CLI Reference Manual Page 0 - 8

AT8901/2/3

3.8.7 distance rip ................................................................................... 3 - 48

3.8.8 distribute-list out (RIP) .................................................................. 3 - 48

3.8.9 ip rip authentication ....................................................................... 3 - 49

3.8.10 ip rip receive version ..................................................................... 3 - 49

3.8.11 ip rip send version ......................................................................... 3 - 49

3.8.12 hostroutesaccept .......................................................................... 3 - 50

3.8.13 split-horizon .................................................................................. 3 - 50

3.8.14 redistribute (RIP) ........................................................................... 3 - 50

3.8.15 show ip rip ..................................................................................... 3 - 51

3.8.16 show ip rip interface brief .............................................................. 3 - 52

3.8.17 show ip rip interface ...................................................................... 3 - 52

Chapter

4. Quality of Service (QoS) Commands .......................................................... 4 - 2

4.1 Class of Service (CoS) Commands ........................................................ 4 - 2

4.1.1 classofservice dot1p-mapping ........................................................ 4 - 2

4.1.2 classofservice ip-precedence-mapping .......................................... 4 - 3

4.1.3 classofservice ip-dscp-mapping ...................................................... 4 - 3

4.1.4 classofservice trust ......................................................................... 4 - 3

4.1.5 cos-queue min-bandwidth ............................................................... 4 - 4

4.1.6 cos-queue strict .............................................................................. 4 - 4

4.1.7 traffic-shape .................................................................................... 4 - 5

4.1.8 show classofservice dot1p-mapping ............................................... 4 - 5

4.1.9 show classofservice ip-precedence-mapping ................................. 4 - 5

4.1.10 show classofservice ip-dscp-mapping ............................................ 4 - 6

4.1.11 show classofservice trust ................................................................ 4 - 6

4.1.12 show interfaces cos-queue ............................................................. 4 - 6

4.2 Differentiated Services (DiffServ) Commands ........................................ 4 - 7

4.2.1 diffserv ............................................................................................ 4 - 8

4.3 DiffServ Class Commands ...................................................................... 4 - 8

4.3.1 class-map ....................................................................................... 4 - 8

4.3.2 class-map rename .......................................................................... 4 - 9

4.3.3 match ethertype .............................................................................. 4 - 9

4.3.4 match any ....................................................................................... 4 - 9

4.3.5 match class-map ............................................................................. 4 - 9

4.3.6 match cos ..................................................................................... 4 - 10

4.3.7 match secondary-cos .................................................................... 4 - 10

4.3.8 match destination-address mac .................................................... 4 - 11

4.3.9 match dstip ................................................................................... 4 - 11

4.3.10 match dstl4port ............................................................................. 4 - 11

4.3.11 match ip dscp ................................................................................ 4 - 11

4.3.12 match ip precedence .................................................................... 4 - 12

4

Page 0 - 9 AT8901/2/3 CLI Reference Manual

AT8901/2/3

4.3.13 match ip tos ...................................................................................4 - 12

4.3.14 match protocol ...............................................................................4 - 12

4.3.15 match source-address mac ...........................................................4 - 13

4.3.16 match srcip ....................................................................................4 - 13

4.3.17 match srcl4port ..............................................................................4 - 13

4.3.18 match vlan .....................................................................................4 - 14

4.3.19 match secondary-vlan ...................................................................4 - 14

4.4 DiffServ Policy Commands ....................................................................4 - 14

4.4.1 assign-queue .................................................................................4 - 15

4.4.2 drop ...............................................................................................4 - 15

4.4.3 mirror .............................................................................................4 - 15

4.4.4 redirect ..........................................................................................4 - 15

4.4.5 conform-color ................................................................................4 - 15

4.4.6 class ..............................................................................................4 - 16

4.4.7 mark cos ........................................................................................4 - 16

4.4.8 mark ip-dscp ..................................................................................4 - 16

4.4.9 mark ip-precedence ......................................................................4 - 17

4.4.10 police-simple .................................................................................4 - 17

4.4.11 policy-map .....................................................................................4 - 17

4.4.12 policy-map rename ........................................................................4 - 18

4.5 DiffServ Service Commands ..................................................................4 - 18

4.5.1 service-policy ................................................................................4 - 18

4.6 DiffServ Show Commands .....................................................................4 - 19

4.6.1 show class-map ............................................................................4 - 19

4.6.2 show diffserv .................................................................................4 - 20

4.6.3 show policy-map ...........................................................................4 - 20

4.6.4 show diffserv service .....................................................................4 - 22

4.6.5 show diffserv service brief .............................................................4 - 22

4.6.6 show policy-map interface .............................................................4 - 23

4.6.7 show service-policy .......................................................................4 - 23

4.7 MAC Access Control List (ACL) Commands .........................................4 - 24

4.7.1 mac access-list extended ..............................................................4 - 24

4.7.2 mac access-list extended rename .................................................4 - 24

4.7.3 {deny | permit} ...............................................................................4 - 25

4.7.4 mac access-group .........................................................................4 - 26

4.7.5 show mac access-lists ..................................................................4 - 26

4.8 IP Access Control List (ACL) Commands ..............................................4 - 27

4.8.1 access-list .....................................................................................4 - 27

4.8.2 ip access-group .............................................................................4 - 29

4.8.3 acl-trapflags ...................................................................................4 - 29

4.8.4 show ip access-lists ......................................................................4 - 30

4.8.5 show access-lists ..........................................................................4 - 31

AT8901/2/3 CLI Reference Manual Page 0 - 10

AT8901/2/3

Chapter

5. Utility Commands ........................................................................................ 5 - 2

5.1 Commands for accessing base/extension fabric ..................................... 5 - 2

5.1.1 base ................................................................................................ 5 - 2

5.1.2 extension ........................................................................................ 5 - 2

5.2 Commands for download and startup Configuration ............................... 5 - 2

5.2.1 download application ...................................................................... 5 - 3

5.2.2 download ipmifw ............................................................................. 5 - 3

5.2.3 download fwum ............................................................................... 5 - 3

5.2.4 download {kernel | initrd} ................................................................ 5 - 3

5.2.5 download frudata ............................................................................ 5 - 3

5.2.6 download bootloader ...................................................................... 5 - 3

5.2.7 show startupconfig .......................................................................... 5 - 4

5.2.8 startupslot <slotnumber> config ...................................................... 5 - 4

5.2.9 startupslot <slotnumber> activate ................................................... 5 - 4

5.3 ATCA commands .................................................................................... 5 - 4

5.3.1 set board sensor threshold ............................................................. 5 - 4

5.3.2 set board ipmi-controller debug ...................................................... 5 - 5

5.3.3 set board fcap ................................................................................. 5 - 5

5.3.4 set board routing ............................................................................. 5 - 5

5.3.5 atca port override ............................................................................ 5 - 5

5.3.6 atca ekeying invalidate ................................................................... 5 - 6

5.3.7 show atca ekeying .......................................................................... 5 - 6

5

5.4 System Information and Statistics Commands ....................................... 5 - 6

5.4.1 show arp switch .............................................................................. 5 - 6

5.4.2 show eventlog ................................................................................. 5 - 7

5.4.3 show hardware ............................................................................... 5 - 7

5.4.4 show version ................................................................................... 5 - 7

5.4.5 show interface ................................................................................. 5 - 8

5.4.6 show interface ethernet .................................................................. 5 - 9

5.4.7 show mac-addr-table .................................................................... 5 - 15

5.4.8 show running-config ...................................................................... 5 - 16

5.4.9 show sysinfo ................................................................................. 5 - 17

5.4.10 show tech-support ........................................................................ 5 - 17

5.4.11 show boardinfo post-status ........................................................... 5 - 17

5.4.12 show boardinfo sensors ................................................................ 5 - 17

5.4.13 show boardinfo event-log .............................................................. 5 - 18

5.4.14 show boardinfo update-status ....................................................... 5 - 18

5.4.15 show boardinfo version ................................................................. 5 - 18

5.4.16 show boardinfo address ................................................................ 5 - 19

5.4.17 show boardinfo fru ........................................................................ 5 - 19

Page 0 - 11 AT8901/2/3 CLI Reference Manual

AT8901/2/3

5.4.18 show boardinfo ipmidev ................................................................5 - 19

5.4.19 show boardinfo led ........................................................................5 - 19

5.4.20 show boardinfo amc connection ....................................................5 - 19

5.4.21 show boardinfo amc fru .................................................................5 - 19

5.4.22 show boardinfo fcap ......................................................................5 - 19

5.4.23 show boardinfo routing ..................................................................5 - 20

5.5 Logging Commands ...............................................................................5 - 20

5.5.1 logging buffered ............................................................................5 - 20

5.5.2 logging buffered wrap ....................................................................5 - 20

5.5.3 logging console .............................................................................5 - 20

5.5.4 logging host ...................................................................................5 - 21

5.5.5 logging host remove ......................................................................5 - 21

5.5.6 logging port ...................................................................................5 - 21

5.5.7 logging syslog ...............................................................................5 - 22

5.5.8 show logging .................................................................................5 - 22

5.5.9 show logging buffered ...................................................................5 - 22

5.5.10 show logging hosts ........................................................................5 - 23

5.5.11 show logging traplogs ...................................................................5 - 23

5.5.12 show logging backtrace .................................................................5 - 23

5.6 System Utility and Clear Commands .....................................................5 - 23

5.6.1 traceroute ......................................................................................5 - 24

5.6.2 clear config ....................................................................................5 - 24

5.6.3 clear counters ................................................................................5 - 24

5.6.4 clear igmpsnooping .......................................................................5 - 24

5.6.5 clear pass ......................................................................................5 - 24

5.6.6 clear port-channel .........................................................................5 - 24

5.6.7 clear traplog ..................................................................................5 - 25

5.6.8 clear vlan .......................................................................................5 - 25

5.6.9 clear board event-log ....................................................................5 - 25

5.6.10 enable passwd ..............................................................................5 - 25

5.6.11 logout ............................................................................................5 - 25

5.6.12 set bootstopkey .............................................................................5 - 25

5.6.13 ping ...............................................................................................5 - 26

5.6.14 quit ................................................................................................5 - 26

5.6.15 reload ............................................................................................5 - 26

5.6.16 copy ...............................................................................................5 - 26

5.7 Keying for Advanced Features ..............................................................5 - 28

5.7.1 license advanced ..........................................................................5 - 28

5.7.2 show key-features .........................................................................5 - 28

5.8 Simple Network Time Protocol (SNTP) Commands ..............................5 - 28

5.8.1 sntp broadcast client poll-interval ..................................................5 - 29

5.8.2 sntp client mode ............................................................................5 - 29

5.8.3 sntp client port ...............................................................................5 - 29

5.8.4 sntp unicast client poll-interval ......................................................5 - 29

5.8.5 sntp unicast client poll-timeout ......................................................5 - 30

AT8901/2/3 CLI Reference Manual Page 0 - 12

AT8901/2/3

5.8.6 sntp unicast client poll-retry .......................................................... 5 - 30

5.8.7 sntp multicast client poll-interval ................................................... 5 - 30

5.8.8 sntp server .................................................................................... 5 - 31

5.8.9 show sntp ...................................................................................... 5 - 31

5.8.10 show sntp client ............................................................................ 5 - 31

5.8.11 show sntp server ........................................................................... 5 - 32

5.9 DHCP Server Commands ..................................................................... 5 - 32

5.9.1 ip dhcp pool .................................................................................. 5 - 32

5.9.2 client-identifier ............................................................................... 5 - 33

5.9.3 client-name ................................................................................... 5 - 33

5.9.4 default-router ................................................................................ 5 - 33

5.9.5 dns-server ..................................................................................... 5 - 34

5.9.6 hardware-address ......................................................................... 5 - 34

5.9.7 host ............................................................................................... 5 - 34

5.9.8 lease ............................................................................................. 5 - 35

5.9.9 network (DHCP Pool Config) ........................................................ 5 - 35

5.9.10 bootfile .......................................................................................... 5 - 35

5.9.11 domain-name ................................................................................ 5 - 36

5.9.12 netbios-name-server ..................................................................... 5 - 36

5.9.13 netbios-node-type ......................................................................... 5 - 36

5.9.14 next-server .................................................................................... 5 - 37

5.9.15 option ............................................................................................ 5 - 37

5.9.16 ip dhcp excluded-address ............................................................. 5 - 38

5.9.17 ip dhcp ping packets ..................................................................... 5 - 38

5.9.18 service dhcp .................................................................................. 5 - 38

5.9.19 ip dhcp bootp automatic ................................................................ 5 - 39

5.9.20 ip dhcp conflict logging ................................................................. 5 - 39

5.9.21 clear ip dhcp binding ..................................................................... 5 - 39

5.9.22 clear ip dhcp server statistics ........................................................ 5 - 40

5.9.23 clear ip dhcp conflict ..................................................................... 5 - 40

5.9.24 show ip dhcp binding .................................................................... 5 - 40

5.9.25 show ip dhcp global configuration ................................................. 5 - 40

5.9.26 show ip dhcp pool configuration ................................................... 5 - 41

5.9.27 show ip dhcp server statistics ....................................................... 5 - 41

5.9.28 show ip dhcp conflict ..................................................................... 5 - 42

5.10 DHCP Filtering ...................................................................................... 5 - 42

5.10.1 ip dhcp filtering .............................................................................. 5 - 42

5.10.2 ip dhcp filtering trust ...................................................................... 5 - 43

5.10.3 show ip dhcp filtering .................................................................... 5 - 43

Chapter

6. Management Commands ............................................................................ 6 - 2

6

Page 0 - 13 AT8901/2/3 CLI Reference Manual

AT8901/2/3

6.1 Network Interface Commands .................................................................6 - 2

6.1.1 enable (Privileged EXEC access) ...................................................6 - 2

6.1.2 serviceport ip ...................................................................................6 - 2

6.1.3 serviceport protocol .........................................................................6 - 3

6.1.4 network parms .................................................................................6 - 3

6.1.5 network protocol ..............................................................................6 - 3

6.1.6 network mac-address ......................................................................6 - 3

6.1.7 network mac-type ............................................................................6 - 3

6.1.8 network javamode ...........................................................................6 - 4

6.1.9 show network ..................................................................................6 - 4

6.1.10 show serviceport .............................................................................6 - 5

6.2 Console Port Access Commands ............................................................6 - 5

6.2.1 configuration ....................................................................................6 - 5

6.2.2 lineconfig .........................................................................................6 - 6

6.2.3 serial baudrate ................................................................................6 - 6

6.2.4 serial timeout ...................................................................................6 - 6

6.2.5 show serial ......................................................................................6 - 6

6.3 Telnet Commands ...................................................................................6 - 7

6.3.1 ip telnet server enable .....................................................................6 - 7

6.3.2 telnet ...............................................................................................6 - 7

6.3.3 transport input telnet .......................................................................6 - 8

6.3.4 transport output telnet .....................................................................6 - 8

6.3.5 session-limit ....................................................................................6 - 8

6.3.6 session-timeout ...............................................................................6 - 9

6.3.7 telnetcon maxsessions ....................................................................6 - 9

6.3.8 telnetcon timeout .............................................................................6 - 9

6.3.9 disconnect .....................................................................................6 - 10

6.3.10 show telnet ....................................................................................6 - 10

6.3.11 show telnetcon ..............................................................................6 - 10

6.4 Secure Shell (SSH) Command ..............................................................6 - 11

6.4.1 ip ssh .............................................................................................6 - 11

6.4.2 ip ssh protocol ...............................................................................6 - 11

6.4.3 ip ssh server enable ......................................................................6 - 11

6.4.4 sshcon maxsessions .....................................................................6 - 12

6.4.5 sshcon timeout ..............................................................................6 - 12

6.4.6 show ip ssh ...................................................................................6 - 12

6.5 User Account Commands ......................................................................6 - 13

6.5.1 users name ...................................................................................6 - 13

6.5.2 users passwd ................................................................................6 - 13

6.5.3 users snmpv3 accessmode ...........................................................6 - 14

6.5.4 users snmpv3 authentication ........................................................6 - 14

6.5.5 users snmpv3 encryption ..............................................................6 - 15

6.5.6 show loginsession .........................................................................6 - 15

6.5.7 show users ....................................................................................6 - 16

6.6 SNMP Commands .................................................................................6 - 16

AT8901/2/3 CLI Reference Manual Page 0 - 14

AT8901/2/3

6.6.1 snmp-server .................................................................................. 6 - 16

6.6.2 snmp-server bind .......................................................................... 6 - 16

6.6.3 snmp-server community ............................................................... 6 - 17

6.6.4 snmp-server community ipaddr .................................................... 6 - 17

6.6.5 snmp-server community ipmask ................................................... 6 - 18

6.6.6 snmp-server community mode ..................................................... 6 - 18

6.6.7 snmp-server community ro ........................................................... 6 - 18

6.6.8 snmp-server community rw ........................................................... 6 - 19

6.6.9 snmp-server enable traps violation ............................................... 6 - 19

6.6.10 snmp-server enable traps ............................................................. 6 - 19

6.6.11 snmp-server enable traps bcaststorm .......................................... 6 - 19

6.6.12 snmp-server enable traps linkmode .............................................. 6 - 20

6.6.13 snmp-server enable traps multiusers ............................................ 6 - 20

6.6.14 snmp-server enable traps stpmode .............................................. 6 - 20

6.6.15 snmptrap ....................................................................................... 6 - 21

6.6.16 snmptrap snmpversion ................................................................. 6 - 21

6.6.17 snmptrap ipaddr ............................................................................ 6 - 21

6.6.18 snmptrap mode ............................................................................. 6 - 22

6.6.19 snmp trap link-status ..................................................................... 6 - 22

6.6.20 snmp trap link-status all ................................................................ 6 - 22

6.6.21 show snmpbind ............................................................................. 6 - 23

6.6.22 show snmpcommunity .................................................................. 6 - 23

6.6.23 show snmptrap ............................................................................. 6 - 23

6.6.24 show trapflags ............................................................................... 6 - 24

6.7 CLI Command Logging Command ........................................................ 6 - 24

6.7.1 logging cli-command ..................................................................... 6 - 25

6.8 RADIUS Commands ............................................................................. 6 - 25

6.8.1 radius accounting mode ................................................................ 6 - 25

6.8.2 radius server host ......................................................................... 6 - 25

6.8.3 radius server key .......................................................................... 6 - 26

6.8.4 radius server msgauth .................................................................. 6 - 26

6.8.5 radius server primary .................................................................... 6 - 27

6.8.6 radius server retransmit ................................................................ 6 - 27

6.8.7 radius server timeout .................................................................... 6 - 27

6.8.8 show radius ................................................................................... 6 - 28

6.8.9 show radius accounting ................................................................ 6 - 28

6.8.10 show radius statistics .................................................................... 6 - 29

6.9 TACACS+ Commands .......................................................................... 6 - 30

6.9.1 tacacs-server host ........................................................................ 6 - 30

6.9.2 tacacs-server key .......................................................................... 6 - 31

6.9.3 tacacs-server timeout ................................................................... 6 - 31

6.9.4 key ................................................................................................ 6 - 31

6.9.5 port ................................................................................................ 6 - 32

6.9.6 priority ........................................................................................... 6 - 32

6.9.7 timeout .......................................................................................... 6 - 32

Page 0 - 15 AT8901/2/3 CLI Reference Manual

AT8901/2/3

6.9.8 show tacacs ..................................................................................6 - 32

6.10 Configuration Scripting Commands .......................................................6 - 33

6.10.1 script apply ....................................................................................6 - 33

6.10.2 script apply nointerl.scr .................................................................6 - 33

6.10.3 script delete ...................................................................................6 - 34

6.10.4 script list ........................................................................................6 - 34

6.10.5 script show ....................................................................................6 - 34

6.10.6 script validate ................................................................................6 - 34

6.11 Pre-login Banner and System Prompt Commands ................................6 - 35

6.11.1 copy (pre-login banner) .................................................................6 - 35

6.11.2 set prompt .....................................................................................6 - 35

6.12 Watchdog support ..................................................................................6 - 35

6.12.1 show watchdog .............................................................................6 - 35

6.12.2 set watchdog .................................................................................6 - 36

6.13 ASI commands ......................................................................................6 - 36

6.13.1 show asi register ...........................................................................6 - 36

6.13.2 asi register write ............................................................................6 - 36

6.13.3 download asi srom ........................................................................6 - 36

Appendix

A. Getting Help ................................................................................................ A - 2

Appendix

B. List of Commands ....................................................................................... B - 2

A

B

AT8901/2/3 CLI Reference Manual Page 0 - 16

AT8901/2/3

Chapter 1

1

Using the Command-Line Interface

Page 1 - 1 AT8901/2/3 CLI Reference Manual

Using the Command-Line Interface AT8901/2/3

1. Using the Command-Line Interface

The command-line interface (CLI) is a text-based way to manage and monitor the
system. You can access the CLI by using a direct serial connection or by using a
remote logical connection with telnet or SSH.

This chapter describes the CLI syntax, conventions, and modes. It contains the
following sections:

• 1.1 “Command Syntax” on page 1 - 2

• 1.2 “Command Conventions” on page 1 - 2

• 1.3 “Slot/Port Naming Convention” on page 1 - 4

• 1.4 “Using the “No” Form of a Command” on page 1 - 5

• 1.5 “Command Modes” on page 1 - 5

• 1.6 “Using CLI Help” on page 1 - 9

• 1.7 “Accessing the CLI” on page 1 - 10

1.1 Command Syntax

A command is one or more words that might be followed by one or more parameters.
Parameters can be required or optional values.

Some commands, such as
Other commands, such as
command. You must type the parameter values in a specific order, and optional
parameters follow required parameters. The following example describes the

command syntax:

parms

Format

• network parms is the command name.

<ipaddr> and <netmask> are parameters and represent required values that you

•
must enter after you type the command keywords.

•

[gateway] is an optional parameter, so you are not required to enter a value in

place of the parameter.

The CLI Reference lists each command by the command name and provides a brief
description of the command. Each command reference also contains the following
information:

• Format shows the command keywords and the required and optional parameters.

• Mode identifies the command mode you must be in to access the command.

• Default shows the default value, if any, of a configurable setting on the device.

network parms <ipaddr> <netmask> [gateway]

show network or clear vlan, do not require parameters.
network parms, require that you supply a value after the

network

The

show commands also contain a description of the information that the command

shows.

1.2 Command Conventions

In this document, the command name is in bold font. Parameters are in italic font.
You must replace the parameter name with an appropriate value, which might be a
name or number. Parameters are order dependent.

AT8901/2/3 CLI Reference Manual Page 1 - 2

AT8901/2/3 Using the Command-Line Interface

The parameters for a command might include mandatory values, optional values, or
keyword choices. Table 1 describes the conventions this document uses to distinguish
between value types.

Table 1. Parameter Conventions

Symbol Example Description

<> angle brackets

[] square brackets

{} curly braces

| Vertical bars

[{}] Braces within
square brackets

<value>

[value]

{choice1 | choice2}

choice1 | choice2

[{choice1 | choice2}]

Indicates that you must enter a value
in place of the brackets and text
inside them.

Indicates an optional parameter that
you can enter in place of the brackets
and text inside them.

Indicates that you must select a
parameter from the list of choices.

Separates the mutually exclusive
choices.

Indicates a choice within an optional
element.

1.2.1 Common Parameter Values

Parameter values might be names (strings) or numbers.To use spaces as part of a name
parameter, enclose the name value in double quotes. For example, the expression
“System Name with Spaces” forces the system to accept the spaces. Empty strings (““)
are not valid user-defined strings. Table 2 describes common parameter values and
value formatting.

Table 2. Parameter Descriptions

Parameter Description

ipaddr This parameter is a valid IP address. You can enter the IP address in the

following formats:

a (32 bits)

a.b (8.24 bits)

a.b.c (8.8.16 bits)

a.b.c.d (8.8.8.8)

In addition to these formats, the CLI accepts decimal, hexidecimal and
octal formats through the following input formats (where n is any valid
hexidecimal, octal or decimal number):

0xn (CLI assumes hexidecimal format)

0n (CLI assumes octal format with leading zeros)

n (CLI assumes decimal format)

areaid Enter area IDs in dotted-decimal notation (for example, 0.0.0.1). An

area ID of 0.0.0.0 is reserved for the backbone. Area IDs have the same
format as IP addresses but are distinct from IP addresses. You can use
the IP network number of the sub-netted network for the area ID.

routerid Enter the value of

0.0.0.1. A router ID of 0.0.0.0 is invalid.

<routerid> in dotted-decimal notation, such as

Page 1 - 3 AT8901/2/3 CLI Reference Manual

Using the Command-Line Interface AT8901/2/3

Table 2. Parameter Descriptions

Parameter Description

Interface or
unit/slot/port

Logical Interface Represents a Logical slot and port number.. This is applicable in the

Character strings Use double quotation marks to identify character strings, for example,

1.3 Slot/Port Naming Convention

FASTPATH software references physical entities such as cards and ports by using a
unit/slot/port naming convention. The FASTPATH software also uses this convention
to identify certain logical entities, such as Port-Channel interfaces.

The slot number has two uses. In the case of physical ports, it identifies the card
containing the ports. In the case of logical and CPU ports it also identifies the type of
interface or port.

Table 3. Type of Slots

Valid slot and port number separated by forward slashes. For example,
0/1 represents slot number 0 and port number 1.

case of a port-channel (LAG). You can use the logical unit/slot/port to
configure the port-channel.

“System Name with Spaces”. An empty string (“”) is not valid.

Slot Type Description

Physical slot numbers Physical slot numbers begin with zero, and are allocated up to the

maximum number of physical slots.

Logical slot numbers Logical slots immediately follow physical slots and identify port-

channel (LAG) or router interfaces.

CPU slot numbers The CPU slots immediately follow the logical slots.

The port identifies the specific physical port or logical interface being managed on a
given slot.

Table 4. Type of Ports

Port Type Description

Physical Ports The physical ports for each slot are numbered sequentially starting

from zero.

Logical Interfaces Port-channel or Link Aggregation Group (LAG) interfaces are

logical interfaces that are only used for bridging functions.

VLAN routing interfaces are only used for routing functions.

Loopback interfaces are logical interfaces that are always up.

Tunnel interfaces are logical point-to-point links that carry encap­sulated packets.

CPU ports CPU ports are handled by the driver as one or more physical enti-

ties located on physical slots.

NOTE: In the CLI, loopback and tunnel interfaces do not use the unit/slot/port

format. To specify a loopback interface, you use the loopback ID. To
specify a tunnel interface, you use the tunnel ID.

AT8901/2/3 CLI Reference Manual Page 1 - 4

AT8901/2/3 Using the Command-Line Interface

1.4 Using the “No” Form of a Command

The no keyword is a specific form of an existing command and does not represent a
new or distinct command. Almost every configuration command has a
general, use the
default. For example, the
of an interface. Use the command without the keyword

no form to reverse the action of a command or reset a value back to the

no shutdown configuration command reverses the shutdown

no to re-enable a disabled

feature or to enable a feature that is disabled by default.

no form. In

Only the configuration commands are available in the

1.5 Command Modes

The CLI groups commands into modes according to the command function. Each of
the command modes supports specific FASTPATH software commands. The
commands in one mode are not available until you switch to that particular mode, with
the exception of the User EXEC mode commands. You can execute the User EXEC
mode commands in the Privileged EXEC mode.

The command prompt changes in each command mode to help you identify the current
mode. Table 5 describes the command modes and the prompts visible in that mode.

Table 5. CLI Command Modes

Command

Mode

User EXEC

Privileged EXEC

Global Config

VLAN Config

Interface Config

Switch>

Switch#

Switch (Config)#

Switch (Vlan)#

Switch (Interface <unit/slot/
port>)#

Switch (Interface Loopback <id>)#

Switch (Interface Tunnel <id>)#

no form.

Prompt Mode Description

Contains a limited set of
commands to view basic
system information.

Allows you to issue any

EXEC command, enter

the VLAN mode, or
enter the Global Config­uration mode.

Groups general setup
commands and permits
you to make modifica­tions to the running con­figuration.

Groups all the VLAN
commands.

Allows you to enable or
modify the operation of
an interface and provides
access to the router inter­face configuration com­mands.

Use this mode to set up a
physical port for a spe­cific logical connection
operation.

Page 1 - 5 AT8901/2/3 CLI Reference Manual

Using the Command-Line Interface AT8901/2/3

Table 5. CLI Command Modes

Command

Mode

Line Config

Policy Map
Config

Policy Class
Config

Class Map Con­fig

Router OSPF
Config

Router RIP Con­fig

MAC Access-list
Config

TACACS Config

DHCP Pool
Config

Prompt Mode Description

Switch (line)#

Switch (Config-policy-map)#

Switch (Config-policy-class-map)#

Switch (Config-class-map)#

Switch (Config-router)#

Switch (Config-router)#

Switch (Config-mac-access-list)#

Switch (Tacacs)#

Switch (Config dhcp-pool)#

Allows you to configure
various telnet settings
and the console interface.

Allows you to access the
QoS Policy-Map config­uration mode to config­ure the QoS Policy-Map.

Consists of class cre­ation, deletion, and
matching commands.
The class match com­mands specify Layer 2,
Layer 3, and general
match criteria.

Allows you to access the
QoS Class-Map configu­ration mode to configure
QoS class maps.

Allows you to access the
OSPF configuration
commands.

Allows you to access the
RIP configuration com­mands.

Allows you to create a
MAC Access-List and to
enter the mode contain­ing Mac Access-List
configuration com­mands.

Allows you to configure
properties for the
TACACS servers.

Allows you to access the
DHCP Pool configura­tion.

Table 6 explains how to enter or exit each mode.

Table 6. CLI Mode Access and Exit

Command

Mode

User EXEC This is the first level of access. To exit, enter

Privileged EXEC From the User EXEC mode, enter

enable.

AT8901/2/3 CLI Reference Manual Page 1 - 6

Access Method

Exit or Access Previous

Mode

logout.

To exit to the User EXEC
mode, enter exit or press
Ctrl-Z.