Allied Telesis AT-S83 User Manual
Management
Software
AT-S83
Command Line Interface
User’s Guide
AT-10408XP 10-Gigabit Ethernet Switch
Version 1.0.0
613-000546 Rev. A
Copyright © 2007 Allied Telesis, Inc.
All rights reserved. No part of this publication may be reproduced without prior written permission from Allied Telesis, Inc.
Allied Telesis and the Allied Telesis logo are trademarks of Allied Telesis, Inc.
Microsoft and Internet Explorer are registered trademarks of Microsoft Corporation. Netscape Navigator is a registered
trademark of Netscape Communications Corporation. All other product names, company names, logos or other designations
mentioned herein are trademarks or registered trademarks of their respective owners.
Allied Telesis, Inc. reserves the right to make changes in specifications and other information contained in this document
without prior written notice. The information provided herein is subject to change without notice. In no event shall Allied
Telesis, Inc. be liable for any incidental, special, indirect, or consequential damages whatsoever, including but not limited to
lost profits, arising out of or related to this manual or the information contained herein, even if Allied Telesis, Inc. has been
advised of, known, or should have known, the possibility of such damages.
Contents
Preface ................................................................................................................................................................................11
Safety Symbols Used in this Document................................................................................................................................12
Where to Find Web-based Guides .......................................................................................................................................13
Contacting Allied Telesis ......................................................................................................................................................14
Online Support ..............................................................................................................................................................14
Email and Telephone Support .......................................................................................................................................14
Warranty........................................................................................................................................................................14
Returning Products........................................................................................................................................................14
For Sales or Corporate Information...............................................................................................................................14
Chapter 1: Getting Started with the Command Line Interface ......................................................................................15
Introducing the Command Modes.........................................................................................................................................16
View Command Mode ...................................................................................................................................................20
Privileged Executive Command Mode...........................................................................................................................21
Configuration Terminal Mode ........................................................................................................................................22
Interface Configuration Command Mode.......................................................................................................................22
Router Mode..................................................................................................................................................................24
VLAN Configuration Command Mode ...........................................................................................................................24
Line Mode Commands ..................................................................................................................................................25
Key Chain Mode Command ..........................................................................................................................................26
Starting the Command Line Interface ...................................................................................................................................27
Formatting Commands .........................................................................................................................................................28
Command Line Interface Features................................................................................................................................28
Command Formatting Conventions...............................................................................................................................28
Specifying an Interface..................................................................................................................................................28
Command Line Syntax Conventions .............................................................................................................................29
Chapter 2: Introduction .....................................................................................................................................................31
Ethernet Technology ............................................................................................................................................................32
Fast Ethernet.................................................................................................................................................................32
Gigabit Ethernet Technology .........................................................................................................................................32
Switching Technology ...................................................................................................................................................33
Routing Protocol Support ..............................................................................................................................................33
Port Descriptions ..................................................................................................................................................................36
Software Features ................................................................................................................................................................37
Chapter 3: Basic Management Features .........................................................................................................................39
Creating User Accounts........................................................................................................................................................40
SNMP Settings .....................................................................................................................................................................41
Traps .............................................................................................................................................................................42
MIBs ..............................................................................................................................................................................42
Assigning an IP Address ......................................................................................................................................................43
Chapter 4: View Mode Commands ...................................................................................................................................45
CLEAR ARP-CACHE............................................................................................................................................................46
CLEAR IP .............................................................................................................................................................................47
CLEAR MAC ADDRESS-TABLE..........................................................................................................................................48
CLEAR SPANNING-TREE DETECTED PROTOCOLS .......................................................................................................49
DEBUG DOT1X....................................................................................................................................................................50
DEBUG MSTP......................................................................................................................................................................52
DEBUG RIP..........................................................................................................................................................................53
3
AT-S83 Management Software Command Line Interface User’s Guide
DEBUG RSTP ......................................................................................................................................................................54
DEBUG SNMP .....................................................................................................................................................................55
DEBUG STP.........................................................................................................................................................................56
ENABLE ...............................................................................................................................................................................57
EXIT......................................................................................................................................................................................58
HELP ....................................................................................................................................................................................59
LOGOUT ..............................................................................................................................................................................60
QUIT .....................................................................................................................................................................................61
SHOW INTERFACE SWITCHPORT....................................................................................................................................62
SHOW RUNNING-CONFIG..................................................................................................................................................64
Chapter 5: Privileged Executive Mode Commands ........................................................................................................67
BOOT CONFIG-FILE............................................................................................................................................................69
CONFIGURE TERMINAL.....................................................................................................................................................70
COPY ...................................................................................................................................................................................71
DISABLE ..............................................................................................................................................................................72
DOWNLOAD A.B.C.D FILE-NAME ......................................................................................................................................73
DOWNLOAD SERIAL...........................................................................................................................................................74
DOT1X INITIALIZE...............................................................................................................................................................75
PING IP ................................................................................................................................................................................76
SHOW BOOT .......................................................................................................................................................................77
SHOW FLOWCONTROL INTERFACE ................................................................................................................................78
SHOW INTERFACE .............................................................................................................................................................79
SHOW INTERFACE STATUS ALL.......................................................................................................................................80
SHOW NTP ASSOCIATIONS DETAIL.................................................................................................................................81
SHOW NTP STATUS ...........................................................................................................................................................82
SHOW STATIC-CHANNEL-GROUP....................................................................................................................................83
SHOW SYSTEM STATUS....................................................................................................................................................84
SHOW VERSION .................................................................................................................................................................85
SYSTEM REBOOT...............................................................................................................................................................86
TELNET................................................................................................................................................................................87
TERMINAL ...........................................................................................................................................................................88
UNDEBUG ALL ....................................................................................................................................................................89
UNDEBUG DOT1X...............................................................................................................................................................90
UNDEBUG OSPF EVENTS............................................................................................................
UNDEBUG OSPF IFSM .......................................................................................................................................................92
UNDEBUG OSPF LSA .........................................................................................................................................................93
UNDEBUG OSPF NFSM......................................................................................................................................................94
UNDEBUG OSPF NSM........................................................................................................................................................95
UNDEBUG OSPF PACKET..................................................................................................................................................96
UNDEBUG OSPF ROUTE ...................................................................................................................................................98
UNDEBUG RIP.....................................................................................................................................................................99
UPLOAD A.B.C.D FILE-NAME...........................................................................................................................................100
UPLOAD SERIAL ...............................................................................................................................................................101
WRITE ................................................................................................................................................................................102
......................................91
Chapter 6: Configuration Terminal Mode Commands .................................................................................................105
ACCESS-LIST ....................................................................................................................................................................107
ARP ....................................................................................................................................................................................109
DEBUG OSPF EVENTS.....................................................................................................................................................110
DEBUG OSPF IFSM...........................................................................................................................................................112
DEBUG OSPF LSA ............................................................................................................................................................113
DEBUG OSPF NFSM.........................................................................................................................................................114
DEBUG OSPF NSM ...........................................................................................................................................................115
DEBUG OSPF PACKET.....................................................................................................................................................116
DEBUG OSPF ROUTE.......................................................................................................................................................118
DOT1X SYSTEM-AUTH-CTRL ..........................................................................................................................................119
ENABLE PASSWORD........................................................................................................................................................120
ENABLE SECRET..............................................................................................................................................................121
EXIT....................................................................................................................................................................................122
FIB RETAIN........................................................................................................................................................................123
4
AT-S83 Management Software Command Line Interface User’s Guide
HOSTNAME .......................................................................................................................................................................124
INTERFACE .......................................................................................................................................................................125
IP RADIUS SOURCE-INTERFACE....................................................................................................................................126
LINE CONSOLE .................................................................................................................................................................127
LINE VTY............................................................................................................................................................................128
LOG FILE ...........................................................................................................................................................................129
LOG TRAP .........................................................................................................................................................................130
MAC ADDRESS-TABLE AGEING-TIME............................................................................................................................132
MAC ADDRESS-TABLE STATIC DISCARD......................................................................................................................133
MAC ADDRESS-TABLE STATIC FORWARD ...................................................................................................................134
MAXIMUM-PATHS .............................................................................................................................................................135
NTP ACCESS-GROUP ......................................................................................................................................................136
NTP AUTHENTICATE........................................................................................................................................................137
NTP AUTHENTICATION-KEY............................................................................................................................................138
NTP BROADCASTDELAY .................................................................................................................................................139
NTP MASTER ....................................................................................................................................................................140
NTP PEER..........................................................................................................................................................................141
NTP SERVER.....................................................................................................................................................................142
NTP TRUSTED-KEY ..........................................................................................................................................................143
ROUTE-MAP ......................................................................................................................................................................144
ROUTER-ID........................................................................................................................................................................145
UNDEBUG ALL ..................................................................................................................................................................146
USERNAME .......................................................................................................................................................................147
Chapter 7: Internet Protocol (IP) Commands ................................................................................................................149
IP DOMAIN-LIST ................................................................................................................................................................150
IP DOMAIN-LOOKUP.........................................................................................................................................................151
IP DOMAIN-NAME .............................................................................................................................................................152
IP EXTCOMMUNITY-LIST .................................................................................................................................................153
IP FORWARDING ..............................................................................................................................................................154
Chapter 8: Simple Network Management Protocol (SNMP) Commands ....................................................................155
SNMP-SERVER COMMUNITY ..........................................................................................................................................156
SNMP-SERVER CONTACT...............................................................................................................................................157
SNMP-SERVER ENABLE ..................................................................................................................................................158
SNMP-SERVER ENABLE TRAPS ENVIRON...............................................................................................
SNMP-SERVER ENABLE TRAPS SNMP..........................................................................................................................161
SNMP-SERVER ENGINEID LOCAL ..................................................................................................................................162
SNMP-SERVER GROUP ...................................................................................................................................................163
SNMP-SERVER HOST ......................................................................................................................................................165
SNMP-SERVER LOCATION..............................................................................................................................................167
SNMP-SERVER USER ......................................................................................................................................................168
SNMP-SERVER VIEW .......................................................................................................................................................170
Chapter 9: Interface Configuration Mode Commands .................................................................................................171
ARP-AGEING-TIMEOUT....................................................................................................................................................173
BANDWIDTH......................................................................................................................................................................174
DESCRIPTION ...................................................................................................................................................................175
FLOWCONTROL BACKPRESSURE .................................................................................................................................176
FLOWCONTROL RECEIVE...............................................................................................................................................177
FLOWCONTROL SEND.....................................................................................................................................................178
IP ACCESS-GROUP ..........................................................................................................................................................179
IP PROXY-ARP ..................................................................................................................................................................180
MAC-ADDRESS .................................................................................................................................................................181
MDIX...................................................................................................................................................................................182
MTU....................................................................................................................................................................................183
MULTICAST .......................................................................................................................................................................184
SHOW CLI..........................................................................................................................................................................185
SHUTDOWN.......................................................................................................................................................................187
SPANNING-TREE EDGEPORT.........................................................................................................................................188
SPANNING-TREE FORCE-VERSION ...............................................................................................................................189
.....................159
5
AT-S83 Management Software Command Line Interface User’s Guide
SPANNING-TREE GUARD ROOT.....................................................................................................................................190
SPANNING-TREE LINK-TYPE...........................................................................................................................................191
SPANNING-TREE MST INSTANCE ..................................................................................................................................192
SPANNING-TREE PATH-COST ........................................................................................................................................193
SPANNING-TREE PORTFAST..........................................................................................................................................194
SPANNING-TREE PRIORITY ............................................................................................................................................195
SPEED ...............................................................................................................................................................................196
STATIC-CHANNEL-GROUP ..............................................................................................................................................198
STORM-CONTROL............................................................................................................................................................199
SWITCHPORT ACCESS VLAN .........................................................................................................................................201
SWITCHPORT MODE ACCESS........................................................................................................................................202
SWITCHPORT MODE TRUNK ..........................................................................................................................................204
SWITCHPORT TRUNK ALLOWED VLAN .........................................................................................................................206
SWITCHPORT TRUNK NATIVE ........................................................................................................................................208
Chapter 10: IP Interface Commands ..............................................................................................................................209
IP ACCESS-GROUP ..........................................................................................................................................................210
IP ADDRESS......................................................................................................................................................................211
Chapter 11: 802.1x Access Control Commands ...........................................................................................................213
DOT1X MAX-REQ..............................................................................................................................................................214
DOT1X PORT-CONTROL..................................................................................................................................................215
DOT1X QUIET-PERIOD.....................................................................................................................................................216
DOT1X REAUTHENTICATION ..........................................................................................................................................217
DOT1X REAUTHMAX ........................................................................................................................................................218
DOT1X SYSTEM-AUTH-CTRL ..........................................................................................................................................220
DOT1X TIMEOUT RE-AUTHPERIOD....................................................................................................
DOT1X TIMEOUT SERVER-TIMEOUT .............................................................................................................................222
DOT1X TIMEOUT SUPP-TIMEOUT ..................................................................................................................................223
DOT1X TIMEOUT TX-PERIOD..........................................................................................................................................224
IP RADIUS SOURCE-INTERFACE....................................................................................................................................225
RADIUS-SERVER DEADTIME...........................................................................................................................................226
RADIUS-SERVER HOST ...................................................................................................................................................227
RADIUS-SERVER KEY......................................................................................................................................................228
RADIUS-SERVER RETRANSMIT RETRIES .....................................................................................................................229
RADIUS-SERVER TIMEOUT.............................................................................................................................................230
SHOW DOT1X ...................................................................................................................................................................231
SHOW DOT1X ALL ............................................................................................................................................................232
SHOW DOT1X INTERFACE ..............................................................................................................................................235
SHOW DOT1X STATISTICS INTERFACE ........................................................................................................................237
............................221
Chapter 12: Port Configuration ......................................................................................................................................239
FLOWCONTROL OFF........................................................................................................................................................240
FLOWCONTROL ON .........................................................................................................................................................241
SHOW FLOWCONTROL INTERFACE ..............................................................................................................................242
Chapter 13: Spanning Tree Protocol (STP) Commands ..............................................................................................243
REGION REGION_NAME..................................................................................................................................................244
REVISION REVISION_NUMBER.......................................................................................................................................245
SHOW SPANNING-TREE..................................................................................................................................................246
SHOW TRAFFIC-CLASS-TABLE INTERFACE .................................................................................................................249
SPANNING-TREE ACQUIRE.............................................................................................................................................250
SPANNING-TREE CISCO-INTEROPERABILITY ..............................................................................................................251
SPANNING-TREE ERRDISABLE-TIMEOUT.....................................................................................................................252
SPANNING-TREE FORWARD-TIME.................................................................................................................................253
SPANNING-TREE HELLO-TIME........................................................................................................................................254
SPANNING-TREE MAX-AGE.............................................................................................................................................255
SPANNING-TREE MAX-HOPS..........................................................................................................................................256
SPANNING-TREE MODE ..................................................................................................................................................257
SPANNING-TREE MST CONFIGURATION ......................................................................................................................258
SPANNING-TREE MST ENABLE ......................................................................................................................................259
SPANNING-TREE MST INSTANCE ..................................................................................................................................260
6
AT-S83 Management Software Command Line Interface User’s Guide
SPANNING-TREE PORTFAST BPDU-FILTER .................................................................................................................261
SPANNING-TREE PORTFAST BPDU-GUARD.................................................................................................................262
SPANNING-TREE PORTFAST BPDU-GUARD ENABLE..................................................................................................264
SPANNING-TREE PRIORITY ............................................................................................................................................266
SPANNING-TREE RSTP ENABLE ....................................................................................................................................267
SPANNING-TREE STP ENABLE.......................................................................................................................................268
Chapter 14: Routing Information Protocol (RIP) Commands ......................................................................................269
CLEAR IP RIP ROUTE.......................................................................................................................................................271
DEFAULT-INFORMATION ORIGINATE ............................................................................................................................273
DEFAULT-METRIC ............................................................................................................................................................274
DISTANCE .........................................................................................................................................................................275
DISTRIBUTE-LIST..............................................................................................................................................................277
IP RIP AUTHENTICATION KEY-CHAIN ............................................................................................................................278
IP RIP AUTHENTICATION MODE.....................................................................................................................................279
IP RIP AUTHENTICATION STRING ..................................................................................................................................280
IP RIP RECEIVE-PACKET.................................................................................................................................................281
IP RIP RECEIVE VERSION ...............................................................................................................................................282
IP RIP SEND-PACKET.......................................................................................................................................................283
IP RIP SEND VERSION .....................................................................................................................................................284
IP RIP SPLIT-HORIZON.....................................................................................................................................................285
KEY ....................................................................................................................................................................................286
KEY CHAIN ........................................................................................................................................................................287
MAXIMUM-PREFIX ............................................................................................................................................................288
NEIGHBOR ........................................................................................................................................................................289
NETWORK .........................................................................................................................................................................290
OFFSET-LIST.....................................................................................................................................................................291
PASSIVE-INTERFACE.......................................................................................................................................................293
RECV-BUFFER-SIZE.........................................................................................................................................................294
REDISTRIBUTE CONNECTED..........................................................................................................................................295
ROUTE ...............................................................................................................................................................................297
ROUTER RIP .....................................................................................................................................................................298
SHOW IP PROTOCOLS RIP..............................................................................................................................................300
SHOW IP RIP .....................................................................................................................................................................301
SHOW IP RIP DATABASE.................................................................................................................................................303
SHOW IP RIP INTERFACE................................................................................................................................................304
TIMERS BASIC ...................................................................................................................
VERSION ...........................................................................................................................................................................308
...............................................306
Chapter 15: Open Shortest Path First (OSPF) Commands ..........................................................................................311
AUTO-COST REFERENCE-BANDWIDTH ........................................................................................................................312
COMPATIBLE RFC1583 ....................................................................................................................................................313
HOST AREA.......................................................................................................................................................................314
IP OSPF AUTHENTICATION.............................................................................................................................................316
IP OSPF AUTHENTICATION-KEY.....................................................................................................................................317
IP OSPF COST ..................................................................................................................................................................319
IP OSPF DATABASE-FILTER............................................................................................................................................320
IP OSPF DEAD-INTERVAL................................................................................................................................................322
IP OSPF DISABLE ALL......................................................................................................................................................324
IP OSPF HELLO-INTERVAL..............................................................................................................................................325
IP OSPF MESSAGE-DIGEST-KEY....................................................................................................................................326
IP OSPF MTU.....................................................................................................................................................................328
IP OSPF MTU-IGNORE .....................................................................................................................................................330
IP OSPF NETWORK ..........................................................................................................................................................331
IP OSPF PRIORITY ...........................................................................................................................................................332
IP OSPF RETRANSMIT-INTERVAL ..................................................................................................................................334
IP OSPF TRANSMIT-DELAY .............................................................................................................................................335
MAX-CONCURRENT-DD...................................................................................................................................................336
MAX-UNUSE-PACKET.......................................................................................................................................................337
NEIGHBOR ........................................................................................................................................................................338
NETWORK AREA...............................................................................................................................................................340
7
AT-S83 Management Software Command Line Interface User’s Guide
OSPF ABR-TYPE...............................................................................................................................................................342
OVERFLOW DATABASE...................................................................................................................................................344
OVERFLOW DATABASE EXTERNAL...............................................................................................................................346
PASSIVE-INTERFACE.......................................................................................................................................................348
REFRESH TIMER ..............................................................................................................................................................349
ROUTER OSPF..................................................................................................................................................................350
SUMMARY-ADDRESS.......................................................................................................................................................351
TIMERS SPF ......................................................................................................................................................................353
Chapter 16: Line Mode Commands ................................................................................................................................355
EXEC-TIMEOUT.................................................................................................................................................................356
LINE CONSOLE .................................................................................................................................................................357
PRIVILEGE.........................................................................................................................................................................358
Chapter 17: VLAN Commands ........................................................................................................................................359
SHOW INTERFACE VLAN.................................................................................................................................................360
SHOW VLAN ......................................................................................................................................................................361
VLAN ..................................................................................................................................................................................363
VLAN DATABASE ..............................................................................................................................................................364
VLAN NAME.......................................................................................................................................................................365
VLAN STATE......................................................................................................................................................................366
Chapter 18: Sample Configurations ...............................................................................................................................367
Configuring 802.1x Access Control ....................................................................................................................................368
Configuring NTP Authentication .........................................................................................................................................370
Configuring VLANs .............................................................................................................................................................371
Index .................................................................................................................................................................................375
8
Tables
Table 1. Safety Symbols .....................................................................................................................................................12
Table 2. Command Modes .................................................................................................................................................18
Table 3. View Mode Commands .........................................................................................................................................20
Table 4. Privileged Executive Command Mode Commands ..............................................................................................21
Table 5. Configuration Terminal Command Mode Commands ..........................................................................................22
Table 6. Interface Configuration Command Mode Commands ..........................................................................................23
Table 7. RIP and OSPF Commands ...................................................................................................................................24
Table 8. VLAN Commands .................................................................................................................................................25
Table 9. Line Mode Commands ..........................................................................................................................................25
Table 10. Key Chain Mode Commands ..............................................................................................................................26
Table 11. Command Line Syntax Conventions ..................................................................................................................29
Table 12. AT-10408XP Switch Ports ..................................................................................................................................36
Table 13. SHOW FLOWCONTROL INTERFACE Command .............................................................................................78
Table 14. SHOW DOT1X Parameter Description .............................................................................................................233
Table 15. SHOW FLOWCONTROL INTERFACE Command ...........................................................................................242
Table 16. SHOW IP RIP ...................................................................................................................................................301
Table 17. Prefix Length Format ........................................................................................................................................340
9
Tables
10
Preface
The AT-S83 Management Software is a command line software that is
designed for use with the AT-10408XP 10-Gigabit Ethernet Switch. This
guide provides a description of the commands.
The preface contains the following sections:
“Safety Symbols Used in this Document” on page 12
“Where to Find Web-based Guides” on page 13
“Contacting Allied Telesis” on page 14
11
Preface
Safety Symbols Used in this Document
This document uses the safety symbols defined in Table 1.
Table 1. Safety Symbols
Symbol Meaning Description
Caution Performing or omitting a specific action may
result in equipment damage or loss of data.
Warning Performing or omitting a specific action may
result in electrical shock.
12
Where to Find Web-based Guides
The installation and user guides for all Allied Telesis products are available
in portable document format (PDF) on our web site at
www.alliedtelesis.com. You can view the documents online or download
them onto a local workstation or server.
For details about the features and functions of the AT-10408XP switch,
refer to the AT-10408XP 10-Gigabit Ethernet Switch Installation Guide
(part number 613-000707) on our web site.
AT-S83 Management Software Command Line Interface User’s Guide
13
Preface
Contacting Allied Telesis
This section provides Allied Telesis contact information for technical
support as well as sales or corporate information.
Online Support You can request technical support online by accessing the Allied Telesis
Knowledge Base from the following web site:
www.alliedtelesis.com/support/kb.aspx. You can use the Knowledge
Base to submit questions to our technical support staff and review
answers to previously asked questions.
Email and
Telephone
Support
For Technical Support via email or telephone, refer to the Allied Telesis
web site: www.alliedtelesis.com. Select your country from the list
displayed on the website. Then select the appropriate menu tab.
Warranty For warranty information, refer to the Allied Telesis web site:
www.alliedtelesis.com/warranty.
Returning
Products
For Sales or
Corporate
Products for return or repair must first be assigned a Return Materials
Authorization (RMA) number. A product sent to Allied Telesis without a
RMA number will be returned to the sender at the sender’s expense.
To obtain an RMA number, contact the Allied Telesis Technical Support
group at our web site: www.alliedtelesis.com/support/rma. Select your
country from the list displayed on the website. Then select the appropriate
menu tab.
You can contact Allied Telesis for sales or corporate information at our
web site: www.alliedtelesis.com. Select your country from the list
displayed on the website. Then select the appropriate menu tab.
Information
14
Chapter 1
Getting Started with the Command Line Interface
This chapter describes the command modes of the AT-S83 command line
interface and how to access them. This chapter includes the following
sections:
“Introducing the Command Modes” on page 16
“Starting the Command Line Interface” on page 27
“Formatting Commands” on page 28
15
Chapter 1: Getting Started with the Command Line Interface
Introducing the Command Modes
This chapter describes the CLI command modes and how to access the
command line interface. There are 8 command modes:
View
Privileged Executive
Configuration Terminal
Router
VLAN Configuration
Interface Configuration
Line
Key Chain
In the AT-S83 software, the commands are accessed through a hierarchy
of command modes. Each command mode contains a subset of
commands that are available within that mode only. For an illustration of
the command modes, see Figure 1 on page 17.
When you log on to the CLI interface, the default command mode that you
access depends on your login id. There are two default login ids that are
sent from the factory. The operator login id enables you to display the
software. With this login, you access the View command mode
automatically. The manager login id permits full administrator capabilities.
With this login, you access the Privileged Executive mode by default.
To navigate from one command mode to another, you enter a specific
command. For example, to access the Privileged Executive mode, you
enter the ENABLE command from the View mode. Once you enter a new
command mode, the AT-S83 prompt changes to indicate the new mode.
See Table 2 on page 18 for information about the commands used to
access the modes and their respective prompts.
16
AT-S83 Management Software Command Line Interface User’s Guide
View mode
Router
mode
router rip
router ospf
VLAN
Configuration
mode
Privileged
Executive
Configuration
Terminal
VLAN
database
Interface
Configuration
mode
mode
interface
IFNAME
mode
enable
configure
terminal
line vty [FIRST]
(LAST)
Command used to
enter the next mode
Command used to
enter the next mode
Commands used to
enter the next mode
key chain
NAME
Line
mode
Key Chain
mode
Figure 1. AT-S83 Command Modes
1221
17
Chapter 1: Getting Started with the Command Line Interface
Table 2. Command Modes
Command
Mode
Prompt Description
View mode Switch#
Privileged
Switch#
Executive
mode
Configuration
Switch(config)#
Terminal Mode
Router Mode Switch(config-router)#
This is the default command mode for the
operator login.
Enter the LOGOUT or EXIT commands
to quit the software.
This is the default command mode for the
manager login.
Access this mode from the View mode
with the ENABLE command.
Enter the DISABLE or EXIT commands
to return to the View mode.
Use the CONFIGURE command to enter
this mode from the Privileged Executive
mode.
To return to the Privileged Executive
mode, enter the END or EXIT
commands.
Type the ROUTER RIP or ROUTER
OSPF commands to enter this mode from
the Configuration Terminal mode.
18
Interface
Configuration
VLAN
Configuration
Switch(config-if)#
Switch(config-vlan)#
To return to the Configuration Terminal
mode, enter the END or EXIT
commands.
To access interface 1, enter the following
from the Configuration Terminal Mode:
interface xe1
Enter the END or EXIT commands to
return to the Configuration Terminal
mode.
From the Configuration Terminal mode,
type the VLAN DATABASE command.
Enter the END or EXIT commands to
return to the Configuration Terminal
mode.
AT-S83 Management Software Command Line Interface User’s Guide
Table 2. Command Modes (Continued)
Command
Mode
Prompt Description
Line Switch(config-line)
Key Chain Switch(config-
keychain)#
In addition, there are commands that allow you to move between the
modes. For example, typing the EXIT command when you are in the
Interface Configuration mode returns you to the Configuration Terminal
mode. From the View mode, the LOGOUT command exits the software.
If you enter a command that is not accessible from a command mode, the
software displays a “command not found” message. For example, you can
enter the SHOW SNMP command from the Privileged Executive mode,
but you cannot enter this command from the VLAN Configuration mode.
Within the manual, a command mode is listed for each command.
From the Configuration Terminal mode,
type the LINE VTY command.
Enter the END or EXIT commands to
return to the Configuration Terminal
mode.
To enter this mode from the Configuration
Terminal mode, type the KEY CHAIN
command.
Enter the END or EXIT commands to
return to the Configuration Terminal
mode.
See the following sections for a description of each command mode:
“View Command Mode” on page 20
“Privileged Executive Command Mode” on page 21
“Configuration Terminal Mode” on page 22
“Interface Configuration Command Mode” on page 22
“Router Mode” on page 24
“VLAN Configuration Command Mode” on page 24
“Line Mode Commands” on page 25
“Key Chain Mode Command” on page 26
19
Chapter 1: Getting Started with the Command Line Interface
View Command
Mode
The View command mode is the default command mode for the operator
login id. It permits access to basic commands. To indicate the View mode,
the prompt changes to “Switch>.” All of the commands in the View mode
are accessible from any of the other modes with the exception of the
ENABLE command.
See Table 3 on page 20 for a sample list of commands that can be
accessed from the View mode and a brief description of each command.
For more detailed information about the View mode commands, see
Chapter 4, “View Mode Commands” on page 45.
Table 3. View Mode Commands
Command Definition
CLEAR IP Clears the IP routing table and the stale kernel
route on the switch.
DEBUG DOT1X Turns on debugging is turned on for the 802.1x
protocol parameters.
ENABLE Changes the command mode from the View
mode to the Privilege Executive mode.
EXIT Exits the software from the View mode. From all
other modes, exits the current command mode
and returns to the previous mode.
LOGOUT Exits the software.
SHOW
RUNNINGCONFIG
Displays the current switch configuration.
20
AT-S83 Management Software Command Line Interface User’s Guide
Privileged
Executive
Command Mode
The Privileged Executive command mode is the default command mode
for the manager login. The commands in this mode permit you to perform
system level commands such as rebooting the system, copying
configuration files, and clearing statistics. The prompt changes to
“Switch#” to indicate the Privileged Executive mode.
To access the View mode from the Privileged Executive mode, enter the
EXIT command. To return to the Privileged Executive mode, enter the
ENABLE command.
See Table 4 for a sample list of commands that can be access from the
Privileged Executive command mode. For detailed information about the
commands in this mode, see Chapter 5, “Privileged Executive Mode
Commands” on page 67.
Table 4. Privileged Executive Command Mode Commands
Command Description
BOOT CONFIGFILE
CONFIGURE
TERMINAL
Reboots the system.
Changes the mode to the Configuration
Terminal Mode.
COPY Uploads the configuration file to an image or
configuration file.
DISABLE Exits the Privileged Executive command mode.
PING IP Pings an IP address to check connectivity to
another system.
REBOOT Reboots the system.
SHOW
INTERFACE
Displays interface configuration and status.
21
Chapter 1: Getting Started with the Command Line Interface
Configuration
Terminal Mode
The Configuration Terminal mode allows you to configure advanced
system features such as broadcast storm control, SNMP, and STP. To
access this mode, you must first access the Privileged Executive mode.
The prompt changes to “Switch(config)#” to indicate the software has
entered the Configuration Terminal mode.
See Table 5 for a sample list of commands that can be accessed from the
Configuration Terminal mode. For detailed information about the
commands in this mode, see the following chapters:
Chapter 6, “Configuration Terminal Mode Commands” on page 105
Chapter 7, “Internet Protocol (IP) Commands” on page 149
Chapter 8, “Simple Network Management Protocol (SNMP)
Commands” on page 155
Table 5. Configuration Terminal Command Mode Commands
Command Description
ACCESS-LIST Creates an access list.
ARP Sets an IP address for the Address Resolution
Protocol (ARP).
Interface
Configuration
Command Mode
LINE CONSOLE Sets the console configuration.
HOSTNAME Sets the name of the system.
INTERFACE Accesses the Interface Configuration command
mode (you must also specify an interface).
SNMP-SERVER
ENABLE
USERNAME Sets a system user name and password.
The Interface Configuration command mode allows you to configure
features that pertain to the interfaces such as flow control and duplex
mode. To access this mode, you must first access the Privileged
Executive and Configuration Terminal modes, depending on your login id.
For example, to access interface 1 enter the following from the
Configuration Terminal mode:
interface xe1
The prompt changes to “Switch(config-if)#” to indicate the Interface
Configuration mode.
Enables an SNMP agent on the switch.
22
After you have accessed this mode, the commands you enter apply only to
the interface specified in the Configuration Terminal mode. For example, if
you enter “interface xe3” in the Configuration Terminal mode, all of the
subsequent commands that you enter apply to interface 3 only. To
AT-S83 Management Software Command Line Interface User’s Guide
perform interface-specific commands on another interface, specify the
new interface in the Interface Configuration mode.
For a sample list of commands that can be accessed from the Interface
Configuration command mode, see Table 6. For more detailed information
about the commands in the Interface Configuration mode, see the
following chapters:
Chapter 9, “Interface Configuration Mode Commands” on page 171.
Chapter 10, “IP Interface Commands” on page 209
Chapter 11, “802.1x Access Control Commands” on page 213
Chapter 12, “Port Configuration” on page 239
Chapter 13, “Spanning Tree Protocol (STP) Commands” on page 243
Table 6. Interface Configuration Command Mode Commands
Commands Description
ARP-AGEING-
Set a timer for ARP on a specific interface.
TIMEOUT
DOT1X MAXREQ
Sets the maximum number of reauthentication
attempts after authentication fails.
FLOWCONTROL ONEnables flow control and configures the flow
control mode for the interface.
IP ADDRESS Sets an IP address for the switch or specifies that
the switch uses a DHCP client to obtain an IP
address.
MAC-ADDRESS Sets the MAC address for a specified interface.
SHUTDOWN Disables an interface.
SPANNING-TREE
MODE
Sets the active spanning tree protocol and enables
it on the switch.
SPEED Sets the speed and duplex mode for an interface.
23
Chapter 1: Getting Started with the Command Line Interface
Router Mode The Router mode permits access to Layer 3 routing commands using the
RIP and OSPF protocols. Access this mode through the Configuration
Terminal mode with the following commands:
ROUTER RIP
ROUTER OSPF
When you enter either of these commands, the prompt changes to
“Switch(config-router)#” to indicate the new mode.
For a sample list of RIP and OSPF commands, see Table 7. For more
information about the RIP and OSPF commands, see the following
chapters:
Chapter 14, “Routing Information Protocol (RIP) Commands” on page
269
Chapter 15, “Open Shortest Path First (OSPF) Commands” on page
311
Table 7. RIP and OSPF Commands
VLAN
Configuration
Command Mode
Commands Description
CLEAR IP RIP ROUTE Clears data from the RIP routing table.
DEFAULT-METRIC Specifies the metrics assigned to
redistributed routes.
HOST AREA Specifies a stub host entry belonging to an
area.
NEIGHBOR Specifies a neighbor router.
IP OSPF COST Specifies the cost of link-state metric in a
router-LSA.
IP OSPF
AUTHENTICATION-KEY
The VLAN Configuration command mode allows you to configure
commands that are applied to a VLAN interface. For instance, you can
assign an IP address to a VLAN interface in this mode.
To access this mode, you must first access the View, Privileged
Executive, and Configuration Terminal modes, depending on your login id.
From the Configuration Terminal command mode, type the VLAN
DATABASE command. The prompt changes to “Switch(config-vlan)#” to
indicate the VLAN Configuration mode.
Specifies an OSPF authentication
password for the neighboring routers.
24
After you have accessed the VLAN Configuration mode, you enter
commands that apply to specific VLANs. For a sample list of commands
AT-S83 Management Software Command Line Interface User’s Guide
that can be accessed from the VLAN Configuration command mode, see
Table 8. For more detailed information about the commands in the VLAN
Configuration mode, see Chapter 17, “VLAN Commands” on page 359.
Table 8. VLAN Commands
Commands Description
SHOW VLAN Displays information about a particular
VLAN.
VLAN Creates a VLAN and enables it.
VLAN NAME Assigns a name to a VLAN.
VLAN STATE Sets the operational state of the VLAN.
Line Mode
Commands
To Line mode permits you to assign a console timeout, the length of the
console lines, and the user privilege level when creating a Telnet
connection. Access the Line mode through the Configuration Terminal
mode, with the LINE VTY command. The prompt changes to
“Switch(config-line)#” to indicate the Line mode.
For a list of commands that can be accessed from the Line mode, see
Table 9. For more information about this mode, see Chapter 16, “Line
Mode Commands” on page 355.
Table 9. Line Mode Commands
Command Description
EXEC-TIMEOUT Sets the interval the command interpreter
waits for user input detected.
LINE CONSOLE Sets the primary terminal line.
PRIVILEGE Sets the access level to the AT-S83
commands.
25
Chapter 1: Getting Started with the Command Line Interface
Key Chain Mode
Command
The Key Chain mode is used to assign an authentication key. Use the
KEY CHAIN command to access this mode from the Configuration
Terminal mode. Within this mode, you can assign a key number.
For a list of commands that can be accessed from the Key Chain mode,
see Table 10. The commands in this mode are in Chapter 14, “Routing
Information Protocol (RIP) Commands” on page 269.
Table 10. Key Chain Mode Commands
Command Description
IP RIP AUTHENTICATION KEY-CHAIN Specifies the name of the
authentication key chain.
KEY Assigns a key number.
KEY CHAIN Accesses the Key Chain
mode.
26
Starting the Command Line Interface
To start the command line interface, perform the following procedure:
1. Type the user id and password.
There are two default user ids and passwords. For the system
administrator login, the default user id is “manager” and the default
password is “friend.” For the operator login, the default user id is
“operator” and the default password is “operator.”
A command line prompt is displayed in Figure 2.
Username:manager
Password:
(none) #
AT-S83 Management Software Command Line Interface User’s Guide
Figure 2. Command Line Login Screen
The default switch name is “(none)” and the pound sign (#) prompt
indicates the Privileged Executive mode which is the default mode
accessed by the manager login.
If you login with the operator login id, the prompt changes to “none>” to
indicate the View mode.
27
Chapter 1: Getting Started with the Command Line Interface
Formatting Commands
The AT-S83 software command line interface follows the same formatting
conventions for all of the command modes. There are command line
interface features which apply to the general use of the command line and
command syntax conventions which apply when entering the commands.
See the following sections.
Command Line
Interface
Features
The following features are supported in the command line interface:
Command history - Use the up and down arrow keys.
Context-specific help - Press the question mark key, ?, to display a list
of permitted parameters or all of the available commands for a
particular command mode. There are two formatting options:
– command ? - List the keywords or arguments that
are required by a particular command. A space
between a command and a question mark is required.
– abbreviated command? - Provides a list of
commands that begin with a particular character string.
There is no space between the command and the
question mark.
Keyword abbreviations - Any keyword can be recognized by typing an
unambiguous prefix, for example, type “sh” and the software responds
with “show.”
Tab key - Pressing the Tab key fills in the rest of the keyword
automatically. For example, typing “di” and then pressing the Tab key
enters “disable” on the command line.
Formatting
Conventions
Specifying an
28
Command
Interface
The following formatting conventions are used in this manual:
screen text font - This font illustrates the format of a command and
command examples.
ALL CAPITAL LETTERS- All capital letters indicate a parameter for
you to enter.
[ ] - Brackets indicate optional parameters.
| - Vertical line separates parameter options for you to choose from.
The AT-10408XP switch has eight 10G ports. Within the command line
interface, specify each interface with “xe” and the number of the interface.
For example, interface 3 is specified as “xe3.” For more information about
the ports, see “Port Descriptions” on page 36.
AT-S83 Management Software Command Line Interface User’s Guide
Command Line
Syntax
Conventions
The following table describes the conventions used in the AT-S83
command interface.
Table 11. Command Line Syntax Conventions
Convention Description Example
A.B.C.D/M Indicates an IP address and a
subnet mask.
line Indicates a line of text that
accepts spaces without
quotation marks.
string Indicates a string of
alphanumeric characters,
including special characters
such as spaces. You must
place quotation marks around
a value with spaces.
int Indicates a whole integer. 202
IFNAME Indicates an interface name.
Specify values xe1 through
xe8 and eth0.
192.68.1.11/24
Switch 24, San
Jose, Building 4
“Switch 24, San
Jose, Building 4”
xe3
mask Indicates a subnet mask. 255.255.240.0
sec Indicates seconds. 120
min Indicates minutes. 8
trunk ID Indicates trunk group ID. 4
VLANID Indicates a VLAN instance
(including name and VLAN
identifier).
vlan3
29
Chapter 1: Getting Started with the Command Line Interface
30
Loading...