Kontron AT8901M CLI User Manual

AT8901M CLI Reference Manual

AdvancedTCA

M5305_TECH_2 Manual ID

1.05 Revision Index

26 March, 2008 Date of Issue

AT8901M Preface

Revision History

Publication Title: AT8901M CLI Reference Manual

ID Number: M5305_TECH_2

Rev.

Index

1.00 Initial Issue 2007-01-09

1.01 BGP references removed 2007-03-06

1.02 AT8904M only 2007-04-05

1.03 AT8902M only 2007-05-08

1.04 Added commands for Port channel, LAG and multicast for AT8901M,

AT8902M and AT8904M

1.05 Added “show boardinfo memory-usage” command 2008-03-26

Brief Description of Changes Date of Issue

2007-11-06

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 AT8901M CLI Reference Manual

AT8901M Table of Contents

Chapter

1

Chapter

2

Table of Contents

Revision History .........................................................................................................ii

Imprint ........................................................................................................................ii

Disclaimer ..................................................................................................................ii

Table of Contents ......................................................................................................iii

About This Book ......................................................................................................xxi

Why the Document was Created ............................................................................xxi

How to Use This Document .................................................................................... xxi

Proprietary Note ......................................................................................................xxi

Trademarks ............................................................................................................ xxii

Environmental Protection Statement ...................................................................... xxii

Explanation of Symbols ........................................................................................ xxiii

For Your Safety ..................................................................................................... xxiii

High Voltage Safety Instructions ....................................................................... xxiv

Special Handling and Unpacking Instructions .................................................. xxiv

General Instructions on Usage .......................................................................... xxv

Two Year Warranty ................................................................................................. xxv

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

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

iii AT8901M CLI Reference Manual

Table of Contents AT8901M

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

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

AT8901M CLI Reference Manual iv

AT8901M Table of Contents

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

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

v AT8901M CLI Reference Manual

Table of Contents AT8901M

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

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

AT8901M CLI Reference Manual vi

AT8901M Table of Contents

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

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

vii AT8901M CLI Reference Manual

Table of Contents AT8901M

Chapter

3

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

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

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

AT8901M CLI Reference Manual viii

AT8901M Table of Contents

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

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

3.2.1 routing ............................................................................................. 3 - 6

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

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

3.2.4 ip route ............................................................................................ 3 - 7

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

3.2.6 ip route distance ............................................................................. 3 - 8

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

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

3.2.9 ip mtu .............................................................................................. 3 - 9

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

3.2.11 show ip brief .................................................................................. 3 - 10

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

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

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

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

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

3.2.17 show ip stats ................................................................................. 3 - 13

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

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

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

3.3.3 ip irdp holdtime ............................................................................. 3 - 14

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

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

3.3.6 ip irdp preference .......................................................................... 3 - 15

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

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

3.4.1 vlan routing ................................................................................... 3 - 16

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

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

3.5.1 ip vrrp (Global Config) ................................................................... 3 - 17

3.5.2 ip vrrp (Interface Config) ............................................................... 3 - 17

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

3.5.4 ip vrrp ip ........................................................................................ 3 - 18

3.5.5 ip vrrp authentication .................................................................... 3 - 18

3.5.6 ip vrrp preempt .............................................................................. 3 - 19

3.5.7 ip vrrp priority ................................................................................ 3 - 19

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

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

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

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

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

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

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

ix AT8901M CLI Reference Manual

Table of Contents AT8901M

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 - 23

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 - 25

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 - 27

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 - 28

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

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

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

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 - 30

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

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

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

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

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

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

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

3.7.27 ip ospf areaid .................................................................................3 - 33

3.7.28 ip ospf authentication ....................................................................3 - 33

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

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

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 - 35

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 - 36

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

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

3.7.39 timers spf .......................................................................................3 - 37

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

AT8901M CLI Reference Manual x

AT8901M Table of Contents

Chapter

4

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

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

3.7.43 show ip ospf area .......................................................................... 3 - 39

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

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

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 - 44

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

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

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

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

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

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

3.8.1 router rip ....................................................................................... 3 - 48

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

3.8.3 ip rip .............................................................................................. 3 - 48

3.8.4 auto-summary ............................................................................... 3 - 48

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

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

3.8.7 distance rip ................................................................................... 3 - 49

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

3.8.9 ip rip authentication ....................................................................... 3 - 50

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

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

3.8.12 hostroutesaccept .......................................................................... 3 - 51

3.8.13 split-horizon .................................................................................. 3 - 51

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

3.8.15 show ip rip ..................................................................................... 3 - 52

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

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

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-dscp-mapping ...................................................... 4 - 3

4.1.3 classofservice trust ......................................................................... 4 - 3

4.1.4 cos-queue min-bandwidth ............................................................... 4 - 4

4.1.5 cos-queue strict .............................................................................. 4 - 4

4.1.6 traffic-shape .................................................................................... 4 - 4

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

xi AT8901M CLI Reference Manual

Table of Contents AT8901M

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

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

4.1.10 show classofservice trust ................................................................4 - 6

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

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

4.2.1 diffserv .............................................................................................4 - 7

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 - 10

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 - 11

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 - 13

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

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

4.4.1 assign-queue .................................................................................4 - 14

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 - 15

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

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

4.4.9 mark ip-precedence ......................................................................4 - 16

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

AT8901M CLI Reference Manual xii

AT8901M Table of Contents

Chapter

5

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 - 23

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 - 24

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 - 29

4.8.5 show access-lists .......................................................................... 4 - 30

4.9 ACL trap commands ............................................................................. 4 - 31

4.9.1 acl-traptimer .................................................................................. 4 - 31

4.9.2 show acl-traptimer ........................................................................ 4 - 31

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

5.1 Commands for update and startup Configuration ................................... 5 - 2

5.1.1 download ipmifw ............................................................................. 5 - 2

5.1.2 download initrd ................................................................................ 5 - 2

5.1.3 download frudata ............................................................................ 5 - 3

5.1.4 download fwum ............................................................................... 5 - 3

5.1.5 download bootloader ...................................................................... 5 - 3

5.1.6 download amcipmifw ...................................................................... 5 - 3

5.1.7 startupslot ....................................................................................... 5 - 3

5.1.8 startupslot activate .......................................................................... 5 - 4

5.1.9 show startupconfig .......................................................................... 5 - 4

5.2 ATCA commands .................................................................................... 5 - 4

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

5.2.2 set board ipmi-controller debug ...................................................... 5 - 4

5.2.3 set board fcap ................................................................................. 5 - 5

5.2.4 show boardinfo fcap ........................................................................ 5 - 5

5.2.5 set board routing ............................................................................. 5 - 5

5.2.6 show boardinfo routing ................................................................... 5 - 5

5.2.7 ekeying ........................................................................................... 5 - 5

5.2.8 show atca ekeying .......................................................................... 5 - 6

xiii AT8901M CLI Reference Manual

Table of Contents AT8901M

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

5.3.1 show arp switch ...............................................................................5 - 6

5.3.2 show eventlog .................................................................................5 - 6

5.3.3 show hardware ................................................................................5 - 6

5.3.4 show version ...................................................................................5 - 7

5.3.5 show interface .................................................................................5 - 7

5.3.6 show interface ethernet ...................................................................5 - 8

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

5.3.8 show running-config ......................................................................5 - 16

5.3.9 show sysinfo ..................................................................................5 - 16

5.3.10 show tech-support .........................................................................5 - 17

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

5.3.12 show boardinfo sensors ................................................................5 - 17

5.3.13 show boardinfo event-log ..............................................................5 - 17

5.3.14 show boardinfo update-status .......................................................5 - 17

5.3.15 show boardinfo version .................................................................5 - 18

5.3.16 show boardinfo address ................................................................5 - 18

5.3.17 show boardinfo fru .........................................................................5 - 18

5.3.18 show boardinfo ipmidev ................................................................5 - 18

5.3.19 show boardinfo led ........................................................................5 - 19

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

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

5.3.22 show boardinfo amc ipmidev .........................................................5 - 19

5.3.23 show boardinfo cpu-load ...............................................................5 - 19

5.3.24 show boardinfo memory-usage .....................................................5 - 19

5.4 Logging Commands ...............................................................................5 - 20

5.4.1 logging buffered .............................................................................5 - 20

5.4.2 logging buffered wrap ....................................................................5 - 20

5.4.3 logging cli-command .....................................................................5 - 20

5.4.4 logging console .............................................................................5 - 21

5.4.5 logging host ...................................................................................5 - 21

5.4.6 logging host remove ......................................................................5 - 21

5.4.7 logging port ...................................................................................5 - 21

5.4.8 logging syslog ...............................................................................5 - 22

5.4.9 show logging .................................................................................5 - 22

5.4.10 show logging buffered ...................................................................5 - 22

5.4.11 show logging hosts ........................................................................5 - 23

5.4.12 show logging traplogs ...................................................................5 - 23

5.4.13 show logging backtrace .................................................................5 - 23

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

5.5.1 traceroute ......................................................................................5 - 24

5.5.2 clear config ....................................................................................5 - 24

5.5.3 clear counters ................................................................................5 - 24

5.5.4 clear igmpsnooping .......................................................................5 - 24

5.5.5 clear pass ......................................................................................5 - 24

5.5.6 clear port-channel .........................................................................5 - 24

AT8901M CLI Reference Manual xiv

AT8901M Table of Contents

5.5.7 clear traplog .................................................................................. 5 - 25

5.5.8 clear vlan ...................................................................................... 5 - 25

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

5.5.10 enable passwd .............................................................................. 5 - 25

5.5.11 logout ............................................................................................ 5 - 25

5.5.12 set bootstopkey ............................................................................. 5 - 25

5.5.13 ping ............................................................................................... 5 - 26

5.5.14 quit ................................................................................................ 5 - 26

5.5.15 reload ............................................................................................ 5 - 26

5.5.16 copy .............................................................................................. 5 - 26

5.6 Keying for Advanced Features .............................................................. 5 - 27

5.6.1 license advanced .......................................................................... 5 - 27

5.6.2 show key-features ......................................................................... 5 - 28

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

5.7.1 sntp broadcast client poll-interval ................................................. 5 - 28

5.7.2 sntp client mode ............................................................................ 5 - 28

5.7.3 sntp client port .............................................................................. 5 - 29

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

5.7.5 sntp unicast client poll-timeout ...................................................... 5 - 29

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

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

5.7.8 sntp server .................................................................................... 5 - 30

5.7.9 show sntp ...................................................................................... 5 - 30

5.7.10 show sntp client ............................................................................ 5 - 31

5.7.11 show sntp server ........................................................................... 5 - 31

5.8 DHCP Server Commands ..................................................................... 5 - 32

5.8.1 ip dhcp pool .................................................................................. 5 - 32

5.8.2 client-identifier ............................................................................... 5 - 32

5.8.3 client-name ................................................................................... 5 - 33

5.8.4 default-router ................................................................................ 5 - 33

5.8.5 dns-server ..................................................................................... 5 - 33

5.8.6 hardware-address ......................................................................... 5 - 34

5.8.7 host ............................................................................................... 5 - 34

5.8.8 lease ............................................................................................. 5 - 34

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

5.8.10 bootfile .......................................................................................... 5 - 35

5.8.11 domain-name ................................................................................ 5 - 35

5.8.12 netbios-name-server ..................................................................... 5 - 36

5.8.13 netbios-node-type ......................................................................... 5 - 36

5.8.14 next-server .................................................................................... 5 - 36

5.8.15 option ............................................................................................ 5 - 37

5.8.16 ip dhcp excluded-address ............................................................. 5 - 37

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

5.8.18 service dhcp .................................................................................. 5 - 38

5.8.19 ip dhcp bootp automatic ................................................................ 5 - 38

xv AT8901M CLI Reference Manual

Table of Contents AT8901M

Chapter

6

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

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

5.8.22 clear ip dhcp server statistics ........................................................5 - 39

5.8.23 clear ip dhcp conflict ......................................................................5 - 39

5.8.24 show ip dhcp binding .....................................................................5 - 39

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

5.8.26 show ip dhcp pool configuration ....................................................5 - 40

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

5.8.28 show ip dhcp conflict .....................................................................5 - 41

5.9 DHCP Filtering .......................................................................................5 - 41

5.9.1 ip dhcp filtering ..............................................................................5 - 42

5.9.2 ip dhcp filtering trust ......................................................................5 - 42

5.9.3 show ip dhcp filtering .....................................................................5 - 42

5.10 Enhanced Port-Channel / LAG and Multicast Commands ....................5 - 43

5.10.1 port-channel hash multicast ..........................................................5 - 43

5.10.2 show port-channel hash multicast .................................................5 - 43

5.10.3 port-channel hash unicast .............................................................5 - 43

5.10.4 show port-channel hash unicast ....................................................5 - 43

5.10.5 multicast (interface) .......................................................................5 - 44

5.10.6 show port multicast .......................................................................5 - 44

5.10.7 multicast (VLAN) ...........................................................................5 - 44

5.10.8 show vlan multicast .......................................................................5 - 44

5.11 Serviceability Packet Tracing Commands .............................................5 - 45

5.11.1 debug console ...............................................................................5 - 45

5.11.2 debug clear ...................................................................................5 - 45

5.11.3 debug spanning-tree bpdu transmit ...............................................5 - 45

5.11.4 debug spanning-tree bpdu receive ................................................5 - 46

5.11.5 debug spanning-tree bpdu ............................................................5 - 47

5.11.6 debug igmpsnooping packet transmit ............................................5 - 47

5.11.7 debug igmpsnooping packet receive .............................................5 - 48

5.11.8 debug igmpsnooping packet .........................................................5 - 48

5.11.9 debug ping packet .........................................................................5 - 49

5.11.10 debug rip packet ............................................................................5 - 49

5.11.11 debug ospf packet .........................................................................5 - 50

5.11.12 debug lacp packet .........................................................................5 - 52

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

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

AT8901M CLI Reference Manual xvi

AT8901M Table of Contents

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 show network .................................................................................. 6 - 4

6.1.9 show serviceport ............................................................................. 6 - 4

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

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

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

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

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

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

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

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

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

6.3.3 transport input telnet ....................................................................... 6 - 7

6.3.4 transport output telnet ..................................................................... 6 - 7

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

6.3.6 session-timeout ............................................................................... 6 - 8

6.3.7 telnetcon maxsessions ................................................................... 6 - 8

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

6.3.9 disconnect ....................................................................................... 6 - 9

6.3.10 show loginsession ........................................................................... 6 - 9

6.3.11 show telnet .................................................................................... 6 - 10

6.3.12 show telnetcon .............................................................................. 6 - 10

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

6.4.1 ip ssh ............................................................................................ 6 - 10

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

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

6.4.4 sshcon maxsessions ..................................................................... 6 - 11

6.4.5 sshcon timeout .............................................................................. 6 - 11

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

6.5 User Account Commands ..................................................................... 6 - 12

6.5.1 users name ................................................................................... 6 - 12

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

6.5.3 users snmpv3 accessmode .......................................................... 6 - 13

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

6.5.5 users snmpv3 encryption .............................................................. 6 - 14

6.5.6 show users .................................................................................... 6 - 15

6.6 SNMP Commands ................................................................................ 6 - 15

6.6.1 snmp-server .................................................................................. 6 - 15

6.6.2 snmp-server community ............................................................... 6 - 15

6.6.3 snmp-server community ipaddr .................................................... 6 - 16

6.6.4 snmp-server community ipmask ................................................... 6 - 16

6.6.5 snmp-server community mode ..................................................... 6 - 17

xvii AT8901M CLI Reference Manual

Table of Contents AT8901M

6.6.6 snmp-server community ro ............................................................6 - 17

6.6.7 snmp-server community rw ...........................................................6 - 17

6.6.8 snmp-server enable traps violation ...............................................6 - 17

6.6.9 snmp-server enable traps ..............................................................6 - 18

6.6.10 snmp-server enable traps bcaststorm ...........................................6 - 18

6.6.11 snmp-server enable traps linkmode ..............................................6 - 18

6.6.12 snmp-server enable traps multiusers ............................................6 - 19

6.6.13 snmp-server enable traps stpmode ...............................................6 - 19

6.6.14 snmptrap .......................................................................................6 - 19

6.6.15 snmptrap snmpversion ..................................................................6 - 20

6.6.16 snmptrap ipaddr ............................................................................6 - 20

6.6.17 snmptrap mode .............................................................................6 - 20

6.6.18 snmp trap link-status .....................................................................6 - 20

6.6.19 snmp trap link-status all .................................................................6 - 21

6.6.20 show snmpcommunity ...................................................................6 - 21

6.6.21 show snmptrap ..............................................................................6 - 22

6.6.22 show trapflags ...............................................................................6 - 22

6.7 CLI Command Logging Command ........................................................6 - 23

6.7.1 logging cli-command .....................................................................6 - 23

6.8 RADIUS Commands ..............................................................................6 - 23

6.8.1 radius accounting mode ................................................................6 - 23

6.8.2 radius server host ..........................................................................6 - 23

6.8.3 radius server key ...........................................................................6 - 24

6.8.4 radius server msgauth ...................................................................6 - 24

6.8.5 radius server primary ....................................................................6 - 25

6.8.6 radius server retransmit ................................................................6 - 25

6.8.7 radius server timeout .....................................................................6 - 25

6.8.8 show radius ...................................................................................6 - 26

6.8.9 show radius accounting .................................................................6 - 26

6.8.10 show radius statistics ....................................................................6 - 27

6.9 TACACS+ Commands ...........................................................................6 - 28

6.9.1 tacacs-server host .........................................................................6 - 28

6.9.2 tacacs-server key ..........................................................................6 - 29

6.9.3 tacacs-server timeout ....................................................................6 - 29

6.9.4 key .................................................................................................6 - 29

6.9.5 port ................................................................................................6 - 30

6.9.6 priority ...........................................................................................6 - 30

6.9.7 timeout ..........................................................................................6 - 30

6.9.8 show tacacs ...................................................................................6 - 30

6.10 Configuration Scripting Commands .......................................................6 - 30

6.10.1 script apply ....................................................................................6 - 31

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

6.10.3 script delete ...................................................................................6 - 32

6.10.4 script list ........................................................................................6 - 32

6.10.5 script show ....................................................................................6 - 32

AT8901M CLI Reference Manual xviii

AT8901M Table of Contents

Appendix

A

Appendix

B

6.10.6 script validate ................................................................................ 6 - 32

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

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

6.11.2 set prompt ..................................................................................... 6 - 33

6.12 Bootcycle commands ............................................................................ 6 - 33

6.12.1 show boardinfo bootcycle ............................................................. 6 - 33

6.12.2 set board bootcycle ....................................................................... 6 - 33

6.13 Watchdog support ................................................................................. 6 - 33

6.13.1 set watchdog ................................................................................. 6 - 33

6.13.2 show watchdog ............................................................................. 6 - 34

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

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

xix AT8901M CLI Reference Manual

Table of Contents AT8901M

AT8901M CLI Reference Manual xx

AT8901M 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 configu­ration 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 as­sumed 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.

Note

Refer to the release notes for the FASTPATH application level code. The re­lease notes detail the platform specific functionality of the Switching, Routing,
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.

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 sys­tem 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, prod­uct, or example shown in this document.

Kontron Modular Computers GmbH reserves the right to change, modify, or improve this doc­ument or the product described herein, as seen fit by Kontron Modular Computers GmbH with­out further notice.

Page xxi AT8901M CLI Reference Manual

Preface AT8901M

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
names, company logos and trademarks, which are registered trademarks and, therefore, pro­prietary 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.

AT8901M CLI Reference Manual Page xxii

AT8901M Preface

Explanation of Symbols

CE Conformity

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

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 indi­cated 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 fol­lowing 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 han­dling operations and inspections of this product, in order to ensure product
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

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 im­proper 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.

Page xxiii AT8901M CLI Reference Manual

Preface AT8901M

High Voltage Safety Instructions

Warning!

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

Caution, Electric Shock!

High voltages are present inside the chassis when the unit’s power cord is
plugged into an electrical outlet. Turn off system power, turn off the power
supply, and then disconnect the power cord from its source before removing
the chassis cover. Turning off the system power switch does not remove
power to components.

Caution!

Do not look into the laser beam!
The module may have optical interfaces fitted with a class 1 or 1M laser. To
avoid possible exposure to hazardous levels of invisible laser radiation, do
not exceed maximum ratings.

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 inspections
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 pur­poses 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 piggy­backs, 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 plas­tics or sponges. They can cause short circuits and damage the batteries or conductive circuits
on the board.

AT8901M CLI Reference Manual Page xxiv

AT8901M Preface

General Instructions on Usage

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 techni­cal 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 in­structions supplied by the present manual.

Keep all the original packaging material for future storage or warranty shipments. If it is neces­sary 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.

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 neg­ligence, improper use, incorrect handling, servicing or maintenance, or which has been dam­aged 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 exclud­ed 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, togeth­er 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).

Page xxv AT8901M CLI Reference Manual

Preface AT8901M

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, re­funding 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 di­rectly 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 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 im­plicit, 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 Kon­tron be liable for direct, indirect or consequential damages resulting from the use of our hard­ware 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 pur­chase.

Please remember that no Kontron Modular Computers GmbH employee, dealer or agent is au­thorized 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.

AT8901M CLI Reference Manual Page xxvi

Chapter 1

1

AT8901M

Using the Command-Line Interface

Page 1 - 1 AT8901M CLI Reference Manual

Using the Command-Line Interface AT8901M

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

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

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 <ipaddr> <netmask> [gateway]

network

• 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.

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.

AT8901M CLI Reference Manual Page 1 - 2

AT8901M 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 AT8901M CLI Reference Manual

Using the Command-Line Interface AT8901M

Table 2. Parameter Descriptions

Parameter Description

Interface or
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
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 slot/port to con­figure 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 slot/port for-

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

AT8901M CLI Reference Manual Page 1 - 4