Adtran AOS Commands!
Adtran AOS Commands!
Command Reference Guide AOS Version 11.1 NetVanta 1000 Series Products
Trademarks
Any brand names and product names included in this manual are trademarks, registered trademarks, service marks, or trade names of their respective holders.
Conventions
Cautions signify information that could prevent service interruption or damage to the equipment.
901 Explorer Boulevard P.O. Box 140000 Huntsville, AL 35814-4000 Phone: (256) 963-8000 www.adtran.com Copyright 2005 ADTRAN All Rights Reserved. Printed in the U.S.A.
61200500L1-35E
Product Registration
Registering your product helps ensure complete customer satisfaction. Please take time to register your products on line at www.adtran.com. Click Service/Support and then on Product Registration under Support.
Identify the RMA number clearly on the package (below the address), and return to the following address:
ADTRAN Customer and Product Service 901 Explorer Blvd. (East Tower) Huntsville, Alabama 35806 RMA # _____________
61200500L1-35E
Post-Sales Support
Your reseller should serve as the first point of contact for support. If additional support is needed, the ADTRAN Support website provides a variety of support services such as a searchable knowledge base, updated firmware releases, latest product documentation, service request ticket generation and trouble-shooting tools. All of this, and more, is available at: http://support.adtran.com When needed, further post-sales assistance is available by calling our Technical Support Center. Please have your unit serial number available when you call.
Technical Support (888) 4ADTRAN
Installation and Maintenance Support The ADTRAN Custom Extended Services (ACES) program offers multiple types and levels of installation and maintenance services which allow you to choose the kind of assistance you need. This support is available at: http://www.adtran.com/aces For questions, call the ACES Help Desk.
ACES Help Desk (888) 874-ACES (2237)
61200500L1-35E
Training
The Enterprise Network (EN) Technical Training Department offers training on our most popular products. These courses include overviews on product features and functions while covering applications of ADTRAN's product lines. ADTRAN provides a variety of training options, including customized training and courses taught at our facilities or at your site. For more information about training, please contact your Territory Manager or the Enterprise Training Coordinator.
Training Phone Training Fax Training Email (800) 615-1176, ext. 7500 (256) 963-6700 [email protected]
Export Statement
An Export License is required if an ADTRAN product is sold to a Government Entity outside of the EU+8 (Austria, Australia, Belgium, Czech Republic, Denmark, Finland, France, Germany, Greece, Hungary, Ireland, Italy, Japan, Luxembourg, Netherlands, New Zealand, Norway, Poland, Portugal, Spain, Sweden, Switzerland and the United Kingdom). This requirement is per DOC/BIS ruling G030477 issued 6/6/03. This product also requires that the Exporter of Record file a semi-annual report with the BXA detailing the information per EAR 740.17(5)(e)(2). DOC - Department of Commerce BIS - Bureau of Industry and Security BXA - Bureau of Export Administration
61200500L1-35E
Table of Contents
Table of Contents
Basic Mode Command Set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14 Common Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24 Enable Mode Command Set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34 Global Configuration Mode Command Set. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205 Line (Console) Interface Config Command Set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 344 Line (SSH) Interface Config Command Set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 357 Line (Telnet) Interface Config Command Set. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 365 Ethernet Interface Configuration Command Set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 374 Loopback Interface Configuration Command Set. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 419 Port Channel Interface Config Command Set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 432 VLAN Configuration Command Set. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 456 VLAN Database Configuration Command Set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 460 VLAN Interface Config Command Set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 469 DHCP Pool Command Set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 481 Radius Group Command Set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 499 TACACS+ Group Configuration Command Set. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 501 Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 503
61200500L1-35E
CLI Introduction
CLI INTRODUCTION
This portion of the Command Reference Guide is designed to introduce you to the basic concepts and strategies associated with using the AOS CLI. Accessing the CLI from your PC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 Understanding Command Security Levels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 Understanding Configuration Modes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 Using CLI Shortcuts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 Performing Common CLI Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 Understanding CLI Error Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
61200500L1-35E
Access by...
beginning an AOS session.
Prompt
>
Enable
entering enable while in the # Basic command security level as follows: >enable
To prevent unauthorized users from accessing the configuration functions of your AOS product, immediately install an Enable-level password. Refer to the Quick Configuration Guides and Quick Start Guides located on the ADTRAN OS Documentation CD provided with your unit for more information on configuring a password.
Access by...
entering config while at the Enable command security level prompt. For example: >enable #config term
Sample Prompt
(config)#
61200500L1-35E
Mode
Line
Access by...
Sample Prompt
(config-con0)# specifying a line (console or Telnet) while at the Global Configuration mode prompt. For example: >enable #config term (config)#line console 0 entering router rip or router ospf (config-rip)# while at the Global Configuration mode prompt. For example: >enable #config term (config)#router rip specifying an interface (T1, Ethernet, Frame Relay, ppp, etc.) while in the Global Configuration mode. For example: >enable #config term (config)#int eth 0/1 (config-eth 0/1)# (The above prompt is for the Ethernet LAN interface located on the rear panel of the unit.)
Router
Interface
Description
To re-display a previously entered command, use the up arrow key. Continuing to press the up arrow key cycles through all commands entered starting with the most recent command. Pressing the <Tab> key after entering a partial (but unique) command will complete the command, display it on the command prompt line, and wait for further input.
<Tab> key
61200500L1-35E
Shortcut
?
Description
The ADTRAN CLI contains help to guide you through the configuration process. Using the question mark, do any of the following: Display a list of all subcommands in the current mode. For example: (config-t1 1/1)#coding ? ami - Alternate Mark Inversion b8zs - Bipolar Eight Zero Substitution Display a list of available commands beginning with certain letter(s). For example: (config)#ip d? default-gateway dhcp-server domain-lookup domain-name domain-proxy Obtain syntax help for a specific command by entering the command, a space, and then a question mark (?). The ADTRAN CLI displays the range of values and a brief description of the next parameter expected for that particular command. For example: (config-eth 0/1)#mtu ? <64-1500> - MTU (bytes)
<Ctrl + A>
Jump to the beginning of the displayed command line. This shortcut is helpful when using the no form of commands (when available). For example, pressing <Ctrl + A> at the following prompt will place the cursor directly after the #: (config-eth 0/1)#ip address 192.33.55.6 Jump to the end of the displayed command line. For example, pressing <Ctrl + E> at the following prompt will place the cursor directly after the 6: (config-eth 0/1)#ip address 192.33.55.6
<Ctrl + E>
<Ctrl + U>
Clears the current displayed command line. The following provides an example of the <Ctrl + U> feature: (config-eth 0/1)#ip address 192.33.55.6 (Press <Ctrl + U> here) (config-eth 0/1)#
auto finish
You need only enter enough letters to identify a command as unique. For example, entering int t1 1/1 at the Global configuration prompt provides you access to the configuration parameters for the specified T1 interface. Entering interface t1 1/1 would work as well, but is not necessary.
61200500L1-35E
10
Description
The do command provides a way to execute commands in other command sets without taking the time to exit the current and enter the desired one. The following example shows the do command used to view the Frame Relay interface configuration while currently in the T1 interface command set: (config)#interface t1 1/1 (config-t1 1/1)#do show interfaces fr 7
no
To undo an issued command or to disable a feature, enter no before the command. For example: no shutdown t1 1/1
When you are ready to save the changes made to the configuration, enter this command. This copies your changes to the units nonvolatile random access memory (NVRAM). Once the save is complete, the changes are retained even if the unit is shut down or suffers a power outage. Displays the current configuration. Use the debug command to troubleshoot problems you may be experiencing on your network. These commands provide additional information to help you better interpret possible problems. For information on specific debug commands, refer to the section Enable Mode Command Set on page 34. To turn off any active debug commands, enter this command.
undebug all
The overhead associated with the debug command takes up a large portion of your AOS products resources and at times can halt other processes. It is best to only use the debug command during times when the network resources are in low demand (non-peak hours, weekends, etc.).
61200500L1-35E
11
Helpful Hints
The command may not be valid in the current command mode, or you may not have entered enough correct characters for the command to be recognized. Try using the ? command to determine your error. See Using CLI Shortcuts on page 9 for more information. The command may not be valid in the current command mode, or you may not have entered all of the pertinent information required to make the command valid. Try using the ? command to determine your error. See Using CLI Shortcuts on page 9 for more information. The error in command entry is located where the caret (^) mark appears. Enter a question mark at the prompt. The system will display a list of applicable commands or will give syntax information for the entry.
61200500L1-35E
12
Command Descriptions
COMMAND DESCRIPTIONS
This portion of the guide provides a detailed listing of all available commands for the ADTRAN OS CLI (organized by command set). Each command listing contains pertinent information including the default value, a description of all sub-command parameters, functional notes for using the command, and a brief technology review. To search for a particular command alphabetically, use the Index at the end of this document. To search for information on a group of commands within a particular command set, use the linked references given below: Basic Mode Command Set on page 14 Common Commands on page 24 Enable Mode Command Set on page 34 Global Configuration Mode Command Set on page 205 Line Interface Command Sets Line (Console) Interface Config Command Set on page 344 Line (SSH) Interface Config Command Set on page 357 Line (Telnet) Interface Config Command Set on page 365 Physical Interface Command Sets Ethernet Interface Configuration Command Set on page 374 Virtual Interface Command Sets Loopback Interface Configuration Command Set on page 419 Port Channel Interface Config Command Set on page 432 VLAN Configuration Command Set on page 456 VLAN Database Configuration Command Set on page 460 VLAN Interface Config Command Set on page 469 Security and Services Command Sets DHCP Pool Command Set on page 481 Radius Group Command Set on page 499 TACACS+ Group Configuration Command Set on page 501
61200500L1-35E
13
The following command is common to multiple command sets and is covered in a centralized section of this guide. For more information, refer to the section listed below: exit on page 32 All other commands for this command set are described in this section in alphabetical order. enable on page 15 logout on page 16 ping <address> on page 17 show clock on page 19 show snmp on page 20 show version on page 21 telnet <address> on page 22 traceroute <address> on page 23
61200500L1-35E
14
enable
Use the enable command (at the Basic Command mode prompt) to enter the Enable Command mode. Use the disable command to exit the Enable Command mode. Refer to Enable Mode Command Set on page 34 for more information. Syntax Description
No subcommands.
Default Values
No default value necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 1.1 Command was introduced.
Functional Notes
The Enable Command mode provides access to operating and configuration parameters and should be password protected to prevent unauthorized use. Use the enable password command (found in the Global Configuration mode) to specify an Enable Command mode password. If the password is set, access to the Enable Commands (and all other privileged commands) is only granted when the correct password is entered. Refer to enable password [md5] <password> on page 238 for more information.
Usage Examples
The following example enters the Enable Command mode and defines an Enable Command mode password: >enable #configure terminal (config)#enable password ADTRAN At the next login, the following sequence must occur: >enable Password: ****** #
61200500L1-35E
15
logout
Use the logout command to terminate the current session and return to the login screen. Syntax Description
No subcommands.
Default Values
No defaults necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 1.1 Command was introduced.
Usage Examples
The following example shows the logout command being executed in the Basic mode: >logout Session now available Press RETURN to get started.
61200500L1-35E
16
ping <address>
Use the ping command (at the Basic Command mode prompt) to verify Internet Protocol (IP) network connectivity. Syntax Description
<address> Specifies the IP address of the system to ping. Entering the ping command with no specified address prompts the user with parameters for a more detailed ping configuration. Refer to Functional Notes (below) for more information.
Default Values
No default value necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 1.1 Command was introduced.Command was introduced.
Functional Notes
The ping command helps diagnose basic IP network connectivity using the Packet InterNet Groper program to repeatedly bounce Internet Control Message Protocol (ICMP) echo-request packets off a system (using a specified IP address). The AOS allows executing a standard ping request to a specified IP address or provides a set of prompts to configure a more specific ping configuration. The following is a list of output messages from the ping command: ! Success Destination Host Unreachable $ Invalid Host Address X TTL Expired in Transit ? Unknown Host * Request Timed Out
61200500L1-35E
17
Command Reference Guide The following is a list of available extended ping fields with descriptions: Target IP address Repeat Count
Specifies the IP address of the system to ping. Specifies the number of ping packets to send to the system (valid range: 1 to 1,000,000). Datagram Size Specifies the size (in bytes) of the ping packet (valid range: 1 to 1448). Timeout in Seconds Specifies the timeout period after which a ping is considered unsuccessful (valid range: 1 to 5 seconds). Extended Commands Specifies whether additional commands are desired for more ping configuration parameters. Source Address (or interface) Specifies the IP address to use as the source address in the ECHO_REQ packets. Data Pattern Specifies an alphanumeric string to use (the ASCII equivalent) as the data pattern in the ECHO_REQ packets. Sweep Range of Sizes Varies the sizes of the ECHO_REQ packets transmitted. Sweep Min Size Specifies the minimum size of the ECHO_REQ packet (valid range: 0 to 1448). Sweep Max Size Specifies the maximum size of the ECHO_REQ packet (valid range: Sweep Min Size to 1448). Sweep Interval Specifies the interval used to determine packet size when performing the sweep (valid range: 1 to 1448). Verbose Output Specifies an extended results output.
Usage Examples
The following is an example of a successful ping command: >ping Target IP address:192.168.0.30 Repeat count[1-1000000]:5 Datagram Size [1-1000000]:100 Timeout in seconds [1-5]:2 Extended Commands? [y or n]:n Type CTRL+C to abort. Legend: '!' = Success '?' = Unknown host '$' = Invalid host address '*' = Request timed out '-' = Destination host unreachable 'x' = TTL expired in transit Pinging 192.168.0.30 with 100 bytes of data: !!!!! Success rate is 100 percent (5/5) round-trip min/avg/max = 19/20.8/25 ms
61200500L1-35E
18
show clock
Use the show clock command to display the system time and date entered using the clock set command. Refer to the section clock set <time> <day> <month> <year> on page 59 for more information. Syntax Description
No subcommands.
Default Values
No default value necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 1.1 Command was introduced.
Usage Examples
The following example displays the current time and data from the system clock: >show clock 23:35:07 UTC Tue Aug 20 2002
61200500L1-35E
19
show snmp
Use the show snmp command to display the system Simple Network Management Protocol (SNMP) parameters and current status of SNMP communications. Syntax Description
No subcommands.
Default Values
No default value necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 1.1 Command was introduced.
Usage Examples
The following is an example output using the show snmp command for a system with SNMP disabled and the default chassis and contact parameters: >show snmp Chassis: Chassis ID Contact: Customer Service 0 Rx SNMP packets 0 Bad community names 0 Bad community uses 0 Bad versions 0 Silent drops 0 Proxy drops 0 ASN parse errors
61200500L1-35E
20
show version
Use the show version command to display the current AOS version information. Syntax Description
No subcommands.
Default Values
No default value necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 1.1 Command was introduced.
Usage Examples
The following is a sample show version output: >show version AOS version 06.01.00 Checksum: 1F0D5243 built on Fri Nov 08 13:12:06 2002 Upgrade key: de76efcfeb4c8eeb6901188475dd0917 Boot ROM version 03.00.18 Checksum: 7A3D built on: Fri Nov 08 13:12:25 2002 Copyright (c) 1999-2002 ADTRAN Inc. Serial number C14C6308 UNIT_2 uptime is 0 days 4 hours 59 minutes 43 seconds System returned to ROM by Warm Start Current system image file is "030018adv.biz" Boot system image file is "030018adv.biz"
61200500L1-35E
21
telnet <address>
Use the telnet command to open a Telnet session (through the AOS) to another system on the network. Syntax Description
<address> Specifies the IP address of the remote system.
Default Values
No default value necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 1.1 Command was introduced.
Usage Examples
The following example opens a Telnet session with a remote system (10.200.4.15): >telnet 10.200.4.15 User Access Login Password:
61200500L1-35E
22
traceroute <address>
Use the traceroute command to display the Internet Protocol (IP) routes a packet takes to reach the specified destination. Syntax Description
<address> Specifies the IP address of the remote system to trace the routes to.
Default Values
No default value necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 1.1 Command was introduced.
Usage Examples
The following example performs a traceroute on the IP address 192.168.0.1: #traceroute 192.168.0.1 Type CTRL+C to abort. Tracing route to 192.168.0.1 over a maximum of 30 hops 1 2 # 22ms 20ms 20ms 23ms 20ms 20ms 192.168.0.65 192.168.0.1
61200500L1-35E
23
Common Commands
COMMON COMMANDS
The following section contains descriptions of commands that are common across multiple command sets. These commands are listed in alphabetical order. alias <text> on page 25 cross-connect <#> <from interface> <slot/port> <tdm-group#> <to interface> <slot/port> on page 26 description <text> on page 29 do on page 30 end on page 31 exit on page 32 shutdown on page 33
61200500L1-35E
24
Common Commands
alias <text>
Use the alias command to populate the ifAlias OID (Interface Table MIB of RFC2863) for all physical and virtual interfaces when using Simple Network Management Protocol (SNMP) management stations. Syntax Description
<text> Describes the interface (for SNMP) using an alphanumeric character string enclosed in quotation marks (limited to 64 characters).
Default Values
No defaults required for this command.
Applicable Platforms
Applies to all AOS products.
Command History
Release 1.1 Command was introduced.
Functional Notes
The ifAlias OID is a member of the ifXEntry object-type (defined in RFC2863) used to provide a non-volatile, unique name for various interfaces. This name is preserved through power cycles. Enter a string (using the alias command) which clearly identifies the interface.
Usage Examples
The following example defines a unique character string for the T1 interface: (config)#interface t1 1/1 (config-t1 1/1)#alias CIRCUIT_ID_23-908-8887-401
Technology Review
Please refer to RFC2863 for more detailed information on the ifAlias display string.
61200500L1-35E
25
Common Commands
Syntax Description
<#> <from interface> <slot/port> <tdm-group#> <to interface> <slot/port> Identifies the cross-connect using a number descriptor or label for (useful in systems that allow multiple cross-connects). Specifies the interface (physical or virtual) on one end of the cross-connect. Enter cross-connect 1 ? for a list of valid interfaces. Used when a physical interface is specified in the <from interface> subcommand (For example: specifying the T1 port of a T1 module would be t1 1/1). Specifies which configured TDM group to use for this cross-connect. This subcommand only applies to T1 physical interfaces. Specifies the virtual interface on the other end of the cross-connect. Use the ? to display a list of valid interfaces. Used when a physical interface is specified in the <to interface> subcommand. (For example, specifying the primary T1 port of a T1 module would be t1 1/1).
Default Values
By default, there are no configured cross-connects.
Applicable Platforms
Applies to all AOS products
Command History
Release 1.1 Release 5.1 Command was introduced. Command was expanded to include the E1 interface.
Functional Notes
Cross-connects provide the mechanism for connecting a configured virtual (layer 2) endpoint with a physical (layer 1) interface. Supported layer 2 protocols include Frame Relay and point-to-point protocol (PPP).
61200500L1-35E
26
Common Commands
Usage Examples
The following example creates a Frame Relay endpoint and connects it to the T1 1/1 physical interface: 1. Create the Frame Relay virtual endpoint and set the signaling method: (config)# interface frame-relay 1 (config-fr 1)# frame-relay lmi-type cisco 2. Create the sub-interface and configure the PVC parameters (including DLCI and IP address): (config-fr 1)# interface fr 1.1 (config-fr 1.1)# frame-relay interface-dlci 17 (config-fr 1.1)# ip address 168.125.33.252 255.255.255.252 3. Create the TDM group of 12 DS0s (64K) on the T1 physical interface: (THIS STEP IS ONLY VALID FOR T1 INTERFACES.) (config)# interface t1 1/1 (config-t1 1/1)# tdm-group 1 timeslots 1-12 speed 64 (config-t1 1/1)# exit 4. Connect the Frame Relay sub-interface with port T1 1/1: (config)# cross-connect 1 t1 1/1 1 fr 1
Technology Review
Creating an endpoint that uses a layer 2 protocol (such as Frame Relay) is generally a four-step process: Step 1: Create the Frame Relay virtual endpoint (using the interface frame-relay command) and set the signaling method (using the frame-relay lmi-type command). Also included in the Frame Relay virtual endpoint are all the applicable Frame Relay timers logging thresholds, encapsulation types, etc. Generally, most Frame Relay virtual interface parameters should be left at their default state. For example, the following creates a Frame Relay interface labeled 7 and sets the signaling method to ansi. (config)# interface frame-relay 7 (config-fr 7)# frame-relay lmi-type ansi
61200500L1-35E
27
Common Commands
Create the sub-interface and configure the PVC parameters. Using the sub-interface, apply access policies to the interface, create bridging interfaces, configure dial-backup, assign an IP address, and set the PVC data-link control identifier (DLCI). For example, the following creates a Frame Relay sub-interface labeled 22, sets the DLCI to 30, and assigns an IP address of 193.44.69.253 to the interface. (config-fr 7)# interface fr 7.22 (config-fr 7.22)# frame-relay interface-dlci 30 (config-fr 7.22)# ip address 193.44.69.253 255.255.255.252 Step 3: (VALID ONLY FOR T1 INTERFACES) Specify the group of DS0s used for signaling on the T1 interface by creating a TDM group. Group any number of contiguous DS0s together to create a data pipe for layer 2 signaling. Also use the tdm-group command to specify the per-DS0 signaling rate on the interface. For example, the following creates a TDM group labeled 9 containing 20 DS0s (each DS0 having a data rate of 56 kbps). (config)# interface t1 1/1 (config-t1 1/1)# tdm-group 9 timeslots 1-20 speed 56 (config-t1 1/1)# exit Step 4: Make the association between the layer 2 endpoint and the physical interface using the cross-connect command. Supported layer 2 protocols include Frame Relay and point-to-point protocol (PPP). For example, the following creates a cross-connect (labeled 5) to make an association between the Frame Relay virtual interface (fr 7) and the TDM group configured on interface t1 1/1 (tdm-group 9). (config)# cross-connect 5 t1 1/1 9 fr 7
61200500L1-35E
28
Common Commands
description <text>
Use the description command to identify the specified interface (for example, circuit ID, contact information, etc.). Syntax Description
<text> Identifies the specified interface using up to 80 alphanumeric characters.
Default Values
No defaults required for this command.
Applicable Platforms
Applies to all AOS products.
Command History
Release 1.1 Command was introduced.
Usage Examples
The following example enters comment information using the description command: (config)#interface t1 1/1 (config-t1 1/1)#description This is the Dallas office T1
61200500L1-35E
29
Common Commands
do
Use the do command to execute any AOS command, regardless of the active configuration mode. It provides a way to execute commands in other modes without taking the time to exit the current mode and enter the desired one. Syntax Description
No subcommands.
Default Values
No defaults required for this command.
Applicable Platforms
Applies to all AOS products.
Command History
Release 2.1 Command was introduced.
Functional Notes
Use the do command to view configurations or interface states after configuration changes are made without exiting to the Enable mode.
Usage Examples
The following example shows the do command used to view the Frame Relay interface configuration while currently in the T1 Interface Configuration mode: (config)#interface t1 1/1 (config-t1 1/1)#do show interfaces fr 7 fr 7 is ACTIVE Signaling type is ANSI signaling role is USER Polling interval is 10 seconds full inquiry interval is 6 polling intervals Output queue: 0/0 (highest/drops) 0 packets input 0 bytes 0 pkts discarded 0 error pkts 0 unknown protocol pkts 0 packets output 0 bytes 0 tx pkts discarded 0 tx error pkts
61200500L1-35E
30
Common Commands
end
Use the end command to exit the current configuration mode and enter the Enable Security mode. When exiting the Global Configuration mode, remember to perform a copy running-config startup-config to save all configuration changes.
Syntax Description
No subcommands.
Default Values
No defaults necessary for this command.
Applicable Platforms
Applies to all AOS products.
Command History
Release 1.1 Command was introduced.
Usage Examples
The following example shows the end command being executed in the T1 Interface Configuration mode: (config-t1 1/1)#end # #- Enable Security mode command prompt
61200500L1-35E
31
Common Commands
exit
Use the exit command to exit the current configuration mode and enter the previous one. For example, using the exit command in an interface configuration mode will activate the Global Configuration mode. When using the exit command in the Basic mode, the current session will be terminated. When exiting the Global Configuration mode, remember to perform a copy running-config startup-config to save all configuration changes.
Syntax Description
No subcommands.
Default Values
No defaults necessary for this command.
Applicable Platforms
Applies to all AOS products.
Command History
Release 1.1 Command was introduced.
Usage Examples
The following example shows the exit command being executed in the Global Configuration mode: (config)#exit # #- Enable Security mode command prompt
61200500L1-35E
32
Common Commands
shutdown
Use the shutdown command to disable the interface (both physical and virtual) so that no data will be passed through. Use the no form of this command to turn on the interface and allow it to pass data. By default, all interfaces are disabled. Syntax Description
No subcommands.
Default Values
By default, all interfaces are disabled.
Applicable Platforms
Applies to all AOS products.
Command History
Release 1.1 Command was introduced.
Usage Examples
The following example administratively disables the modem interface: (config)#interface modem 1/2 (config-modem 1/2)#shutdown
61200500L1-35E
33
The following command is common to multiple command sets and is covered in a centralized section of this guide. For more information, refer to the section listed below: exit on page 32 All other commands for this command set are described in this section in alphabetical order. clear commands begin on page 36 clock auto-correct-dst on page 57 clock no-auto-correct-dst on page 58 clock set <time> <day> <month> <year> on page 59 clock timezone <text> on page 60 configure [memory | network | overwrite-network | terminal] on page 63 copy <source> <destination> on page 64 copy console <filename> on page 65 copy flash <destination> on page 66 copy tftp <destination> on page 67 copy xmodem <destination> on page 68 debug commands begin on page 69 dir on page 97 dir [<input> | flash | flash <input>] on page 98 disable on page 99 enable on page 100 erase [<filename> | startup-config] on page 101 events on page 102 exception report generate on page 103 logout on page 104 ping <address> on page 105 ping stack-member on page 107 reload [cancel | in <delay>] on page 108 show commands begin on page 109
61200500L1-35E
34
telnet <address> on page 197 telnet stack-member <unit id> on page 198 terminal length <text> on page 199 traceroute <address> source <address> on page 200 undebug all on page 201 vlan database on page 202 wall <message> on page 203 write [dynvoice-config | erase | memory | network | terminal] on page 204
61200500L1-35E
35
clear arp-cache
Use the clear arp-cache command to remove all dynamic entries from the Address Resolution Protocol (ARP) cache table. Syntax Description
No subcommands.
Default Values
No default value necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 1.1 Command was introduced.
Usage Examples
The following example removes all dynamic entries from the ARP cache: >enable #clear arp-cache
61200500L1-35E
36
Default Values
No default value necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 1.1 Command was introduced.
Usage Examples
The following example removes the entry for 10.200.4.56 from the ARP cache: >enable #clear arp-entry 10.200.4.56
61200500L1-35E
37
Default Values
No default value necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 3.1 Command was introduced.
Usage Examples
The following example clears the maximum-used buffer statics: >enable #clear buffers max-used
61200500L1-35E
38
Default Values
No default values necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 1.1 Release 9.1 Command was introduced. Command was expanded to include HDLC and tunnel interfaces.
Usage Examples
The following example clears all counters associated with the Ethernet 0/1 interface: >enable #clear counters ethernet 0/1
61200500L1-35E
39
Default Values
No default value necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, and 1000R Series units.
Command History
Release 8.1 Command was introduced.
Usage Examples
The following example clears all counters for port channel 1: >enable #clear counters port-channel 1
61200500L1-35E
40
Default Values
No default value necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, and 2000 Series units.
Command History
Release 5.1 Command was introduced.
Usage Examples
The following example resets the counters on VLAN interface 7: >enable #clear counters vlan 7
61200500L1-35E
41
clear dump-core
The clear dump-core command clears diagnostic information appended to the output of the show version command. This information results from an unexpected unit reboot. Syntax Description
No subcommands.
Default Values
No default value necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 6.1 Command was introduced.
Usage Examples
The following example clears the entire database of IKE SAs (including the active associations): >enable #clear dump-core
61200500L1-35E
42
clear event-history
Use the clear event-history command to clear all messages logged to the local event-history. Messages cleared from the local event-history (using the clear event-history command) are no longer accessible.
Syntax Description
No subcommands.
Default Values
No default value necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 1.1 Command was introduced.
Usage Examples
The following example clears all local event-history messages: >enable #clear event-history
61200500L1-35E
43
Default Values
There are no default settings for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, and 1000R Series units.
Command History
Release 8.1 Command was introduced.
Usage Examples
The following example clears counter statistics on the GVRP interfaces: >enable #clear gvrp statistics all
61200500L1-35E
44
Default Values
No default value necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 10.1 Command was introduced.
Functional Notes
A DHCP server binding represents an association between a MAC address and an IP address that was offered by the unit to a DHCP client (i.e., most often a PC). Clearing a binding allows the unit to offer that IP address again, should a request be made for one.
Usage Examples
The following example clears a DHCP server binding for the IP address 125.25.47.4: >enable #clear ip dchp-server binding 125.25.47.4
61200500L1-35E
45
Default Values
There are no default settings for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 8.1 Command was introduced.
Usage Examples
The following example resets all LLDP counters: >enable #clear lldp counters
61200500L1-35E
46
Default Values
No default values are necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 8.1 Command was introduced.
Usage Examples
The following example resets the counters on PPP interface 1: >enable #clear lldp counters interface ppp 1
61200500L1-35E
47
Default Values
There are no default settings for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 8.1 Command was introduced.
Functional Notes
This command generates output indicating the names of any neighbors deleted from the database and the name of the interface on which the neighbor was learned.
Usage Examples
The following example clears LLDP neighbor Switch_1 from the Ethernet interface 0/7: >enable #clear lldp neighbors LLDP: Deleted neighbor Switch_1 on interface eth 0/7 #
61200500L1-35E
48
Default Values
No default value necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, and 1000R Series units.
Command History
Release 5.1 Command was introduced.
Usage Examples
The following example removes the dynamic address A0:B1:C2:D3:E4:A1 from the MAC address table: >enable #clear mac address-table dynamic address A0:B1:C2:D3:E4:A1 The following example removes all dynamic addresses from the MAC address table: >enable #clear mac address-table dynamic
61200500L1-35E
49
clear port-security
Use the clear port-security command to clear the dynamic or sticky secure media access control (MAC) addresses associated with an interface. This can be done on a per-address or per-port basis. Variations of this command include the following:
clear port-security dynamic address <address> clear port-security dynamic interface <interface id> clear port-security sticky address <address> clear port-security sticky interface <interface id>
Syntax Description
dynamic sticky address <address> Clears the dynamic MAC addresses. Clears the sticky secure MAC addresses. Clears the information for the specified address.
interface <interface id> Clears the information for the specified interface. Type clear port-security sticky interface ? or clear port-security dynamic interface ? for a complete list of applicable interfaces.
Default Values
No default value necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, and 1000R Series units.
Command History
Release 8.1 Command was introduced.
Usage Examples
The following command clears all dynamic secure MAC addresses associated with the Ethernet interface 0/1: >enable #clear port-security dynamic interface eth 0/1
61200500L1-35E
50
Default Values
No default value necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, and 1000R Series units.
Command History
Release 8.1 Command was introduced.
Usage Examples
The following command clears the violation count associated with the Ethernet interface 0/1: >enable #clear port-security violation-count eth 0/1
61200500L1-35E
51
Default Values
No default value necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 5.1 Command was introduced.
Usage Examples
The following example resets the CPU maximum usage statistics: >enable #clear process cpu max
61200500L1-35E
52
Default Values
No default value necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 6.1 Command was introduced.
Usage Examples
The following example clears the spanning tree counters for Ethernet 0/10: >enable #clear spanning-tree counters interface eth 0/10
61200500L1-35E
53
Default Values
No default value necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 5.1 Command was introduced.
Functional Notes
The switch has the ability to operate using the rapid spanning-tree protocol or the legacy 802.1D version of spanning-tree. When a BPDU (bridge protocol data unit) of the legacy version is detected on an interface, the switch automatically regresses to using the 802.1D spanning-tree protocol for that interface. Issue the clear spanning-tree detected-protocols command to return to rapid spanning-tree operation.
Usage Examples
The following example re-initiates the protocol migration process on Ethernet interface 0/3: >enable #clear spanning-tree detected-protocols interface ethernet 0/3 The following example re-initiates the protocol migration process on all interfaces: >enable #clear spanning-tree detected-protocols
61200500L1-35E
54
Default Values
No default value necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 11.1 Command was introduced.
Usage Examples
The following example clears all TACACS+ protocol statistics: >enable #clear tacacs+ statistics
61200500L1-35E
55
clear user [console <user number> | ssh <user number> | telnet <user number>]
Use the clear user command to detach a user from a given line. Syntax Description
console <user number> Detaches a specific console user. Valid range is 0 to 1. ssh <user number> telnet <user number> Detaches a specific secure shell (SSH) user. Valid range is 0 to 4. Detaches a specific Telnet user. Valid range is 0 to 5.
Default Values
No default value necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 11.1 Command was introduced.
Usage Examples
The following example detaches the console 1 user: >enable #clear user console 1
61200500L1-35E
56
clock auto-correct-dst
The clock auto-correct-dst command allows the automatic one-hour correction for Daylight Saving Time (DST). Use the clock no-auto-correct-dst command to disable this feature. Syntax Description
No subcommands.
Default Values
By default this command is enabled.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 6.1 Command was introduced.
Usage Examples
The following example allows for automatic DST correction: >enable #clock auto-correct-dst
61200500L1-35E
57
clock no-auto-correct-dst
The clock no-auto-correct-dst command allows you to override the automatic one-hour correction for Daylight Saving Time (DST). Syntax Description
No subcommands.
Default Values
No default value is necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 6.1 Command was introduced.
Functional Notes
Many time zones include an automatic one-hour correction for daylight saving time at the appropriate time. You may override it at your location using this command.
Usage Examples
The following example overrides the one-hour offset for DST: >enable #clock no-auto-correct-dst
61200500L1-35E
58
Default Values
No default value necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 1.1 Command was introduced.
Usage Examples
The following example sets the system software clock for 3:42 pm, August 22 2004: >enable #clock set 15:42:00 22 Au 2004
61200500L1-35E
59
Default Values
No default value is necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 6.1 Release 11.1 Command was introduced. Command was expanded to include clock timezone 0.
61200500L1-35E
60
Functional Notes
The following list shows sample cities and their timezone codes. clock timezone +1-Amsterdam clock timezone +1-Belgrade clock timezone +1-Brussels clock timezone +1-Sarajevo clock timezone +1-West-Africa clock timezone +10-Brisbane clock timezone +10-Canberra clock timezone +10-Guam clock timezone +10-Hobart clock timezone +10-Vladivostok clock timezone +11 clock timezone +12-Auckland clock timezone +12-Fiji clock timezone +13 clock timezone +2-Athens clock timezone +2-Bucharest clock timezone +2-Cairo clock timezone +2-Harare clock timezone +2-Helsinki clock timezone +2-Jerusalem clock timezone +3-Baghdad clock timezone +3-Kuwait clock timezone +3-Moscow clock timezone +3-Nairobi clock timezone +3:30 clock timezone +4-Abu-Dhabi clock timezone +4-Baku clock timezone +4:30 clock timezone +5-Ekaterinburg clock timezone +5-Islamabad clock timezone +5:30 clock timezone +5:45 clock timezone +6-Almaty clock timezone +6-Astana clock timezone +6-Sri-Jay clock timezone +6:30 clock timezone +7-Bangkok clock timezone +7-Kranoyarsk clock timezone +8-Bejing clock timezone +8-Irkutsk clock timezone +8-Kuala-Lumpur clock timezone +8-Perth clock timezone +8-Taipei clock timezone +9-Osaka clock timezone +9-Seoul clock timezone +9-Yakutsk clock timezone +9:30-Adelaide clock timezone +9:30-Darwin clock timezone -1-Azores clock timezone -1-Cape-Verde clock timezone -10 clock timezone -11 clock timezone -12 clock timezone -2 clock timezone -3-Brasilia clock timezone -3-Buenos-Aires clock timezone -3-Greenland clock timezone -3:30 clock timezone -4-Atlantic-Time clock timezone -4-Caracus clock timezone -4-Santiago clock timezone -5 clock timezone -5-Bogota clock timezone -5-Eastern-Time clock timezone -6-Central-America clock timezone -6-Central-Time clock timezone -6-Mexico-City clock timezone -6-Saskatchewan clock timezone -7-Arizona clock timezone -7-Mountain-Time clock timezone -8 clock timezone -9 clock timezone 0 clock timezone GMT-Casablanca clock timezone GMT-Dublin
61200500L1-35E
61
Usage Examples
The following example sets the timezone for Santiago, Chile. >enable #clock timezone -4-Santiago
61200500L1-35E
62
Default Values
No default value necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 1.1 Command was introduced.
Usage Examples
The following example enters the Global Configuration mode from the Enable mode: >enable #configure terminal (config)#
61200500L1-35E
63
Default Values
No default value necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 1.1 Command was introduced.
Usage Examples
The following example creates a copy of the file myfile.biz (located in FLASH memory) and names it newfile.biz: >enable #copy myfile.biz newfile.biz The following example creates a backup copy of the startup configuration file (and places in FLASH memory): >enable #copy startup-config backup.bak The following example copies the current running-configuration file to the startup configuration file located in NVRAM: >enable #copy running-config startup-config
61200500L1-35E
64
Default Values
No default is necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 8.1 Command was introduced.
Functional Notes
The copy console command works much like a line editor. Prior to pressing <Enter>, changes can be made to the text on the line. Changes can be made using <Delete> and <Backspace> keys. The text can be traversed using the arrow keys, <Ctrl+A> (to go to the beginning of a line), and <Ctrl+E> (to go to the end of a line). To end copying to the text file, type <Ctrl+D>. The file will be saved in the AOS root directory. Use the dir command to see a list of files in the root directory.
Usage Examples
The following example copies the console input into the file config (located in the AOS root directory): >enable #copy console config
61200500L1-35E
65
Default Values
No default value necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 1.1 Command was introduced.
Usage Examples
The following example copies the contents of the units flash memory to a TFTP server: >enable #copy flash tftp
61200500L1-35E
66
Default Values
No default value necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 1.1 Command was introduced.
Usage Examples
The following example copies myfile.biz from the TFTP server (10.200.2.4) to flash memory and labels it newfile.biz: >enable #copy tftp flash Address of remote host?10.200.2.4 Source filename myfile.biz Destination filename newfile.biz Initiating TFTP transfer... Received 45647 bytes. Transfer Complete! #
61200500L1-35E
67
Default Values
No default value necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 1.1 Command was introduced.
Usage Examples
The following example copies a .biz file to flash memory and labels it newfile.biz: >enable #copy xmodem flash Destination filename newfile.biz Begin the Xmodem transfer now... Press CTRL+X twice to cancel CCCCCC The AOS is now ready to accept the file on the CONSOLE port (using the XMODEM protocol). The next step in the process may differ depending on the type of terminal emulation software you are using. For HyperTerminal, you will now select Transfer > Send File and browse to the file you wish to copy. Once the transfer is complete, information similar to the following is displayed: Received 231424 bytes. Transfer complete.
61200500L1-35E
68
debug aaa
Use the debug aaa command to activate debug messages associated with authentication from the AAA subsystem. Debug messages are displayed (real time) on the terminal (or Telnet) screen. Use the no form of this command to disable the debug messages. Syntax Description
No subcommands.
Default Values
By default, all debug messages in the AOS are disabled.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 5.1 Command was introduced.
Functional Notes
The debug aaa events include connection notices, login attempts, and session tracking.
Usage Examples
The following is sample output for this command: >enable #debug aaa AAA: New Session on portal 'TELNET 0 (172.22.12.60:4867)'. AAA: No list mapped to 'TELNET 0'. Using 'default'. AAA: Attempting authentication (username/password). AAA: RADIUS authentication failed. AAA: Authentication failed. AAA: Closing Session on portal 'TELNET 0 (172.22.12.60:4867)'.
61200500L1-35E
69
debug auto-config
Use the debug auto-config command to activate debug messages associated auto-config events. Debug messages are displayed (real time) on the terminal (or Telnet) screen. Use the no form of this command to disable the debug messages. Syntax Description
No subcommands.
Default Values
By default, all debug messages in the AOS are disabled.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 11.1 Command was introduced.
Usage Examples
The example activates debug messages associated with auto-config events: >enable #debug auto-config
61200500L1-35E
70
debug data-call
Use the debug data-call command to activate debug messages associated with data call errors and events. Debug messages are displayed (real time) on the terminal (or Telnet) screen. Use the no form of this command to disable the debug messages. Syntax Description
No subcommands.
Default Values
By default, all debug messages in the AOS are disabled.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 11.1 Command was introduced.
Usage Examples
The following example activates debug messages associated with data call errors and events: >enable #debug data-call
61200500L1-35E
71
Default Values
By default, all debug messages in the AOS are disabled.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 8.1 Command was introduced.
Usage Examples
The following example activates dynamic DNS debug messages: >enable #debug dynamic-dns verbose
61200500L1-35E
72
Default Values
By default, all debug messages in the AOS are disabled.
Applicable Platforms
This command applies to the NetVanta 300, 1000, and 1000R Series units.
Command History
Release 8.1 Command was introduced.
Functional Notes
With GVRP enabled on many ports, this command can produce a lot of output. To see these messages just for individual interfaces, refer to the command debug gvrp interface <interface> [bpdus | vlans] on page 74.
Usage Examples
The following example displays debug messages showing GVRP configuration messages sent and received on Ethernet interface 0/24: >enable #debug gvrp bpdus 2000.07.31 23:15:51 GVRP BPDUS.eth 0/24: TX = (Len:2 LeaveAll) (Len:4 JoinIn Vlan:1) (End) ... SENT 2000.07.31 23:15:52 GVRP BPDUS.eth 0/24: RX = (Len:4 Empty Vlan:2) (Len:4 JoinIn Vlan:20) (end) 2000.07.31 23:15:52 GVRP BPDUS.eth 0/24: TX = (Len:4 JoinIn Vlan:1) (End) ... SENT 2000.07.31 23:15:52 GVRP BPDUS.eth 0/24: RX = (Len:4 JoinIn Vlan:20) (end) 2000.07.31 23:16:00 GVRP BPDUS.eth 0/24: RX = (Len:2 LeaveAll) (end) #
61200500L1-35E
73
Default Values
By default, all debug messages in the AOS are disabled.
Applicable Platforms
This command applies to the NetVanta 300, 1000, and 1000R Series units.
Command History
Release 8.1 Command was introduced.
Usage Examples
The following example displays debug messages showing GVRP configuration messages sent and received on Ethernet interface 0/24: >enable #debug gvrp interface ethernet 0/24 bpdus 2000.07.31 23:15:51 GVRP BPDUS.eth 0/24: TX = (Len:2 LeaveAll) (Len:4 JoinIn Vlan:1) (End) ... SENT 2000.07.31 23:15:52 GVRP BPDUS.eth 0/24: RX = (Len:4 Empty Vlan:2) (Len:4 JoinIn Vlan:20) (end) 2000.07.31 23:15:52 GVRP BPDUS.eth 0/24: TX = (Len:4 JoinIn Vlan:1) (End) ... SENT 2000.07.31 23:15:52 GVRP BPDUS.eth 0/24: RX = (Len:4 JoinIn Vlan:20) (end) 2000.07.31 23:16:00 GVRP BPDUS.eth 0/24: RX = (Len:2 LeaveAll) (end)
61200500L1-35E
74
Default Values
By default, all debug messages in the AOS are disabled.
Applicable Platforms
This command applies to the NetVanta 300, 1000, and 1000R Series units.
Command History
Release 8.1 Command was introduced.
Functional Notes
With GVRP enabled on many ports, this command can produce a lot of output. To see these messages just for individual interfaces, refer to the command debug gvrp interface <interface> [bpdus | vlans] on page 74.
Usage Examples
The following example displays debug messages showing GVRP-related VLAN changes for VLAN 1: >enable #debug gvrp vlans 1 # 2000.07.31 22:05:42 GVRP VLANS: Creating dynamic VLAN 20 2000.07.31 22:05:42 GVRP VLANS.eth 0/24: Dynamically adding port to VLAN 20 # 2000.07.31 22:05:56 INTERFACE_STATUS.eth 0/24 changed state to down 2000.07.31 22:06:08 GVRP VLANS.eth 0/24: Dynamically removing port from VLAN 20 2000.07.31 22:06:08 GVRP VLANS: Last port removed from VLAN 20, destroying VLAN
61200500L1-35E
75
Default Values
By default, all debug messages in the AOS are disabled.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 3.1 Release 6.1 Release 7.1 Release 9.1 Command was introduced. Command was expanded to include T1 and FXS interfaces. Command was expanded to include FXO interface. Command was expanded to include tunnel interface.
Functional Notes
The debug interface command activates debug messages to aid in the troubleshooting of physical interfaces.
Usage Examples
The following example activates all possible debug messages associated with the Ethernet port: >enable #debug interface ethernet
61200500L1-35E
76
debug ip dhcp-client
Use the debug ip dhcp-client command to activate debug messages associated with Dynamic Host Configuration Protocol (DHCP) client operation in the AOS. Debug messages are displayed (real time) to the terminal (or Telnet) screen. Use the no form of this command to disable the debug messages. Syntax Description
No subcommands.
Default Values
By default, all debug messages in the AOS are disabled.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 2.1 Command was introduced.
Functional Notes
The debug ip dhcp-client command activates debug messages to provide information on DHCP client activity in the AOS. The AOS DHCP client capability allows interfaces to dynamically obtain an IP address from a network DHCP server.
Usage Examples
The following example activates debug messages associated with DHCP client activity: >enable #debug ip dhcp-client
61200500L1-35E
77
debug ip dhcp-server
Use the debug ip dhcp-server command to activate debug messages associated with Dynamic Host Configuration Protocol (DHCP) server operation in the AOS. Debug messages are displayed (real time) to the terminal (or Telnet) screen. Use the no form of this command to disable the debug messages. Syntax Description
No subcommands.
Default Values
By default, all debug messages in the AOS are disabled.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 2.1 Command was introduced.
Functional Notes
The debug ip dhcp-server command activates debug messages to provide information on DHCP server activity in the AOS. The AOS DHCP server capability allows the AOS to dynamically assign IP addresses to hosts on the network.
Usage Examples
The following example activates debug messages associated with DHCP server activity: >enable #debug ip dhcp-server
61200500L1-35E
78
debug ip dns-client
Use the debug ip dns-client command to activate debug messages associated with domain naming system (DNS) client operation in the AOS. Debug messages are displayed (real time) to the terminal (or Telnet) screen. Use the no form of this command to disable the debug messages. Syntax Description
No subcommands.
Default Values
By default, all debug messages in the AOS are disabled.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 3.1 Command was introduced.
Functional Notes
The debug ip dns-client command activates debug messages to provide information on DNS client activity in the AOS. The IP DNS capability allows for DNS-based host translation (name-to-address).
Usage Examples
The following example activates debug messages associated with DNS client activity: >enable #debug ip dns-client
61200500L1-35E
79
debug ip dns-proxy
Use the debug ip dns-proxy command to activate debug messages associated with domain naming system (DNS) proxy operation in the AOS. Debug messages are displayed (real time) to the terminal (or Telnet) screen. Use the no form of this command to disable the debug messages. Syntax Description
No subcommands.
Default Values
By default, all debug messages in the AOS are disabled.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 3.1 Command was introduced.
Functional Notes
The debug ip dns-proxy command activates debug messages to provide information on DNS proxy activity in the AOS. The IP DNS capability allows for DNS-based host translation (name-to-address).
Usage Examples
The following example activates debug messages associated with DNS proxy activity: >enable #debug ip dns-proxy
61200500L1-35E
80
Default Values
By default, all debug messages in the AOS are disabled.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, and 2000 and Total Access 900 Series units.
Command History
Release 6.1 Command was introduced.
Usage Examples
The following example activates debug messages associated with HTTP activity: >enable #debug ip http
61200500L1-35E
81
Default Values
By default, all debug messages in the AOS are disabled.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 3.1 Command was introduced.
Usage Examples
The following example activates the debug ip icmp send and receive messages for the AOS: >enable #debug ip icmp ICMP SEND: From (0.0.0.0) to (172.22.14.229) Type=8 Code=0 Length=72 Details:echo request ICMP RECV: From (172.22.14.229) to (10.100.23.19) Type=0 Code=0 Length=72 Details:echo reply ICMP SEND: From (0.0.0.0) to (172.22.14.229) Type=8 Code=0 Length=72 Details:echo request ICMP RECV: From (172.22.14.229) to (10.100.23.19) Type=0 Code=0 Length=72 Details:echo reply ICMP RECV: From (172.22.255.200) to (10.100.23.19) Type=11 Code=0 Length=36 Details:TTL equals 0 during transit ICMP RECV: From (172.22.14.229) to (10.100.23.19) Type=3 Code=3 Length=36 Details:port unreachable ICMP RECV: From (172.22.14.229) to (10.100.23.19) Type=3 Code=3 Length=36 Details:port unreachable
61200500L1-35E
82
debug ip mrouting
Use the debug ip mrouting command to activate debug messages associated with multicast table routing events. Debug messages are displayed (real time) on the terminal (or Telnet) screen. Use the no form of this command to disable the debug messages. Syntax Description
No subcommands.
Default Values
By default, all debug messages in the AOS are disabled.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 10.1 Command was introduced.
Usage Examples
The following sample activates ip mrouting debug messages: >enable #debug ip mrouting
61200500L1-35E
83
Syntax Description
events Optional. Displays only TCP protocol events.
Default Values
By default, all debug messages in the AOS are disabled.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 4.1 Command was introduced.
Functional Notes
In the debug ip tcp events information, TCB stands for TCP task control block. The numbers which sometimes appear next to TCB (e.g., TCB5 in the following example) represent the TCP session number. This allows you to differentiate debug messages for multiple TCP sessions.
61200500L1-35E
84
Usage Examples
The following is sample output for this command: >enable #debug ip tcp events 2003.02.17 07:40:56 IP.TCP EVENTS TCP: Allocating block 5 2003.02.17 07:40:56 IP.TCP EVENTS TCB5: state change: FREE->SYNRCVD 2003.02.17 07:40:56 IP.TCP EVENTS TCB5: new connection from 172.22.75.246:3473 to 10.200.2.201:23 2003.02.17 07:40:56 IP.TCP EVENTS TCB5: state change: SYNRCVD->ESTABLISHED [172.22.75.246:3473] 2003.02.17 07:41:06 IP.TCP EVENTS TCB5: Connection aborted -- error = RESET 2003.02.17 07:41:06 IP.TCP EVENTS TCB5: De-allocating tcb
61200500L1-35E
85
debug ip udp
Use the debug ip udp command to activate debug messages associated with User Datagram Protocol (UDP) send and receive events in the AOS. Debug messages are displayed (real time) to the terminal (or Telnet) screen. Use the no form of this command to disable the debug messages.
These debug events are logged for packets that are sent or received from the router. Forwarded UDP packets are not included.
The overhead associated with this command takes up a large portion of your routers resources and at times can halt other router processes. It is best to only use the command during times when the network resources are in low demand (non-peak hours, weekends, etc.). Syntax Description
No subcommands.
Default Values
By default, all debug messages in the AOS are disabled.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 4.1 Command was introduced.
Functional Notes
In the debug ip udp information, the message no listener means that there is no service listening on this UDP port (i.e., the data is discarded).
61200500L1-35E
86
Usage Examples
The following is sample output for this command: >enable #debug ip udp 2003.02.17 07:38:48 IP.UDP RX: src=10.200.3.236:138, dst=10.200.255.255:138, 229 bytes, no listener 2003.02.17 07:38:48 IP.UDP RX: src=10.200.2.7:138, dst=10.200.255.255:138, 227 bytes, no listener 2003.02.17 07:38:48 IP.UDP RX: src=10.200.201.240:138, dst=10.200.255.255:138, 215 bytes, no listener
61200500L1-35E
87
Default Values
By default, all debug messages in the AOS are disabled.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 8.1 Command was introduced.
Usage Examples
The following example activates all possible debug messages associated with LLDP operation: >enable #debug lldp rx #debug lldp tx #debug lldp verbose
61200500L1-35E
88
debug port-auth [general | packet [both | rx | tx] | auth-sm | bkend-sm | reauth-sm | supp-sm]
Use the debug port-auth command to generate debug messages used to aid in troubleshooting problems during the port authentication process. Debug messages are displayed (real time) on the terminal (or Telnet) screen. Use the no form of this command to disable the debug messages. Syntax Description
general packet both packet rx packet tx auth-sm bkend reauth-sm supp-sm Optional. Displays configuration changes to the port authentication system. Optional. Displays packet exchange information in both receive and transmit directions. Optional. Displays packet exchange information in the receive-only direction. Optional. Displays packet exchange information in the transmit-only direction. Optional. Displays AuthPAE-state machine information. Optional. Displays backend-state machine information. Optional. Displays reauthentication-state machine information. Optional. Displays supplicant-state machine information.
Default Values
By default, all debug messages in the AOS are disabled.
Applicable Platforms
This command applies to the NetVanta 1000, 1000R, 3000, 4000, and 5000 Series units.
Command History
Release 9.1 Release 10.1 Command was introduced. New options were introduced.
Usage Examples
The following example activates port authentication debug information on received packets: >enable #debug port-auth packet rx Rcvd EAPOL Start for sess 1 on int eth 0/2
61200500L1-35E
89
Default Values
By default, all debug messages in the AOS are disabled.
Applicable Platforms
This command applies to the NetVanta 300, 1000, and 1000R Series units.
Command History
Release 8.1 Command was introduced.
Usage Examples
The following example activates port security debug messages: >enable #debug port security
61200500L1-35E
90
debug radius
Use the debug radius command to enable debug messages from the RADIUS subsystem. Debug messages are displayed (real time) to the terminal (or Telnet) screen. Use the no form of this command to disable the debug messages. Syntax Description
No subcommands.
Default Values
By default, all debug messages in the AOS are disabled.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 5.1 Command was introduced.
Functional Notes
The debug radius messages show the communication process with the remote RADIUS servers.
Usage Examples
The following is an example output for the debug radius command: >enable #debug radius RADIUS AUTHENTICATION: Sending packet to 172.22.48.1 (1645). RADIUS AUTHENTICATION: Received response from 172.22.48.1.
61200500L1-35E
91
debug sntp
Use the debug sntp command to enable debug messages associated with the Simple Network Time Protocol (SNTP). All SNTP packet exchanges and time decisions are displayed with these debugging events enabled. Debug messages are displayed (real time) to the terminal (or Telnet) screen. Use the no form of this command to disable the debug messages. Syntax Description
No subcommands.
Default Values
By default, all debug messages in the AOS are disabled.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 3.1 Command was introduced.
Functional Notes
The debug sntp command activates debug messages to aid in troubleshooting SNTP protocol issues.
Usage Examples
The following is an example output for the debug sntp command: >enable #debug sntp #config term (config)#sntp server timeserver.localdomain 2002.12.11 15:06:37 SNTP.CLIENT sent Version 1 SNTP time request to 63.97.45.57 2002.12.11 15:06:37 SNTP.CLIENT received SNTP reply packet from 63.97.45.57 2002.12.11 15:06:37 SNTP.CLIENT setting time to 12-11-2002 15:06:02 UTC 2002.12.11 15:06:37 SNTP.CLIENT waiting for 86400 seconds for the next poll interval
61200500L1-35E
92
Default Values
No default value necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 5.1 Command was introduced.
Usage Examples
The following example displays debug messages for BPDU packets that are transmitted and received by the unit: >enable #debug spanning-tree bpdu all
61200500L1-35E
93
Default Values
No default value necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 5.1 Command was introduced.
Usage Examples
The following example enables the display of general spanning-tree debug messages: >enable #debug spanning-tree general
61200500L1-35E
94
Default Values
By default, all debug messages in the AOS are disabled.
Applicable Platforms
This command applies to the NetVanta 1000 and 1000R Series units.
Command History
Release 8.1 Command was introduced.
Usage Examples
The following example activates the possible debug stack messages: >enable #debug stack SW_API #debug stack verbose
61200500L1-35E
95
debug system
Use the debug system command to enable debug messages associated with system events (i.e., login, logouts, etc.). Debug messages are displayed (real time) to the terminal (or Telnet) screen. Use the no form of this command to disable the debug messages. Syntax Description
No subcommands.
Default Values
By default, all debug messages in the AOS are disabled.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 3.1 Command was introduced.
Usage Examples
The following example activates debug messages associated with system information: >enable #debug system
61200500L1-35E
96
dir
Use the dir command to display a directory list of files on the system. Syntax Description
No subcommands.
Default Values
No default value necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 3.1 Command was introduced.
Usage Examples
The following is sample output from the dir command: >enable #dir Files: 988161 NV3200A-02-00-11.biz 1152 startup-config 1113 startup-config.bak 1739729 030018adv.biz 231424 boot030015.biz 1352150 NV3200A-E03-00-17.biz 232894 boot030018.biz 1812281 NV3200A-E03-00-20-adv.biz 6366976 bytes used, 335104 available, 6702080 total
61200500L1-35E
97
Default Values
No default value necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 10.1 Command was introduced.
Usage Examples
The following is example lists all files stored in flash: >enable #dir flash
61200500L1-35E
98
disable
Use the disable command to exit the Enable mode and enter the Basic mode. Syntax Description
No subcommands.
Default Values
No default value necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 1.1 Command was introduced.
Usage Examples
The following example exits the Enable mode and enters the Basic Command mode: #disable >
61200500L1-35E
99
enable
Use the enable command to enter a password for the Enable mode. Syntax Description
No subcommands.
Default Values
No default value necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 10.1 Command was introduced.
Functional Notes
The Enable Command mode provides access to operating and configuration parameters and should be password protected to prevent unauthorized use. Use the enable password command (found in the Global Configuration mode) to specify an Enable Command mode password. If the password is set, access to the Enable Commands (and all other privileged commands) is only granted when the correct password is entered. Refer to enable password [md5] <password> on page 238 for more information.
Usage Examples
The following example enters the Enable Command mode and defines an Enable Command mode password: >enable Password: ***** #
61200500L1-35E
100
Default Values
No default value necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 1.1 Command was introduced.
Usage Examples
The following example erases the startup configuration file stored in NVRAM: >enable #erase startup-config If a new startup-configuration file is not specified before power-cycling the unit, the AOS will initialize using a default configuration.
61200500L1-35E
101
events
Use the events command to enable event reporting to the current command line interface (CLI) session. Use the no form of this command to disable all event reporting to the current CLI session. Syntax Description
No subcommands.
Default Values
By default, this command is enabled.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 3.1 Command was introduced.
Usage Examples
The following example enables event reporting: >enable #events
61200500L1-35E
102
Default Values
No default value necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 10.1 Command was introduced.
Usage Examples
The following example immediately generates an exception report: >enable #exception report generate
61200500L1-35E
103
logout
Use the logout command to terminate the current session and return to the login screen. Syntax Description
No subcommands.
Default Values
No defaults necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 1.1 Command was introduced.
Usage Examples
The following example shows the logout command being executed in Enable mode: >enable #logout Session now available Press RETURN to get started.
61200500L1-35E
104
ping <address>
Use the ping command (at the Enable mode prompt) to verify IP network connectivity. Syntax Description
<address> Optional. Specifies the IP address of the system to ping. Entering the ping command with no specified address prompts the user with parameters for a more detailed ping configuration. Refer to Functional Notes (below) for more information.
Default Values
No default value necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 1.1 Command was introduced.
Functional Notes
The ping command helps diagnose basic IP network connectivity using the Packet Internet Groper program to repeatedly bounce Internet Control Message Protocol (ICMP) Echo_Request packets off a system (using a specified IP address). The AOS allows executing a standard ping request to a specified IP address or provides a set of prompts to configure a more specific ping configuration. The following is a list of output messages from the ping command: ! $ X ? * Success Destination Host Unreachable Invalid Host Address TTL Expired in Transit Unknown Host Request Timed Out
61200500L1-35E
105
Command Reference Guide The following is a list of available extended ping fields with descriptions: Target IP address: Repeat Count: Datagram Size: Timeout in Seconds: Specifies the IP address of the system to ping.
Specifies the number of ping packets to send to the system (valid range: 1 to 1,000,000). Size (in bytes) of the ping packet (valid range: 1 to 1448). If a ping response is not received within the timeout period, the ping is considered unsuccessful (valid range: 1 to 5 seconds).
Extended Commands: Specifies whether additional commands are desired for more ping configuration parameters. Source Address: Data Pattern: Specifies the IP address to use as the source address in the ECHO_REQ (or interface) packets. Specifies an alphanumerical string to use (the ASCII equivalent) as the data pattern in the ECHO_REQ packets. Specifies the minimum size of the ECHO_REQ packet (valid range: 0 to 1488). Specifies the maximum size of the ECHO_REQ packet (valid range: Sweep Min Size to 1448). Specifies the interval used to determine packet size when performing the sweep (valid range: 1 to 1448). Specifies an extended results output.
Sweep Range of Sizes: Varies the sizes of the ECHO_REQ packets transmitted. Sweep Min Size: Sweep Max Size: Sweep Interval: Verbose Output:
Usage Examples
The following is an example of a successful ping command: >enable #ping Target IP address:192.168.0.30 Repeat count[1-1000000]:5 Datagram Size [1-1000000]:100 Timeout in seconds [1-5]:2 Extended Commands? [y or n]:n Type CTRL+C to abort. Legend: '!' = Success '?' = Unknown host '$' = Invalid host address '*' = Request timed out '-' = Destination host unreachable 'x' = TTL expired in transit Pinging 192.168.0.30 with 100 bytes of data: !!!!! Success rate is 100 percent (5/5) round-trip min/avg/max = 19/20.8/25 ms
61200500L1-35E
106
ping stack-member
Use the ping stack-member command to ping a member of the stack. Syntax Description
No subcommands.
Default Values
No default value necessary for this command.
Applicable Platforms
This command applies to the NetVanta 1000 and 1000R Series units.
Command History
Release 8.1 Command was introduced.
Functional Notes
This command is available only in stack-master mode.
Usage Examples
The following example pings a member of the stack: >enable #ping stack-member 3 Type CTRL+C to abort. Legend: '!' = Success, '?' = Unknown host, '$' = Invalid host address '*' = Request timed out, '-' = Destination host unreachable 'x' = TTL expired in transit Sending 5, 100-byte ICMP Echos to 169.254.0.3, timeout is 2 seconds: !!!!! Success rate is 100 percent (5/5), round-trip min/avg/max = 2/2.2/3 ms #
61200500L1-35E
107
Syntax Description
cancel in <delay> Optional. Deactivates a pending reload command. Optional. Specifies a delay period the AOS will wait before reloading. Specifies the delay period in minutes (mmm) or hours and minutes (hh:mm).
Default Values
No default value necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 1.1 Command was introduced.
Usage Examples
The following example reloads the AOS software in 3 hours and 27 minutes: >enable #reload in 03:27 The following example reloads the AOS software in 15 minutes: >enable #reload in 15 The following example terminates a pending reload command: >enable #reload cancel
61200500L1-35E
108
Default Values
No default value necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 1.1 Release 10.1 Command was introduced. The real time display option was introduced.
Functional Notes
Use the realtime argument for this command to display full-screen output in real time. Information is continuously updated on the console until you either freeze the data (by pressing the F key) or exit realtime mode (by pressing Ctrl-C). If there is not enough room on the screen for all available data, the information will truncate at the bottom of the screen. In order to maximize the amount of data displayed, increase the terminal length (using the terminal length command; refer to terminal length <text> on page 199).
Usage Examples
The following is a sample output of the show arp command: >enable #show arp ADDRESS 192.168.30.36 192.168.30.253 224.0.0.9 TTL (min) 13 17 71578541 MAC ADDRESS 00:E0:7D:88:1A:B9 02:60:8C:DD:0A:CE 01:00:5E:00:00:09 LAST UPDATED (min) 4260 4264 0 INTERFACE eth 0/1 eth 0/1 eth 0/2
61200500L1-35E
109
show auto-config
Use the show auto-config command to display auto-configuration status. Syntax Description
No subcommands.
Default Values
No default value necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 11.1 Command was introduced.
Usage Examples
The following is a sample output of the show auto-config command: >enable #show auto-config Auto-Config is enabled, current status: Done. TFTP Server is 10.20.20.1 Config filename is 1524STfile Maximum retry count is 0 (repeat indefinitely), total retries is 0
61200500L1-35E
110
Default Values
No default value necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 3.1 Release 10.1 Command was introduced. The real time display option was introduced.
Functional Notes
Use the realtime argument for this command to display full-screen output in real time. Information is continuously updated on the console until you either freeze the data (by pressing the F key) or exit realtime mode (by pressing Ctrl-C). If there is not enough room on the screen for all available data, the information will truncate at the bottom of the screen. In order to maximize the amount of data displayed, increase the terminal length (using the terminal length command; refer to terminal length <text> on page 199).
Usage Examples
The following is a sample output from the show buffers command: >enable #show buffers Buffer handles: 119 of 2000 used. Pool 0 1 2 3 4 5 Size 1800 2048 4096 8192 16384 32768 Total 1894 64 32 4 2 2 Used 119 0 0 0 0 0 Available 1775 64 32 4 2 2 Max. Used 122 0 0 0 0 0
61200500L1-35E
111
Default Values
No default value necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 4.1 Release 10.1 Command was introduced. The real time display option was introduced.
Functional Notes
Use the realtime argument for this command to display full-screen output in real time. Information is continuously updated on the console until you either freeze the data (by pressing the F key) or exit realtime mode (by pressing Ctrl-C). If there is not enough room on the screen for all available data, the information will truncate at the bottom of the screen. In order to maximize the amount of data displayed, increase the terminal length (using the terminal length command; refer to terminal length <text> on page 199).
Usage Examples
The following is a sample from the show buffers users command: >enable #show buffers users Number of users: 7 Rank User 1 0x0052f4f8 2 0x0051a4fc 3 0x00528564 4 0x0053c1c8 5 fixedsize
Count 59 32 8 7 5
61200500L1-35E
112
Command Reference Guide 6 7 8 9 10 11 12 13 14 15 0x001d8298 0x0010d970 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 2 1 0 0 0 0 0 0 0 0
61200500L1-35E
113
show channel-group
Use the show channel-group command to display detailed information regarding port aggregation of a specified channel group (i.e., channel groups and their associated ports). Variations of this command include the following:
show channel-group port-channel load-balance show channel-group summary show channel-group <channel group #> summary
Syntax Description
port-channel load-balance summary <channel group #> Displays the current load-balance scheme. Summarizes the state of all channel groups or of a specific channel group (if specified by the <channel group #> argument). Specifies the channel group using the channel group ID (16).
Default Values
No default value necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, and 1000R Series units.
Command History
Release 5.1 Command was introduced.
Usage Examples
The following is a sample from the show channel-group command: >enable #show channel-group summary Channel Group Port channel -----------------------------------1 2 1 2
Associated Ports ----------------------eth 0/2 eth 0/3 eth 0/5 eth 0/6 eth 0/7
61200500L1-35E
114
Default Values
No default value necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 1.1 Command was introduced.
Usage Examples
The following example displays the current time and data from the system clock: >show clock 23:35:07 UTC Tue Aug 20 2002
61200500L1-35E
115
show configuration
Use the show configuration command to display a text printout of the startup configuration file stored in nonvolatile random access memory (NVRAM). Syntax Description
No subcommands.
Default Values
No default value necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 1.1 Command was introduced.
Usage Examples
The following is a sample output of the show configuration command: >enable #show configuration ! ! no enable password ! ip subnet-zero ip classless ip routing ! event-history on no logging forwarding logging forwarding priority-level info no logging email ! ip policy-timeout tcp all-ports 600 ip policy-timeout udp all-ports 60 ip policy-timeout icmp 60 !
61200500L1-35E
116
Command Reference Guide ! ! interface eth 0/1 speed auto no ip address shutdown ! interface dds 1/1 shutdown ! interface bri 1/2 shutdown ! ! ip access-list standard Outbound permit host 10.3.50.6 permit 10.200.5.0 0.0.0.255 ! ! ip access-list extended UnTrusted deny icmp 10.5.60.0 0.0.0.255 any source-quench deny tcp any any ! no ip snmp agent ! ! ! line con 0 no login ! line telnet 0 login line telnet 1 login line telnet 2 login line telnet 3 login line telnet 4 login !
61200500L1-35E
117
show debugging
Use the show debugging command to display a list of all activated debug message categories. Syntax Description
No subcommands.
Default Values
No default value necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 1.1 Command was introduced.
Usage Examples
The following is a sample output from the show debugging command: >enable #show debugging debug access-list MatchAll debug firewall debug ip rip debug frame-relay events debug frame-relay llc2 debug frame-relay lmi
61200500L1-35E
118
show dynamic-dns
Use the show dynamic-dns command to show information related to the dynamic domain naming system (DNS) configuration. Syntax Description
No subcommands.
Default Values
No default is necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 8.1 Command was introduced.
Usage Examples
The following is sample output from this command: >enable #show dynamic-dns eth 0/1: Hostname: host Is Updated: no Last Registered IP: 10.15.221.33 Last Update Time: 00:00:00 UTC Thu Jan 01 1970
61200500L1-35E
119
show event-history
Use the show event-history command to display all entries in the current local event-history log. Syntax Description
No subcommands.
Default Values
No default value necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 1.1 Command was introduced.
Usage Examples
The event history provides useful information regarding the status of the system and individual port states. Use the event history as a troubleshooting tool when identifying system issues. The following is a sample event-history log. >enable #show event-history Using 526 bytes 2002.07.12 15:34:01 T1.t1 1/1 Yellow 2002.07.12 15:34:01 INTERFACE_STATUS.t1 1/1 changed state to down. 2002.07.12 15:34:02 T1.t1 1/1 No Alarms 2002.07.12 15:34:02 INTERFACE_STATUS.t1 1/1 changed state to up. 2002.07.12 15:34:03 INTERFACE_STATUS.eth 0/1 changed state to up. 2002.07.12 15:34:10 OPERATING_SYSTEM Warm Start 2002.07.12 15:34:12 PPP.NEGOTIATION LCP up 2002.07.12 15:34:12 PPP.NEGOTIATION IPCP up
61200500L1-35E
120
show flash
Use the show flash command to display a list of all files currently stored in FLASH memory. Syntax Description
No subcommands.
Default Values
No default value necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 1.1 Command was introduced.
Usage Examples
The following is a sample show flash output: >enable #show flash Files: 245669 010100boot.biz 1141553 new.biz 821 startup-config 1638 startup-config.old 1175679 020016.biz 821 startup-config.bak 2572304 bytes used 4129776 available 6702080 total
61200500L1-35E
121
Default Values
No default value necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, and 1000R Series units.
Command History
Release 8.1 Command was introduced.
Usage Examples
The following example displays the current configured GARP application timer values: >enable #show garp timer Timer -------Join Leave LeaveAll
61200500L1-35E
122
Default Values
No default value necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, and 1000R Series units.
Command History
Release 8.1 Command was introduced.
Usage Examples
The following example displays a GVRP configuration summary for the switch: >enable #show gvrp configuration Global GVRP Configuration: GVRP Feature is currently enabled globally. GVRP Timers (milliseconds) Join 200 Leave 600 LeaveAll 20000 Port based GVRP Configuration: GVRP enabled ports ---------------------------------------------------eth 0/24 #
61200500L1-35E
123
Default Values
No default value necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, and 1000R Series units.
Command History
Release 8.1 Command was introduced.
Usage Examples
The following example displays statistics related to GVRP for Ethernet interface 0/24: >enable #show gvrp statistics interface ethernet 0/24 Name: eth 0/24 Join Empty Received: 0 Join In Received: 272 Empty Received: 30 Leave Empty Received: 0 Leave In Received: 0 Leave All Received: 28 Join Empty Transmitted: 0 Join In Transmitted: 286 Empty Transmitted: 28 Leave Empty Transmitted: 0 Leave In Transmitted: 0 Leave All Transmitted: 115 #
61200500L1-35E
124
Default Values
No default value necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 3.1
Functional Notes
The list below describes the fields contained in the host table: Flags: Indicate whether the entry is permanent (P) or temporary (T) and if the entry is OK or expired (EXP). Age: Indicates the age of the entry. Type: Shows the protocol type. Address: Displays the IP address for the entry.
Usage Examples
The following example is sample output from the show hosts command: >enable #show hosts Name/address lookup uses domain name service DNS Proxy is disabled Default domain is not set Name servers are 1.1.1.1 2.2.2.2 Host Flags Age Type Address Example1 (P OK) -IP 1.1.1.1 Example2 (P OK) -IP 2.2.2.2
61200500L1-35E
125
performance-statistics total-24-hourOptional. Displays the current 24-hour totals and the past seven 24-hour intervals. performance-statistics <x-y> Shows the current 15-minute interval, the current 24-hour totals, and all intervals from x through y. This command is basically the same thing as the performance-statistics command with the added function of allowing you to specify a particular interval (or range of intervals) to display rather than displaying all 96.
Note: If you want to display the 24th interval, enter (for example) show interface t11/1 performance-statistics 24-24. Entering show interface t1 1/1 performance-statistics 24 results in displaying the 24-hour statistics. Any number other than 24 (between 1 and 96) results in the correct display of the selected interval (e.g., show interface t1 1/1 performance-statistics 4 shows the fourth interval).
realtime status verbose version Displays full-screen output in real time. See the Functional Notes below for more information. Optional. Displays information such as name, type, status, VLAN, speed, and duplex for all the Ethernet interfaces only. Displays detailed configuration information on the terminal screen (versus only the non-default values). Optional. Displays current version information (e.g., model and list number, software version, etc.) for the T1 interface.
Default Values
No default value necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
61200500L1-35E
126
Command History
Release 1.1 Release 6.1 Release 9.1 Release 10.1 Release 11.1 Command was introduced. Command was updated to include performance-statistics option. Command was expanded to include HDLC and tunnel interfaces. The realtime option and PRI interface were added. Description, status, and verbose options were introduced. The demand, FXO, and serial interfaces were added.
Functional Notes
Use the realtime argument for this command to display full-screen output in real time. Information is continuously updated on the console until you either freeze the data (by pressing the F key) or exit realtime mode (by pressing Ctrl-C). If there is not enough room on the screen for all available data, the information will truncate at the bottom of the screen. In order to maximize the amount of data displayed, increase the terminal length (using the terminal length command; refer to terminal length <text> on page 199).
Usage Examples
The following are samples from various show interfaces commands: >enable #show interfaces t1 1/1 t1 1/1 is UP T1 coding is B8ZS framing is ESF Clock source is line FDL type is ANSI Line build-out is 0dB No remote loopbacks No network loopbacks DS0 Status: 123456789012345678901234 NNNNNNNNNNNNNNNNNNNNNNNN Line Status: -- No Alarms -Current Performance Statistics: 0 Errored Seconds 0 Bursty Errored Seconds 0 Severely Errored Seconds 0 Severely Errored Frame Seconds 0 Unavailable Seconds 0 Path Code Violations 0 Line Code Violations 0 Controlled Slip Seconds 0 Line Errored Seconds 0 Degraded Minutes
61200500L1-35E
127
Command Reference Guide #show interfaces modem 1/2 modem 1/2 is UP Line status: on-hook Caller ID will be used to route incoming calls 0 packets input 0 bytes 0 no buffer 0 runts 0 giants 0 throttles 0 input errors 0 CRC 0 frame 0 abort 0 ignored 0 overruns 0 packets output 0 bytes 0 underruns 0 input clock glitches 0 output clock glitches 0 carrier lost 0 cts lost #show interfaces eth 0/1 Ip address is 10.200.1.50 Netmask is 255.255.0.0 MTU is 1500 Fastcaching is Enabled RIP Authentication is Disabled RIP Tx uses global version value RIP Rx uses global version value #show interfaces dds 1/1 dds 1/1 is UP line protocol is UP Encapsulation FRAME-RELAY (fr 1) Loop rate is set to 56000 actual rate is 56000 Clock source is line Data scrambling is disabled No Loopbacks 75 packets input 6108 bytes 0 no buffer 0 runts 0 giants 0 throttles 0 input errors 0 CRC 0 frame 0 abort 0 ignored 0 overruns 81 packets output 11496 bytes 0 underruns 0 input clock glitches 0 output clock glitches 0 carrier lost 0 cts lost
61200500L1-35E
128
Command Reference Guide #show interfaces fr 1 TDM group 10 line protocol is UP Encapsulation FRAME-RELAY (fr 1) 463 packets input 25488 bytes 0 no buffer 0 runts 0 giants 0 throttles 0 input errors 0 CRC 0 frame 0 abort 0 ignored 0 overruns 864 packets output 239993 bytes 0 underruns 0 input clock glitches 0 output clock glitches 0 carrier lost 0 cts lost Line Status: -- No Alarms -Current Performance Statistics: 0 Errored Seconds 0 Bursty Errored Seconds 0 Severely Errored Seconds 0 Severely Errored Frame Seconds 0 Unavailable Seconds 0 Path Code Violations 0 Line Code Violations 0 Controlled Slip Seconds 0 Line Errored Seconds 0 Degraded Minutes #show interfaces fr 1.100* fr 1.100 is Active Ip address is 63.97.45.57, mask is 255.255.255.248 Interface-dlci is 100 MTU is 1500 bytes, BW is 96000 Kbit (limited) Average utilization is 53%
*Note: If the user has configured a Bc and Be value on the virtual circuit, the bandwidth (BW) displayed is the sum of those values (Bc + Be). If not, the value for BW is the speed of the interface. The Average utilization displayed is the average utilization of the displayed bandwidth. If the bandwidth number is the Bc + Be value, the (limited) text appears (as shown above).
61200500L1-35E
129
Default Values
No default value necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, and 2000 Series units.
Command History
Release 6.1 Release 10.1 Command was introduced. VLANS option was introduced.
Functional Notes
The output of this command is restricted to switch-only information.
Usage Examples
The following is sample output from the show interfaces switchport command: >enable #show interfaces switchport Name: eth 0/1 Switchport: enabled Administrative mode: access Negotiation of Trunking: access Access mode VLAN: 1 Trunking Native mode VLAN: 1 Trunking VLAN Enabled: 1-4094 Name: eth 0/2 Switchport: enabled Administrative mode: access Negotiation of Trunking: access Access mode VLAN: 12.....
61200500L1-35E
130
Default Values
No default value necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 1.1 Release 10.1 Command was introduced. The real time display option was introduced.
Functional Notes
Use the realtime argument for this command to display full-screen output in real time. Information is continuously updated on the console until you either freeze the data (by pressing the F key) or exit realtime mode (by pressing Ctrl-C). If there is not enough room on the screen for all available data, the information will truncate at the bottom of the screen. In order to maximize the amount of data displayed, increase the terminal length (using the terminal length command; refer to terminal length <text> on page 199).
Usage Examples
The following is a sample output of the show ip arp command: >enable #show ip arp ADDRESS 192.168.30.36 192.168.30.253 224.0.0.9 TTL (min) 13 17 71578541 MAC ADDRESS 00:E0:7D:88:1A:B9 02:60:8C:DD:0A:CE 01:00:5E:00:00:09 LAST UPDATED (min) 4260 4264 0
61200500L1-35E
131
Default Values
No default value necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 2.1 Command was introduced.
Usage Examples
The following is a sample output from the show dhcp-client lease command: >enable #show dhcp-client lease Interface: ethernet 0/1 Temp IP address: 10.100.23.64 Mask: 0.0.0.0 DHCP Lease server: 10.100.23.207 State: Bound (3) Lease: 120 seconds Temp default gateway address: 0.0.0.0 Client-ID: N/A
61200500L1-35E
132
Default Values
No default value necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 2.1 Command was introduced.
Usage Examples
The following is a sample output from the show ip dhcp-server binding command: >enable #show ip dhcp-server binding IP Address 10.100.23.64 Client Id Lease Expiration 01:00:a0:c8:00:8f:b3 Aug 15 2002 11:02 AM Client Name Router
61200500L1-35E
133
brief
Default Values
No default value necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 1.1 Release 9.1 Release 11.1 Command was introduced. Command was expanded to include HDLC and tunnel interfaces. Demand interface was added.
Usage Examples
The following is a sample output of the show ip interfaces command: >enable #show ip interfaces eth 0/1 is UP, line protocol is UP Ip address is 10.10.10.1 Netmask is 255.255.255.0 MTU is 1500 Fastcaching is Enabled RIP Authentication is Disabled RIP Tx uses global version value RIP Rx uses global version value
61200500L1-35E
134
Default Values
No default value necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 3.1 Release 10.1 Command was introduced. The real time display option was introduced.
Functional Notes
Use the realtime argument for this command to display full-screen output in real time. Information is continuously updated on the console until you either freeze the data (by pressing the F key) or exit realtime mode (by pressing Ctrl-C). If there is not enough room on the screen for all available data, the information will truncate at the bottom of the screen. In order to maximize the amount of data displayed, increase the terminal length (using the terminal length command; refer to terminal length <text> on page 199).
Usage Examples
>enable #show ip traffic
61200500L1-35E
135
show lldp
Use the show lldp command to display local loop demarkation point (LLDP) timer configuration. Syntax Description
No subcommands.
Default Values
No default values are necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 8.1 Command was introduced.
Usage Examples
The following example shows a sample LLDP timer configuration: >enable #show lldp Global LLDP information: Sending LLDP packets every 30 seconds Sending TTL of 120 seconds
61200500L1-35E
136
Default Values
No default values are necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 8.1 Command was introduced.
Functional Notes
If there is more than one neighbor with the same system name, all neighbors with that system name will be displayed.
Usage Examples
The following example shows specific information about a neighbor for the system name Router: >enable #show lldp device Router Chassis ID: 00:A0:C8:02:DD:2A (MAC Address) System Name: Router Device Port: eth 0/1 (Locally Assigned) Holdtime: 30 Platform: NetVanta 3305 Software: Version: 08.00.22.sw1.D, Date: Mon Nov 01 10:28:55 2004 Capabilities: Bridge, Router Enabled Capabilities: Router Local Port: eth 0/3 Management Addresses: Address Type: IP version 4, Address: 10.23.10.10 Interface Type: Interface Index, Interface Id: 2
61200500L1-35E
137
Default Values
No default values are necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 8.1 Command was introduced.
Usage Examples
The following example shows LLDP configuration and statistics for the Ethernet 0/1 interface: >enable #show lldp interface ethernet 0/1 eth 0/1 (TX/RX) 0 packets input 0 input errors 0 TLV errors, 0 TLVs Discarded 0 packets discarded 8799 packets output 0 neighbor ageouts #
61200500L1-35E
138
Default Values
No default values necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 8.1 Release 10.1 Command was introduced. The real time display option was introduced.
Functional Notes
Use the realtime argument for this command to display full-screen output in real time. Information is continuously updated on the console until you either freeze the data (by pressing the F key) or exit realtime mode (by pressing Ctrl-C). If there is not enough room on the screen for all available data, the information will truncate at the bottom of the screen. In order to maximize the amount of data displayed, increase the terminal length (using the terminal length command; refer to terminal length <text> on page 199).
61200500L1-35E
139
Usage Examples
The following example shows detailed information about a devices neighbors: >enable #show lldp neighbors interface eth 0/3 detail Chassis ID: 00:A0:C8:02:DD:2A (MAC Address) System Name: Router Device Port: eth 0/1 (Locally Assigned) Holdtime: 38 Platform: NetVanta 3305 Software: Version: 08.00.22.sw1.D, Date: Mon Nov 01 10:28:55 2004 Capabilities: Bridge, Router Enabled Capabilities: Router Local Port: eth 0/3 Management Addresses: Address Type: IP version 4, Address: 10.23.10.10 Interface Type: Interface Index, Interface Id: 2
61200500L1-35E
140
Default Values
There are no default values necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 8.1 Command was introduced.
Functional Notes
This command shows information about the changes in this devices neighbor table. The information displayed indicates the last time a neighbor was added to or removed from the table as well as the number of times neighbors were inserted into or deleted from the table.
Usage Examples
The following example shows sample output for this command: >enable #show lldp neighbors statistics System Last Change Time Inserts 10-15-2004 14:24:56 55
Deletes 3
Drops 1
Age outs 1
System Last Change Time - Shows the time at which the most recent change occurred in the neighbor table. Inserts - Shows the number of times neighbors have been added to the table. Deletes - Shows how many times neighbors have been deleted from the table because an interface was shut down. Drops - Shows how many times the insertion of a new neighbor into the table failed because the table was full. Age outs - Shows how many times neighbors have been removed from the table because no new updates were received from that neighbor before its time-to-live timer expired.
61200500L1-35E
141
Default Values
No default value necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, and 2000 Series units.
Command History
Release 5.1 Command was introduced.
Usage Examples
The following is sample output from the show mac address-table command: >enable #show mac address-table Mac Address Table -----------------------------------------Vlan 1 1 2 2 2 2 2 2 2 2 2 2 2 Mac Address aa:bb:ee:d1:c2:33 00:00:00:00:00:00 00:90:2b:7d:30:00 00:a0:c8:00:8e:a6 00:a0:c8:00:8f:ba 00:a0:c8:00:8f:73 00:a0:c8:00:00:00 00:a0:c8:01:ff:02 00:a0:c8:01:09:d3 00:a0:c8:01:13:34 00:a0:c8:01:14:4a 00:a0:c8:03:95:4b 00:a0:c8:05:00:89 Type STATIC STATIC DYNAMIC DYNAMIC DYNAMIC DYNAMIC DYNAMIC DYNAMIC DYNAMIC DYNAMIC DYNAMIC DYNAMIC DYNAMIC Ports eth 0/18 CPU eth 0/1 eth 0/1 eth 0/1 eth 0/1 eth 0/1 eth 0/1 eth 0/1 eth 0/1 eth 0/1 eth 0/1 eth 0/1
61200500L1-35E
142
Usage Examples
2 2 2 00:a0:c8:05:00:ac 00:a0:c8:05:00:ad 00:a0:c8:05:00:c2 DYNAMIC DYNAMIC DYNAMIC eth 0/1 eth 0/1 eth 0/1
61200500L1-35E
143
Syntax Description
<mac address> Specifies a valid 48-bit MAC address. interface <interface type> Shows information for a specific interface. Type show mac address-table address interface ? for a list of valid interfaces. <interface id> vlan <vlan id> Specifies a valid slot/port interface ID (e.g., 0/1). Specifies a valid VLAN interface ID (1 to 4094).
Default Values
No default value necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, and 2000 Series units.
Command History
Release 5.1 Command was introduced.
Usage Examples
The following sample from the show mac address-table address command displays information regarding a specific MAC address from the MAC address table: >enable #show mac address-table address 00:a0:c8:7d:30:00 Mac Address Table -----------------------------------------Vlan -------2 Mac Address -------------------00:a0:c8:7d:30:00 Type --------DYNAMIC Ports ----------eth 0/1
61200500L1-35E
144
The following sample from the show mac address-table address command displays information regarding a specific MAC address and interface from the MAC address table: >enable #show mac address-table address 00:a0:c8:7d:30:00 ethernet 0/1 Mac Address Table -----------------------------------------Vlan -------2 # Mac Address -------------------00:a0:c8:7d:30:00 Type --------DYNAMIC Ports ----------eth 0/1
61200500L1-35E
145
Default Values
No default value necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, and 2000 Series units.
Command History
Release 5.1 Command was introduced.
Usage Examples
The following is a sample from the show mac address-table aging-time command for a switch configured with an address-table aging-time: >enable #show mac address-table aging-time Aging Time ---------------300 Seconds
61200500L1-35E
146
Default Values
No default value necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, and 2000 Series units.
Command History
Release 5.1 Command was introduced.
Usage Examples
The following is a sample from the show mac address-table count command: >enable #show mac address-table count Mac Table Entries: -------------------------Dynamic Address Count: 19 Static Address Count: 3 Total Mac Addresses: 23 Total Mac Address Space Available: 8169
61200500L1-35E
147
Syntax Description
address <mac address> Specifies a valid 48-bit MAC address. interface <interface type> Shows information for a specific interface. Type show mac address-table dynamic interface ? for a list of valid interfaces. <interface id> vlan <vlan id> Specifies a valid slot/port interface ID (e.g., 0/1). Specifies a valid VLAN interface ID (1 to 4094).
Default Values
No default value necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, and 2000 Series units.
Command History
Release 5.1 Command was introduced.
61200500L1-35E
148
Usage Examples
The following is a sample from the show mac address-table dynamic command: >enable #show mac address-table dynamic Mac Address Table ---------------------------Vlan Mac Address Type ------- --------------------------1 00:a0:c8:7d:30:00 DYNAMIC 1 00:a0:c8:05:89:09 DYNAMIC 1 00:a0:c8:07:d9:d2 DYNAMIC 1 00:a0:c8:07:d9:19 DYNAMIC 1 00:a0:c8:09:95:6b DYNAMIC 1 00:a0:c8:0a:2d:7c DYNAMIC 1 00:a0:c8:f6:e9:a6 DYNAMIC 1 00:a0:c8:01:0a:ef DYNAMIC 1 00:a0:c8:0c:74:80 DYNAMIC 1 00:a0:c8:15:5a:9f DYNAMIC 1 00:a0:c8:6c:71:49 DYNAMIC 1 00:a0:c8:77:78:c1 DYNAMIC 1 00:a0:c8:6b:53:7b DYNAMIC 1 00:a0:c8:72:e6:d6 DYNAMIC 1 00:a0:c8:05:00:e6 DYNAMIC Total Mac Addresses for this criterion: 15
Ports -------eth 0/1 eth 0/2 eth 0/5 eth 0/7 eth 0/7 eth 0/12 eth 0/24 eth 0/23 eth 0/20 eth 0/7 eth 0/2 eth 0/3 eth 0/4 giga-eth 0/2 giga-eth 0/1
61200500L1-35E
149
show mac address-table interface [<interface type> <interface id> | vlan <vlan id>]
Use the show mac address-table interface command to display information regarding medium access control (MAC) address table entries specific to a certain interface. Syntax Description
<interface type> <interface id> vlan <vlan id> Shows information for a specific interface type. Type show mac address-table interface ? for a list of valid interfaces. Shows address-table information related to a specific interface (e.g., eth 0/1). Shows address-table information related to a specific VLAN. Specifies a valid VLAN interface ID (1 to 4094).
Default Values
No default value necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, and 2000 Series units.
Command History
Release 5.1 Command was introduced.
Usage Examples
The following is an example of the show mac address-table interface eth 0/1 command displaying MAC address-table entries specifically on Ethernet 0/1: >enable #show mac address-table interface ethernet 0/1 Mac Address Table Vlan 2 2 2 2 2 2 2 Mac Address 00:90:2b:7d:30:00 00:a0:c8:05:00:ac 00:a0:c8:05:00:ad 00:a0:c8:05:00:c2 00:a0:c8:05:01:6e 00:a0:c8:09:95:6b 00:a0:c8:0a:2d:7c Type DYNAMIC DYNAMIC DYNAMIC DYNAMIC DYNAMIC DYNAMIC DYNAMIC Ports eth 0/1 eth 0/1 eth 0/1 eth 0/1 eth 0/1 eth 0/1 eth 0/1
61200500L1-35E
150
Syntax Description
address <mac address> Specifies a valid 48-bit MAC address. interface <interface type> Shows information for a specific interface. Type show mac address-table static interface ? for a list of valid interfaces. <interface id> vlan <vlan id> Specifies any valid slot/port interface ID (e.g., 0/1). Specifies a valid VLAN interface ID (1 to 4094).
Default Values
No default value necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, and 1000R Series units.
Command History
Release 5.1 Command was introduced.
61200500L1-35E
151
Usage Examples
The following is a sample from the show mac address-table static command: >enable #show mac address-table static
Mac Address Table ----------------------------Vlan -----1 Mac Address ------------------00:a0:c8:00:88:40 Type -------STATIC Ports -------CPU
61200500L1-35E
152
realtime
Default Values
No default value necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 3.1 Release 10.1 Release 11.1 Command was introduced. Realtime option was introduced. Uncached heap option was introduced.
Functional Notes
Use the realtime argument for this command to display full-screen output in real time. Information is continuously updated on the console until you either freeze the data (by pressing the F key) or exit realtime mode (by pressing Ctrl-C). If there is not enough room on the screen for all available data, the information will truncate at the bottom of the screen. In order to maximize the amount of data displayed, increase the terminal length (using the terminal length command; refer to terminal length <text> on page 199).
61200500L1-35E
153
Usage Examples
The following is a sample output from the show memory heap command: >enable #show memory heap Memory Heap: HeapFree: 2935792 HeapSize: 8522736 Block Managers: Mgr 0 1 2 3 4 5 6 7 8 9 10 11 12 13 Size 0 16 48 112 240 496 1008 2032 4080 8176 16368 32752 65520 Used 58 1263 1225 432 140 72 76 25 2 31 8 5 3 Free 0 10 2 2 3 2 1 1 1 1 0 1 0 0 Max-Used 58 1273 1227 434 143 74 26 26 3 32 8 6 30 0
131056 0
61200500L1-35E
154
Default Values
No default value necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, and 1000R Series units.
Command History
Release 5.1 Command was introduced.
Usage Examples
The following is a sample from the show monitor session command: >enable #show monitor session 1 Monitor Session 1 ----------------Source Ports: RX Only: None TX Only: None Both: eth 0/2, eth 0/3 Destination Port: eth 0/6
61200500L1-35E
155
show output-startup
Use the show output-startup command to display startup configuration output line-by-line. This output can be copied into a text file and then used as a configuration editing tool. Syntax Description
No subcommands.
Default Values
No default value necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 3.1 Command was introduced.
Usage Examples
The following is a sample output from the show output-startup command: >enable #show output-startup ! #! #hostname "UNIT_2" UNIT_2#no enable password UNIT_2#! UNIT_2#ip subnet-zero UNIT_2#ip classless UNIT_2#ip routing UNIT_2#! UNIT_2#event-history on UNIT_2#no logging forwarding UNIT_2#logging forwarding priority-level info UNIT_2#no logging email etc....
61200500L1-35E
156
Default Values
No default value necessary for this command.
Applicable Platforms
This command applies to the NetVanta 1000 and 1000R Series units.
Command History
Release 10.1 Command was introduced.
Usage Examples
The following example displays the port authentication information: >enable #show port-auth Global Port-Authentication Parameters: re-authentication enabled: reauth-period: quiet-period: tx-period: supp-timeout: server-timeout: reauth-max: max-req: False 3600 60 30 30 30 2 2
61200500L1-35E
157
Command Reference Guide Port-Authentication Port Summary: Interface Status Type Mode Authorized --------------------------------------------------------------------------------------eth 0/1 disabled port-based n/a n/a eth 0/2 disabled port-based n/a n/a eth 0/3 disabled port-based n/a n/a eth 0/4 disabled port-based n/a n/a eth 0/5 disabled port-based n/a n/a eth 0/6 disabled port-based n/a n/a eth 0/7 disabled port-based n/a n/a eth 0/8 disabled port-based n/a n/a eth 0/9 disabled port-based n/a n/a eth 0/10 disabled port-based n/a n/a eth 0/11 disabled port-based n/a n/a eth 0/12 disabled port-based n/a n/a eth 0/13 disabled port-based n/a n/a eth 0/14 disabled port-based n/a n/a eth 0/15 disabled port-based n/a n/a eth 0/16 disabled port-based n/a n/a eth 0/17 disabled port-based n/a n/a eth 0/18 disabled port-based n/a n/a eth 0/19 disabled port-based n/a n/a eth 0/20 disabled port-based n/a n/a eth 0/21 disabled port-based n/a n/a eth 0/22 disabled port-based n/a n/a eth 0/23 disabled port-based n/a n/a eth 0/24 disabled port-based n/a n/a Port Authentication Port Details: Port-Authentication is disabled on eth 0/1 Port-Authentication is disabled on eth 0/2
61200500L1-35E
158
Default Values
No default value necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, and 1000R Series units.
Command History
Release 8.1 Command was introduced.
Usage Examples
The following displays all secure MAC addresses related to the Ethernet 0/1 interface: >enable #show port-security interface eth 0/1 address VLAN Mac Address Type of Entry Interface Remaining Time -------------------------------------------------------------------------------------------------------------1 00:a0:c8:0a:c6:4a Dynamic-Secure eth 0/1 -1 00:a0:c8:0a:c6:4b Dynamic-Secure eth 0/1 --------------------------------------------------------------------------------------------------------------Dynamic Address Count: 2 Static Address Count: 0 Sticky Address Count: 0 Total Address Count: 2
61200500L1-35E
159
Default Values
No default value necessary for this command.
Applicable Platforms
This command applies to the NetVanta 1000 and 1000R series units.
Command History
Release 9.1 Release 11.1 Command was introduced. The real time display option was added.
Functional Notes
Use the realtime argument for this command to display full-screen output in real time. Information is continuously updated on the console until you either freeze the data (by pressing the F key) or exit realtime mode (by pressing Ctrl-C). If there is not enough room on the screen for all available data, the information will truncate at the bottom of the screen. In order to maximize the amount of data displayed, increase the terminal length (using the terminal length command; refer to terminal length <text> on page 199).
Usage Examples
The following example displays power information for all PoE interfaces: >enable #show power inline Interface eth 0/1 Admin auto Oper off Power (watts) n/a Class n/a
61200500L1-35E
160
Command Reference Guide eth 0/2 eth 0/3 eth 0/4 eth 0/5 eth 0/6 eth 0/7 eth 0/8 eth 0/9 auto auto auto auto off off off auto off off on off n/a n/a n/a on n/a n/a 3.1 n/a n/a n/a n/a 2.4
Enable Mode Command Set n/a n/a Class 0 n/a n/a n/a n/a Class 1
61200500L1-35E
161
Default Values
No default value necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 3.1 Release 10.1 Command was introduced. New option was introduced.
Functional Notes
Use the realtime argument for this command to display full-screen output in real time. Information is continuously updated on the console until you either freeze the data (by pressing the F key) or exit realtime mode (by pressing Ctrl-C). If there is not enough room on the screen for all available data, the information will truncate at the bottom of the screen. In order to maximize the amount of data displayed, increase the terminal length (using the terminal length command; refer to terminal length <text> on page 199).
Usage Examples
The following is a sample output from the show processes cpu command: >enable #show processes cpu processes cpu System load: 7.07% Min: 0.00% Context switch load: 0.21%
Max 85.89%
61200500L1-35E
162
Command Reference Guide Task D 0 1 3 4 5 10 11 12 13 14 ....etc. Task Name Idle FrontPanel Stack Usage Q Test 1 Q Test 2 Clock PacketRouting Thread Pool IKE RouteTableTick Invoked PRI STAT 0W 249 W 11 W 10 W 11 W 20 W 250 W 50 W 10 W 50 W Exec (count) 129689 9658 485 50 50 1443 31656 161 2 49 Time (usec) 1971 165 305 4 6 24 10 159 341 874 Runtime (usec) 927923 3202 325 0 0 55 3871 0 0 874
Enable Mode Command Set Load % (1sec) 92.79 0.32 0.03 0.00 0.00 0.01 0.39 0.00 0.00 0.09
61200500L1-35E
163
interface <interface id> Displays the QoS settings on a specific interface (Ethernet, Gigabit Ethernet, or Port Channel). queuing Displays the type of queuing being used. If weighted round robin (WRR) queuing is enabled, the command also displays the weight of each queue.
Default Values
No defaults necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, and 1000R Series units.
Command History
Release 6.1 Release 7.1 Command was introduced. Command was expanded to include the dscp-cos option.
61200500L1-35E
164
Usage Examples
The following is sample output from the show qos cos-map command: >enable #show qos cos-map CoS Priority: 0 1 2 3 4 5 6 7 Priority Queue: 1 1 2 2 3 3 4 4 The following is sample output from the show qos interface command for Ethernet 0/8 interface: >enable #show qos interface ethernet 0/8 Ethernet 0/8 trust state: trusted default CoS: 0 The following is sample output from the show qos queuing command with WRR queuing enabled: >enable #show qos queuing Queue-type: wrr Expedite queue: disabled wrr weights: qid - weight 1 - 12 2 - 45 3 - 55 4 - 65
61200500L1-35E
165
Default Values
No default value necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 5.1 Command was introduced.
Usage Examples
The following is an example output using the show radius statistics command: >enable #show radius statistics Auth. 3 0 0 2 ms 3 ms Acct. 0 0 0 0 ms 0 ms
Number of packets sent: Number of invalid responses: Number of timeouts: Average delay: Maximum delay:
61200500L1-35E
166
show running-config
Use the show running-config command to display a text print of all the non-default parameters contained in the current running configuration file. Specific portions of the running-config may be displayed, based on the command entered. Variations of this command include the following:
show running-config show running-config access-lists show running-config access-lists verbose show running-config checksum show running-config interface <interface type> <interface id> show running-config interface <interface type> <interface id> verbose show running-config ip-crypto show running-config ip-crypto verbose show running-config policy-class show running-config policy-class verbose show running-config qos-map show running-config qos-map verbose show running-config router pim-sparse show running-config router pim-sparse verbose show running-config verbose
Syntax Description
access-lists checksum Displays the current running configuration for all configured IP access lists. Optional. Displays the encrypted Message Digest 5 (MD5) version of the running configuration.
interface <interface type> Displays the current running configuration for a particular interface. Type show running-config interface ? for a list of valid interfaces. <interface id> ip crypto policy-class qos-map router pim-sparse verbose Specifies any valid slot/port interface (e.g., 0/1). Displays the current running configuration for all IPSec VPN settings. Displays the current running configuration for all configured policy classes. Displays the current running configuration for all configured QoS maps. Optional: Displays the current global PIM-SM configuration. Optional. Displays the entire running configuration to the terminal screen (versus only the non-default values).
Default Values
No default value necessary for this command.
61200500L1-35E
167
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 1.1 Release 9.1 Release 11.1 Command was introduced. Command was expanded to include HDLC and tunnel interfaces. Demand, FXO, and serial interfaces were added. IP crypto and router pim-sparse key words were added.
Usage Examples
The following is a sample output from the show running-config command: >enable #show running-config Building configuration... ! no enable password ! ip subnet-zero ip classless ip routing ! event-history on no logging forwarding logging forwarding priority-level info no logging email ! ip policy-timeout tcp all-ports 600 ip policy-timeout udp all-ports 60 ip policy-timeout icmp 60 ! interface eth 0/1........
61200500L1-35E
168
show snmp
Use the show snmp command to display the system Simple Network Management Protocol (SNMP) parameters and current status of SNMP communications. Syntax Description
No subcommands.
Default Values
No default value necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 1.1 Command was introduced.
Usage Examples
The following is an example output using the show snmp command for a system with SNMP disabled and the default Chassis and Contact parameters: >enable #show snmp Chassis: Chassis ID Contact: Customer Service 0 Rx SNMP packets 0 Bad community names 0 Bad community uses 0 Bad versions 0 Silent drops 0 Proxy drops 0 ASN parse errors
61200500L1-35E
169
show sntp
Use the show sntp command to display the system Simple Network Time Protocol (SNTP) parameters and current status of SNTP communications. Syntax Description
No subcommands.
Default Values
No default value necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 3.1 Command was introduced.
Usage Examples
>enable #show sntp
61200500L1-35E
170
Default Values
No default value necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 5.1 Command was introduced.
Usage Examples
The following is an example output using the show spanning-tree command: >enable #show spanning-tree Spanning Tree enabled protocol ieee Root ID Priority 32768 00:a0:c8:00:88:41 Address
We are the root of the spanning tree Hello Time 2 sec Max Age 20 sec Forward Delay 15 sec Bridge ID Priority Address 32768 00:a0:c8:00:88:41
Hello Time 2 sec Max Age 20 sec Forward Delay 15 sec Aging Time 300 Interface ------------------eth 0/2 eth 0/3 eth 0/4 giga-eth 0/1 giga-eth 0/2 Role ------------------Desg Desg Desg Desg Desg Sts ------------------FWD FWD FWD FWD FWD Cost ----------19 19 19 4 4 Prio.Nbr ------------128.2 128.3 128.4 128.25 128.26 Type --------------P2p P2p P2p P2p P2p
61200500L1-35E
171
Default Values
No default value necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, and 1000R Series units.
Command History
Release 5.1 Command was introduced.
Usage Examples
The following is an example output using the show spanning-tree active command: >enable #show spanning-tree active Spanning Tree enabled protocol ieee Root ID Priority 32768 00:a0:c8:00:88:41 Address
We are the root of the spanning tree Hello Time 2 sec Max Age 20 sec Forward Delay 15 sec Bridge ID Priority Address 32768 00:a0:c8:00:88:41
Hello Time 2 sec Max Age 20 sec Forward Delay 15 sec Aging Time 300 eth 0/9 eth 0/24 Interface ------------------eth 0/2 eth 0/3 eth 0/9 Desg FWD 19 Desg FWD 19 Role ------------------Desg Desg Desg 128.9 P2p 128.24 P2p Sts FWD FWD FWD Cost 19 19 19 Prio.Nbr ------------128.2 128.3 128.9 Type --------------P2p P2p P2p
------------------ -----------
61200500L1-35E
172
Default Values
No default value necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, and 1000R Series units.
Command History
Release 5.1 Command was introduced.
Usage Examples
The following is an example output using the show spanning-tree blockedports command: >enable #show spanning-tree blockedports Blocked Interfaces List -----------------------------------eth 0/3 giga-eth 0/2 p-chan 1 Number of blocked ports (segments) in the system: 3
61200500L1-35E
173
Default Values
No default value necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, and 1000R Series units.
Command History
Release 5.1 Command was introduced.
Usage Examples
The following is an example output using the show spanning-tree detail command: > enable # show spanning-tree detail Executing the ieee compatible Spanning Tree protocol Bridge Identifier has priority 32768, address 00:a0:c8:00:88:41 Configured hello time 2, max age 20, forward delay 15 We are the root of the spanning tree Number of topology changes 8 last change occurred 00:21:00 ago from eth 0/24 Times: hold 3, topology change 0, notification 0 hello 2, max age 20, forward delay 15 Timers: hello 1, topology change 0, notification 0, aging 300 Port 4 (eth 0/4) is learning Port path cost 19, Port priority 128, Port Identifier 128.4. Designated root has priority 32768, address 00:a0:c8:00:88:41 Designated bridge has priority 32768, address 00:a0:c8:00:88:41 Designated port id is 128.4, designated path cost 0 Timers: message age 0, forward delay 15, hold 3 Number of transitions to forwarding state: 1 BPDU: sent 46, received 0
61200500L1-35E
174
show spanning-tree interface ethernet <interface id> [active | active detail | cost | detail | detail active | edgeport | priority | rootcost | state]
Use the show spanning-tree interface ethernet command to display spanning-tree protocol information for a particular Ethernet interface. Syntax Description
<slot/port> active active detail cost detail detail active edgeport priority rootcost state Specifies the slot and port number of the interface. Optional. Displays information for an active interface. Optional. Displays detailed spanning-tree protocol information for an active interface. Optional. Displays only spanning-tree protocol path cost information. Optional. Displays detailed spanning-tree protocol information. Optional. Displays detailed spanning-tree protocol information for an active interface. Optional. Displays information for all interfaces configured as edgeports. Optional. Displays only spanning-tree protocol priority information. Optional. Displays only spanning-tree protocol root path cost information. Optional. Displays only spanning-tree protocol state information.
Default Values
No default value necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, and 1000R Series units.
Command History
Release 5.1 Command was introduced.
Usage Examples
The following is an example output using the show spanning-tree interface ethernet command: >enable #show spanning-tree interface ethernet 0/2 Interface Role Sts ------------------- ------------------- -----------------eth 0/2 Desg LIS Cost ----------19 Prio.Nbr ------------128.2 Type --------------P2p
61200500L1-35E
175
show spanning-tree interface gigabit-ethernet <interface id> [active | active detail | cost | detail | detail active | priority | rootcost | state]
Use the show spanning-tree interface gigabit-ethernet command to display spanning-tree protocol information for a particular Gigabit Ethernet interface. Syntax Description
<slot/port> active active detail cost detail detail active priority rootcost state Specify the slot and port number of the interface. Optional. Displays information for an active interface. Optional. Displays detailed spanning-tree protocol information for an active interface. Optional. Displays only spanning-tree protocol path cost information. Optional. Displays detailed spanning-tree protocol information. Optional. Displays detailed spanning-tree protocol information. Optional. Displays only spanning-tree protocol priority information. Optional. Displays only spanning-tree protocol root path cost information. Optional. Displays only spanning-tree protocol state information.
Default Values
No default value necessary for this command.
Applicable Platforms
This command applies to the NetVanta 1000 and 1000R Series units.
Command History
Release 5.1 Command was introduced.
Usage Examples
The following is an example output using the show spanning-tree interface gigabit-ethernet command: >enable #show spanning-tree interface gig 0/2 Interface Role Sts ------------------- ------------------- -----------------gig-eth 0/2 Desg FWD Cost ----------19 Prio.Nbr ------------128.27 Type --------------P2p
61200500L1-35E
176
show spanning-tree interface port-channel <interface id> [active | active detail | cost | detail | detail active | edgeport | priority | rootcost | state]
Use the show spanning-tree interface port-channel command to display spanning-tree protocol information for a particular port channel interface. Syntax Description
<slot/port> active active detail cost detail detail active edgeport priority rootcost state Specifies the slot and port number of the interface. Optional. Displays information for an active interface. Optional. Displays detailed spanning-tree protocol information for an active interface. Optional. Displays only spanning-tree protocol path cost information. Optional. Displays detailed spanning-tree protocol information. Optional. Displays detailed spanning-tree protocol information for an active interface. Optional. Displays information for all interfaces configured as edgeports. Optional. Displays only spanning-tree protocol priority information. Optional. Displays only spanning-tree protocol root path cost information. Optional. Displays only spanning-tree protocol state information.
Default Values
No default value necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, and 1000R Series units.
Command History
Release 5.1 Command was introduced.
Usage Examples
The following is an example output using the show spanning-tree interface port-channel command: >enable #show spanning-tree interface port-channel 1 Interface Role Sts ------------------- ------------------- -----------------p-chan 1 Desg FWD Cost ----------19 Prio.Nbr ------------128.27 Type --------------P2p
61200500L1-35E
177
Default Values
No default value necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, and 1000R Series units.
Command History
Release 5.1 Command was introduced.
Usage Examples
The following is sample output using the show spanning-tree pathcost method command. In this case 32-bit values are being used when calculating path costs: >enable #show spanning-tree pathcost method Spanning tree default pathcost method used is long
61200500L1-35E
178
Default Values
No default value necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, and 1000R Series units.
Command History
Release 5.1 Release 10.1 Command was introduced. The real time display option was introduced.
Functional Notes
Use the realtime argument for this command to display full-screen output in real time. Information is continuously updated on the console until you either freeze the data (by pressing the F key) or exit realtime mode (by pressing Ctrl-C). If there is not enough room on the screen for all available data, the information will truncate at the bottom of the screen. In order to maximize the amount of data displayed, increase the terminal length (using the terminal length command; refer to terminal length <text> on page 199).
61200500L1-35E
179
Usage Examples
The following is sample output using the show spanning-tree realtime command. >enable #show spanning-tree realtime ------------------------------------------------------------------------------------------------STP 0 Vlan 1 Spanning Tree enabled protocol ieee 802.1w (Rapid Spanning-Tree) Root ID Priority 8894 Address 00:a0:c8:00:f5:52 Cost 46 Port 1 (giga-eth 0/1) Hello Time 2 sec Max Age 20 sec Forward Delay 15 sec Bridge ID Priority 32768 Address 00:a0:c8:02:f6:6b Aging Time 300
Interface Role Sts Cost Prio.Nbr Type ---------------- ---- --- --------- -------- -------------------------------------------------------giga-eth 0/1 Root FWD 19 128.1 P2p giga-eth 0/5 Altn BLK 19 128.5 P2p ----------------------------------------------------------------------------------------------------Exit - 'Ctrl-C', Freeze - 'f', Resume - 'r'
61200500L1-35E
180
show spanning-tree root [address | cost | detail | forward-time | hello-time | id | max-age | port | priority | priority system-id]
Use the show spanning-tree root command to display information regarding the spanning-tree protocol root. Syntax Description
address cost detail forward-time hello-time id max-age port priority priority system-id Optional. Displays the address of the spanning-tree root. Optional. Displays the path cost of the spanning-tree root. Optional. Displays the spanning-tree root information in detail. Optional. Displays the forward-time of the spanning-tree root. Optional. Displays the hello-time of the spanning-tree root. Optional. Displays the ID of the spanning-tree root. Optional. Displays the maximum age of the spanning-tree root. Optional. Displays the port of the spanning-tree root. Optional. Displays the priority of the spanning-tree root. Optional. Displays the priority and system-id of the spanning-tree root.
Default Values
No default value necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, and 1000R Series units.
Command History
Release 5.1 Command was introduced.
Usage Examples
The following is an example output using the show spanning-tree root command: >enable #show spanning-tree root Root ID -------------------8191 00:a0:c8:b9:bb:82 Root Cost -------------108 Hello Time ------------2 Max Age -----------20 Fwd Dly -------------15 Root Port ---------------eth 0/1
61200500L1-35E
181
Default Values
No default value necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, and 1000R Series units.
Command History
Release 5.1 Command was introduced.
Usage Examples
The following is an example output using the show spanning-tree summary command: >enable #show spanning-tree summary Spanning tree default pathcost method is short Blocking Listening Learning ---------------------------------------0 0 0
Forwarding --------------12
61200500L1-35E
182
Default Values
No default value necessary for this command.
Applicable Platforms
This command applies to the NetVanta 1000 and 1000R Series units.
Command History
Release 8.1 Release 10.1 Command was introduced. The real time display option was introduced.
Functional Notes
The stack candidates are a list of units that could be added to the stack. They are not yet members. Use the realtime argument for this command to display full-screen output in real time. Information is continuously updated on the console until you either freeze the data (by pressing the F key) or exit realtime mode (by pressing Ctrl-C). If there is not enough room on the screen for all available data, the information will truncate at the bottom of the screen. In order to maximize the amount of data displayed, increase the terminal length (using the terminal length command; refer to terminal length <text> on page 199).
61200500L1-35E
183
Usage Examples
The following example displays the configuration of the switch stack while in stack-master mode: >enable #show stack Stack mode is MASTER Management Vlan is 2386, firmware version is 08.00.18.D Stack network is 169.254.0.0/24 Stack members... Member 2 3 # Member MAC address Mgmt IP Address Source Interface State stack member's Unit ID stack member's MAC address stack member's IP address interface that the stack member was learned from Up (member is up and functioning properly); Down (member was at one time functioning, but we have lost contact with it); Waiting (we are waiting for the unit to register with us; when he does, we will add it to the stack); Denied (the unit could not be added to the stack because the stack protocol versions were not compatible). Mac Address 00:A0:C8:02:CF:C0 00:A0:C8:00:8C:20 Mgmt IP Address 169.254.0.2 169.254.0.3 Source Interface Stack port Stack port State Up Up
The following example displays the configuration of the switch stack while in stack-member mode: >enable #show stack Stack mode is STACK-MEMBER My Unit ID is 3, management Vlan is 2386 Stack management network is 169.254.0.0/24 Stack Master info: Master is "Switch", learned via giga-eth 0/1 IP address is 169.254.0.1, MAC address is 00:DE:AD:00:65:83 # The following example displays all units that have registered with this stack-master.
61200500L1-35E
184
Command Reference Guide >enable #show stack candidates Displaying all known Stack candidates... MAC Address 00:A0:C8:00:8C:20 00:A0:C8:00:F5:6C 00:A0:C8:02:CF:C0 # System Name LabSwitch1 LabSwitch2 LabSwitch3 Source Interface stack port stack port stack port
61200500L1-35E
185
show startup-config
Use the show startup-config command to display a text printout of the startup configuration file stored in NVRAM. Syntax Description
No subcommands.
Default Values
No default value necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 1.1 Command was introduced.
Usage Examples
The following is a sample output of the show startup-config command: >enable #show startup-config ! ! no enable password ! ip subnet-zero ip classless ip routing ! event-history on no logging forwarding logging forwarding priority-level info no logging email ! ip policy-timeout tcp all-ports 600 ip policy-timeout udp all-ports 60 ip policy-timeout icmp 60 !
61200500L1-35E
186
Command Reference Guide ! ! interface eth 0/1 speed auto no ip address shutdown ! interface dds 1/1 shutdown ! interface bri 1/2 shutdown ! ! ip access-list standard MatchAll permit host 10.3.50.6 permit 10.200.5.0 0.0.0.255 ! ! ip access-list extended UnTrusted deny icmp 10.5.60.0 0.0.0.255 any source-quench deny tcp any any ! no ip snmp agent ! ! !
61200500L1-35E
187
Default Values
No default value necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 8.1 Command was introduced.
Functional Notes
This command is used in conjunction with the show running-config checksum command to determine whether the configuration has changed since the last time it was saved.
Usage Examples
The following example displays the MD5 checksum of the units startup configuration: >enable #show startup-config checksum 10404D5DAB3FE35E307B6A79AC6AC8C0 # #show running-config checksum 10404D5DAB3FE35E307B6A79AC6AC8C0 #
61200500L1-35E
188
Default Values
No default value necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 11.1 Command was introduced.
Usage Examples
>enable #show tacacs+ statistics Authentication 0 0 0 0ms 0ms 0 0 0 0 0 0 0 0 Authorization 0 0 0 0ms 0ms Accounting 0 0 0 0ms 0ms
Socket Opens: Socket Closes: Socket Aborts: Socket Errors: Socket Timeouts: Socket Failed Connections: Socket Packets Sent: Socket Packets Received:
61200500L1-35E
189
Default Values
No default value necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 4.1 Release 10.1 Command was introduced. The real time display option was introduced.
Function Notes
Use the realtime argument for this command to display full-screen output in real time. Information is continuously updated on the console until you either freeze the data (by pressing the F key) or exit realtime mode (by pressing Ctrl-C). If there is not enough room on the screen for all available data, the information will truncate at the bottom of the screen. In order to maximize the amount of data displayed, increase the terminal length (using the terminal length command; refer to terminal length <text> on page 199).
Usage Examples
The following is a sample from the show tcp info command: >enable #show tcp info TCP TCB Entries
61200500L1-35E
190
Usage Examples
ID 0 1 2 3 4 5 . . 31 STATE LSTATE OSTATE FREE FREE FREE FREE LISTEN FREE FREE LISTEN FREE FREE LISTEN FREE FREE LISTEN FREE FREE FREE FREE TYPE SRVR CONN CONN CONN CONN SRVR FLAGS RPORT LPORT SWIN 0 0 0 0 0 21 0 0 0 80 0 0 0 23 0 0 0 5761 0 0 0 0 0 0 SRT 0 0 0 0 0 0 INTERFACE NONE NONE NONE NONE NONE NONE
FREE
FREE
FREE
SRVR
NONE
61200500L1-35E
191
Syntax Description
realtime Displays full-screen output in real time. See the Functional Notes below for more information.
Default Values
No default value necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 5.1 Release 10.1 Command was introduced. The real time display option was introduced.
Functional Notes
Use the realtime argument for this command to display full-screen output in real time. Information is continuously updated on the console until you either freeze the data (by pressing the F key) or exit realtime mode (by pressing Ctrl-C). If there is not enough room on the screen for all available data, the information will truncate at the bottom of the screen. In order to maximize the amount of data displayed, increase the terminal length (using the terminal length command; refer to terminal length <text> on page 199).
61200500L1-35E
192
Usage Examples
The following is a sample of show users output: >enable #show users - CONSOLE 0 'adtran' logged in and enabled Idle for 00:00:00 - TELNET 0 (172.22.12.60:3998) 'password-only' logged in (not enabled) Idle for 00:00:14 - FTP (172.22.12.60:3999) 'adtran' logged in (not enabled) Idle for 00:00:03
61200500L1-35E
193
show version
Use the show version command to display the current ADTRAN operating system (AOS) version information. Syntax Description
No subcommands.
Default Values
No default value necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 1.1 Command was introduced.
Usage Examples
The following is a sample show version output: >enable #show version AOS version: 02.01.00 Checksum: 1505165C Built on: Fri Aug 23 10:23:13 2002 Upgrade key: 420987gacs9097gbdsado BootROM version: 02.01.00 Checksum: DB85 Built on: Mon Aug 19 10:33:03 2002 Copyright 1999-2002 ADTRAN Inc. Serial number b104 Router uptime is 0 days 3 hours 9 minutes 54 seconds System returned to ROM by External Hard Reset System image file is "020100.biz"
61200500L1-35E
194
show vlan [brief | brief realtime | id <vlan id> | name <vlan name> | realtime]
Use the show vlan command to display current virtual local area network (VLAN) information. Syntax Description
brief brief realtime id <vlan id> name <vlan name> realtime Optional. Shows an abbreviated version of the VLAN information (brief description). Displays full-screen output in real time. See the Functional Notes below for more information. Optional. Shows information regarding a specific VLAN, specified by a VLAN interface ID (valid range: 1 to 4094). Optional. Shows information regarding a specific VLAN, specified by a VLAN interface name (up to 32 characters). Displays full-screen output in real time. See the Functional Notes below for more information.
Default Values
No default value necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, and 2000 Series units.
Command History
Release 5.1 Release 10.1 Command was introduced. The real time display option was introduced.
Function Notes
Use the realtime argument for this command to display full-screen output in real time. Information is continuously updated on the console until you either freeze the data (by pressing the F key) or exit realtime mode (by pressing Ctrl-C). If there is not enough room on the screen for all available data, the information will truncate at the bottom of the screen. In order to maximize the amount of data displayed, increase the terminal length (using the terminal length command; refer to terminal length <text> on page 199).
61200500L1-35E
195
Usage Examples
The following is a sample show vlan output: >enable #show vlan VLAN Name Status -------------active Ports ----------eth 0/5, eth 0/6, eth 0/8, eth 0/13, eth 0/14, eth 0/15, eth 0/16, eth 0/17, eth 0/18, eth 0/19, eth 0/20, eth 0/21, eth 0/22, eth 0/23, eth 0/24, giga-eth 0/1, giga-eth 0/2
2 3 VLAN
eth 0/1, eth 0/2 eth 0/3, eth 0/4, eth 0/7, eth 0/9, eth 0/10, eth 0/11, eth 0/12
The following is an example of the show vlan name command that displays VLAN 2 (accounting VLAN) information: >enable #show vlan name accounting VLAN Name Status ------------active MTU ------------1500 Ports ---------------eth 0/1, eth 0/2
61200500L1-35E
196
telnet <address>
Use the telnet command to open a Telnet session (through the AOS) to another system on the network. Syntax Description
<address> Specifies the IP address of the remote system.
Default Values
No default value necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 1.1 Command was introduced.
Usage Examples
The following example opens a Telnet session with a remote system (10.200.4.15): >enable #telnet 10.200.4.15 User Access Login: Password:
61200500L1-35E
197
Default Values
No default value necessary for this command.
Applicable Platforms
This command applies to the NetVanta 1000 and 1000R Series units.
Command History
Release 8.1 Command was introduced.
Functional Notes
This command is only available when in stack-master mode.
Usage Examples
The following example Telnets to a member of the stack: >enable #telnet stack-member 3 Trying Stack Member 3...Press Ctrl+C to abort
61200500L1-35E
198
Default Values
The default setting for this command is 24 rows.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 6.1 Command was introduced.
Usage Examples
The following example sets the number of rows to 30. >enable #terminal length 30
61200500L1-35E
199
Default Values
No default value necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 1.1 Command was introduced.
Usage Examples
The following is a sample traceroute output: >enable #traceroute 192.168.0.1 Type CTRL+C to abort. Tracing route to 192.168.0.1 over a maximum of 30 hops 1 2 # The following example specifies the source of the trace. The ip address 10.10.10.10 is the destination address: >enable #traceroute 10.10.10.10 source 192.168.0.3 22ms 20ms 20ms 23ms 20ms 20ms 192.168.0.65 192.168.0.1
61200500L1-35E
200
undebug all
Use the undebug all command to disable all activated debug messages. Syntax Description
No subcommands.
Default Values
No default value necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 2.1 Command was introduced.
Usage Examples
The following example disabled all activated debug messages: >enable #undebug all
61200500L1-35E
201
vlan database
Use the vlan database command to enter the VLAN Database Configuration mode. Refer to the section VLAN Database Configuration Command Set on page 460 for more information. Syntax Description
No subcommands.
Default Values
No defaults necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, and 1000R Series units.
Command History
Release 5.1 Command was introduced.
Usage Examples
The following example enters the VLAN Configuration mode: >enable #vlan database
61200500L1-35E
202
wall <message>
Use the wall command to send messages to all users currently logged in to the AOS unit. Syntax Description
No subcommands.
Default Values
No defaults necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 6.1 Command was introduced.
Usage Examples
The following example sends the message Reboot in 5 minutes if no objections to the CLI screen of everyone currently connected: >enable #wall Reboot in 5 minutes if no objections
61200500L1-35E
203
Default Values
No default value necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 3.1 Command was introduced.
Usage Examples
The following example saves the current configuration to the units NVRAM: >enable #write memory
61200500L1-35E
204
The following commands are common to multiple command sets and are covered in a centralized section of this guide. For more information, refer to the sections listed below: cross-connect <#> <from interface> <slot/port> <tdm-group#> <to interface> <slot/port> on page 26 description <text> on page 29 do on page 30 end on page 31 exit on page 32 shutdown on page 33 All other commands for this command set are described in this section in alphabetical order. aaa accounting commands begin on page 208 aaa authentication commands begin on page 211 aaa authorization commands begin on page 217 aaa group server [radius | tacacs+] <listname> on page 219 aaa on on page 221 aaa processes <threads> on page 223 arp <ip address> <mac address> arpa on page 224 auto-config [filename <name> | restart | retry-count <number>| server <name or address>] on page 225 banner [exec | login | motd] <character> <message> <character> on page 227 boot system flash <filename> [no-backup | <backup filename>] on page 228 clock [auto-correct-dst | no-auto-correct-dst] on page 230 clock set <time> <day> <month> <year> on page 231 clock timezone <text> on page 232 cross-connect <#> <from interface> <slot/port> <tdm-group#> <to interface> <slot/port> on page 235 enable password [md5] <password> on page 238 event-history on on page 240
61200500L1-35E
205
event-history priority [error | fatal | info | notice | warning] on page 241 exception report [filename <filename>] on page 243 ftp authentication <listname> on page 244 garp timer [join | leave | leaveall] <timer value> on page 245 gvrp on page 246 hostname <name> on page 247 interface <interface> [<slot/port> | <interface id>] [point-to-point] on page 248 interface range <interface type> <slot/port> - <slot/port> on page 249 ip access-list commands begin on page 250 ip default-gateway <ip address> on page 260 ip dhcp-server commands begin on page 261 ip domain commands begin on page 266 ip ftp commands begin on page 269 ip host <name> <address1> on page 272 ip http [access-class <listname> in | authentication <listname> | secure-access-class <listname> in | secure-server | server | session-limit | session-timeout] on page 273 ip name-server <server-address1-6> on page 274 ip radius source-interface <interface> on page 275 ip scp server on page 276 ip snmp agent on page 277 ip sntp source-interface <interface> on page 278 ip [ssh-server <port> | telnet-server <port>] on page 279 ip tftp source-interface <interface> on page 280 line [console | telnet | ssh] <line-number> <ending number> on page 281 lldp [minimum-transmit-interval l reinitialization-delay l transmit-interval l ttl-multiplier] <numeric value> on page 283 logging commands begin on page 285 mac address-table aging-time <aging time> on page 299 mac address-table static <mac address> vlan <vlan id> interface <interface> on page 300 monitor session <session number> [destination interface <interface id> | source interface <interface id> | no tag] [both | rx | tx] on page 301 port-auth commands begin on page 302 port-channel load-balance [dst-mac | src-mac] on page 306 qos commands begin on page 307 radius-server on page 311 radius-server host on page 313 service password-encryption on page 314 snmp-server commands begin on page 315 sntp retry-timeout <time> on page 327
61200500L1-35E
206
sntp server <address or hostname> version <1-3> on page 328 sntp wait-time <time> on page 329 spanning tree commands begin on page 330 stack [master | member | vlan] <master> <member> <vlan> on page 339 tacacs-server on page 341 username <username> password <password> on page 342 vlan <vlan id> on page 343
61200500L1-35E
207
aaa accounting commands <level> [<listname> | default] [none | stop-only] [group <groupname> | group tacacs+]
Use aaa accounting commands to set parameters for AAA accounting. For more detailed information on AAA functionality, refer to the Technology Review section of the command aaa on on page 221. Syntax Description
<level> <listname> default none stop-only group <groupname> group tacacs+ Specifies the commands enable level. (1=unprivileged, 15 = privileged). Specifies the name of the list. Uses the default accounting list. Disables accounting. Records stop-only when service terminates. Uses the specified group of remote servers for accounting. Uses the TACACS+ server for accounting.
Default Values
By default, accounting is not enabled.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 11.1 Command was introduced.
Usage Examples
The following example creates a list called myList and sets accounting for Level 1 commands at stop-only activities: (config)#aaa accounting commands 1 myList stop-only group tacacs+
To complete this command, Telnet must be applied to the lines. See Line (Telnet) Interface Config Command Set on page 365 for more detailed instructions.
61200500L1-35E
208
Default Values
By default, this command is disabled, which means the accounting records for null usernames are sent to the server.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 11.1 Command was introduced.
Usage Examples
The following command causes the unit to refrain from sending accounting records for users with null usernames: (config)#aaa accounting suppress null-username
61200500L1-35E
209
Default Values
By default, accounting records are sent every 5 minutes.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 11.1 Command was introduced.
Usage Examples
The following command sets the unit to send accounting records every 600 minutes to the server: (config)#aaa accounting update periodic 600
61200500L1-35E
210
Default Values
banner fail-message password-prompt username-prompt User Access Verification Authentication Failed Password: Username:
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 5.1 Command was introduced.
Usage Examples
The following is a typical example of customizing the AAA authentication process: (config)# aaa authentication banner # Enter TEXT message. End with the character '#'. User login authentication:# (config)# (config)#aaa authentication fail-message #
61200500L1-35E
211
Command Reference Guide Enter TEXT message. End with the character '#'. Authentication denied.# (config)#
(config)#aaa authentication username-prompt Enter Username: (config)#aaa authentication password-prompt Enter Password:
61200500L1-35E
212
aaa authentication enable default [none | line | enable | group <groupname> | group radius | group tacacs+]
Use the aaa authentication enable default command to create (or change) the list of fallback methods used for privileged mode access authentication. For more detailed information on AAA functionality, refer to the Technology Review section of the command aaa on on page 221. Syntax Description
none line enable group <groupname> group radius group tacacs+ Access automatically granted. Uses the line password for authentication. Uses the enable password for authentication. Uses the specified group of remote servers for authentication. Uses all defined RADIUS servers for authentication. Uses all defined TACACS+ servers for authentication.
Default Values
If there is no default methods list configured, the default behavior is to use the enable password for the unit. If there is no password configured, consoles are allowed access (this prevents a lock-out).
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 5.1 Release 11. Command was introduced. The group tacacs+ command was added.
Functional Notes
A user is authenticated by trying the list of methods from first to last until a method succeeds or fails. If a method is unable to complete, the next method is tried. The group falls through if the servers in the remote group cannot be found. Note that enable access is a password-only process. The local-user database cannot be used, and the username given to any remote RADIUS server is $enab15$. The only list name allowed is default.
Usage Examples
The following example specifies using the line password as the first method for enable authentication and using the enable password as the second: (config)#aaa authentication enable default line enable
61200500L1-35E
213
aaa authentication login [<listname> | default] [none | line | enable | local | group <groupname> | group radius | group tacacs+]
Use the aaa authentication login command to create (or change) a named list with the ability to have a chain of fallback authentication methods for user authentication. Available methods for the fallback authentication methods are: no authentication (which grants login access without authentication), line password, enable password, local database, and defined group of servers. The defined server groups may be TACACS+ or RADIUS servers. For more detailed information on AAA functionality, refer to the Technology Review section of the command aaa on on page 221. Syntax Description
<listname> default none line enable local group <groupname> group radius group tacacs+ Specifies a named login list. Specifies the default list used to authenticate users when no other list is assigned. Access automatically granted. Uses line password (Telnet 0-4 or console 0-1) for authentication. Uses enable password for authentication. Uses local user database for authentication. Uses specified group of remote servers for authentication. Uses defined RADIUS servers for authentication. Uses defined TACACS+ servers for authentication.
Default Values
The login list named default is the default list used to authenticate users when no other list is assigned.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 5.1 Release 11. Command was introduced. The group tacacs+ command was added.
Functional Notes
A user is authenticated by trying the list of methods from first to last until authentication succeeds or fails. If a method does not succeed or fail, the next method is tried. The local user database method falls through to the next method if the username does not appear in the database. The group method falls through if the servers in the remote group cannot be found. Refer to the command radius-server on page 311 or tacacs-server on page 341 for information on defining server groups.
61200500L1-35E
214
Usage Examples
The following example creates a named list called myList and specifies using the local database as the first method, myGroup as the second method, and line password as the third method for login authentication: (config)#aaa authentication login myList local group myGroup line The following command sets the default authentication list for logins to use the local database as the first fallback method: (config)#aaa authentication login default local
61200500L1-35E
215
aaa authentication port-auth default [group <groupname> | group radius | local | none]
Use the aaa authentication port-auth default command to create a default list for port authentication. For more detailed information on AAA functionality, refer to the Technology Review section of the command aaa on on page 221. Syntax Description
group <groupname> group radius local none Specifies a group of remote servers to use for authentication. Specifies using all defined RADIUS servers for authentication. Specifies using the local user database for authentication. Automatically grants access.
Default Values
The login list named default is the default list used to authenticate users when no other list is assigned to the line.
Applicable Platforms
This command applies to the NetVanta 1000 and 1000R Series units.
Command History
Release 10.1 Command was introduced.
Usage Examples
The following example specifies that the local user database be used for port authentication: (config)#aaa authentication port-auth default local
61200500L1-35E
216
aaa authorization commands <level> [<listname> | default] [group <groupname> | group tacacs+ | if-authenticated | none]
Use aaa authorization commands to create (or change) a list of methods for user authorization. For more detailed information on AAA functionality, refer to the Technology Review section of the command aaa on on page 221. Syntax Description
<level> <listname> default group <groupname> group tacacs+ if-authenticated none Specifies the commands enable level. (1=unprivileged, 15 = privileged). Specifies the name of the authorization list. Specifies the default authorization list and applies it implicitly across all lines. Uses the specified group of remote servers for authorization. Uses all defined TACACS+ servers for authorization. Succeeds if user has authenticated. Access automatically granted.
Default Values
The authorization list named default is the default list used to authorize commands when no other list is assigned to the line.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 11.1 Command was introduced.
Usage Examples
The following command creates a list called myList to authorize unprivileged commands (which succeeds only if the user has been authenticated successfully): (config)#aaa authorization commands 1 myList if-authenticated The following command uses the default list to authorize privileged (level 15) commands against the defined TACACS+ servers: (config)#aaa authorization commands 15 default group tacacs+
61200500L1-35E
217
Default Values
By default, authorization for console is disabled. However, configuration mode commands are authorized by default.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 11.1 Command was introduced.
Usage Examples
The following example enables authorization of configuration mode commands: (config)#aaa authorization config-command The following example enables authorization of console commands: (config)#aaa authorization console
61200500L1-35E
218
Default Values
No default value necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 5.1 Release 11.1 Command was introduced. TACACS+ server support was added.
Functional Notes
Use the radius-server command to specify RADIUS servers before adding them to a group. Likewise, use the tacacs-server command to specify TACACS+ servers before adding them to a group. These commands enter a mode for adding individual servers to the named group. Refer to Radius Group Command Set on page 499 or TACACS+ Group Configuration Command Set on page 501 for more information. The default group cannot be changed and includes all RADIUS servers in the order they were specified by the radius-server commands. The same is true of TACACS+ servers specified by the tacacs-server commands.
61200500L1-35E
219
Usage Examples
The following example creates the named list myServers and enters the RADIUS group: (config)#aaa group server radius myServers (config-sg-radius)# The following example creates the named list myServers and enters the TACACS+ group: (config)#aaa group server tacacs myServers (config-sg-tacacs+)#
61200500L1-35E
220
aaa on
Use the aaa on command to activate the AAA subsystem. Use the no form of this command to deactivate AAA. Syntax Description
No subcommands.
Default Values
By default, AAA is not activated.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 5.1 Command was introduced.
Functional Notes
By default, the AAA subsystem is turned off and authentication follows the line technique (local, line, etc.). Once activated, the AAA lists override the methods specified in the line command.
Usage Examples
The following example activates the AAA subsystem: (config)#aaa on
Technology Review
AAA stands for authentication, authorization, and accounting. The AOS AAA subsystem currently supports authentication. Authentication is the means by which a user is granted access to the device (router). For instance, a username/password is authenticated before the user can use the CLI. VPN clients can also verify username/password before getting access through the device. There are several methods that can be used to authenticate a user: NONE Instant access LINE-PASSWORD Use the line password (telnet 0-4 or console 0-1) ENABLE-PASSWORD Use the enable password LOCAL-USERS Use the local-user database GROUP <groupname> Use a group of remote RADIUS servers
61200500L1-35E
221
The AAA system allows users to create a named list of these methods to attempt in order (if one fails, it falls to the next one on the list). This named list is then attached to a portal (telnet 0-4 or console 0-1). When a user Telnets in or accesses the terminal, the AAA system uses the methods from the named list to authenticate the user. The AAA system must be turned on to be active. By default it is off. Use the aaa on command to activate the AAA system. If a portal is not explicitly assigned a named list, the name default is automatically assigned to it. Users can customize the default list just like any other list. If no default list is configured, the following default behavior applies (defaults are based on portal): Instant access (NONE) is assigned to the console using the default list (when the list has not been configured). The local-user database is used for Telnet sessions using the default list (when the list has not been configured). No access is granted for FTP access using the default list (when the list has not been configured). Methods fail (and therefore cause the system to proceed to the next configured method) under the following circumstances: LINE and ENABLE passwords fall through if there are no LINE or ENABLE passwords configured. LOCAL-USERS fall through if the given user is not in the database. RADIUS server groups fall through if the given server(s) cannot be contacted on the network.
Example For a default list defined with the order [LINE, ENABLE, LOCAL, and GROUP mygroup], the following statements are true: If there is no LINE password, the list falls through to the ENABLE password. If there is no ENABLE password, the AAA system prompts the user for a username and password for the local-user database. If the given user is not in the local list, the username and password are handed to the remote servers defined in mygroup. A failure at any point (password not matching) denies access.
If the AAA process falls through the list completely, system behavior is based on portal: Console access is granted if the process falls completely through (this prevents a lock-out condition). Telnet and FTP are denied access.
61200500L1-35E
222
Default Values
By default, this is set to 1 process.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 5.1 Command was introduced.
Functional Notes
Increasing this number may speed up simultaneous authentication at the cost of system resources (e.g., memory).
Usage Examples
The following example specifies five available threads for the AAA subsystem: (config)#aaa processes 5
61200500L1-35E
223
Default Values
The default for this command is arpa.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 5.1 Release 6.1 Command was introduced. Command was extended to include NetVanta 2000 Series units.
Usage Examples
The following example enables standard ARP for the VLAN interface: (config)#interface vlan 1 (config-interface-vlan 1)#arp 196.173.22.253 00:A0:C8:00:00:01 arpa
61200500L1-35E
224
Refer to the Auto-Config Configuration Guide (61200560L1-29.2) for more information on this command. This document is located on the ADTRAN OS Documentation CD provided with your unit
Syntax Description
filename <name> restart retry-count <number> Specifies the configuration filename to download. Restarts auto-config parameters. Specifies the maximum number of retries. Range: 0 to 1000.
server <name or address> Specifies the IP address or host name of TFTP Server from which to download.
Default Values
By default, auto-config is disabled.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 11.1 Command was introduced.
Usage Examples
The following command enables auto-config: (config)#auto-config
61200500L1-35E
225
The following command specifies the name of the file to download: (config)#auto-config filename myConfig The following command restarts the auto-config process: (config)#auto-config restart The following command sets the number of retries when downloading a configuration file to 100: (config)#auto-config retry-count 100 The following command specifies the TFTP server IP address from which to download the configuration file: (config)#auto-config server 192.33.5.99 The following command specifies the TFTP server hostname from which to download the configuration file: (config)#auto-config server myHost
61200500L1-35E
226
Default Values
By default, no banners are configured.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 2.1 Command was introduced.
Functional Notes
Banners appear in the following order (if configured): MOTD banner appears at initial connection. Login banner follows the MOTD banner. Exec banner appears after successful login.
Usage Examples
The following example configures the system to display a message of the day: (config)#banner motd *The system will be shut down today from 7PM to 11PM*
61200500L1-35E
227
Default Values
No default value necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 1.1 Command was introduced.
Functional Notes
Detailed instructions for upgrading the AOS and loading files into flash memory are found on the ADTRAN OS Documentation CD.
61200500L1-35E
228
Default Values
By default, all configured bridge interfaces implement ieee spanning-tree protocol.
Applicable Platforms
This command applies to the NetVanta 300, 1000R, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 1.1 Command was introduced.
Usage Examples
The following example deletes the bridge protocol setting for bridge-group 17: (config)#no bridge 17 protocol ieee
61200500L1-35E
229
Default Values
By default DST correction takes place automatically.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 6.1 Release 11.1 Command was introduced. Command was added to the Global command set.
Functional Notes
Depending on the clock timezone chosen (see clock timezone <text> on page 232 for more information) one-hour DST correction may be enabled automatically. You may override this default using this command.
Usage Examples
The following example allows for automatic DST correction: (config)#clock auto-correct-dst The following example overrides the one-hour offset for DST: (config)#clock no-auto-correct-dst
61200500L1-35E
230
Default Values
No default value necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 6.1 Release 11.1 Command was introduced. Command was added to the Global command set.
Usage Examples
The following example sets the system software clock for 3:42 pm, August 22 2004: (config)#clock set 15:42:00 22 Au 2004
61200500L1-35E
231
Default Values
No default value is necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 6.1 Command was introduced.
Depending on the clock timezone chosen, one-hour Daylight Savings Time (DST) correction may be enabled automatically. See clock [auto-correct-dst | no-auto-correct-dst] on page 230 for more information.
61200500L1-35E
232
Functional Notes
The following list shows sample cities and their timezone codes. clock timezone +1-Amsterdam clock timezone +1-Belgrade clock timezone +1-Brussels clock timezone +1-Sarajevo clock timezone +1-West-Africa clock timezone +10-Brisbane clock timezone +10-Canberra clock timezone +10-Guam clock timezone +10-Hobart clock timezone +10-Vladivostok clock timezone +11 clock timezone +12-Auckland clock timezone +12-Fiji clock timezone +13 clock timezone +2-Athens clock timezone +2-Bucharest clock timezone +2-Cairo clock timezone +2-Harare clock timezone +2-Helsinki clock timezone +2-Jerusalem clock timezone +3-Baghdad clock timezone +3-Kuwait clock timezone +3-Moscow clock timezone +3-Nairobi clock timezone +3:30 clock timezone +4-Abu-Dhabi clock timezone +4-Baku clock timezone +4:30 clock timezone +5-Ekaterinburg clock timezone +5-Islamabad clock timezone +5:30 clock timezone +5:45 clock timezone +6-Almaty clock timezone +6-Astana clock timezone +6-Sri-Jay clock timezone +6:30 clock timezone +7-Bangkok clock timezone +7-Kranoyarsk clock timezone +8-Bejing clock timezone +8-Irkutsk clock timezone +8-Kuala-Lumpur clock timezone +8-Perth clock timezone +8-Taipei clock timezone +9-Osaka clock timezone +9-Seoul clock timezone +9-Yakutsk clock timezone +9:30-Adelaide clock timezone +9:30-Darwin clock timezone -1-Azores clock timezone -1-Cape-Verde clock timezone -10 clock timezone -11 clock timezone -12 clock timezone -2 clock timezone -3-Brasilia clock timezone -3-Buenos-Aires clock timezone -3-Greenland clock timezone -3:30 clock timezone -4-Atlantic-Time clock timezone -4-Caracus clock timezone -4-Santiago clock timezone -5 clock timezone -5-Bogota clock timezone -5-Eastern-Time clock timezone -6-Central-America clock timezone -6-Central-Time clock timezone -6-Mexico-City clock timezone -6-Saskatchewan clock timezone -7-Arizona clock timezone -7-Mountain-Time clock timezone -8 clock timezone -9 clock timezone GMT-Casablanca clock timezone GMT-Dublin
61200500L1-35E
233
Usage Examples
The following example sets the timezone for Santiago, Chile. >enable (config)#clock timezone -4-Santiago
61200500L1-35E
234
Syntax Description
<#> <from interface> <slot/port> <tdm-group#> <to interface> <slot/port> Identifies the cross-connect using a number descriptor or label for (useful in systems that allow multiple cross-connects). Specifies the interface (physical or virtual) on one end of the cross-connect. Enter cross-connect 1 ? for a list of valid interfaces. Used when a physical interface is specified in the <from interface> subcommand (For example: specifying the T1 port of a T1 module would be t1 1/1). Specifies which configured TDM group to use for this cross-connect. This subcommand only applies to T1 physical interfaces. Specifies the virtual interface on the other end of the cross-connect. Use the ? to display a list of valid interfaces. Used when a physical interface is specified in the <to interface> subcommand. (For example, specifying the primary T1 port of a T1 module would be t1 1/1).
Default Values
By default, there are no configured cross-connects.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 1.1 Release 5.1 Command was introduced. Command was expanded to include the E1 interface.
Functional Notes
Cross-connects provide the mechanism for connecting a configured virtual (layer 2) endpoint with a physical (layer 1) interface. Supported layer 2 protocols include Frame Relay and point-to-point protocol (PPP).
61200500L1-35E
235
Usage Examples
The following example creates a Frame Relay endpoint and connects it to the T1 1/1 physical interface: 1. Create the Frame Relay virtual endpoint and set the signaling method: (config)# interface frame-relay 1 (config-fr 1)# frame-relay lmi-type cisco 2. Create the sub-interface and configure the PVC parameters (including DLCI and IP address): (config-fr 1)# interface fr 1.1 (config-fr 1.1)# frame-relay interface-dlci 17 (config-fr 1.1)# ip address 168.125.33.252 255.255.255.252 3. Create the TDM group of 12 DS0s (64K) on the T1 physical interface: (THIS STEP IS ONLY VALID FOR T1 INTERFACES.) (config)# interface t1 1/1 (config-t1 1/1)# tdm-group 1 timeslots 1-12 speed 64 (config-t1 1/1)# exit 4. Connect the Frame Relay sub-interface with port T1 1/1: (config)# cross-connect 1 t1 1/1 1 fr 1
Technology Review
Creating an endpoint that uses a layer 2 protocol (such as Frame Relay) is generally a four-step process: Step 1: Create the Frame Relay virtual endpoint (using the interface frame-relay command) and set the signaling method (using the frame-relay lmi-type command). Also included in the Frame Relay virtual endpoint are all the applicable Frame Relay timers logging thresholds, encapsulation types, etc. Generally, most Frame Relay virtual interface parameters should be left at their default state. For example, the following creates a Frame Relay interface labeled 7 and sets the signaling method to ansi. (config)# interface frame-relay 7 (config-fr 7)# frame-relay lmi-type ansi
61200500L1-35E
236
Create the sub-interface and configure the PVC parameters. Using the sub-interface, apply access policies to the interface, create bridging interfaces, configure dial-backup, assign an IP address, and set the PVC data-link control identifier (DLCI). For example, the following creates a Frame Relay sub-interface labeled 22, sets the DLCI to 30, and assigns an IP address of 193.44.69.253 to the interface. (config-fr 7)# interface fr 7.22 (config-fr 7.22)# frame-relay interface-dlci 30 (config-fr 7.22)# ip address 193.44.69.253 255.255.255.252 Step 3: (VALID ONLY FOR T1 INTERFACES) Specify the group of DS0s used for signaling on the T1 interface by creating a TDM group. Group any number of contiguous DS0s together to create a data pipe for layer 2 signaling. Also use the tdm-group command to specify the per-DS0 signaling rate on the interface. For example, the following creates a TDM group labeled 9 containing 20 DS0s (each DS0 having a data rate of 56 kbps). (config)# interface t1 1/1 (config-t1 1/1)# tdm-group 9 timeslots 1-20 speed 56 (config-t1 1/1)# exit Step 4: Make the association between the layer 2 endpoint and the physical interface using the cross-connect command. Supported layer 2 protocols include Frame Relay and point-to-point protocol (PPP). For example, the following creates a cross-connect (labeled 5) to make an association between the Frame Relay virtual interface (fr 7) and the TDM group configured on interface t1 1/1 (tdm-group 9). (config)# cross-connect 5 t1 1/1 9 fr 7
61200500L1-35E
237
Syntax Description
md5 Optional. Specifies Message Digest 5 (MD5) as the encryption protocol to use when displaying the enable password during show commands. If the md5 keyword is not used, encryption is not used when displaying the Enable password during show commands Specifies the Enable Security mode password using a string (up to 30 characters in length).
<password>
Default Values
By default, there is no configured enable password.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 1.1 Command was introduced.
61200500L1-35E
238
Usage Examples
To provide extra security, the AOS can encrypt the Enable password when displaying the current configuration. For example, the following is a show configuration printout (password portion) with an unencrypted Enable password (ADTRAN): ! enable password ADTRAN ! Alternately, the following is a show configuration printout (password portion) with an Enable password of ADTRAN using MD5 encryption: ! enable password md5 encrypted 5aa5fbae7d01a90e79fb57705ce74676 !
61200500L1-35E
239
event-history on
Use the event-history on command to enable event logging for the AOS system. Event log messages will not be recorded unless this command has been issued (regardless of the event-history priority configured). The event log may be displayed using the show event-history command. Use the no form of this command to disable the event log. Syntax Description
No subcommands.
Default Values
By default, the AOS event logging capabilities are disabled.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 1.1 Command was introduced.
Functional Notes
The event history provides useful information regarding the status of the system and individual port states. Use the event history as a troubleshooting tool when identifying system issues. The following is a sample event history log. #show event-history Using 526 bytes 2002.07.12 15:34:01 T1.t1 1/1 Yellow 2002.07.12 15:34:01 INTERFACE_STATUS.t1 1/1 changed state to down. 2002.07.12 15:34:02 T1.t1 1/1 No Alarms 2002.07.12 15:34:02 INTERFACE_STATUS.t1 1/1 changed state to up. 2002.07.12 15:34:03 INTERFACE_STATUS.eth 0/1 changed state to up. 2002.07.12 15:34:10 OPERATING_SYSTEM Warm Start 2002.07.12 15:34:12 PPP.NEGOTIATION LCP up 2002.07.12 15:34:12 PPP.NEGOTIATION IPCP up
Usage Examples
The following example enables the AOS event logging feature: (config)#event-history on
61200500L1-35E
240
Default Values
By default, no event messages are logged to the event history.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 1.1 Command was introduced.
Functional Notes
The event history provides useful information regarding the status of the system and individual port states. Use the event history as a troubleshooting tool when identifying system issues. The following is a sample event history log. Router#show event-history Using 526 bytes 2002.07.12 15:34:01 T1.t1 1/1 Yellow 2002.07.12 15:34:01 INTERFACE_STATUS.t1 1/1 changed state to down. 2002.07.12 15:34:02 T1.t1 1/1 No Alarms 2002.07.12 15:34:02 INTERFACE_STATUS.t1 1/1 changed state to up. 2002.07.12 15:34:03 INTERFACE_STATUS.eth 0/1 changed state to up. 2002.07.12 15:34:10 OPERATING_SYSTEM Warm Start 2002.07.12 15:34:12 PPP.NEGOTIATION LCP up 2002.07.12 15:34:12 PPP.NEGOTIATION IPCP up
61200500L1-35E
241
Usage Examples
The following example logs all events to the event history: (config)#event-history priority info
61200500L1-35E
242
Default Values
By default, the exception report filename is exception report-yyyyMMddHHmmss. (The yyyyMMddHHmmss will be automatically replaced with the actual year, month, day, hour, minutes, and seconds.)
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 10.1 Command was introduced.
Usage Example
The following example specifies the output filename for an exception report: (config)#exception report file-name example (config)#exit #exception report generate Exception report generated. #show flash 1744 startup-config 45676 example-20050708080537 #config t (config)#no exception report file-name (config)#exit Appropriate commands must be issued to preserve configuration. #exception report generate Exception report generated. #show flash 1744 startup-config 45676 example-20050708080537 45900 exception-report-20050708080552
61200500L1-35E
243
Default Values
There is no default configuration for the list. If AAA is turned on but no ftp authentication list has been assigned, FTP denies all login attempts.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 5.1 Command was introduced.
Usage Examples
The following example attaches the authentication list, MyList, to the FTP server: (config)#ftp authentication MyList The following example specifies that the AOS use the default AAA login list for FTP authentication: (config)#ftp authentication default
61200500L1-35E
244
Default Values
By default, the join timer is 200 milliseconds, the leave timer is 600 milliseconds, and the leaveall timer is 10000 milliseconds.
Applicable Platforms
This command applies to the NetVanta 300, 1000, and 1000R Series units.
Command History
Release 8.1 Command was introduced.
Functional Notes
All devices communicating using GARP in the network need to have the same values for these timers. Changing these values is not recommended.
Usage Examples
The following example specifies the time (in milliseconds) between GARP application leave all messages: (config)#garp timer leaveall 20000
61200500L1-35E
245
gvrp
Use the gvrp command to enable or disable GVRP on the switch globally. Syntax Description
No subcommands.
Default Values
By default, GVRP is disabled.
Applicable Platforms
This command applies to the NetVanta 300, 1000, and 1000R Series units.
Command History
Release 8.1 Command was introduced.
Functional Notes
Disabling GVRP globally will disable GVRP on all interfaces.
Usage Examples
The following example enables GVRP on the switch globally: (config)#gvrp
61200500L1-35E
246
hostname <name>
Creates a name used to identify the unit. This alphanumeric string should be used as a unique description for the unit. This string will be displayed in all prompts. Syntax Description
<name> Identifies the unit using an alphanumeric string up to 32 characters.
Default Values
<name> Router
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 1.1 Command was introduced.
Usage Examples
The following example creates a hostname for the AOS device of ATL_RTR to identify the system as the Atlanta router: (config)#hostname ATL_RTR
61200500L1-35E
247
<slot/port>
<interface id>
point-to-point
Default Values
No default values required for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 1.1 Release 3.1 Release 8.1 Release 9.1 Release 11.1 Command was introduced. Command expanded to include loopback interface. Command expanded to include ATM interface. Command expanded to include HDLC interface. Command expanded to include demand, FXO, and PRI interfaces.
Usage Examples
The following example enters the serial interface mode for a serial module installed in slot 1: (config)#interface serial 1/1 (config-ser 1/1)#
61200500L1-35E
248
Default Values
No default value is necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, and 2000, and Total Access 900 Series units.
Command History
Release 6.1 Release 11.1 Command was introduced. Command was expanded to include FXO range.
Functional Notes
All configuration changes made in this mode will apply to all interfaces in the range specified.
Usage Examples
The following example selects seven consecutive Ethernet ports for configuration: (config)#interface range eth 0/1-0/7 (config-eth 0/1-7)# The following example selects nonconsecutive FXS ports for configuration: (config)#interface range fxs 3/1-2, 3/3, 3/4-6, 3/8 (config-fxs 3/1-2, 3/3, 3/4-6, 3/8)#
61200500L1-35E
249
Example: Source IP Address [permit | deny] [ip | tcp | udp] [any | host <A.B.C.D> | <A.B.C.D> <W.W.W.W>] <source port>* [any | host <A.B.C.D> | <A.B.C.D> <W.W.W.W>] <destination port>* Destination IP Address Example:
Source IP Address
[permit | deny] icmp [any | host <A.B.C.D> | <A.B.C.D> <W.W.W.W>] [any | host <A.B.C.D> | <A.B.C.D> <W.W.W.W>] <icmp-type>* <icmp-code>* <icmp-message>* Destination IP Address * = optional Syntax Description
<listname> <protocol> <source ip> Identifying the configured access list using an alphanumeric descriptor. All access list descriptors are case-sensitive. Specifies the data protocol such as IP, ICMP, TCP, UDP, or a specific protocol (range: 0 to 255). Specifies the source IP address used for packet matching. IP addresses can be expressed in one of three ways: 1. Using the keyword any to match any IP address. For example, entering deny any will effectively shut down the interface that uses the access list because all traffic will match the any keyword. 2. Using the host <A.B.C.D> to specify a single host address. For example, entering permit host 196.173.22.253 will allow all traffic from the host with an IP address of 196.173.22.253. 3. Using the <A.B.C.D> <wildcard> format to match all IP addresses in a range. Wildcard masks work in reverse logic from subnet mask. Specifying a one in the wildcard mask equates to a dont care. For example, entering permit 192.168.0.0 0.0.0.255 will permit all traffic from the 192.168.0.0/24 network. <source port> Optional. The source port is used only when <protocol> is tcp or udp.
61200500L1-35E
250
The following keywords and port numbers are supported for the <source port> field: any eq <port number> gt <port number> host <port number> lt <port number> neq <port number> range <port number> Matches any destination port. Matches only packets on a given port number. Matches only packets with a port number higher than the one listed. Matches a single destination host. Matches only packets with a port number lower than the one listed. Matches only packets that do not contain the specified port number. Matches only packets that contain a port number specified in the listed range.
The <port number> may be specified using the following syntax: <0-65535>. Specifies the port number used by TCP or UDP to pass information to upper layers. All ports below 1024 are considered well-known ports and are controlled by the Internet Assigned Numbers Authority (IANA). All ports above 1024 are dynamically assigned ports that include registered ports for vendor-specific applications <port list> The AOS provides a condensed list of port numbers that may be entered using a text name. The following is the list of UDP port numbers that may be identified using the text name (in bold): biff (Port 512) bootpc (Port 68) bootps(Port 67) discard (Port 9) dnsix (Port 195) domain (Port 53) echo (Port 7) isakmp (Port 500) mobile-ip (Port 434) nameserver (Port 42) netbios-dgm (Port 138) netbios-ns (Port 137) netbios-ss (Port 139) ntp (Port 123) pim-auto-rp (Port 496) rip (Port 520) snmp (Port 161) snmptrap (Port 162) sunrpc (Port 111) syslog (Port 514) tacacs (Port 49) talk (Port 517) tftp (Port 69) time (Port 37) who (Port 513) xdmcp (Port 177)
61200500L1-35E
251
The following is the list of TCP port numbers that may be identified using the text name (in bold): bgp (Port 179) chargen (Port 19) cmd (Port 514) daytime (Port 13) discard (Port 9) domain (Port 53) echo (Port 7) exec (Port 512) finger (Port 79) ftp (Port 21) gopher (Port 70) hostname (Port 101) ident (Port 113) irc (Port 194) klogin (Port 543) kshell (Port 544) login (Port 513) <destination ip> Specifies the destination IP address used for packet matching. IP addresses can be expressed in one of three ways: 1. Using the keyword any to match any IP address. For example, entering deny any will effectively shut down the interface that uses the access list because all traffic will match the any keyword. 2. Using the host <A.B.C.D> to specify a single host address. For example, entering permit host 196.173.22.253 will allow all traffic from the host with an IP address of 196.173.22.253. 3. Using the <A.B.C.D> <wildcard> format to match all IP addresses in a range. Wildcard masks work in reverse logic from subnet mask. Specifying a one in the wildcard mask equates to a dont care. For example, entering permit 192.168.0.0 0.0.0.255 will permit all traffic from the 192.168.0.0/24 network. <destination port> Optional. Specifies the destination port. Only valid when <protocol> is tcp or udp (Refer to previously listed <source port> for more details). Optional. Filters packets using ICMP defined (and numbered) messages carried in IP datagrams (used to send error and control information). Valid range is 0 to 255. lpd (Port 515) nntp (Port 119) pim-auto-rp (Port 496) pop2 (Port 109) pop3 (Port 110) smtp (Port 25) sunrpc (Port 111) syslog (Port 514) tacacs (Port 49) talk (Port 517) tftp (Port 69) telnet (Port 23) time (Port 37) uucp (Port 540) whois (Port 43) www (Port 80)
<icmp-type>
61200500L1-35E
252
Optional. Filters ICMP packets that are filtered using the ICMP message type (using the <icmp-type> keyword) may also be filtered using the ICMP message code (valid range: 0 to 255). An <icmp-type> must be specified when entering an <icmp-code>.
<icmp-message>
Optional. Filters packets using ICMP descriptive message rather than the corresponding type and code associations.
Default Values
By default, all AOS security features are disabled and there are no configured access lists.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 2.1 Command was introduced.
Functional Notes
Access control lists (ACLs) are used as packet selectors by other AOS systems; by themselves they do nothing. ACLs are composed of an ordered list of entries with an implicit deny all at the end of each list. An ACL entry contains two parts: an action (permit or deny) and a packet pattern. A permit ACL is used to allow packets (meeting the specified pattern) to enter the router system. A deny ACL advances the AOS to the next access policy entry. The AOS provides two types of ACLs: standard and extended. Standard ACLs allow source IP address packet patterns only. Extended ACLs may specify patterns using most fields in the IP header and the TCP or UDP header. ACLs are performed in order from the top of the list down. Generally, the most specific entries should be at the top and the most general at the bottom. The following commands are contained in the access-list extended mode: remark Associates a descriptive tag (up to 80 alphanumeric characters enclosed in quotation marks) to the access list. Enter a functional description for the list such as This list blocks all outbound web traffic. Logs a message (if debug access-list is enabled for this access list) when the access list finds a packet match.
log
61200500L1-35E
253
Usage Examples
The following example creates an access list AllowIKE to allow all IKE (UDP Port 500) packets from the 190.72.22.55.0/24 network: (config)#ip access-list extended AllowIKE (config-ext-nacl)#permit udp 190.72.22.55.0 0.0.0.255 eq 500 any eq 500 For more details, refer to the ADTRAN OS System Documentation CD or the ADTRAN website (www.adtran.com) for technical support notes regarding access-list configuration.
Technology Review
Creating access policies and lists to regulate traffic through the routed network is a four-step process: Step 1: Enable the security features of the AOS using the ip firewall command. Step 2: Create an access control list (using the ip access-list command) to permit or deny specified traffic. Standard access lists provide pattern matching for source IP addresses only. (Use extended access lists for more flexible pattern matching.) IP addresses can be expressed in one of three ways: 1. Using the keyword any to match any IP address. For example, entering deny any will effectively shut down the interface that uses the access list because all traffic will match the any keyword. 2. Using the host <A.B.C.D> to specify a single host address. For example, entering permit host 196.173.22.253 will allow all traffic from the host with an IP address of 196.173.22.253. 3. Using the <A.B.C.D> <wildcard> format to match all IP addresses in a range. Wildcard masks work in reverse logic from subnet mask. Specifying a one in the wildcard mask equates to a dont care. For example, entering permit 192.168.0.0 0.0.0.255 will permit all traffic from the 192.168.0.0/24 network. Step 3: Create an access control policy (using the ip policy-class command) that uses a configured access list. AOS access policies are used to allow, discard, or manipulate (using NAT) data for each physical interface. Each ACP consists of a selector (access list) and an action (allow, discard, NAT). When packets are received on an interface, the configured ACPs are applied to determine whether the data will be processed or discarded. Possible actions performed by the access policy are as follows: allow list <access list names> All packets passed by the access list(s) entered will be allowed to enter the router system. discard list <access list names> All packets passed by the access list(s) entered will be dropped from the router system. allow list <access list names> policy <access policy name> All packets passed by the access list(s) entered and destined for the interface using the access policy listed will be permitted to enter the router system. This allows for configurations to permit packets to a single interface and not the entire system.
61200500L1-35E
254
discard list <access list names> policy <access policy name> All packets passed by the access list(s) entered and destined for the interface using the access policy listed will be blocked from the router system. This allows for configurations to deny packets on a specified interface. nat source list <access list names> address <IP address> overload All packets passed by the access list(s) entered will be modified to replace the source IP address with the entered IP address. The overload keyword allows multiple source IP addresses to be replaced with the single IP address entered. This hides private IP addresses from outside the local network. nat source list <access list names> interface <interface> overload [policy] All packets passed by the access list(s) entered will be modified to replace the source IP address with the primary IP address of the listed interface. The overload keyword allows multiple source IP addresses to be replaced with the single IP address of the specified interface. This hides private IP addresses from outside the local network. The policy option specifies the destination policy class. nat destination list <access list names> address <IP address> All packets passed by the access list(s) entered will be modified to replace the destination IP address with the entered IP address. The overload keyword is not an option when performing NAT on the destination IP address; each private address must have a unique public address. This hides private IP addresses from outside the local network.
Before applying an access control policy to an interface, verify your Telnet connection will not be affected by the policy. If a policy is applied to the interface you are connecting through and it does not allow Telnet traffic, your connection will be lost.
Step 4: Apply the created access control policy to an interface. To assign an access policy to an interface, enter the interface configuration mode for the desired interface and enter access policy <policy name>. The following example assigns access policy MatchAll to the Ethernet 0/1 interface: (config)#interface ethernet 0/1 (config-eth 0/1)#access-policy MatchAll
61200500L1-35E
255
Syntax Description
<listname> Identifies the configured access list using an alphanumeric descriptor. All access list descriptors are case-sensitive. Permits or denies entry to the routing system for specified packets. Specifies the source IP address used for packet matching. IP addresses can be expressed in one of three ways: 1. Using the keyword any to match any IP address. For example, entering deny any will effectively shut down the interface that uses the access list because all traffic will match the any keyword. 2. Using the host <A.B.C.D> to specify a single host address. For example, entering permit host 196.173.22.253 will allow all traffic from the host with an IP address of 196.173.22.253. 3. Using the <A.B.C.D> <wildcard> format to match all IP addresses in a range. Wildcard masks work in reverse logic from subnet mask. Specifying a one in the wildcard mask equates to a dont care. For example, entering permit 192.168.0.0 0.0.0.255 will permit all traffic from the 192.168.0.0/24 network.
Default Values
By default, all AOS security features are disabled and there are no configured access lists.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 9000 Series units.
Command History
Release 2.1 Command was introduced.
61200500L1-35E
256
Functional Notes
Access control lists are used as packet selectors by access policies (ACPs); by themselves they do nothing. ACLs are composed of an ordered list of entries with an implicit deny all at the end of each list. An ACL entry contains two parts: an action (permit or deny) and a packet pattern. A permit ACL is used to allow packets (meeting the specified pattern) to enter the router system. A deny ACL advances the AOS to the next access policy entry. The AOS provides two types of ACLs: standard and extended. Standard ACLs allow source IP address packet patterns only. Extended ACLs may specify patterns using most fields in the IP header and the TCP or UDP header. ACLs are performed in order from the top of the list down. Generally the most specific entries should be at the top and the most general at the bottom. The following commands are contained in the access-list standard: remark Associates a descriptive tag (up to 80 alphanumeric characters enclosed in quotation marks) to the access list. Enter a functional description for the list such as This list blocks all outbound web traffic. log Logs a message (if debug access-list is enabled for this access list) when the access list finds a packet match. permit or deny any Uses the any keyword to match any IP address received by the access list. For example, the following allows all packets through the configured access list: (config)#ip access-list standard MatchAll (config-std-nacl)#permit any permit or deny host <ip address> Uses the host <A.B.C.D> keyword to specify a single host address. For example, the following allows all traffic from the host with an IP address of 196.173.22.253. (config)#ip access-list standard MatchHost (config-std-nacl)#permit host 196.173.22.253 permit or deny <ip address> <wildcard> Uses the <A.B.C.D> <wildcard> format to match all IP addresses in a range. Wildcard masks work in reverse logic from subnet mask. Specifying a one in the wildcard mask equates to a dont care. For example, the following denies all traffic from the 192.168.0.0/24 network: (config)#ip access-list standard MatchNetwork (config-std-nacl)#deny 192.168.0.0 0.0.0.255
61200500L1-35E
257
Usage Examples
The following example creates an access list UnTrusted to deny all packets from the 190.72.22.248/30 network: (config)#ip access-list standard UnTrusted (config-std-nacl)#deny 190.72.22.248 0.0.0.3 For more details, refer to the ADTRAN OS System Documentation CD or the ADTRAN website (www.adtran.com) for technical support notes regarding access list configuration.
Technology Review
Creating access policies and lists to regulate traffic through the routed network is a four-step process: Step 1: Enable the security features of the AOS using the ip firewall command. Step 2: Create an access list to permit or deny specified traffic. Standard access lists provide pattern matching for source IP addresses only. (Use extended access lists for more flexible pattern matching.) IP addresses can be expressed in one of three ways: 1. Using the keyword any to match any IP address. For example, entering deny any will effectively shut down the interface that uses the access list because all traffic will match the any keyword. 2. Using the host <A.B.C.D> to specify a single host address. For example, entering permit host 196.173.22.253 will allow all traffic from the host with an IP address of 196.173.22.253. 3. Using the <A.B.C.D> <wildcard> format to match all IP addresses in a range. Wildcard masks work in reverse logic from subnet mask. Specifying a one in the wildcard mask equates to a dont care. For example, entering permit 192.168.0.0 0.0.0.255 will permit all traffic from the 192.168.0.0/24 network. Step 3: Create an access policy that uses a configured access list. AOS access policies are used to allow, discard, or manipulate (using NAT) data for each physical interface. Each ACP consists of a selector (access list) and an action (allow, discard, NAT). When packets are received on an interface, the configured ACPs are applied to determine whether the data will be processed or discarded. Possible actions performed by the access policy are as follows: allow list <access list names> All packets passed by the access list(s) entered will be allowed to enter the router system. discard list <access list names> All packets passed by the access list(s) entered will be dropped from the router system. allow list <access list names> policy <access policy name> All packets passed by the access list(s) entered and destined for the interface using the access policy listed will be permitted to enter the router system. This allows for configurations to permit packets to a single interface and not the entire system.
61200500L1-35E
258
discard list <access list names> policy <access policy name> All packets passed by the access list(s) entered and destined for the interface using the access policy listed will be blocked from the router system. This allows for configurations to deny packets on a specified interface. nat source list <access list names> address <IP address> overload All packets passed by the access list(s) entered will be modified to replace the source IP address with the entered IP address. The overload keyword allows multiple source IP addresses to be replaced with the single IP address entered. This hides private IP addresses from outside the local network. nat source list <access list names> interface <interface> overload [policy] All packets passed by the access list(s) entered will be modified to replace the source IP address with the primary IP address of the listed interface. The overload keyword allows multiple source IP addresses to be replaced with the single IP address of the specified interface. This hides private IP addresses from outside the local network. The policy option specifies the destination policy class. nat destination list <access list names> address <IP address> All packets passed by the access list(s) entered will be modified to replace the destination IP address with the entered IP address. The overload keyword is not an option when performing NAT on the destination IP address; each private address must have a unique public address. This hides private IP addresses from outside the local network.
Before applying an access control policy to an interface, verify your Telnet connection will not be affected by the policy. If a policy is applied to the interface you are connecting through and it does not allow Telnet traffic, your connection will be lost.
Step 4: Apply the created access policy to an interface. To assign an access policy to an interface, enter the interface configuration mode for the desired interface and enter access policy <policy name>. The following example assigns access policy MatchAll to the Ethernet 0/1 interface: (config)#interface ethernet 0/1 (config-eth 0/1)#access-policy MatchAll
61200500L1-35E
259
Default Values
By default, there is no configured default-gateway.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 1.1 Command was introduced.
Functional Notes
Only use the ip default-gateway when IP routing is disabled on the router. For all other cases, use the ip route 0.0.0.0 0.0.0.0 <ip address> command.
Usage Examples
The following example disables IP routing and configures a default gateway for 192.22.71.50: (config)#no ip routing (config)#ip default-gateway 192.22.71.50
61200500L1-35E
260
Default Values
No default values.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 10.1 Command was introduced.
Usage Examples
The following example configures the DHCP database agent with local bindings: (config)#ip dhcp-server database local
61200500L1-35E
261
Default Values
By default, there are no excluded IP addresses.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 2.1 Command was introduced.
Functional Notes
The AOS DHCP server (by default) allows all IP addresses for the DHCP pool to be assigned to requesting clients. This command is used to ensure that the specified address is never assigned by the DHCP server. When static addressed hosts are present in the network, it is helpful to exclude the IP addresses of the host from the DHCP IP address pool. This will avoid IP address overlap.
Usage Examples
The following example excludes an IP address of 172.22.5.100 and the range 172.22.5.200 through 172.22.5.250: (config)#ip dhcp-server excluded-address 172.22.5.100 (config)#ip dhcp-server excluded-address 172.22.5.200 172.22.5.250
61200500L1-35E
262
Default Values
By default, the number of DHCP server ping packets is set at 2 packets.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 2.1 Command was introduced.
Functional Notes
Before assigning an IP address to a requesting client, the AOS DHCP server transmits a ping packet on the network to verify there are no other network hosts already configured with the specified address. If the DHCP server receives no reply, the IP address is assigned to the requesting client and added to the DHCP database as an assigned address. Configuring the ip dhcp-server ping packets command with a value of 0 prevents the DHCP server from using ping packets as part of the IP address assignment process.
Usage Examples
The following example configures the DHCP server to transmit four ping packets before assigning an address: (config)#ip dhcp-server ping packets 4
61200500L1-35E
263
Default Values
By default, the ip dhcp-server ping timeout is set to 500 milliseconds.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 2.1 Command was introduced.
Functional Notes
Before assigning an IP address to a requesting client, the AOS DHCP server transmits a ping packet on the network to verify there are no other network hosts already configured with the specified address. If the DHCP server receives no reply, the IP address is assigned to the requesting client and added to the DHCP database as an assigned address.
Usage Examples
The following example configures the DHCP server to wait 900 milliseconds for a response to a transmitted DHCP ping packet before considering the ping a failure: (config)#ip dhcp-server ping timeout 900
61200500L1-35E
264
Default Values
By default, there are no configured DHCP address pools.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 2.1 Command was introduced.
Functional Notes
Use the ip dhcp-server pool to create multiple DHCP server address pools for various segments of the network. Multiple address pools can be created to service different segments of the network with tailored configurations.
Usage Examples
The following example creates a DHCP server address pool (labeled SALES) and enters the DHCP server pool mode: (config)#ip dhcp-server pool SALES (config-dhcp)#
61200500L1-35E
265
ip domain-lookup
Use the ip domain-lookup command to enable the IP domain naming system (DNS), allowing DNS-based host translation (name-to-address). Use the no form of this command to disable DNS. Syntax Description
No subcommands.
Default Values
By default, this command is enabled.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 3.1 Command was introduced.
Functional Notes
Use the ip domain-lookup command to enable the DNS client in the router. This will allow the user to input web addresses instead of IP addresses for applications such as ping, Telnet, and traceroute.
Usage Examples
The following example enables DNS: (config)#ip domain-lookup
61200500L1-35E
266
ip domain-name <name>
Use the ip domain-name command to define a default IP domain name to be used by the AOS to resolve host names. Use the no form of this command to disable this function. Syntax Description
<name> Specifies the default IP domain name used to resolve unqualified host names. Do not include the initial period that separates the unresolved name from the default domain name.
Default Values
By default, this command is disabled.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 3.1 Command was introduced.
Functional Notes
Use the ip domain-name command to set a default name which will be used to complete any IP host name that is invalid (i.e., any name that is not recognized by the name server). When this command is enabled, any IP host name that is not initially recognized will have the ip domain-name appended to it and the request will be resent.
Usage Examples
The following example defines adtran as the default domain name: (config)#ip domain-name adtran
61200500L1-35E
267
ip domain-proxy
Use the ip domain-proxy command to enable DNS proxy for the router. This enables the router to act as a proxy for other units on the network. Syntax Description
No subcommands.
Default Values
By default, this command is disabled.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 3.1 Command was introduced.
Functional Notes
When this command is enabled, incoming DNS requests will be handled by the router. It will first search its host table for the query, and if it is not found there the request will be forwarded to the servers configured with the ip name-server command.
Usage Examples
The following example enables DNS proxy: (config)#ip domain-proxy
61200500L1-35E
268
Default Values
By default, all FTP access is allowed.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 2.1 Command was introduced.
Usage Examples
The following example applies the configured ACP (labeled Inbound_FTP) to inbound FTP traffic: (config)#ip ftp access-class Inbound_FTP in
61200500L1-35E
269
ip ftp agent
Use the ip ftp agent command to enable the file transfer protocol (FTP) agent. Syntax Description
No subcommands.
Default Values
By default, the FTP agent is enabled.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 4.1 Command was introduced.
Usage Examples
The following example enables the IP FTP agent: (config)#ip ftp agent
61200500L1-35E
270
Default Values
No default value is necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 6.1 Release 9.1 Command was introduced. Command expanded to include HDLC interface.
Functional Notes
This command allows you to override the sender field in the IP packet. If you have multiple interfaces in your unit, changing the sender tells the receiver where to send replies. This functionality can also be used to allow packets to get through firewalls that would normally block the flow.
Usage Examples
The following example configures the unit to use the loopback 1 interface as the source IP for FTP traffic: (config)#ip ftp source-interface loopback 1
61200500L1-35E
271
Default Values
By default, the host table is empty.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 3.1 Command was introduced.
Functional Notes
The name may be any combination of numbers and letters as long as it is not a valid IP address or does not exceed 256 characters.
Usage Examples
The following example defines two static mappings: (config)#ip host mac 10.2.0.2 (config)#ip host dal 172.38.7.12
61200500L1-35E
272
ip http [access-class <listname> in | authentication <listname> | secure-access-class <listname> in | secure-server | server | session-limit | session-timeout]
Use the ip http command to enable web access to the unit. Syntax Description
access-class <listname> in authentication secure-access-class secure-server server session-limit session-timeout Enables HTTP for all incoming connections associated with a specific access list. Specifies the access list name. Applies to all incoming connections. Assigns the specified AAA list to HTTP authentication. Applies to all self-bound HTTPS connections. Enables the SSL server. Enables the HTTP server connection. Sets the maximum number of sessions allowed. Valid range is 0 to 100 with 100 as the default. Sets the session timeout. Valid range is 10 to 86,400 seconds. The default is 600.
Default Values
By default, this command is disabled.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, and 2000 and Total Access 900 Series units.
Command History
Release 3.1 Command was introduced.
Usage Examples
The following example enables web access to the router: (config)#ip http server
61200500L1-35E
273
ip name-server <server-address1-6>
Use the ip name-server command to designate one or more name servers to use for name-to-address resolution. Use the no form of this command to remove any addresses previously specified. Syntax Description
<server-address1-6> Specifies up to six name-server addresses.
Default Values
By default, no name servers are specified.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 3.1 Command was introduced.
Usage Examples
The following example specifies host 172.34.1.111 as the primary name server and host 172.34.1.2 as the secondary server: (config)#ip name-server 172.341.1.111 172.34.1.2 This command will be reflected in the configuration file as follows: ip name-server 172.34.1.111 172.34.1.2
61200500L1-35E
274
Default Values
By default, no source interface is defined.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 5.1 Command was introduced.
Functional Notes
If this value is not defined, the address of the source network interface is used.
Usage Examples
The following example configures the Ethernet 0/1 port to be the source interface: (config)#ip radius source-interface ethernet 0/1 Release 11.1 Demand added as a supported interface.
61200500L1-35E
275
ip scp server
Use the ip scp server to enable the secure copy (SCP) server. SCP is a more secure form of the older Berkley r-tool RCP or remote copy. It allows an SCP client to send or receive files to/from the unit. SCP relies on Secure Shell (SSH) for authentication and encryption of the data transfer. Syntax Description
No subcommands.
Default Values
By default, the secure copy server is disabled.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 10.1 Command was introduced.
Usage Examples
The following example enables the secure copy server: (config)#ip scp server
61200500L1-35E
276
ip snmp agent
Use the ip snmp agent command to enable the Simple Network Management Protocol (SNMP) agent. Syntax Description
No subcommands.
Default Values
By default, the SNMP agent is disabled.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 1.1 Command was introduced.
Functional Notes
Allows a MIB browser to access standard MIBs within the product. This also allows the product to send traps to a trap management station.
Usage Examples
The following example enables the IP SNMP agent: (config)#ip snmp agent
61200500L1-35E
277
Default Values
No default value is necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 6.1 Command was introduced.
Functional Notes
This command allows you to override the sender field in the IP packet. If you have multiple interfaces in your unit, changing the sender tells the receiver where to send replies. This functionality can also be used to allow packets to get through firewalls that would normally block the flow.
Usage Examples
The following example configures the unit to use the loopback 1 interface as the source IP for SNTP traffic: (config)#ip sntp source-interface loopback
61200500L1-35E
278
Default Values
By default, the SSH server listens on TCP port 22 and Telnet listens on TCP port 23.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 11.1 Command was introduced.
Functional Notes
SSH is a newer version of Telnet which allows you to run command line and graphical applications (as well as transfer files) over an encrypted connection.
Usage Examples
The following example configures the Telnet server to listen on TCP port 2323 instead of the default port 23: (config)#ip telnet-server 2323 The following example configures the SSH server to listen on TCP port 2200 instead of the default port 22: (config)#ip ssh-server 2200 To return to the default settings, use the no version of the command. For example: (config)#no ip ssh-server 2200
61200500L1-35E
279
Default Values
No default value is necessary for this command.
Default Values
No default value is necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 6.1 Command was introduced.
Functional Notes
This command allows you to override the sender field in the IP packet. If you have multiple interfaces in your unit, changing the sender tells the receiver where to send replies. This functionality can also be used to allow packets to get through firewalls that would normally block the flow.
Usage Examples
The following example configures the unit to use the loopback 1 interface as the source IP for TFTP traffic: (config)#ip tftp source-interface loopback 1
61200500L1-35E
280
telnet
ssh
Default Values
By default, the AOS line console parameters are configured as follows: Data Rate: 9600 Data bits: 8 Stop bits: 1 Parity Bits: 0 No flow control By default, there are no configured Telnet or SSH sessions.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
61200500L1-35E
281
Command History
Release 1.1 Release 11.1 Command was introduced. Command was expanded to include SSH.
Usage Examples
The following example begins the configuration for the CONSOLE port located on the rear of the unit: (config)#line console 0 (config-con0)# The following example begins the configuration for all available Telnet sessions: (config)#line telnet 0 4 (config-telnet0-4)# The following example begins the configuration for all available SSH sessions: (config)#line ssh 0 4 (config-ssh0-4)#
61200500L1-35E
282
Default Values
By default, minimum-transmit-interval = 2 seconds (valid range: 1 through 8192); reinitialization-delay = 2 seconds (valid range 1 through 10); transmit-interval = 30 seconds (valid range 5 through 32,768); and ttl-multiplier = 4 (valid range 2 through 10).
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 8.1 Command was introduced.
Functional Notes
Once a device receives data from a neighboring device in an LLDP frame, it will retain that data for a limited amount of time. This amount of time is called time-to-live, and it is part of the data in the LLDP frame. The time-to-live transmitted in the LLDP frame is equal to the transmit interval multiplied by the TTL multiplier.
61200500L1-35E
283
Usage Examples
The following example sets the LLDP minimum transmit interval to 10 seconds: (config)#lldp minimum-transmit-interval 10 The following example sets the LLDP reinitialization delay to 5 seconds: (config)#lldp reinitialization-delay 5 The following example sets the LLDP transmit interval to 15 seconds: (config)#lldp transmit-interval 15 The following example sets the LLDP TTL multiplier to 2 and the time-to-live for all LLDP frames transmitted from this unit to 30 seconds; (config)#lldp transmit-interval 15 (config)#lldp ttl-multiplier 2
61200500L1-35E
284
logging console
Use the logging console command to enable the AOS to log events to all consoles. Use the no form of this command to disable console logging. Syntax Description
No subcommands.
Default Values
By default, logging console is disabled.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 5.1 Command was introduced.
Usage Examples
The following example enables the AOS to log events to all consoles: (config)#logging console
61200500L1-35E
285
Default Values
By default, there are no configured logging email addresses.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 1.1 Command was introduced.
Usage Examples
The following example specifies three email addresses to use when sending logged messages: (config)#logging email address-list [email protected];[email protected];[email protected]
61200500L1-35E
286
Default Values
By default, there are no configured logging email addresses.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 11.1 Command was introduced.
Functional Notes
When AOS experiences an exception it will generate a file with detailed information that ADTRANs Technical Support can use to diagnose the problem, This command allows the unit to email the exception report to a list of addresses upon rebooting after the exception. This command should be used in conjunction with the other logging email commands. Refer to logging email address-list <email address> ;
<email address> on page 286, logging email on on page 288, logging email priority-level [error | fatal | info | notice | warning] on page 289, logging email receiver-ip <ip address> on page 290, logging email sender on page 291, and logging email source-interface <interface> on page 292 for more information.
Usage Examples
The following example will enable exception report forwarding to [email protected] using the 1.1.1.1 SMTP email server: (config)#logging email on (config)#logging email receiver-ip 1.1.1.1 (config)#logging email exception-report address-list [email protected]
61200500L1-35E
287
logging email on
Use the logging email on command to enable the AOS email event notification feature. Use the logging email address-list command to specify email address(es) that will receive notification when an event matching the criteria configured using the logging email priority-level command is logged by the AOS. Refer to logging email priority-level [error | fatal | info | notice | warning] on page 289 for more information. Use the no form of this command to disable the email notification feature. Syntax Description
No subcommands.
Default Values
By default, email event notification is disabled.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 1.1 Command was introduced.
Functional Notes
The domain name is appended to the sender name when sending event notifications. Refer to the command ip domain-name <name> on page 267 for related information.
Usage Examples
The following example enables the AOS email event notification feature: (config)#logging email on
61200500L1-35E
288
Default Values
By default, the logging email priority-level is set to warning.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 1.1 Command was introduced.
Usage Examples
The following example sends all messages with warning level or greater to the email addresses listed using the logging email address-list command: (config)#logging email priority-level warning
61200500L1-35E
289
Default Values
By default, there are no configured email server addresses.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 1.1 Command was introduced.
Usage Examples
The following example specifies an email server (with address 172.5.67.99) to use when sending logged messages: (config)#logging email receiver-ip 172.5.67.99
61200500L1-35E
290
Default Values
No default value is necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 6.1 Command was introduced.
Usage Examples
The following example sets a sender for outgoing messages: (config)#logging email sender [email protected]
61200500L1-35E
291
Default Values
No default value is necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 6.1 Command was introduced.
Functional Notes
This command allows you to override the sender field in the IP packet. If you have multiple interfaces in your unit, changing the sender tells the receiver where to send replies. This functionality can also be used to allow packets to get through firewalls that would normally block the flow.
Usage Examples
The following example configures the unit to use the loopback 1 interface as the source IP for email messages: (config)#logging email source-interface loopback 1
61200500L1-35E
292
Default Values
The default value is local7.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 3.1 Command was introduced.
Functional Notes
The following is a list of all the valid facility types: auth cron daemon kern local0 - local7 lpr mail news sys9 - sys14 syslog user uucp Authorization system Cron facility System daemon Kernel Reserved for locally-defined messages Line printer system Mail system USENET news System use System log User process UNIX-to-UNIX copy system
61200500L1-35E
293
Usage Examples
The following example configures the syslog facility to the cron facility type: (config)#logging facility cron
61200500L1-35E
294
logging forwarding on
Use the logging forwarding on command to enable the AOS syslog event feature. Use the logging forwarding priority-level command to specify the event matching the criteria used by the AOS to determine whether a message should be forwarded to the syslog server. Refer to logging forwarding priority-level [error | fatal | info | notice | warning] on page 296 for related information. Use the no form of this command to disable the syslog event feature. Syntax Description
No subcommands.
Default Values
By default, syslog event notification is disabled.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 1.1 Command was introduced.
Usage Examples
The following example enables the AOS syslog event feature: (config)#logging forwarding on
61200500L1-35E
295
Default Values
By default the logging forwarding priority-level is set to warning.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 1.1 Command was introduced.
Usage Examples
The following example sends all messages with warning level or greater to the syslog server listed using the logging forwarding receiver-ip command. (config)#logging forwarding priority-level warning
61200500L1-35E
296
Default Values
By default, there are no configured syslog server addresses.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 1.1 Command was introduced.
Usage Examples
The following example specifies a syslog server (with address 172.5.67.99) to use when logging messages: (config)#logging forwarding receiver-ip 172.5.67.99
61200500L1-35E
297
Default Values
No default value is necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 6.1 Command was introduced.
Functional Notes
This command allows you to override the sender field in the IP packet. If you have multiple interfaces in your unit, changing the sender tells the receiver where to send replies. This functionality can also be used to allow packets to get through firewalls that would normally block the flow.
Usage Examples
configures the unit to use the loopback 1 interface as the source IP for event log traffic: (config)#logging forwarding source-interface loopback 1
61200500L1-35E
298
Default Values
By default, the aging time is 300 seconds.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 5.1 Command was introduced.
Usage Examples
The following example sets the aging time to 10 minutes: (config)#mac address-table aging-time 600
61200500L1-35E
299
mac address-table static <mac address> vlan <vlan id> interface <interface>
Use the mac address-table static command to insert a static MAC address entry into the MAC address table. Use the no form of this command to remove an entry from the table. Syntax Description
<mac address> <vlan id> interface <interface> Specifies a valid 48-bit MAC address. Specifies a valid VLAN interface ID (1 to 4094). Specifies the interface. Type mac address-table static vlan interface ? for a complete list of valid interfaces. Specifies a valid slot/port interface ID (e.g., eth 0/1).
Default Values
By default, there are no static entries configured.
Applicable Platforms
This command applies to the NetVanta 300, 1000, and 1000R Series units.
Command History
Release 5.1 Command was introduced.
Usage Examples
The following example adds a static MAC address to Ethernet 0/1 on VLAN 4: (config)#mac address-table static 00:A0:C8:00:00:01 00:12:79:00:00:01 vlan 4 interface ethernet 0/1
61200500L1-35E
300
monitor session <session number> [destination interface <interface id> | source interface <interface id> | no tag] [both | rx | tx]
Use the monitor session command to configure a port mirroring session. Use the no form of this command to remove a port mirroring session or to remove a source or destination interface. Syntax Description
<session number> destination interface <interface id> source interface <interface id> no tag both | rx | tx Selects the monitor session number (only one is allowed). Selects the destination interface. Selects the source interface(s). A range of interfaces is allowed. Removes the VLAN tag that is normally appended to mirrored traffic. Optional. Sets the direction of traffic on the source interface (transmit and receive, receive only, or transmit only).
Default Values
Direction of traffic defaults to both.
Applicable Platforms
This command applies to the NetVanta 300, 1000, and 1000R Series units.
Command History
Release 5.1 Command was introduced.
Usage Examples
The following example sets Ethernet 0/1 as the destination and adds Ethernet 0/2, Ethernet 0/3, and Ethernet 0/5 as source ports: (config)#monitor session 1 destination interface eth 0/1 (config)#monitor session 1 source interface eth 0/2-3, eth 0/5
61200500L1-35E
301
port-auth default
Use the port-auth default command to set all global port-authentication settings to their default states. Syntax Description
No subcommands.
Default Values
No default value is necessary for this command.
Applicable Platforms
This command applies to the NetVanta 1000 and 1000R Series units.
Command History
Release 10.1 Command was introduced.
Usage Examples
The following example sets all global port-authentication settings to their default states: (config)#port-auth default
61200500L1-35E
302
Default Values
By default, the maximum number of authentication requests is set at 2.
Applicable Platforms
This command applies to the NetVanta 1000 and 1000R Series units.
Command History
Release 10.1 Command was introduced.
Usage Examples
The following example sets the maximum number of authentication requests at 4: (config)#port-auth max-req 4
61200500L1-35E
303
port-auth re-authentication
Use the port-auth re-authentication command to enable re-authentication. Syntax Description
No subcommands necessary.
Default Values
By default, re-authentication is disabled.
Applicable Platforms
This command applies to the NetVanta 1000 and 1000R Series units.
Command History
Release 10.1 Command was introduced.
Usage Examples
The following example enables re-authentication: (config)#port-auth reauthentication
61200500L1-35E
304
Default Values
By default, quiet-period is set to 60 seconds, re-authperiod is set to 3600 seconds (1 hour), and tx-period is set to 30 seconds.
Applicable Platforms
This command applies to the NetVanta 1000 and 1000R Series units.
Command History
Release 10.1 Command was introduced.
Usage Examples
The following example sets the quiet-period to 10 seconds: (config)#port-auth timeout quiet-period 10
61200500L1-35E
305
Default Values
By default, load balance is set to src-mac.
Applicable Platforms
This command applies to the NetVanta 300, 1000, and 1000R Series units.
Command History
Release 5.1 Command was introduced.
Functional Notes
During port aggregation, the port channel interface must determine on which physical port to transmit packets. With the source-address configuration, the source MAC address of the received packets is used to determine this allocation. Packets coming from a specific host always use the same physical port. Likewise, when the destination address configuration is used, packets are forwarded based on the MAC address of the destination. Packets destined for a specific host always use the same physical port.
Usage Examples
The following example sets the load distribution to use the destination MAC address: (config)# port-channel load-balance dst-mac
61200500L1-35E
306
qos cos-map <cos queue id> <cos value 0> <cos value 1>...<cos val 7>
Use the qos cos-map command to associate cost of service (CoS) values with each queue. Syntax Description
<cos queue id> <cos val 0> <cos val 1-7> Specifies the queue number to which you are assigning CoS value(s). Associates listed CoS values with a particular priority queue. Optional. Associates up to eight CoS values with the queue.
Default Values
By default, CoS 0 and 1 are mapped to queue 1; CoS 2 and 3 are mapped to queue 2; CoS 4 and 5 are mapped to queue 3; CoS 6 and 7 are mapped to queue 4.
Applicable Platforms
This command applies to the NetVanta 300, 1000, and 1000R Series units.
Command History
Release 5.1 Command was introduced.
Usage Examples
The following example maps CoS values 4 and 5 to queue 1: (config)#qos cos-map 1 4 50
61200500L1-35E
307
Default Values
By default, this command is disabled.
Applicable Platforms
This command applies to the NetVanta 300, 1000, and 1000R Series units.
Command History
Release 7.1 Command was introduced.
Functional Notes
When one of the specified DSCP values is detected in an incoming packet, the CoS priority is altered based on the corresponding map value. By configuring the list, the mapping functionality is enabled.
Usage Examples
The following example enables the mapping of DSCP values 24 and 48 to CoS values 1 and 2: (config)#qos dscp-cos 24 48 to 1 2 The following example disables DSCP-to-CoS mapping: (config)#no qos dscp-cos
61200500L1-35E
308
Default Values
By default, the queue type is weighted round robin (WRR).
Applicable Platforms
This command applies to the NetVanta 300, 1000, and 1000R Series units.
Command History
Release 5.1 Command was introduced.
Usage Examples
The following example enables strict-priority queuing: (config)#qos queue-type strict-priority
61200500L1-35E
309
expedite
Default Values
By default, all four weights are set to 25.
Applicable Platforms
This command applies to the NetVanta 300, 1000, and 1000R Series units.
Command History
Release 5.1 Command was introduced.
Functional Notes
The actual weight is a calculated value based on the sum of all entered weights. It is the ratio of the individual weight over the sum of all weights. For example: If the user enters 10, 20, 30, and 40 as the weight values, the first queue will have a ratio of 1/10. This is derived from the formula 10/(10+20+30+40). Therefore, this queue will transmit 1 packet out of every 10 opportunities.
Usage Examples
The following example configures weights for all four queues: (config)#qos queue-type wrr 10 20 30 40
61200500L1-35E
310
radius-server
Use the radius-server command to configure several global RADIUS parameters. Most of these global defaults can be overridden on a per-server basis. Variations of this command include the following:
radius-server challenge-noecho radius-server deadtime <minutes> radius-server enable-username <name> radius-server key <key> radius-server retry <attempts> radius-server timeout <seconds>
Syntax Description
challenge-noecho Turns off echoing of user challenge-entry. When echo is turned on, users see the text of the challenge as they type responses. Enabling this option hides the text as it is being entered. Specifies how long a RADIUS server is considered dead once a timeout occurs. The server will not be tried again until after the deadtime expires. Specifies a username to be used for enable authentication. Specifies the shared key to use with a RADIUS server. Specifies how many attempts to make on a RADIUS server before marking it dead. Specifies how long to wait for a RADIUS server to respond to a request.
deadtime <minutes> enable-username <name> key <key> retry <attempts> timeout <seconds>
Default Values
challenge-noecho deadtime key retry timeout enable-username By default, echo is turned on. 1 minute No default 3 attempts 5 seconds $enab15$
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
61200500L1-35E
311
Command History
Release 5.1 Release 7.1 Command was introduced. Added enable-username selection.
Functional Notes
RADIUS servers (as defined with the radius-server command) may have many optional parameters. However, they are uniquely identified by their addresses and ports. Port values default to 1812 and 1813 for authorization and accounting, respectively. If a server is added to a named group but is not defined by a radius-server command, the server is simply ignored when accessed. Empty server lists are not allowed. When the last server is removed from a list, the list is automatically deleted.
Usage Examples
The following example shows a typical configuration of these parameters: (config)#radius-server challenge-noecho (config)#radius-server deadtime 10 (config)#radius-server timeout 2 (config)#radius-server retry 4 (config)#radius-server key my secret key
61200500L1-35E
312
radius-server host
Use the radius-server host to specify the parameters for a remote RADIUS server. At a minimum, the address (IP or DNS name) of the server must be given. The other parameters are also allowed and (if not specified) will take default values or fall back on the global RADIUS servers default settings. Syntax Description
acct-port <port#> auth-port <port#> retry <attempts> timeout <seconds> key <key> Sends accounting requests to this remote port. Sends authentication requests to this remote port. Retries server after timeout this number of times (uses RADIUS global setting if not given). Waits for a response this number of seconds (uses RADIUS global setting if not given). Defines the shared key with the RADIUS server (uses RADIUS global setting if not given). Note that the key must appear last on the input line since it reads the rest of the line beyond the key keyword. Defines an encrypted shared key with the RADIUS server (uses RADIUS global setting if not given). Note that the key must appear last on the input line since it reads the rest of the line beyond the key keyword.
Default Values
By default, acct-port is set to 1813 and auth-port is set to 1812.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 5.1 Release 11.1 Command was introduced. Command was expanded to include the key encrypted command.
Usage Examples
The following example shows a typical configuration of these parameters: (config)#radius-server host 1.2.3.4 (config)#radius-server host 3.3.1.2 acct-port 1646 key my key
61200500L1-35E
313
service password-encryption
Use the service password-encryption command to turn on global password protection. Use the no form of this command to return to default settings. If you need to go back to a previous revision of the code (e.g., AOS Revision 10), this command must be disabled first. Once the service is disabled, all necessary passwords must be re-entered so that they are in the clear text form. If this is not done properly, you will not be able to log back in to the unit after you revert to a previous revision that does not support password encryption. Syntax Description
No subcommands.
Default Values
By default, global password protection is disabled.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 11.1 Command was introduced.
Functional Notes
When enabled, all currently configured passwords are encrypted. Also, any new passwords are encrypted after they are entered. Password encryption is applied to all passwords, including passwords for username, enable, Telnet/console, PPP, BGP, and authentication keys. When passwords are encrypted, unauthorized persons cannot view them in configuration files since the encrypted form of the password is displayed in the running-config. While this provides some level of security, the encryption method used with password encryption is not a strong form of encryption so you should take additional network security measures.
You cannot recover a lost encrypted password. You must erase the startup-config and set a new password.
Usage Examples
The following example enables password encryption for all passwords on the unit: (config)#service password-encryption
61200500L1-35E
314
Default Values
By default, the snmp-server chassis-id is set to Chassis ID.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 1.1 Command was introduced.
Usage Examples
The following example configures a chassis ID of A432692: (config)#snmp-server chassis-id A432692
61200500L1-35E
315
ro rw <listname>
Default Values
By default, there are no configured SNMP communities.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 1.1 Release 9.1 Command was introduced. view <viewname> option added.
Usage Examples
The following example specifies a community named MyCommunity, specifies a previously defined view named blockinterfaces, and assigns read-write access: (config)#snmp-server community MyCommunity view blockinterfaces rw
61200500L1-35E
316
Default Values
No default values necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 10.1 Command was introduced.
Usage Examples
The following example specifies 6536999 for the pager number: (config)#snmp-server contact pager 6536999
61200500L1-35E
317
Default Values
By default, the snmp-server contact is set to Customer Service.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 1.1 Command was introduced.
Usage Examples
The following example specifies Network Administrator x4000 for the sysContact string: (config)#snmp-server contact Network Administrator x4000
61200500L1-35E
318
snmp
Default Values
By default, there are no enabled traps.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 1.1 Command was introduced.
Usage Examples
The following example enables the SNMP traps: (config)#snmp-server enable traps snmp
61200500L1-35E
319
Default Values
By default, there are no hosts or traps enabled.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 1.1 Command was introduced.
Usage Examples
The following example sends all SNMP traps to the host at address 190.3.44.69 and community string My Community: (config)#snmp-server host 190.3.44.69 traps My Community snmp
61200500L1-35E
320
snmp-server host <address> traps version <version> <community> <trap type> [snmp]
Use the snmp-server host traps version command to specify traps sent to an identified host. Use multiple snmp-server host traps version commands to specify all desired hosts. Use the no form of this command to return to the default value. Syntax Description
<address> <version> Specifies the IP address of the SNMP host that receives the traps. Specifies the SNMP version as one of the following: 1 - SNMPv1 2C - SNMPv2C <community> <trap type> snmp Specifies the community string (used as a password) for authorized agents to obtain access to SNMP information. Specifies the type of notification trap to enable. Leaving this option blank enables ALL system traps. Optional. Enables a subset of traps specified in RFC1157. The following traps are supported: coldStart warmStart linkUp linkDown authenticationFailure
Default Values
By default, there are no hosts or traps enabled.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 1.1 Command was introduced.
Usage Examples
The following example sends all SNMP traps to the host at address 190.3.44.69 and community string My Community using SNMPv2C: (config)#snmp-server host 190.3.44.69 traps version 2c My Community snmp
61200500L1-35E
321
Default Values
By default, the snmp-server location is set to ADTRAN.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 1.1 Command was introduced.
Usage Examples
The following example specifies a location of 5th Floor Network Room: (config)#snmp-server location 5th Floor Network Room
61200500L1-35E
322
Default Values
No default is necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000 and Total Access 900 Series units.
Command History
Release 8.1 Command was introduced.
Usage Examples
The following example specifies the URL http://www.mywatch.com as the devices management software: (config)#snmp-server management-url http://www.mywatch.com
61200500L1-35E
323
Default Values
No default is necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000 and Total Access 900 Series units.
Command History
Release 8.1 Command was introduced.
Usage Examples
The following example specifies the label watch for the management software: (config)#snmp-server management-url-label watch
61200500L1-35E
324
Default Values
By default, there are no trap-source interfaces defined.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 7.1 Command was introduced.
Usage Examples
The following example specifies that the Ethernet interface (ethernet 0/1) should be the source for all SNMP traps and get/set requests: (config)#snmp-server source-interface ethernet 0/1
61200500L1-35E
325
excluded included
Default Values
No default value necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 9.1 Command was introduced.
Usage Examples
The snmp-server view command can include or exclude a group of OIDs. The following example shows how to create a view (named blockInterfaces) to exclude the OID subtree family 1.3.3.1.2.1.2: (config)#snmp-server view blockInterfaces 1.3.6.1.2.1.2.* excluded The following example shows how to create a view (named block) to include a specific OID: (config)#snmp-server view block 1.3.6.1.2.1.2. included
61200500L1-35E
326
Default Values
By default, the retry timeout is set to 5 seconds.
Applicable Platforms
This command applies to the NetVanta 300, 1000, and 1000R and Total Access 900 Series units.
Command History
Release 8.1 Command was introduced.
Usage Examples
The following example sets the SNTP retry timeout to 10 seconds: (config)#sntp retry-time 10
61200500L1-35E
327
Default Values
By default, NTP version is set to 1.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 3.1 Command was introduced.
Usage Examples
The following example sets the SNTP server to time.nist.gov using SNTP version 1 (the default version): (config)#sntp server time.nist.gov The following example sets the SNTP server as time.nist.gov. All requests for time use version 2 of the SNTP: (config)#sntp server time.nist.gov version 2
61200500L1-35E
328
Default Values
By default, the wait time is set to 86400 seconds (1 day).
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R and Total Access 900 Series units.
Command History
Release 8.1 Command was introduced.
Usage Examples
The following example sets the SNTP wait time to two days: (config)#sntp wait-time 172800
61200500L1-35E
329
Default Values
Disabled by default.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 5.1 Command was introduced.
Functional Notes
The BPDU filter blocks any BPDUs from being transmitted and received on an interface. This can be overridden on an individual port.
Usage Examples
The following example enables the bpdufilter on all ports by default: (config)#spanning-tree edgeport bpdufilter default To disable the BPDU filter on a specific interface, issue the appropriate commands for the given interface using the following commands as an example: (config)#interface ethernet 0/1 (config-eth 0/1)#spanning-tree bpdufilter disable
61200500L1-35E
330
Default Values
Disabled by default.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 5.1 Command was introduced.
Functional Notes
The bpduguard blocks any BPDUs from being received on an interface. This can be overridden on an individual port.
Usage Examples
The following example enables the BPDU guard on all ports by default. (config)#spanning-tree bpduguard default To disable the BPDU guard on a specific interface, issue the appropriate commands for the given interface using the following commands as an example: (config)#interface ethernet 0/1 (config-eth 0/1)#spanning-tree bpduguard disable
61200500L1-35E
331
Default Values
Disabled by default.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 3000, and 4000 and Total Access 900 Series units.
Command History
Release 5.1 Command was introduced.
Usage Examples
The following example configures all interfaces running spanning tree to be edgeports by default: (config)#spanning-tree edgeport default An individual interface can be configured to not be considered an edgeport. For example: (config)#interface ethernet 0/1 (config-eth 0/1)#spanning-tree edgeport disable or (config)#interface ethernet 0/1 (config-eth 0/1)#no spanning-tree edgeport
61200500L1-35E
332
Default Values
By default, the forwarding delay is set to 15 seconds.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 5.1 Command was introduced.
Usage Examples
The following example sets the forwarding time to 18 seconds: (config)#spanning-tree forward-time 18
61200500L1-35E
333
Default Values
By default, the delay is set to 2 seconds.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 5.1 Command was introduced.
Usage Examples
The following example configures a spanning-tree hello-time interval of 10,000 seconds: (config)#spanning-tree hello-time 10000
61200500L1-35E
334
Default Values
By default, the wait interval is set at 20 seconds.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 5.1 Command was introduced.
Usage Examples
The following example configures a wait interval of 45 seconds: (config)#spanning-tree max-age 45
61200500L1-35E
335
Default Values
By default, spanning-tree mode is set to rstp.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 5.1 Command was introduced.
Usage Examples
The following example sets the spanning-tree mode to rapid spanning-tree protocol: (config)#spanning-tree mode rstp
61200500L1-35E
336
Default Values
By default, spanning-tree pathcost is set to short.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 5.1 Command was introduced.
Usage Examples
The following example specifies that the spanning-tree protocol use a long pathcost method: (config)#spanning-tree pathcost method long
61200500L1-35E
337
Default Values
By default, the priority level is set to 32768.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 5.1 Command was introduced.
Usage Examples
The following example sets spanning-tree priority to the maximum level: (config)#spanning-tree priority 0
61200500L1-35E
338
Default Values
By default, stack vlan is 2386, and the stack IP network is 169.254.0.0/24.
Applicable Platforms
This command applies to the NetVanta 1000 and 1000R Series units.
Command History
Release 8.1 Command was introduced.
Usage Examples
The following are variations of the stack command: This example configures the unit to be the stack master and use the default stack VLAN and IP network. (config)#stack master 2000 This example configures the unit to be the stack master and use VLAN 2000 as the management VLAN and 192.168.1.0/24 as the management network. (config)#stack master 2000 192.168.1.0 255.255.255.0
61200500L1-35E
339
This example adds the switch with the CPU MAC address 00:A0:C8:00:8C:20 to the stack; also assigns the number 2 as the new stack member's unit ID. (config)#stack member 00:A0:C8:00:8C:20 2 This example specifies that this unit is in the stack using VLAN 2000 as its management VLAN; also specifies that this unit is in stack member mode (not a stack-master). (config)#stack vlan 2000
61200500L1-35E
340
tacacs-server
Use the tacacs-server command to customize setting for communication with TACACS servers. Use the no form of this command to return to default settings. Variations of this command include the following: tacacs-server host <hostname or IP address> tacacs-server host <hostname or IP address> key <key> tacacs-server host <hostname or IP address> port <TCP port> tacacs-server host <hostname or IP address> timeout <seconds> tacacs-server key <key> tacacs-server packet maxsize <maximum packet size> tacacs-server timeout <seconds> Syntax Description<
Specifies the IP host by name or IP address. Sets an encryption string to be used for encrypting and decrypting the traffic between the Network Access Server (NAS) and the TACACS+ daemon. Setting a key for a particular server (using the tacacs-server host <name/IP> key <key> command) supersedes keys set globally using the tacacs-server key <key> command. port <tcp port> Specifies the TCP port number to be used when connecting to the TACACS+ daemon. timeout <seconds> Specifies a timeout limit (in seconds) that the unit will wait for a response from the daemon before declaring an error. Range is 1 to 1000 seconds. Setting a timeout for a particular server (using the tacacs-server host <name/IP> timeout <seconds> command) supersedes time limits set globally using the tacacs-server timeout <seconds> command. packet maxsize <size> Specifies a maximum packet size for this server. Range is 10,240 to 65,535. host <name/IP> key <key>
Default Values
By default, the key is set to key and the default TCP port number is 49.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 11.1 Command was introduced.
Usage Examples
The following example sets a timeout limit of 60 seconds for the specified server: (config)#tacacs-server host 10.5.6.7 timeout 60
61200500L1-35E
341
Default Values
By default, there is no established username and password.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 1.1 Command was introduced.
Functional Notes
All users defined using the username/password command are valid for access to the unit using the login local-userlist command.
Usage Examples
The following example creates a username of ADTRAN with password ADTRAN: (config)#username ADTRAN password ADTRAN
61200500L1-35E
342
Default Values
No defaults necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, and 2000 Series units.
Command History
Release 5.1 Command was introduced.
Usage Examples
The following example enters the VLAN configuration mode for VLAN 1: (config)#vlan 1 (config-vlan 1)#
61200500L1-35E
343
The following commands are common to multiple command sets and are covered in a centralized section of this guide. For more information, refer to the sections listed below: cross-connect <#> <from interface> <slot/port> <tdm-group#> <to interface> <slot/port> on page 26 do on page 30 end on page 31 exit on page 32 All other commands for this command set are described in this section in alphabetical order. accounting commands [<level> l <name> l default] on page 345 authorization commands [<level> l <name> l default] on page 346 databits [7 | 8] on page 347 flowcontrol [none | software in] on page 348 line-timeout <minutes> on page 349 login on page 350 login authentication <aaa login list> on page 351 login local-userlist on page 352 parity [even | mark | none | odd | space] on page 353 password [md5] <password> on page 354 speed <rate> on page 355 stopbits [1 | 2] on page 356
61200500L1-35E
344
Default Values
The default for this command is off.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 11.1 Command was introduced.
Usage Examples
The following example applies the default accounting method to line 1: (config)#aaa on (config)#line console 0 (config-con0)#accounting commands 1 default
61200500L1-35E
345
Default Values
The default for this command is off.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 11.1 Command was introduced.
Usage Examples
The following example applies the default authorization method to line 1: (config)#aaa on (config)#line console 0 (config-con0)#authorization commands 1 default
61200500L1-35E
346
databits [7 | 8]
Use the databits command to set the number of databits per character for a terminal session. This value must match the configuration of your VT100 terminal or terminal emulator software. The default is 8 databits per character. Use the no form of this command to return to the default value. Syntax Description
7 8 Specifies 7 data bits per character. Specifies 8 data bits per character.
Default Values
By default, the databits are set to 8.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 1.1 Command was introduced.
Usage Examples
The following example configures 7 databits per character for the console terminal session: (config)#line console 0 (config-con 0)#databits 7
61200500L1-35E
347
Default Values
By default, flow control is set to none.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 3.1 Command was introduced.
Usage Examples
The following example configures no flow control for the line console: (config)#line console 0 (config-con 0)#flowcontrol none
61200500L1-35E
348
line-timeout <minutes>
Use the line-timeout command to specify the number of minutes a line session may remain inactive before the AOS terminates the session. Use the no form of this command to return to the default value. Syntax Description
<minutes> Specifies the number of minutes a line session may remain inactive before the AOS terminates the session. Entering a line-timeout value of 0 disables the feature.
Default Values
By default the line-timeout is set to 15 minutes (Console and Telnet).
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 1.1 Command was introduced.
Usage Examples
The following example specifies a timeout of 2 minutes: (config)#line console 0 (config-con 0)#line-timeout 2
61200500L1-35E
349
login
Use the login command to enable security login on the line session requiring the password configured using the password command. Use the no form of this command to disable the login feature. Syntax Description
No subcommands.
Default Values
By default, there is no login password set for access to the unit.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 1.1 Command was introduced.
Usage Examples
The following example enables the security login feature and specifies a password on the available console session: (config)#line console 0 (config-console 0)#login (config-console 0)#password mypassword
61200500L1-35E
350
Default Values
The default value is the default AAA list.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 5.1 Command was introduced.
Functional Notes
If the AAA subsystem is activated but no login authentication list is given, the default list is used. If the default list is used but the default list is not configured, the behavior for consoles is to be granted access. This prevents a lockout configuration.
Usage Examples
The following example specifies that myList will be used for authenticating users connecting on this line: (config)#line console 0 (config-con 0)#login authentication myList
61200500L1-35E
351
login local-userlist
Use the login local-userlist command to enable security login for the terminal session requiring the usernames and passwords configured using the username/password Global Configuration command. Use the no form of this command to disable the login local-userlist feature. All user properties assigned using the username/password command are valid when using the login local-userlist command.
Syntax Description
No subcommands.
Default Values
By default, there is no login password set for access to the unit.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 1.1 Command was introduced.
Usage Examples
The following example displays creating a local userlist and enabling the security login feature on the CONSOLE port: (config)#username my_user password my_password (config)#line console 0 (config-con 0)#login local-userlist When connecting to the unit, the following prompts are displayed: User Access Login Username: ADTRAN Password: Router#
61200500L1-35E
352
Default Values
By default, the parity option is set to none.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 1.1 Command was introduced.
Functional Notes
Parity is the process used to detect whether characters have been altered during the data transmission process. Parity bits are appended to data frames to ensure that parity (whether it be odd or even) is maintained.
Usage Examples
The following example specifies mark parity for the console terminal session: (config)#line console 0 (config-con 0)#parity mark
61200500L1-35E
353
<password>
Default Values
By default, there is no login password set for access to the unit.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 1.1 Release 6.1 Command was introduced. Added encryption.
Usage Examples
The following example enables the security login feature and specifies a password on the CONSOLE port: (config)#line console 0 (config-con 0)#login (config-con 0)#password mypassword To provide extra security, the AOS can encrypt the enable password when displaying the current configuration. For example, the following is a show configuration printout (password portion) with an unencrypted enable password (ADTRAN): ! enable password ADTRAN ! Alternately, the following is a show configuration printout (password portion) with an enable password of ADTRAN using md5 encryption: ! enable password md5 encrypted 5aa5fbae7d01a90e79fb57705ce74676 !
61200500L1-35E
354
speed <rate>
Use the speed command to specify the data rate for the CONSOLE port. This setting must match your VT100 terminal emulator or emulator software. Use the no form of this command to restore the default value. Syntax Description
<rate> Specifies rate of data transfer on the interface (2400; 4800; 9600; 19,200; 38,400; 57,600; or 115,200 bps).
Default Values
By default, the speed is set to 9600 bps.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 1.1 Command was introduced.
Usage Examples
The following example configures the CONSOLE port for 19200 bps: (config)#line console 0 (config-con 0)#speed 19200
61200500L1-35E
355
stopbits [1 | 2]
Use the stopbits command to set the number of stopbits per character for a terminal session. This value must match the configuration of your VT100 terminal or terminal emulator software. The default is 1 stopbit per character. Use the no form of this command to return to the default value. Syntax Description
1 2 Specifies 1 stopbit per character. Specifies 2 stopbits per character.
Default Values
By default, the stopbits are set to 1.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 1.1 Command was introduced.
Usage Examples
The following example configures 2 stopbits per character for the console terminal session: (config)#line console 0 (config-con 0)#stopbits 2
61200500L1-35E
356
You can select a single line by entering the line ssh command followed by the line number (0-4). For example:
>enable #configure terminal (config)#line ssh 2 (config-ssh2)#
The following commands are common to multiple command sets and are covered in a centralized section of this guide. For more information, refer to the sections listed below: do on page 30 end on page 31 exit on page 32 shutdown on page 33 All other commands for this command set are described in this section in alphabetical order. access-class <listname> in on page 358 accounting commands [<level> l <name> l default] on page 359 authorization commands [<level> l <name> l default] on page 360 line-timeout <minutes> on page 361 login on page 362 login authentication <aaa login list> on page 363 login local-userlist on page 364
61200500L1-35E
357
access-class <listname> in
Use the access-class in command to restrict Secure Shell (SSH) access using a configured access list. Received packets passed by the access list will be allowed. Use the access list configuration to deny hosts or entire networks or to permit specified IP addresses. See ip access-list standard <listname> [permit | deny] <ip address> on page 256 and ip access-list extended <listname> on page 250 for more information about configuring access lists. Syntax Description
<listname> Identifies the configured access list using an alphanumeric descriptor (all access list descriptors are case-sensitive).
Default Values
By default, there are no configured access lists associated with SH sessions.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 11.1 Command was introduced.
Functional Notes
When using the access-class in command to associate an access list with an SSH session, remember to duplicate the access-class in command for all configured SSH sessions 0 through 4. SSH access to the unit using a particular SSH session is not possible. Users will be assigned the first available SSH session.
Usage Examples
The following example associates the access list Trusted (to allow SSH sessions from the 192.22.56.0/24 network) with all SSH sessions (0 through 4): Create the access list: (config)#ip access-list standard Trusted (config)#permit 192.22.56.0 0.0.0.255 Enter the line (ssh) : (config)#line ssh 0 4 Associate the access list with the SSH session: (config-ssh0-4)#access-class Trusted in
61200500L1-35E
358
Default Values
The default for this command is off.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 11.1 Command was introduced.
Usage Examples
The following example applies the default accounting method to line 1: (config)#aaa on (config)#line ssh 1 (config-ssh1)#accounting commands 1 default
61200500L1-35E
359
Default Values
The default for this command is off.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 11.1 Command was introduced.
Usage Examples
The following example applies the default authorization method to line 1: (config)#aaa on (config)#line ssh 1 (config-ssh1)#authorization commands 1 default
61200500L1-35E
360
line-timeout <minutes>
Use the line-timeout command to specify the number of minutes a line session may remain inactive before the AOS terminates the session. Use the no form of this command to return to the default value. Syntax Description
<minutes> Specifies the number of minutes a line session may remain inactive before the AOS terminates the session. Valid range: 0 to 35791. Entering a line-timeout value of 0 disables the feature.
Default Values
By default the line-timeout is set to 15 minutes.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 11.1 Command was introduced.
Usage Examples
The following example specifies a timeout of 2 minutes for all SSH sessions: (config)#line ssh 0 4 (config-ssh0-4)#line-timeout 2
61200500L1-35E
361
login
Use the login command to enable security login on the line session requiring the password configured using the password command. Use the no form of this command to disable the login feature. Syntax Description
No subcommands.
Default Values
By default, there is no login password set for access to the unit.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 11.1 Command was introduced.
Usage Examples
The following example enables the security login feature and specifies a password on all the available SSH sessions (0 through 4): (config)#line ssh 0 4 (config-ssh0-4)#login (config-ssh0-4)#password mypassword
61200500L1-35E
362
Default Values
The default value is the default AAA list.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 11.1 Command was introduced.
Functional Notes
If the AAA subsystem is activated but no login authentication list is given, the default list is used. If the default list is used but the default list is not configured, SSH uses the local user database.
Usage Examples
The following example specifies that myList will be used for authenticating users connecting on this line: (config)#line ssh 2 (config-ssh2)#login authentication myList
61200500L1-35E
363
login local-userlist
Use the login local-userlist command to check the local list of usernames and passwords configured using the username/password Global Configuration command (see username <username> password <password> on page 342). Use the no form of this command to disable the login local-userlist feature. All user properties assigned using the username/password command are valid when using the login local-userlist command.
Syntax Description
No subcommands.
Default Values
By default, there is no login password set for access to the unit.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 11.1 Command was introduced.
Usage Examples
The following example creates a local userlist and enables the security login feature: (config)#username my_user password my_password (config)#line ssh 0 (config-ssh0)#login local-userlist When connecting to the unit, the following prompts are displayed: User Access Login Username: my_user Password: #
61200500L1-35E
364
You can select a single line by entering the line telnet command followed by the line number (0-4). For example:
>enable #configure terminal (config)#line telnet 2 (config-telnet2)#
The following commands are common to multiple command sets and are covered in a centralized section of this guide. For more information, refer to the sections listed below: cross-connect <#> <from interface> <slot/port> <tdm-group#> <to interface> <slot/port> on page 26 do on page 30 end on page 31 exit on page 32 shutdown on page 33 All other commands for this command set are described in this section in alphabetical order. access-class <listname> in on page 366 accounting commands [<level> l <name> l default] on page 367 authorization commands [<level> l <name> l default] on page 368 line-timeout <minutes> on page 369 login on page 370 login authentication <aaa login list> on page 371 login local-userlist on page 372 password [md5] <password> on page 373
61200500L1-35E
365
access-class <listname> in
Use the access-class in command to restrict Telnet access using a configured access list. Received packets passed by the access list will be allowed. Use the access list configuration to deny hosts or entire networks or to permit specified IP addresses. See ip access-list standard <listname> [permit | deny] <ip address> on page 256 and ip access-list extended <listname> on page 250 for more information about configuring access lists. Syntax Description
<listname> Identifies the configured access list using an alphanumeric descriptor (all access list descriptors are case-sensitive).
Default Values
By default, there are no configured access lists associated with Telnet sessions.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 1.1 Command was introduced.
Functional Notes
When using the access-class in command to associate an access list with a Telnet session, remember to duplicate the access-class in command for all configured Telnet sessions 0 through 4. Telnet access to the unit using a particular Telnet session is not possible. Users will be assigned the first available Telnet session.
Usage Examples
The following example associates the access list Trusted (to allow Telnet sessions from the 192.22.56.0/24 network) with all Telnet sessions (0 through 4): Create the access list: (config)#ip access-list standard Trusted (config)#permit 192.22.56.0 0.0.0.255 Enter the line (telnet): (config)#line telnet 0 4 Associate the access list with the Telnet session: (config-telnet0-4)#access-class Trusted in
61200500L1-35E
366
Default Values
The default for this command is off.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 11.1 Command was introduced.
Usage Examples
The following example applies the default accounting method to Telnet session 1: (config)#aaa on (config)#line telnet 1 (config-telnet1)#accounting commands 1 default
61200500L1-35E
367
Default Values
The default for this command is off.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 11.1 Command was introduced.
Usage Examples
The following example applies the default authorization method to line 1: (config)#aaa on (config)#line telnet 1 (config-telnet1)#authorization commands 1 default
61200500L1-35E
368
line-timeout <minutes>
Use the line-timeout command to specify the number of minutes a line session may remain inactive before the AOS terminates the session. Use the no form of this command to return to the default value. Syntax Description
<minutes> Specifies the number of minutes a line session may remain inactive before the AOS terminates the session. Entering a line-timeout value of 0 disables the feature.
Default Values
By default the line-timeout is set to 15 minutes (Console and Telnet).
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 1.1 Command was introduced.
Usage Examples
The following example specifies a timeout of 2 minutes: (config)#line telnet 0 (config-telnet0)#line-timeout 2
61200500L1-35E
369
login
Use the login command to enable security login on the line session requiring the password configured using the password command. Use the no form of this command to disable the login feature. Syntax Description
No subcommands.
Default Values
By default, there is no login password set for access to the unit.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 1.1 Command was introduced.
Usage Examples
The following example enables the security login feature and specifies a password on all the available Telnet sessions (0 through 4): (config)#line telnet 0 4 (config-telnet0-4)#login (config-telnet0-4)#password mypassword
61200500L1-35E
370
Default Values
The default value is the default AAA list.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 5.1 Command was introduced.
Functional Notes
If the AAA subsystem is activated but no login authentication list is given, the default list is used. If the default list is used but the default list is not configured, the behavior for telnets is to use the local user database.
Usage Examples
The following example specifies that myList will be used for authenticating users connecting on this line: (config)#line telnet 2 (config-telnet2)#login authentication myList
61200500L1-35E
371
login local-userlist
Use the login local-userlist command to enable security login for the terminal session requiring the usernames and passwords configured using the username/password Global Configuration command. Use the no form of this command to disable the login local-userlist feature. All user properties assigned using the username/password command are valid when using the login local-userlist command.
Syntax Description
No subcommands.
Default Values
By default, there is no login password set for access to the unit.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 1.1 Command was introduced.
Usage Examples
The following example displays creating a local userlist and enabling the security login feature: (config)#username my_user password my_password (config)#line telnet 0 (config-telnet0)#login local-userlist When connecting to the unit, the following prompts are displayed: User Access Login Username: my_user Password: Router#
61200500L1-35E
372
<password>
Default Values
By default, there is no login password set for access to the unit.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 1.1 Command was introduced.
Usage Examples
The following example enables the security login feature and specifies a password for the Telnet session 0: (config)#line telnet 0 (config-telnet0)#login (config-telnet0)#password mypassword To provide extra security, the AOS can encrypt the enable password when displaying the current configuration. For example, the following is a show configuration printout (password portion) with an unencrypted enable password (ADTRAN): ! enable password ADTRAN ! Alternately, the following is a show configuration printout (password portion) with an enable password of ADTRAN using md5 encryption: ! enable password md5 encrypted 5aa5fbae7d01a90e79fb57705ce74676
61200500L1-35E
373
To activate the basic Ethernet Interface Configuration mode, enter the interface ethernet command at the Global Configuration mode prompt. For example:
>enable #configure terminal (config)#interface ethernet 0/1 (config-eth 0/1)#
To activate the Gigabit Ethernet Interface Configuration mode, enter the interface gigabit-ethernet command at the Global Configuration mode prompt. For example:
>enable #configure terminal (config)#interface gigabit-ethernet 0/3 (config-giga-eth 0/3)#
To activate the Ethernet Sub-Interface Configuration mode, enter the interface ethernet command at the Global Configuration mode prompt. For example:
>enable #configure terminal (config)#interface ethernet 0/1.1 (config-eth 0/1.1)#
To activate the Ethernet Configuration mode for a range of Ethernet interfaces, enter the interface range command at the Global Configuration mode prompt. For example:
>enable #configure terminal (config)#interface range ethernet 0/1, 0/8 (config-eth 0/1, 0/8)#
61200500L1-35E
374
Not all Ethernet commands apply to all Ethernet types. Use the ? command to display a list of valid commands. For example: >enable Password:xxxxx #config term (config)#int eth 0/1 (config-eth 0/1)#? access-policy - Assign access control policy for this interface alias - A text name assigned by an SNMP NMS arp - Set ARP commands bandwidth - Set bandwidth informational parameter bridge-group - Assign the current interface to a bridge group etc.... The following commands are common to multiple command sets and are covered in a centralized section of this guide. For more information, refer to the sections listed below: alias <text> on page 25 description <text> on page 29 do on page 30 end on page 31 exit on page 32 shutdown on page 33 All other commands for this command set are described in this section in alphabetical order. arp arpa on page 377 channel-group <group#> mode on on page 378 dynamic-dns [dyndns | dyndns-custom | dyndns-static] <hostname> <username> <password> on page 379 full-duplex on page 381 half-duplex on page 383 lldp receive on page 384 lldp send [management-address l port-description l system-capabilities l system-description l system-name l and-receive] on page 385 port-auth auth-mode [mac-based | port-based] on page 387 port-auth control-direction [both | in] on page 388
61200500L1-35E
375
port-auth multiple-hosts on page 389 port-auth port-control [auto | force-authorized | force-unauthorized] on page 390 power inline [auto | legacy | never] on page 391 qos [trust cos | default-cos <cos value>] on page 392 snmp trap on page 393 snmp trap link-status on page 394 spanning-tree commands begin on page 395 speed [10 | 100 | auto | nonegotiate] on page 401 storm-control [broadcast level | multicast level | unicast level] <rising level> <falling level>] on page 402 storm-control action [shutdown] on page 404 switchport commands begin on page 405
61200500L1-35E
376
arp arpa
Use the arp arpa command to enable address resolution protocol (ARP) on the Ethernet interface. Syntax Description
arpa Sets standard address resolution protocol for this interface.
Default Values
The default for this command is arpa.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 3.1 Release 5.1 Command was introduced. Command was expanded to include Ethernet sub-interfaces and Gigabit Ethernet interfaces.
Usage Examples
The following example enables standard ARP for the Ethernet interface: (config)#interface eth 0/1 (config-eth 0/1)#arp arpa
61200500L1-35E
377
Default Values
By default, the interface is not part of a channel group.
Applicable Platforms
This command applies to the NetVanta 300, 1000, and 1000R Series units.
Command History
Release 5.1 Command was introduced.
Functional Notes
There can be up to six channel groups with 2-8 interfaces per group. Dynamic protocols are not yet supported (only static). A physical interface can be a member of only one channel group.
Usage Examples
The following example adds the Ethernet 0/1 interface to channel group 1: (config)#interface eth 0/1 (config-eth 0/1)#channel-group 1 mode on (config-eth 0/1)#
61200500L1-35E
378
Default Values
No default is necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 8.1 Command was introduced.
Functional Notes
dyndns - The Dynamic DNSSM service allows you to alias a dynamic IP address to a static hostname in various domains. This allows your unit to be more easily accessed from various locations on the Internet. This service is provided for up to five hostnames. dyndns-custom - DynDNS.org's Custom DNSSM service provides a full DNS solution, giving you complete control over an entire domain name. A web-based interface provides two levels of control over your domain, catering to average or advanced users. Five globally redundant DNS servers ensure that your domain will always resolve. A choice of two interfaces is available. The basic interface is designed for most users. It comes preconfigured for the most common configuration and allows for easy creation of most common record types. The advanced interface is designed for system administrators with a solid DNS background, and provides layout and functionality similar to a BIND zone file allowing for the creation of nearly any record type. Custom DNSSM can be used with both static and dynamic IPs and has the same automatic update capability through Custom DNS-aware clients as Dynamic DNS. dyndns-static - The Static DNS service is similar to Dynamic DNS service in that it allows a hostname such as yourname.dyndns.org to point to your IP address. Unlike a Dynamic DNS host, a Static DNS host does not expire after 35 days without updates, but updates take longer to propagate though the DNS system. This service is provided for up to five hostnames.
61200500L1-35E
379
If your IP address does not change often or at all but you still want an easy name to remember it by (without having to purchase your own domain name), Static DNS service is ideal for you. If you would like to use your own domain name (such as yourname.com), you need Custom DNS service which also provides full dynamic and static IP address support. Usage Examples The following example sets the dynamic-dns to dyndns-custom with hostname host, username user, and password pass: (config)#interface eth 0/1 (config-eth 0/1)#dynamic-dns dyndns-custom host user pass
61200500L1-35E
380
full-duplex
Use the full-duplex command to configure the Ethernet interface for full-duplex operation. This allows the interface to send and receive simultaneously. Use the no form of this command to return to the default half-duplex operation. Syntax Description
No subcommands.
Default Values
By default, all Ethernet interfaces are configured for half-duplex operation.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 1.1 Command was introduced.
Functional Notes
Full-duplex Ethernet is a variety of Ethernet technology currently being standardized by the IEEE. Because there is no official standard, vendors are free to implement their independent versions of full-duplex operation. Therefore, it is not safe to assume that one vendors equipment will work with another. Devices at each end of a full-duplex link have the ability to send and receive data simultaneously over the link. Theoretically, this simultaneous action can provide twice the bandwidth of normal (half-duplex) Ethernet. To deploy full-duplex Ethernet, each end of the link must only connect to a single device (a workstation or a switched hub port). With only two devices on a full-duplex link, there is no need to use the medium access control mechanism (to share the signal channel with multiple stations) and listen for other transmissions or collisions before sending data.
If the speed is manually set to 10 or 100, the duplex must be manually configured as full-duplex or half-duplex. Refer to speed [10 | 100 | auto | nonegotiate] on page 401 for more information.
The 10BaseT, 100BaseTX, and 100BaseFX signalling systems support full-duplex operation (because they have transmit and receive signal paths that can be simultaneously active).
61200500L1-35E
381
Usage Examples
The following example configures the Ethernet interface for full-duplex operation: (config)#interface ethernet 0/1 (config-eth 0/1)#full-duplex
61200500L1-35E
382
half-duplex
Use the half-duplex command to configure the Ethernet interface for half-duplex operation. This setting allows the Ethernet interface to either send or receive at any given moment, but not simultaneously. Use the no form of this command to disable half-duplex operation. Syntax Description
No subcommands.
Default Values
By default, all Ethernet interfaces are configured for half-duplex operation.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 1.1 Command was introduced.
Functional Notes
Half-duplex Ethernet is the traditional form of Ethernet that employs the Carrier Sense Multiple Access/Collision Detect (CSMA/CD) protocol to allow two or more hosts to share a common transmission medium while providing mechanisms to avoid collisions. A host on a half-duplex link must listen on the link and only transmit when there is an idle period. Packets transmitted on the link are broadcast (so it will be heard by all hosts on the network). In the event of a collision (two hosts transmitting at once), a message is sent to inform all hosts of the collision and a backoff algorithm is implemented. The backoff algorithm requires the station to remain silent for a random period of time before attempting another transmission. This sequence is repeated until a successful data transmission occurs.
If the speed is manually set to 10 or 100, the duplex must be manually configured as full-duplex or half-duplex. Refer to speed [10 | 100 | auto | nonegotiate] on page 401 for more information. Usage Examples
The following example configures the Ethernet interface for half-duplex operation: (config)#interface ethernet 0/1 (config-eth 0/1)#half-duplex
61200500L1-35E
383
lldp receive
Use the lldp receive command to allow LLDP packets to be received on this interface. Syntax Description
No subcommands.
Default Values
By default, all interfaces are configured to send and receive LLDP packets.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 8.1 Command was introduced.
Usage Examples
The following example configures Ethernet interface 0/1 to receive LLDP packets: (config)#interface eth 0/1 (config-eth 0/1)#lldp receive
61200500L1-35E
384
Default Values
Be default, all interfaces are configured to transmit and receive LLDP packets of all types.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 8.1 Command was introduced.
Functional Notes
Individual LLDP information can be enabled or disabled using the various forms of the lldp send command. For example, use the lldp send and-receive command to enable transmit and receive of all LLDP information. Then use the no lldp send port-description command to prevent LLDP from transmitting port description information.
61200500L1-35E
385
Usage Examples
The following example configures Ethernet interface 0/1 to transmit LLDP packets containing all enabled information types: (config)#interface eth 0/1 (config-eth 0/1)#lldp send The following example configures Ethernet interface 0/1 to transmit and receive LLDP packets containing all information types: (config)#interface eth 0/1 (config-eth 0/1)#lldp send-and-receive
61200500L1-35E
386
Default Values
By default, the authentication mode is port-based.
Applicable Platforms
This command applies to the NetVanta 1000 and 1000R Series units.
Command History
Release 10.1 Command was introduced.
Usage Examples
The following example configures the unit for MAC-based authentication mode: (config)#interface ethernet 0/1 (config-eth 0/1)#port-auth auth-mode mac-based
61200500L1-35E
387
Default Values
By default, traffic is blocked in both directions.
Applicable Platforms
This command applies to the NetVanta 1000 and 1000R Series units.
Command History
Release 10.1 Command was introduced.
Usage Examples
The following example causes traffic to be blocked in both directions when the port becomes unauthorized: (config)#interface ethernet 0/1 (config-eth 0/1)#port-auth control-direction both
61200500L1-35E
388
port-auth multiple-hosts
Use the port auth multiple-hosts command to allow multiple hosts to access an authorized port without going through the authentication process. This command is only applicable when authentication is port-based. Use the no form of this command to return to the default settings. Syntax Description
No subcommands.
Default Values
By default, this command is disabled.
Applicable Platforms
This command applies to the NetVanta 1000 and 1000R Series units.
Command History
Release 10.1 Command was introduced.
Usage Examples
The following example enables multiple hosts to access an authorized port: (config)#interface ethernet 0/1 (config-eth 0/1)#port-auth multiple-hosts
61200500L1-35E
389
Default Values
By default, all ports are forced to an authorized state.
Applicable Platforms
This command applies to the NetVanta 1000 and 1000R Series units.
Command History
Release 10.1 Command was introduced.
Usage Examples
The following example forces Ethernet port 0/1 into an unauthorized state: (config)#interface ethernet 0/1 (config-eth 0/1)#port-auth port-control force unauthorized
61200500L1-35E
390
Default Values
By default, PWR switches discover and provide power to IEEE compliant PDs.
Applicable Platforms
This command applies to the NetVanta 1000 and 1000R Power over Ethernet Series units.
Command History
Release 9.1 Command was introduced.
Usage Examples
The following example configures the ethernet interface to detect and supply power to PDs: (config)#interface ethernet 0/3 (config-eth 0/3)#power inline auto
61200500L1-35E
391
Default Values
By default, the interface is untrusted with a default CoS of 0.
Applicable Platforms
This command applies to the NetVanta 300, 1000, and 1000R Series units.
Command History
Release 5.1 Command was introduced.
Functional Notes
Set the interface to trust cos if received 802.1P CoS values are considered valid (i.e., no need to reclassify) and do not need to be tagged with the default value. When set to untrusted, the default-cos value for the interface is used.
Usage Examples
The following example sets eth 0/1 as a trusted interface and assigns untagged packets a CoS value of 1: (config)#interface eth 0/1 (config-eth 0/1)#qos trust cos (config-eth 0/1)#qos default-cos 1
61200500L1-35E
392
snmp trap
Use the snmp trap command to enable all supported Simple Network Management Protocol (SNMP) traps on the interface. Syntax Description
No subcommands.
Default Values
By default, all interfaces (except virtual Frame Relay interfaces and sub-interfaces) have SNMP traps enabled.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 1.1 Release 3.1 Release 5.1 Command was introduced. Command was extended to the SHDSL interface. Command was expanded to include Ethernet sub-interfaces and Gigabit Ethernet interfaces.
Usage Examples
The following example enables SNMP capability on the Ethernet interface: (config)#interface eth 0/1 (config-eth 0/1)#snmp trap
61200500L1-35E
393
Default Values
By default, the ifLinkUpDownTrapEnable OID is enabled for all interfaces except virtual Frame Relay interfaces.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 1.1 Release 3.1 Release 5.1 Command was introduced. Command was extended to the SHDSL interface. Command was expanded to include Gigabit Ethernet, port channel, VLAN, E1, and G.703 interfaces.
Functional Notes
The snmp trap link-status command is used to control the RFC2863 ifLinkUpDownTrapEnable OID (OID number 1.3.6.1.2.1.31.1.1.1.14.0).
Usage Examples
The following example disables the link-status trap on the interface: (config)#interface ethernet 0/1 (config-eth 0/1)#no snmp trap link-status
61200500L1-35E
394
Default Values
By default, this setting is disabled.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 5.1 Command was introduced.
Functional Notes
The bpdufilter blocks any BPDUs from being transmitted and received on an interface.
Usage Examples
The following example enables the BPDU filter on the interface eth 0/3: (config)#interface eth 0/3 (config-eth 0/3)#spanning-tree bpdufilter enable The BPDU filter can be disabled on the eth 0/3 by issuing the following commands: (config)#interface eth 0/3 (config-eth 0/3)#spanning-tree bpdufilter disable
61200500L1-35E
395
Default Values
By default, this setting is disabled.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 5.1 Command was introduced.
Functional Notes
The bpduguard blocks any BPDUs from being received on an interface.
Usage Examples
The following example enables the BPDU guard on the interface eth 0/3: (config)#interface eth 0/3 (config-eth 0/3)#spanning-tree bpduguard enable The BPDU guard can be disabled on the eth 0/3 by issuing the following commands: (config)#interface eth 0/3 (config-eth 0/3)#spanning-tree bpduguard disable
61200500L1-35E
396
spanning-tree edgeport
Use the spanning-tree edgeport command to configure the interface to be an edgeport. This command overrides the related Global setting (refer to spanning-tree edgeport default on page 332). Use the no version of the command to return to the default setting. Syntax Description
No subcommands.
Default Values
By default, this setting is disabled.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 5.1 Command was introduced.
Functional Notes
Enabling this command configures the interface to go to a forwarding state when the link becomes active. When not enabled, an interface must go through the listening and learning states before going to the forwarding state.
Usage Examples
The following example configures the interface to be an edgeport: (config)#interface eth 0/1 (config-eth 0/1)#spanning-tree edgeport An individual interface can be configured to not be considered an edgeport. For example: (config)#interface ethernet 0/1 (config-eth 0/1)#no spanning-tree edgeport
61200500L1-35E
397
Default Values
By default, the interface is set to auto.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 5.1 Command was introduced.
Functional Notes
This command overrides the default link type setting determined by the duplex of the individual port. By default, a port configured for half-duplex is set to shared link type, and a port configured for full-duplex is set to point-to-point link type. Setting the link type manually overrides the default and forces the port to use the specified link type. Use the link-type auto command to restore the convention of determining link type based on duplex settings.
Technology Review
Rapid transitions are possible in rapid spanning-tree protocol (RSTP) by taking advantage of point-to-point links (a port is connected to exactly one other bridge) and edge-port connections (a port is not connected to any additional bridges). Setting the link-type to auto allows the spanning-tree to automatically configure the link type based on the duplex of the link. Setting the link type to point-to-point allows a half-duplex link to act as if it were a point-to-point link.
Usage Examples
The following example forces the link type to point-to-point, even if the port is configured to be half-duplex: (config)#interface eth 0/3 (config-eth 0/3)#spanning-tree link-type point-to-point
61200500L1-35E
398
Default Values
By default, spanning-tree pathcost is set to short.
Applicable Platforms
This command applies to the NetVanta 1000, 1000R, 3000, 4000, and 5000 Series units.
Command History
Release 5.1 Command was introduced.
Usage Examples
The following example specifies that the spanning tree protocol use a long pathcost method: (config)#spanning-tree pathcost method long
61200500L1-35E
399
Default Values
By default, this set to 128.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 5.1 Command was introduced.
Functional Notes
The only time that this priority level is used is when two interfaces with a path to the root have equal cost. At that point, the level set in this command will determine which port the spanning tree will use. Set the priority value lower to increase the chance the interface will be used.
Usage Examples
The following example sets the interface to a priority of 100: (config)#interface eth 0/3 (config-eth 0/3)#spanning-tree port-priority 100
61200500L1-35E
400
If the speed is manually set to 10 or 100, the duplex must be manually configured as full-duplex or half-duplex.
Default Values
By default, speed is set to auto.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 1.1 Command was introduced.
Usage Examples
The following example configures the Ethernet port for 100 Mb operation: (config)#interface ethernet 0/1 (config-eth 0/1)#speed 100
61200500L1-35E
401
storm-control [broadcast level | multicast level | unicast level] <rising level> <falling level>]
Use the storm-control command to configure limits on the rates of broadcast, multicast, and unicast traffic on a port. To disable storm-control, use the no version of this command. Syntax Description
broadcast level multicast level unicast level <rising level> <falling level> Sets levels for broadcast traffic. Sets levels for multicast traffic. Sets levels for unicast traffic. Specifies a rising level which determines the percentage of total bandwidth the port accepts before it begins blocking packets. Range: 0 to 100 percent. Optional. Specifies a falling level which determines when the storm is considered over, causing the AOS to no longer block packets. This level must be less than the rising level. Range: 0 to 100 percent.
Default Values
By default, storm-control is disabled.
Applicable Platforms
This command applies to the NetVanta 300, 1000, and 1000R Series units.
Command History
Release 5.1 Command was introduced.
Functional Notes
This setting configures the rising and falling suppression values. When the selected rising level (which is a percentage of total bandwidth) is reached, the port begins blocking packets of the specified type (i.e., broadcast, multicast, or unicast). The AOS uses the rising level as its falling level if no falling level is specified.
61200500L1-35E
402
Usage Examples
The following example sets the rising suppression level to 85 percent for multicast packets: (config)#interface eth 0/1 (config-eth 0/1)#storm-control multicast level 85 The following example sets the rising suppression level to 80 percent for broadcast packets, with a falling level of 50 percent: (config)#interface eth 0/1 (config-eth 0/1)#storm-control broadcast level 80 50
61200500L1-35E
403
Default Values
By default, this command is disabled; the interface will only filter traffic.
Applicable Platforms
This command applies to the NetVanta 300, 1000, and 1000R Series units.
Command History
Release 5.1 Command was introduced.
Functional Notes
Enabling this option shuts down the interface if a multicast, unicast, or broadcast storm occurs.
Usage Examples
The following example shuts down Ethernet interface 0/1 if a storm is detected: (config)#interface eth 0/1 (config-eth 0/1)#storm-control action shutdown
61200500L1-35E
404
Default Values
By default, this is set to VLAN 1 (the default VLAN).
Applicable Platforms
This command applies to the NetVanta 300, 1000, and 1000R Series units.
Command History
Release 5.1 Command was introduced.
Functional Notes
If the port is in the trunk mode, this command will not alter the switchport mode to access. Instead it will save the value to be applied when the port does switch to access mode. Refer to switchport mode [access | stack | trunk] on page 407 for more information.
Usage Examples
The following example sets the switchport mode to static access and makes the Ethernet interface 0/1 port a member of VLAN 2: (config)#interface eth 0/1 (config-eth 0/1)#switchport mode access (config-eth 0/1)#switchport access vlan 2
61200500L1-35E
405
switchport gvrp
Use the switchport gvrp command to enable or disable GVRP on an interface. Syntax Description
No subcommands.
Default Values
By default, GVRP is disabled on all ports.
Applicable Platforms
This command applies to the NetVanta 300, 1000, and 1000R Series units.
Command History
Release 8.1 Command was introduced.
Functional Notes
Enabling GVRP on any interface enables GVRP globally.
Usage Examples
The following example enables GVRP on Ethernet interface 0/24: (config)#interface eth 0/24 (config-eth 0/24)#switchport gvrp
61200500L1-35E
406
Default Values
By default, switchport mode is set to access.
Applicable Platforms
This command applies to the NetVanta 300, 1000, and 1000R Series units.
Command History
Release 5.1 Command was introduced.
Functional Notes
Configuring the interface for stack mode (using the switchport mode stack command) enables the switch to communicate with other switches that it is stacking capable. f the switch is configured as the stack master (using the (config)#stack master command), it will begin advertising itself as a stack master. f the switch is configured as the stack member (using the (config)#stack member command), it will begin advertising other stack masters that it knows about. Stack mode also allows the port to transmit and receive packets on all VLANs that are included in the VLAN allowed list.
Usage Examples
The following example sets the port to be a trunk port: (config)#interface eth 0/1 (config-eth 0/1)#switchport mode trunk
61200500L1-35E
407
switchport protected
Use the switchport protected command to prevent the port from transmitting traffic to all other protected ports. A protected port can only send traffic to unprotected ports. Use the no form of this command to disable. Syntax Description
No subcommands.
Default Values
This command is disabled by default.
Applicable Platforms
This command applies to the NetVanta 1000 and 1000R Series units.
Command History
Release 10.1 Command was introduced.
Usage Example
In the example below, all three of the ports are on VLAN 3, and eth 0/1 and eth 0/2 are designated as protected ports. Eth 0/3 is unprotected. Eth 0/1 and eth 0/2 will be allowed to send traffic to eth 0/3, but traffic traveling between eth 0/1 and eth 0/2 will be blocked. #configure terminal (config)#interface eth 0/1 (config-eth 0/1)#switchport access vlan 3 (config-eth 0/1)#switchport protected (config-eth 0/1)#exit (config)#interface eth 0/2 (config-eth 0/2)#switchport access vlan 32 (config-eth 0/2)#switchport protected (config-eth 0/1)#exit (config)#interface eth 0/3 (config-eth 0/3)#switchport access vlan 3
61200500L1-35E
408
switchport port-security
Use the switchport port-security command to enable port security functionality on the interface. Use the no form of this command to disable. Syntax Description
No subcommands.
Default Values
This command is disabled by default.
Applicable Platforms
This command applies to the NetVanta 300, 1000, and 1000R Series units.
Command History
Release 8.1 Command was introduced.
Functional Notes
You cannot enable port security on a port that is already configured as the following: Monitor session destination Member of a port channel interface Dynamic or trunk port (i.e., the port must be configured as static access)
Usage Examples
The following example enables port security on the Ethernet interface 0/1 interface: (config)#interface eth 0/1 (config-eth 0/1)#switchport port-security
61200500L1-35E
409
Default Values
By default, dynamic and static aging are disabled.
Applicable Platforms
This command applies to the NetVanta 300, 1000, and 1000R Series units.
Command History
Release 8.1 Command was introduced.
Usage Examples
The following example sets the aging time of secure MAC addresses to 10 minutes: (config)#interface eth 0/1 (config-eth 0/1)#switchport port-security aging time 10
61200500L1-35E
410
Default Values
By default, this command is disabled and set to type absolute.
Applicable Platforms
This command applies to the NetVanta 300, 1000, and 1000R Series units.
Command History
Release 8.1 Command was introduced.
Usage Examples
The following example disables Ethernet interface 0/1 after 10 minutes: (config)#interface eth 0/1 (config-eth 0/1)#switchport port-security expire time 10
61200500L1-35E
411
Syntax Description
sticky Adds a sticky secure MAC address associated with this interface. Enables sticky address learning if a MAC address is not specified.
Default Values
By default, sticky learning is disabled and there are no configured MAC addresses.
Applicable Platforms
This command applies to the NetVanta 300, 1000, and 1000R Series units.
Command History
Release 8.1 Command was introduced.
Usage Examples
The following example adds a single static address and enables sticky address learning on interface Ethernet interface 0/1: (config)#interface eth 0/1 (config-eth 0/1)#switchport port-security mac-address 00:A0:C8:02:D0:30 (config-eth 0/1)#switchport port-security mac-address sticky
61200500L1-35E
412
Default Values
The default value for this command is 1.
Applicable Platforms
This command applies to the NetVanta 300, 1000, and 1000R Series units.
Command History
Release 8.1 Command was introduced.
Usage Examples
The following example sets the maximum supported MAC addresses for Ethernet interface 0/1 to 2: (config)#interface eth 0/1 (config-eth 0/1)#switchport port-security maximum 2
61200500L1-35E
413
restrict
shutdown
Default Values
The default for this command is shutdown.
Applicable Platforms
This command applies to the NetVanta 300, 1000, and 1000R Series units.
Command History
Release 8.1 Command was introduced.
Usage Examples
The following example configures the interface to react to security violations by not learning the addresses of and not accepting data from the violation source: (config)#interface eth 0/1 (config-eth 0/1)#switchport port-security violation restrict
61200500L1-35E
414
switchport trunk allowed vlan [add | all | none | except | remove] <vlan id list> [all]
Use the switchport trunk allowed vlan command to allow certain VLANs to transmit and receive traffic on this port when the interface is in trunking mode. To return to defaults, use the no version of this command. Syntax Description
add all none except remove <vlan id list> Adds the specified VLAN IDs to the VLAN trunking allowed list. Adds all configured VLAN IDs to the VLAN trunking allowed list. Adds no VLAN IDs to the VLAN trunking allowed list. Adds all configured VLAN IDs to the VLAN trunking allowed list except those specified in the <vlan id list>. Removes VLAN IDs from the VLAN trunking allowed list. Specifies a list of valid VLAN interface IDs. Refer to Functional Notes, below.
Default Values
By default, all valid VLANs are allowed.
Applicable Platforms
This command applies to the NetVanta 300, 1000, and 1000R Series units.
Command History
Release 5.1 Command was introduced.
Functional Notes
A VLAN list is a set of VLAN IDs. A valid VLAN ID value must be from 1 to 4094 (inclusive). Each VLAN ID in a list is delimited by commas, yet a range of IDs may be expressed as a single element by using a hyphen between endpoints. For example the VLAN ID range 1,2,3,4,6,7,8,9,500 may be more easily expressed as 1-4,6-9,500. No spaces are allowed in a valid ID range.
Usage Examples
The following example adds VLANs to the previously existing list of VLANs allowed to transmit and receive on this port: (config)#interface eth 0/1 (config-eth 0/1)#switchport trunk allowed vlan add 1-4,7-9,500
61200500L1-35E
415
switchport trunk fixed vlan [add l all l except l none l remove] <vlan id>
Use the switchport trunk fixed vlan command to change the configured list of VLANs that remain fixed in use only when GVRP is enabled on the interface. Of these VLANs, VLANs statically created will be available for use on the interface. Syntax Description
add all except none remove <vlan id> Adds VLANs to the VLAN GVRP trunking fixed list. Adds all VLANs to the VLAN GVRP trunking fixed list. Adds all VLAN IDs to the VLAN trunking fixed list except those in the command line VLAN ID list. Removes all VLANs from the VLAN GVRP trunking fixed list. Removes VLAN from the VLAN trunking fixed list. Specifies a valid VLAN interface ID (1 to 4094).
Default Values
By default, no VLANs are in the VLAN GVRP trunking fixed list (switchport trunk fixed vlan none).
Applicable Platforms
This command applies to the NetVanta 300, 1000, and 1000R Series units.
Command History
Release 8.1 Command was introduced.
Functional Notes
This command has no effect on VLAN membership configuration unless GVRP is enabled on the interface.
61200500L1-35E
416
Usage Examples
The following example changes the configured list of fixed VLANs by adding VLAN 50 to the list. (config-eth 0/20)#switchport trunk fixed vlan add 1-15,25-30,40 (config-eth 0/20)#switchport trunk fixed vlan add 50 The following example changes the configured list of fixed VLANs by removing VLANs 10-100 from the list: (config-eth 0/20)#switchport trunk fixed vlan remove 10-100 The following example changes the configured list of fixed VLANs to include only VLANs 1 to 1000: (config-eth 0/20)#switchport trunk fixed vlan 1-1000 The following example changes the configured list of fixed VLANs to include no VLANs (except those VLANs that are native): (config-eth 0/20)#switchport trunk fixed vlan none
61200500L1-35E
417
Default Values
By default, this is set to VLAN 1.
Applicable Platforms
This command applies to the NetVanta 300, 1000, and 1000R Series units.
Command History
Release 5.1 Command was introduced.
Functional Notes
Configure which VLAN the interface uses as its native VLAN during trunking. Packets from this VLAN leaving the interface will not be tagged with the VLAN number. Any untagged packets received by the interface are considered a part of the native VLAN ID.
Usage Examples
The following example sets the native VLAN on Ethernet interface 0/1 to VLAN 2: (config)#interface eth 0/1 (config-eth 0/1)#switchport trunk native vlan 2
61200500L1-35E
418
The following commands are common to multiple command sets and are covered in a centralized section of this guide. For more information, refer to the sections listed below: alias <text> on page 25 cross-connect <#> <from interface> <slot/port> <tdm-group#> <to interface> <slot/port> on page 26 description <text> on page 29 do on page 30 end on page 31 exit on page 32 shutdown on page 33 All other commands for this command set are described in this section in alphabetical order. bandwidth <value> on page 420 dynamic-dns [dyndns | dyndns-custom | dyndns-static] <hostname> <username> <password> on page 421 ip commands begin on page 423 ip commands begin on page 424 mtu <size> on page 429 snmp trap on page 430 snmp trap link-status on page 431
61200500L1-35E
419
bandwidth <value>
Use the bandwidth command to provide the bandwidth value of an interface to the higher-level protocols. This value is used in cost calculations. Use the no form of this command to restore the default values. Syntax Description
<value> Specifies bandwidth in kbps.
Default Values
To view default values, use the show interfaces command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 3.1 Command was introduced.
Functional Notes
The bandwidth command is an informational value that is communicated to the higher-level protocols to be used in cost calculations. This is a routing parameter only and does not affect the physical interface.
Usage Examples
The following example sets bandwidth of the loopback interface to 10 Mbps: (config)#interface loopback 1 (config-loop 1)#bandwidth 10000
61200500L1-35E
420
Default Values
No default is necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 8.1 Command was introduced.
Functional Notes
dyndns - The Dynamic DNSSM service allows you to alias a dynamic IP address to a static hostname in various domains. This allows your unit to be more easily accessed from various locations on the Internet. This service is provided for up to five hostnames. dyndns-custom - DynDNS.org's Custom DNSSM service provides a full DNS solution, giving you complete control over an entire domain name. A web-based interface provides two levels of control over your domain, catering to average or power users. Five globally redundant DNS servers ensure that your domain will always resolve. A choice of two interfaces is available. The basic interface is designed for most users. It comes preconfigured for the most common configuration and allows for easy creation of most common record types. The advanced interface is designed for system administrators with a solid DNS background, and provides layout and functionality similar to a BIND zone file, allowing for the creation of nearly any record type. Custom DNSSM can be used with both static and dynamic IPs and has the same automatic update capability through Custom DNS-aware clients as Dynamic DNS. dyndns-static - The Static DNS service is similar to Dynamic DNS service in that it allows a hostname such as yourname.dyndns.org to point to your IP address. Unlike a Dynamic DNS host, a Static DNS host does not expire after 35 days without updates, but updates take longer to propagate though the DNS system. This service is provided for up to five hostnames.
61200500L1-35E
421
If your IP address doesn't change often or at all, but you still want an easy name to remember it by (without having to purchase your own domain name), Static DNS service is ideal for you. If you would like to use your own domain name (such as yourname.com), you need Custom DNS service which also provides full dynamic and static IP address support.
Usage Examples The following example sets the dynamic-dns to dyndns-custom with hostname host, username user, and password pass: (config)#interface loopback 1 (config-loop 1)#dynamic-dns dyndns-custom host user pass
61200500L1-35E
422
Default Values
By default, these commands are disabled.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 3.1 Command was introduced.
Functional Notes
When this command is enabled, the IP destination address of each packet must be validated before being passed through. If the packet is not acceptable per these settings, it is dropped.
Usage Examples
The following example sets up the router to allow only Telnet traffic into the loopback interface: (config)#ip access-list extended TelnetOnly (config-ext-nacl)#permit tcp any any eq telnet (config-ext-nacl)#interface loopback 1 (config-loop 1)#ip access-group TelnetOnly in
61200500L1-35E
423
Default Values
By default, there are no assigned IP addresses.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 1.1 Release 2.1 Command was introduced. Added ip address dhcp for DHCP client support.
Functional Notes
Use secondary IP addresses to allow dual subnets on a single interface (when you need more IP addresses than the primary subnet can provide). When using secondary IP addresses, avoid routing loops by verifying that all devices on the network segment are configured with secondary IP addresses on the secondary subnet.
Usage Examples
The following example configures a secondary IP address of 192.22.72.101/30: (config)#interface loopback 1 (config-loop 1)#ip address 192.22.72.101 255.255.255.252 secondary
61200500L1-35E
424
ip helper-address <address>
Use the ip helper-address command to configure the AOS to forward User Datagram Protocol (UDP) broadcast packets received on the interface. Use the no form of this command to disable forwarding packets. The ip helper command must be used in conjunction with the ip forward-protocol command to configure the AOS to forward UDP broadcast packets.
Syntax Description
<address> Specifies the destination IP address (in dotted decimal notation) for the forwarded UDP packets.
Default Values
By default, broadcast UDP packets are not forwarded.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 1.1 Command was introduced.
Functional Notes
When used in conjunction with the ip forward-protocol command, the ip helper-address feature allows you to customize which broadcast packets are forwarded. To implement the helper address feature, assign a helper-address(es) (specifying the device that needs to receive the broadcast traffic) to the interface closest to the host that transmits the broadcast packets. When broadcast packets (of the specified type forwarded using the ip forward-protocol command) are received on the interface, they will be forwarded to the device that needs the information. Only packets meeting the following criteria are considered eligible by the ip helper-address feature: 1. The packet IP protocol is User Datagram Protocol (UDP). 2. Any UDP port specified using the ip forward-protocol command. 3. The media access control (MAC) address of the frame is an all-ones broadcast address (ffff.ffff.ffff). 4. The destination IP address is broadcast defined by all ones (255.255.255.255) or a subnet broadcast (for example, 192.33.4.251 for the 192.33.4.248/30 subnet).
61200500L1-35E
425
Usage Examples
The following example forwards all DNS broadcast traffic to the DNS server with IP address 192.33.5.99: (config)#ip forward-protocol udp domain (config)#interface loopback 1 (config-loop 1)#ip helper-address 192.33.5.99
61200500L1-35E
426
ip route-cache
Use the ip route-cache command to enable fast-cache switching on the interface. Use the no form of this command to disable fast-cache switching and return to process switching mode. Using Network Address Translation (NAT) or the AOS firewall capabilities on an interface requires process switching mode (using the no ip route-cache command).
Syntax Description
No subcommands.
Default Values
By default, fast-cache switching is enabled on all Ethernet and virtual Frame Relay sub-interfaces. IP route-cache is enabled for all virtual PPP interfaces.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 2.1 Command was introduced.
Functional Notes
Fast switching allows an IP interface to provide optimum performance when processing IP traffic.
Usage Examples
The following example enables fast switching on the loopback interface: (config)#interface loopback 1 (config-loop 1)#ip route-cache
61200500L1-35E
427
ip unnumbered <interface>
Use the ip unnumbered command to use the IP address assigned to the specified interface for all IP processing on the active interface. Use the no form of this command to remove the unnumbered configuration. Syntax Description
<interface> Specifies the interface in the format type slot/port (e.g., ppp 1) that contains the IP address to be used as the source address for all packets transmitted on this interface. Enter ip unnumbered ? for a complete list of valid interfaces.
Default Values
By default, all interfaces are configured to use a specified IP address (using the ip address command).
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 1.1 Release 11.1 Command was introduced. Command was expanded to include demand interfaces.
Functional Notes
If ip unnumbered is enabled on an interface, all IP traffic from the interface will use a source IP address taken from the specified interface. For example, specifying ip unnumbered ppp 1 while in the Ethernet Interface Configuration mode configures the Ethernet interface to use the IP address assigned to the PPP interface for all IP processing. In addition, the AOS uses the specified interface information when sending route updates over the unnumbered interface.
Usage Examples
The following example configures the loopback interface (labeled loop 1) to use the IP address assigned to the PPP interface (ppp 1): (config)#interface loopback 1 (config-loop 1)#ip unnumbered ppp 1
61200500L1-35E
428
mtu <size>
Use the mtu command to configure the maximum transmit unit size for the active interface. Use the no form of this command to return to the default value. Syntax Description
<size> Configures the window size for transmitted packets. The valid ranges for the various interfaces are listed below: ATM interfaces 64 to 1520 Demand interfaces 64 to 1520 Ethernet interfaces 64 to 1500 FDL interfaces 64 to 256 HDLC interfaces 64 to 1520 Loopback interfaces 64 to 1500 Tunnel interfaces 64 to 18,190 Virtual Frame Relay sub-interfaces 64 to 1520 Virtual PPP interfaces 64 to 1500
Default Values
<size> The default values for the various interfaces are listed below: ATM interfaces 1500 Demand interfaces 1500 Ethernet interfaces 1500 FDL interfaces 256 HDLC interfaces 1500 Loopback interfaces 1500 Tunnel interfaces 1500 Virtual Frame Relay sub-interfaces 1500 Virtual PPP interfaces 1500
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 1.1 Command was introduced.
Functional Notes
OSPF will not become adjacent on links where the MTU sizes do not match. If router A and router B are exchanging hello packets but their MTU sizes do not match, they will never reach adjacency. This is by design and required by the RFC.
Usage Examples
The following example specifies an MTU of 1200 on the loopback interface: (config)#interface loopback 1 (config-loop 1)#mtu 1200
61200500L1-35E
429
snmp trap
Use the snmp trap command to enable all supported Simple Network Management Protocol (SNMP) traps on the interface. Syntax Description
No subcommands.
Default Values
By default, all interfaces (except virtual Frame Relay interfaces and sub-interfaces) have SNMP traps enabled.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 1.1 Release 3.1 Release 5.1 Command was introduced. Command was extended to the SHDSL interface. Command was expanded to include Ethernet sub-interfaces and Gigabit Ethernet interfaces.
Usage Examples
The following example enables SNMP capability on the Ethernet interface: (config)#interface eth 0/1 (config-eth 0/1)#snmp trap
61200500L1-35E
430
Default Values
By default, the ifLinkUpDownTrapEnable OID is enabled for all interfaces except virtual Frame Relay interfaces.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 1.1 Release 3.1 Release 5.1 Command was introduced. Command was extended to the SHDSL interface. Command was expanded to include Gigabit Ethernet, port channel, VLAN, E1, and G.703 interfaces.
Functional Notes
The snmp trap link-status command is used to control the RFC2863 ifLinkUpDownTrapEnable OID (OID number 1.3.6.1.2.1.31.1.1.1.14.0).
Usage Examples
The following example disables the link-status trap on the loopback interface: (config)#interface loopback 1 (config-loop 1)#no snmp trap link-status
61200500L1-35E
431
The following commands are common to multiple command sets and are covered in a centralized section of this guide. For more information, refer to the sections listed below: alias <text> on page 25 cross-connect <#> <from interface> <slot/port> <tdm-group#> <to interface> <slot/port> on page 26 description <text> on page 29 do on page 30 end on page 31 exit on page 32 shutdown on page 33 All other commands for this command set are described in this section in alphabetical order. arp arpa on page 433 lldp receive on page 434 lldp send [management-address l port-description l system-capabilities l system-description l system-name l and-receive] on page 435 qos [trust cos | default-cos <cos value>] on page 437 snmp trap on page 438 snmp trap link-status on page 439 spanning tree commands begin on page 440 storm-control [broadcast level | multicast level | unicast level] <rising level> <falling level> on page 446 storm-control action [shutdown] on page 448 switchport commands begin on page 449
61200500L1-35E
432
arp arpa
Use the arp arpa command to enable address resolution protocol (ARP) on this interface. Syntax Description
arpa Keyword used to set standard address resolution protocol for this interface.
Default Values
The default for this command is arpa.
Applicable Platforms
This command applies to the NetVanta 300, 1000, and 1000R Series units.
Command History
Release 5.1 Command was introduced.
Usage Examples
The following example enables standard ARP for the Port Channel interface: (config)#interface port-channel 1 (config-p-chan 1)#arp arpa
61200500L1-35E
433
lldp receive
Use the lldp receive command to allow LLDP packets to be received on this interface. Syntax Description
No subcommands.
Default Values
By default, all interfaces are configured to send and receive LLDP packets.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R Series units.
Command History
Release 9.1 Command was introduced.
Usage Examples
The following example configures the port channel interface to receive LLDP packets: (config)#interface port-channel 1 (config-p-chan 1)#lldp receive
61200500L1-35E
434
Default Values
Be default, all interfaces are configured to transmit and receive LLDP packets of all types.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R Series units.
Command History
Release 9.1 Command was introduced.
Functional Notes
Individual LLDP information can be enabled or disabled using the various forms of the lldp send command. For example, use the lldp send and-receive command to enable transmit and receive of all LLDP information. Then use the no lldp send port-description command to prevent LLDP from transmitting port description information.
61200500L1-35E
435
Usage Examples
The following example configures the port channel interface to transmit LLDP packets containing all enabled information types: (config)#interface port-channel 1 (config-p-chan 1)#lldp send The following example configures the port channel interface to transmit and receive LLDP packets containing all information types: (config)#interface port-channel 1 (config-p-chan 1)#lldp send and-receive
61200500L1-35E
436
Default Values
By default, the interface is untrusted with a default-cos of 0.
Applicable Platforms
This command applies to the NetVanta 300, 1000, and 1000R Series units.
Command History
Release 5.1 Command was introduced.
Functional Notes
Set the interface to trust cos if received 802.1P CoS values are considered valid (i.e., no need to reclassify) and do not need to be tagged with the default value. When set to untrusted, the default-cos value for the interface is used.
Usage Examples
The following example sets port channel 1 as a trusted interface and assigns untagged packets a CoS value of 1: (config)#interface port-channel 1 (config-p-chan 1)#qos trust cos (config-p-chan 1)#qos default-cos 1
61200500L1-35E
437
snmp trap
Use the snmp trap command to enable all supported Simple Network Management Protocol (SNMP) traps on the interface. Syntax Description
No subcommands.
Default Values
By default, all interfaces (except virtual Frame Relay interfaces and sub-interfaces) have SNMP traps enabled.
Applicable Platforms
This command applies to the NetVanta 300, 1000, and 1000R Series units.
Command History
Release 1.1 Release 3.1 Release 5.1 Command was introduced. Command was extended to the SHDSL interface. Command was expanded to include Ethernet sub-interfaces and Gigabit Ethernet interfaces.
Usage Examples
The following example enables SNMP capability on the port channel interface: (config)#interface port-channel 1 (config-p-chan 1)#snmp trap
61200500L1-35E
438
Default Values
By default, the ifLinkUpDownTrapEnable OID is enabled for all interfaces except virtual Frame Relay interfaces.
Applicable Platforms
This command applies to the NetVanta 300, 1000, and 1000R Series units.
Command History
Release 1.1 Release 3.1 Release 5.1 Release 6.1 Command was introduced. Command was extended to the SHDSL interface. Command was expanded to include Gigabit Ethernet, port channel, VLAN, E1, and G.703 interfaces. Command was expanded to include VLAN and port channel interfaces.
Functional Notes
The snmp trap link-status command is used to control the RFC2863 ifLinkUpDownTrapEnable OID (OID number 1.3.6.1.2.1.31.1.1.1.14.0).
Usage Examples
The following example disables the link-status trap on the port channel interface: (config)#interface port-channel 1 (config-p-chan 1)#no snmp trap link-status
61200500L1-35E
439
Default Values
By default, this setting is disabled.
Applicable Platforms
This command applies to the NetVanta 300, 1000, and 1000R Series units.
Command History
Release 5.1 Command was introduced.
Functional Notes
The bpdufilter blocks any BPDUs from being transmitted and received on an interface.
Usage Examples
The following example enables the BPDU filter on the port channel interface: (config)#interface port-channel 3 (config-p-chan 3)#spanning-tree bpdufilter enable The BPDU filter can be disabled on port channel 3 by issuing the following commands: (config)#interface port-channel 3 (config-p-chan 3)#spanning-tree bpdufilter disable
61200500L1-35E
440
Default Values
By default, this setting is disabled.
Applicable Platforms
This command applies to the NetVanta 300, 1000, and 1000R Series units.
Command History
Release 5.1 Command was introduced.
Functional Notes
The bpduguard blocks any BPDUs from being received on an interface.
Usage Examples
The following example enables the BPDU guard on the port channel interface: (config)#interface port-channel 3 (config-p-chan 3)#spanning-tree bpduguard enable The BPDU guard can be disabled on port channel 3 by issuing the following commands: (config)#interface port-channel 3 (config-p-chan 3)#spanning-tree bpduguard disable
61200500L1-35E
441
Default Values
By default, the cost value is set to 1000/(link speed in Mbps).
Applicable Platforms
This command applies to the NetVanta 300, 1000, and 1000R Series units.
Command History
Release 5.1 Command was introduced.
Usage Examples
The following example sets the interface to a path cost of 1200: (config)#interface port-channel 3 (config-p-chan 3)#spanning-tree cost 1200
61200500L1-35E
442
spanning-tree edgeport
Use the spanning-tree edgeport command to configure the interface to be an edgeport. This command overrides the Global setting (refer to spanning-tree edgeport default on page 332). Use the no version of the command to return to the default setting. Syntax Description
No subcommands.
Default Values
By default, this setting is disabled.
Applicable Platforms
This command applies to the NetVanta 300, 1000, and 1000R Series units.
Command History
Release 5.1 Command was introduced.
Functional Notes
Enabling this command configures the interface to go to a forwarding state when the link goes up.
Usage Examples
The following example configures the interface to be an edgeport: (config)#interface port-channel 1 (config-p-chan 1)#spanning-tree edgeport An individual interface can be configured to not be considered an edgeport. For example: (config)#interface port-channel 1 (config-p-chan 1)#spanning-tree edgeport disable or (config)#interface port-channel 1 (config-p-chan 1)#no spanning-tree edgeport
61200500L1-35E
443
Default Values
By default, the interface is set to auto.
Applicable Platforms
This command applies to the NetVanta 300, 1000, and 1000R Series units.
Command History
Release 5.1 Command was introduced.
Functional Notes
This command overrides the default link type setting determined by the duplex of the individual port. By default, a port configured for half-duplex is set to shared link type, and a port configured for full-duplex is set to point-to-point link type. Setting the link type manually overrides the default and forces the port to use the specified link type. Use the link-type auto command to restore the convention of determining link type based on duplex settings.
Usage Examples
The following example forces the link type to point-to-point, even if the port is configured to be half-duplex: (config)#interface port-channel 1 (config-p-chan 1)#spanning-tree link-type point-to-point
Technology Review
Rapid transitions are possible in RSTP (rapid spanning-tree protocol) by taking advantage of point-to-point links (a port is connected to exactly one other bridge) and edge-port connections (a port is not connected to any additional bridges). Setting the link type to point-to-point allows a half-duplex link to act as if it were a point-to-point link.
61200500L1-35E
444
Default Values
By default, this set to 128.
Applicable Platforms
This command applies to the NetVanta 300, 1000, and 1000R Series units.
Command History
Release 5.1 Command was introduced.
Functional Notes
The only time that this priority level is used is when two interfaces with a path to the root have equal cost. At that point, the level set in this command will determine which port the spanning-tree will use. Set the priority value lower to increase the chance the interface will be used.
Usage Examples
The following example sets the interface to a priority of 96: (config)#interface port-channel 4 (config-p-chan 4)#spanning-tree port-priority 96
61200500L1-35E
445
storm-control [broadcast level | multicast level | unicast level] <rising level> <falling level>
Use the storm-control command to configure limits on the rates of broadcast, multicast, and unicast traffic on a port. To disable storm-control, use the no version of this command. Syntax Description
broadcast level multicast level unicast level <rising level> <falling level> Sets levels for broadcast traffic. Sets levels for multicast traffic. Sets levels for unicast traffic. Specifies a rising level which determines the percentage of total bandwidth the port accepts before it begins blocking packets. Range: 0-100 percent. Specifies a falling level which determines when the storm is considered over, causing the AOS to no longer block packets. This level must be less than the rising level. Range: 0 to 100 percent.
Default Values
By default, storm-control is disabled.
Applicable Platforms
This command applies to the NetVanta 300, 1000, and 1000R Series units.
Command History
Release 5.1 Command was introduced.
Functional Notes
This setting configures the rising and falling suppression values. When the selected rising level (which is a percentage of total bandwidth) is reached, the port begins blocking packets of the specified type (i.e., broadcast, multicast, or unicast). The AOS uses the rising level as its falling level if no falling level is specified.
61200500L1-35E
446
Usage Examples
The following example sets the rising suppression level to 85 percent for multicast packets: (config)#interface port-channel 1 (config-p-chan 1)#storm-control multicast level 85 The following example sets the rising suppression level to 80 percent for broadcast packets, with a falling level of 50 percent: (config)#interface port-channel 1 (config-p-chan 1)#storm-control broadcast level 80 50
61200500L1-35E
447
Default Values
By default, this command is disabled; the interface will only filter traffic.
Applicable Platforms
This command applies to the NetVanta 300, 1000, and 1000R Series units.
Command History
Release 5.1 Command was introduced.
Functional Notes
Enabling this option shuts down the interface if a multicast, unicast, or broadcast storm occurs.
Usage Examples
The following example shuts down the port channel interface if a storm is detected: (config)#interface port-channel 1 (config-p-chan 1)#storm-control action shutdown
61200500L1-35E
448
Default Values
By default, this is set to VLAN 1 (the default VLAN).
Applicable Platforms
This command applies to the NetVanta 300, 1000, and 1000R Series units.
Command History
Release 5.1 Command was introduced.
Functional Notes
If the port is in the trunk mode, this command will not alter the switchport mode to access. Instead it will save the value to be applied when the port does switch to access mode. Refer to switchport mode [access | trunk] on page 451 for more information.
Usage Examples
The following example sets the switchport mode to static-access and makes the port channel 1 port a member of VLAN 2: (config)#interface port-channel 1 (config-p-chan 1)#switchport mode access (config-p-chan 1)#switchport access vlan 2
61200500L1-35E
449
switchport gvrp
Use the switchport gvrp command to enable or disable GVRP on an interface. Syntax Description
No subcommands.
Default Values
By default, GVRP is disabled on all ports.
Applicable Platforms
This command applies to the NetVanta 300, 1000, and 1000R Series units.
Command History
Release 8.1 Command was introduced.
Functional Notes
Enabling GVRP on any interface enables GVRP globally.
Usage Examples
The following example enables GVRP on port channel 3: (config)#interface port-channel 3 (config-p-chan 3)#switchport gvrp
61200500L1-35E
450
Default Values
By default, this is set to access.
Applicable Platforms
This command applies to the NetVanta 300, 1000, and 1000R Series units.
Command History
Release 5.1 Command was introduced.
Usage Examples
The following example sets the port to be a trunk port: (config)#interface port-channel 1 (config-p-chan 1)#switchport mode trunk
61200500L1-35E
451
switchport trunk allowed vlan [add | except | remove] <vlan id list> [all]
Use the switchport trunk allowed vlan command to allow certain VLANs to transmit and receive traffic on this port when the interface is in trunking mode. To return to defaults, use the no version of this command. Syntax Description
add except remove <vlan id list> all Adds the specified VLAN IDs to the VLAN trunking allowed list. Adds all configured VLAN IDs to the VLAN trunking allowed list except those specified in the <vlan id list>. Removes VLAN IDs from the VLAN trunking allowed list. Specifies a list of valid VLAN interface IDs. Refer to Functional Notes below for additional syntax considerations. Adds all configured VLAN IDs to the VLAN trunking allowed list.
Default Values
By default, all valid VLANs are allowed.
Applicable Platforms
This command applies to the NetVanta 300, 1000, and 1000R Series units.
Command History
Release 5.1 Command was introduced.
Functional Notes
A VLAN list is a set of VLAN IDs. A valid VLAN ID value must be from 1 to 4094 (inclusive). Each VLAN ID in a list is delimited by commas, yet a range of IDs may be expressed as a single element by using a hyphen between endpoints. For example the VLAN ID range 1,2,3,4,6,7,8,9,500 may be more easily expressed as 1-4,6-9,500. No spaces are allowed in a valid ID range.
Usage Examples
The following example adds VLANs to the previously existing list of VLANs allowed to transmit and receive on this port: (config)#interface port-channel 1 (config-p-chan 1)#switchport trunk allowed vlan add 1-4,7-9,500
61200500L1-35E
452
switchport trunk fixed vlan [add l all l except l none l remove] <vlan id list>
Use the switchport trunk fixed vlan command to change the configured list of VLANs that remain fixed in use only when GVRP is enabled on the interface. Of these VLANs, VLANs statically or dynamically created will be available for use on the interface. Syntax Description
add all except none remove <vlan id list> Adds VLANs to the VLAN GVRP trunking fixed list. Adds all VLANs to the VLAN GVRP trunking fixed list. Adds all VLAN IDs to the VLAN trunking fixed list except those in the command line VLAN ID list. Removes all VLANs from the VLAN GVRP trunking fixed list. Removes VLAN from the VLAN trunking fixed list. Specifies a list of valid VLAN interface IDs. Refer to Functional Notes below for additional syntax considerations.
Default Values
By default, no VLANs are in the VLAN GVRP trunking fixed list (switchport trunk fixed vlan none).
Applicable Platforms
This command applies to the NetVanta 300, 1000, and 1000R Series units.
Command History
Release 8.1 Command was introduced.
Functional Notes
This command has no effect on VLAN membership configuration unless GVRP is enabled on the interface. Refer to gvrp on page 246 for information on enabling GVRP. A VLAN list is a set of VLAN IDs. A valid VLAN ID value must be from 1 to 4094 (inclusive). Each VLAN ID in a list is delimited by commas, yet a range of IDs may be expressed as a single element by using a hyphen between endpoints. For example the VLAN ID range 1,2,3,4,6,7,8,9,500 may be more easily expressed as 1-4,6-9,500. No spaces are allowed in a valid ID range.
61200500L1-35E
453
Usage Examples
The following example changes the configured list of fixed VLANs by adding VLAN 50 to the list: (config-p-chan 1)#switchport trunk fixed vlan add 1-15,25-30,40 (config-p-chan 1)# (config-p-chan 1)#switchport trunk fixed vlan add 50 (config-p-chan 1)#
61200500L1-35E
454
Default Values
By default, this is set to VLAN 1.
Applicable Platforms
This command applies to the NetVanta 300, 1000, and 1000R Series units.
Command History
Release 5.1 Command was introduced.
Functional Notes
Configure which VLAN the interface uses as its native VLAN during trunking. Packets from this VLAN leaving the interface will not be tagged with the VLAN number. Any untagged packets received by the interface are considered a part of the native VLAN ID.
Usage Examples
The following example sets the native VLAN on port channel 1 to VLAN 2: (config)#interface port-channel 1 (config-p-chan 1)#switchport trunk native vlan 2
61200500L1-35E
455
The following commands are common to multiple command sets and are covered in a centralized section of this guide. For more information, refer to the sections listed below: cross-connect <#> <from interface> <slot/port> <tdm-group#> <to interface> <slot/port> on page 26 do on page 30 end on page 31 exit on page 32 shutdown on page 33 All other commands for this command set are described in this section in alphabetical order. media [ethernet] on page 457 name <vlan name> on page 458 state [active | suspend] on page 459
61200500L1-35E
456
media [ethernet]
Use the media command to set the virtual local area network (VLAN) media type. The only media type currently supported is ethernet. Use the no form of this command to reset to default. Syntax Description
ethernet Sets the VLAN media type to ethernet.
Default Values
By default, media is set to ethernet.
Applicable Platforms
This command applies to the NetVanta 1000, 1000R, and 2000 Series units.
Command History
Release 5.1 Command was introduced.
Usage Examples
The following example sets the media type to Ethernet for VLAN 2: (config)#vlan 2 (config-vlan 2)#media ethernet
61200500L1-35E
457
Default Values
By default, the name is set to VLANxxxx where xxxx represents four numeric digits (including leading zeroes) equal to the VLAN ID number.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, and 2000 Series units.
Command History
Release 5.1 Command was introduced.
Functional Notes
The name is limited to 32 characters and must be unique throughout.
Usage Examples
The following example sets the name of VLAN 2 to Accounting: (config)#vlan 2 (config-vlan 2)#name Accounting
61200500L1-35E
458
Default Values
The default setting is active (once the VLAN has been created).
Applicable Platforms
This command applies to the NetVanta 1000, 1000R, and 2000 Series units.
Command History
Release 5.1 Command was introduced.
Usage Examples
The following example sets the VLAN state to suspended: (config)#vlan 2 (config-vlan 1)#state suspend
61200500L1-35E
459
The following commands are common to multiple command sets and are covered in a centralized section of this guide. For more information, refer to the sections listed below: do on page 30 end on page 31 exit on page 32 All other commands for this command set are described in this section in alphabetical order. abort on page 461 apply on page 462 reset on page 463 show [changes <vlan id> | current | proposed] on page 464 vlan <vlan id> on page 465 vlan <vlan id> media [ethernet] on page 466 vlan <vlan id> name <vlan name> on page 467 vlan <vlan id> state [active | suspend] on page 468
61200500L1-35E
460
abort
Use the abort command to exit the VLAN Database without saving any changes made. Syntax Description
No subcommands.
Default Values
No defaults necessary for this setting.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, and 2000 Series units.
Command History
Release 5.1 Command was introduced.
Functional Notes
The abort command discards all configuration changes made since you entered the VLAN Database Configuration (or since the last time you issued the apply command). The system then exits out of this mode, returning to the enable (#) command prompt. See the command apply on page 462 for more information.
Usage Examples
The following example exits the VLAN Database without saving the changes made: (config)#vlan database (vlan)#abort Discarding all changes and exiting. #
61200500L1-35E
461
apply
Use the apply command to apply changes without exiting the VLAN Database. Syntax Description
No subcommands.
Default Values
No defaults necessary for this setting.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, and 2000 Series units.
Command History
Release 5.1 Command was introduced.
Functional Notes
Applies changes to the VLAN Database configuration in the running configuration.
Usage Examples
The following example applies changes made, remaining in the VLAN Database: (config)#vlan database (vlan)#apply Changes applied. (vlan)#
61200500L1-35E
462
reset
Use the reset command to discard all changes made and revert to the previous configuration. The prompt remains in the VLAN Database. Syntax Description
No subcommands.
Default Values
No defaults necessary for this setting.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, and 2000 Series units.
Command History
Release 5.1 Command was introduced.
Functional Notes
The reset command discards all changes to the VLAN configuration. The configuration remains the same as it was prior to entering the VLAN Database Configuration (or since the last time you issued the apply command). The VLAN Database reverts to the same state it had upon entry. See the command apply on page 462 for more information.
Usage Examples
The following example resets the unit to the previous configuration (i.e., the last configuration saved using the apply or the exit command): (config)#vlan database (vlan)#reset VLAN configuration has been reset. (vlan)#
61200500L1-35E
463
current proposed
Default Values
No defaults necessary.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, and 2000 Series units.
Command History
Release 5.1 Command was introduced.
Usage Examples
The following example shows the proposed VLAN Database configuration which will take effect if an apply or exit command is issued: (config)#vlan database (vlan)#show proposed
61200500L1-35E
464
Default Values
No defaults necessary for this setting.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, and 2000 Series units.
Command History
Release 5.1 Command was introduced.
Usage Examples
The following example creates VLAN 2 only within the VLAN Database. This VLAN is not added to the running configuration until an exit or apply command is issued: (vlan)#vlan 2 VLAN 2 created. Name = VLAN0002 (vlan)# The following example removes VLAN 2 from the VLAN Database. This VLAN is not removed from the running configuration until an exit or apply command is issued: (config)#vlan database (vlan)#no vlan 2
61200500L1-35E
465
Default Values
By default, vlan media is set to ethernet.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, and 2000 Series units.
Command History
Release 5.1 Command was introduced.
Usage Examples
The following example sets the media type of VLAN 2 to ethernet: (config)#vlan database (vlan)#vlan 2 media ethernet
61200500L1-35E
466
Default Values
By default, the assigned name is VLANxxxx; where xxxx represents four numeric digits (including leading zeroes) equal to the VLAN ID number.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, and 2000 Series units.
Command History
Release 5.1 Command was introduced.
Functional Notes
The name is limited to 32 characters and must be unique throughout the network.
Usage Examples
The following example sets the name of VLAN 2 to Accounting: (config)#vlan database (vlan)#vlan 2 name Accounting
61200500L1-35E
467
Default Values
The default setting is active (once the VLAN has been created).
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, and 2000 Series units.
Command History
Release 5.1 Command was introduced.
Usage Examples
The following example sets the VLAN state to suspended: (config)#vlan database (vlan)#vlan 2 state suspend
61200500L1-35E
468
The following commands are common to multiple command sets and are covered in a centralized section of this guide. For more information, refer to the sections listed below: cross-connect <#> <from interface> <slot/port> <tdm-group#> <to interface> <slot/port> on page 26 description <text> on page 29 do on page 30 end on page 31 exit on page 32 shutdown on page 33 All other commands for this command set are described in this section in alphabetical order. arp arpa on page 470 mac-address <address> on page 478 snmp trap on page 479 snmp trap link-status on page 480
61200500L1-35E
469
arp arpa
Use the arp arpa command to enable address resolution protocol (ARP) on the VLAN interface. Syntax Description
arpa Sets the standard address resolution protocol for this interface.
Default Values
The default for this command is arpa.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, and 2000 Series units.
Command History
Release 5.1 Release 6.1 Command was introduced. Command was extended to include NetVanta 2000 Series units.
Usage Examples
The following example enables standard ARP for the VLAN interface: (config)#interface vlan 1 (config-interface-vlan 1)#arp arpa
61200500L1-35E
470
Default Values
By default, there are no assigned IP addresses.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, and 2000 Series units.
Command History
Release 5.1 Command was introduced.
Usage Examples
The following example configures an IP address of 192.22.72.101/30: (config)#interface vlan 1 (config-interface-vlan 1)#ip address 192.22.72.101 255.255.255.252
61200500L1-35E
471
ip address dhcp
Use the ip address dhcp command to use Dynamic Host Configuration Protocol (DHCP) to obtain an address on the interface. Use the no form of this command to remove a configured IP address (using DHCP) and disable DHCP operation on the interface.
ip address dhcp [client-id [<interface> | <identifier>] hostname <string>]
Syntax Description
client-id <interface> Optional. Specifies the client identifier used when obtaining an IP address from a DHCP server. Specifying an interface defines the client identifier as the hexadecimal MAC address of the specified interface (including a hexadecimal number added to the front of the MAC address to identify the media type). For example, specifying the client-id ethernet 0/1 (where the Ethernet interface has a MAC address of d217.0491.1150) defines the client identifier as 01:d2:17:04:91:11:50 (where 01 defines the media type as Ethernet). Refer to hardware-address <hardware-address> <type> on page 488 for a detailed listing of media types. <identifier> Specifies a custom client-identifier using a text string (that is converted to a hexadecimal equivalent) or 7 to 28 hexadecimal numbers (with colon delimiters). For example, a custom client identifier of 0f:ff:ff:ff:ff:51:04:99:a1 may be entered using the <identifier> option. hostname <string> no-default-route no-domain-name no-nameservers Optional. Specifies a text string (to override the global router name) to use as the name in the DHCP option 12 field. String (enclosed in quotation marks) of up to 35 characters to use as the name of the host for DHCP operation. Keyword used to specify that the AOS not install the default-route obtained via DHCP. Keyword used to specify that the AOS not install the domain-name obtained via DHCP. Keyword used to specify that the AOS not install the DNS servers obtained via DHCP.
Default Values
client-id Optional. By default, the client identifier is populated using the following formula: TYPE: INTERFACE SPECIFIC INFO : MAC ADDRESS Where TYPE specifies the media type in the form of one hexadecimal byte (refer to hardware-address <hardware-address> <type> on page 488 for a detailed listing of media types), and the MAC ADDRESS is the Media Access Control (MAC) address assigned to the first Ethernet interface in the unit in the form of six hexadecimal bytes. (For units with a single Ethernet interface, the MAC ADDRESS assigned to Ethernet 0/1 is used in this field).
61200500L1-35E
472
INTERFACE SPECIFIC INFO is only used for Frame Relay interfaces and can be determined using the following: FR_PORT# : Q.922 ADDRESS Where the FR_PORT# specifies the label assigned to the virtual Frame Relay interface using four hexadecimal bytes. For example, a virtual Frame Relay interface labeled 1 would have a FR_PORT# of 00:00:00:01. The Q.922 ADDRESS field is populated using the following:
2 C/R
1 EA EA
DE
Where the FECN, BECN, C/R, DE, and high order EA bits are assumed to be 0 and the lower order extended address (EA) bit is set to 1. The following list provides a few example DLCIs and associated Q.922 address: DLCI (decimal) / Q.922 address (hex) 16 / 0x0401 50 / 0x0C21 60 / 0x0CC1 70 / 0x1061 80 / 0x1401 hostname <string> Optional. Specifies a text string (to override the global router name) to use as the name in the DHCP option 12 field. By default, the hostname is the name configured using the Global Configuration hostname command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, and 2000 Series units.
61200500L1-35E
473
Functional Notes
DHCP allows interfaces to acquire a dynamically assigned IP address from a configured DHCP server on the network. Many Internet Service Providers (ISPs) require the use of DHCP when connecting to their services. Using DHCP reduces the number of dedicated IP addresses the ISP must obtain. Consult your ISP to determine the proper values for the client-id and hostname fields.
Usage Examples
The following example enables DHCP operation on the VLAN interface (labeled 1): (config)#interface vlan 1 (config-interface-vlan 1)#ip address dhcp
61200500L1-35E
474
Syntax Description
release renew Releases DHCP IP address. Renews DHCP IP address.
Default Values
No default values required for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, and 2000 Series units.
Command History
Release 3.1 Command was introduced
Usage Examples
The following example releases the IP DHCP address for the VLAN interface: (config)#interface vlan 1 (config-interface-vlan 1)#ip dhcp release
61200500L1-35E
475
Default Values
By default, this is set to 1500 bytes.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, and 2000 Series units.
Command History
Release 5.1 Command was introduced.
Usage Examples
The following example configures the IP MTU for 2000 bytes: (config)#interface vlan 1 (config-interface-vlan 1)#ip mtu 2000
61200500L1-35E
476
ip unnumbered <interface>
Use the ip unnumbered command to use the IP address assigned to the specified interface for all IP processing on the active interface. Use the no form of this command to remove the unnumbered configuration. Syntax Description
<interface> Specifies the interface (in the format type slot/port) that contains the IP address to use as the source address for all packets transmitted on this interface.
Default Values
By default, all interfaces are configured to use a specified IP address (using the ip address command).
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, and 2000 Series units.
Command History
Release 1.1 Release 11.1 Command was introduced Command was expanded to include demand interfaces.
Functional Notes
If ip unnumbered is enabled on an interface, all IP traffic from the interface will use a source IP address taken from the specified interface. For example, specifying ip unnumbered eth 0/1 while in the Frame Relay Sub-Interface Configuration mode configures the Frame Relay sub-interface to use the IP address assigned to the Ethernet interface for all IP processing. In addition, the AOS uses the specified interface information when sending route updates over the unnumbered interface.
Usage Examples
The following example configures the VLAN interface (labeled vlan 1) to use the IP address assigned to the Ethernet interface (eth 0/1): (config)#interface vlan 1 (config-interface-vlan 1)#ip unnumbered eth 0/1
61200500L1-35E
477
mac-address <address>
Use the mac-address command to specify the Media Access Control (MAC) address of the VLAN interface. Only the last three values of the MAC address can be modified. The first three values contain the ADTRAN reserved number (00:0A:C8) by default. Use the no form of this command to return to the default MAC address programmed by ADTRAN. Syntax Description
<address> MAC address entered in a series of six dual-digit hexadecimal values separated by colons (for example 00:0A:C8:5F:00:D2).
Default Values
A unique default MAC address is programmed in each unit shipped by ADTRAN.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, and 2000 Series units.
Command History
Release 5.1 Command was introduced.
Usage Examples
The following example configures a MAC address of 00:0A:C8:5F:00:D2: (config)#interface vlan 1 (config-interface-vlan 1)#mac-address 00:0A:C8:5F:00:D2
61200500L1-35E
478
snmp trap
Use the snmp trap command to enable all supported Simple Network Management Protocol (SNMP) traps on the interface. Syntax Description
No subcommands.
Default Values
By default, all interfaces (except virtual Frame Relay interfaces and sub-interfaces) have SNMP traps enabled.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, and 2000 Series units.
Command History
Release 1.1 Release 3.1 Release 5.1 Release 6.1 Command was introduced. Command was extended to the SHDSL interface. Command was expanded to include Ethernet sub-interfaces and Gigabit Ethernet interfaces. Command was expanded to include VLAN interfaces.
Usage Examples
The following example enables SNMP capability on the VLAN interface: (config)#interface vlan 1 (config-interface-vlan 1)#snmp trap
61200500L1-35E
479
Default Values
By default, the ifLinkUpDownTrapEnable OID is set to enabled for all interfaces except virtual Frame Relay interfaces.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, and 2000 Series units.
Command History
Release 1.1 Release 3.1 Release 5.1 Release 6.1 Command was introduced. Command was extended to the SHDSL interface. Command was expanded to include Gigabit Ethernet, port channel, VLAN, E1, and G.703 interfaces. Command was expanded to include VLAN interfaces.
Functional Notes
The snmp trap link-status command is used to control the RFC 2863 ifLinkUpDownTrapEnable OID (OID number 1.3.6.1.2.1.31.1.1.1.14.0).
Usage Examples
The following example disables the link-status trap on the VLAN interface: (config)#interface vlan 1 (config-interface-vlan 1)#no snmp trap link-status
61200500L1-35E
480
The following commands are common to multiple command sets and are covered in a centralized section of this guide. For more information, refer to the sections listed below: cross-connect <#> <from interface> <slot/port> <tdm-group#> <to interface> <slot/port> on page 26 do on page 30 end on page 31 exit on page 32 shutdown on page 33 All other commands for this command set are described in this section in alphabetical order. client-identifier <identifier> on page 482 client-name <name> on page 484 default-router <address> <secondary> on page 485 dns-server <address> <secondary> on page 486 domain-name <domain> on page 487 hardware-address <hardware-address> <type> on page 488 host <address> [<subnet mask> or <prefix length>] on page 490 lease <days> <hours> <minutes> on page 491 netbios-name-server <address> <secondary> on page 492 netbios-node-type <type> on page 493 network <address> [<subnet mask> or <prefix length>] on page 494 ntp-server <ip address> on page 495 option <option value> [ascii | hex | ip] <value> on page 496 tftp-server <server> on page 497 timezone-offset <offset> on page 498
61200500L1-35E
481
client-identifier <identifier>
Use the client-identifier command to specify a unique identifier (in dotted hexadecimal notation) for a Dynamic Host Configuration Protocol (DHCP) client. Use the no form of this command to remove a configured client identifier. Syntax Description
<identifier> Specifies a custom client identifier using a text string (that is converted to a hexadecimal equivalent) or 7 to 28 hexadecimal numbers (with colon delimiters). OR Specifies the hexadecimal Media Access Control (MAC) address including a hexadecimal number added to the front of the MAC address to identify the media type. For example, specifying the client-identifier for a MAC address of d217.0491.1150 defines the client identifier as 01:d2:17:04:91:11:50 (where 01 defines the media type as Ethernet). For example, a custom client identifier of 0f:ff:ff:ff:ff:51:04:99:a1 may be entered using the <identifier> option.
Default Values
client-id By default, the client identifier is populated using the following formula: TYPE: INTERFACE SPECIFIC INFO : MAC ADDRESS Where TYPE specifies the media type in the form of one hexadecimal byte (refer to hardware-address <hardware-address> <type> on page 488 for a detailed listing of media types) and MAC ADDRESS is the MAC address assigned to the first Ethernet interface in the unit in the form of six hexadecimal bytes. (For units with a single Ethernet interface, the MAC ADDRESS assigned to Ethernet 0/1 is used in this field). INTERFACE SPECIFIC INFO is only used for Frame Relay interfaces and can be determined using the following: FR_PORT# : Q.922 ADDRESS Where the FR_PORT# specifies the label assigned to the virtual Frame Relay interface using four hexadecimal bytes. For example, a virtual Frame Relay interface labeled 1 would have a FR_PORT# of 00:00:00:01.
61200500L1-35E
482
2 C/R
1 EA EA
DE
Where the FECN, BECN, C/R, DE, and high order EA bits are assumed to be 0, and the lower order extended address (EA) bit is set to 1. The following list provides a few example DLCIs and associated Q.922 addresses: DLCI (decimal) / Q.922 address (hex) 16 / 0x0401 50 / 0x0C21 60 / 0x0CC1 70 / 0x1061 80 / 0x1401
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 2.1 Command was introduced.
Functional Notes
DHCP clients use client identifiers in place of hardware addresses. To create the client-identifier, begin with the two-digit numerical code representing the media type and append the clients MAC address. For example, a Microsoft client with an Ethernet (01) MAC address d2:17:04:91:11:50 uses a client identifier of 01:d2:17:04:91:11:50.
Usage Examples
The following example specifies the client identifier for a Microsoft client with an Ethernet MAC address of d217.0491.1150: (config)#ip dhcp-server pool Microsoft_Clients (config-dhcp)#client-identifier 01:d2:17:04:91:11:50
61200500L1-35E
483
client-name <name>
Use the client-name command to specify the name of a Dynamic Host Configuration Protocol (DHCP) client. Use the no form of this command to remove the configured client name. Syntax Description
<name> Identifies the DHCP client (example is client1) using an alphanumeric string (up to 32 characters in length).
The specified client name should not contain the domain name.
Default Values
By default, there are no specified client names.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 2.1 Command was introduced.
Usage Examples
The following example specifies a client name of myclient: (config)#ip dhcp-server pool MyPool (config-dhcp)#client-name myclient
61200500L1-35E
484
Default Values
By default, there are no specified default routers.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 2.1 Command was introduced.
Functional Notes
When specifying a router to use as the primary/secondary preferred router, verify that the listed router is on the same subnet as the DHCP client. The AOS allows a designation for two routers, listed in order of precedence.
Usage Examples
The following example configures a default router with address 192.22.4.253 and a secondary router with address 192.22.4.254: (config)#ip dhcp-server pool MyPool (config-dhcp)#default-router 192.22.4.253 192.22.4.254
61200500L1-35E
485
Default Values
By default, there are no specified default DNS servers.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 2.1 Command was introduced.
Usage Examples
The following example specifies a default DNS server with address 192.72.3.254 and a secondary DNS server with address 192.100.4.253: (config)#ip dhcp-server pool MyPool (config-dhcp)#dns-server 192.72.3.254 192.100.4.253
61200500L1-35E
486
domain-name <domain>
Use the domain-name command to specify the domain name for the Dynamic Host Configuration Protocol (DHCP) client. Use the no form of this command to remove the configured domain name. Syntax Description
<name> Identifies the DHCP client (e.g., adtran.com) using an alphanumeric string (up to 32 characters in length).
Default Values
By default, there are no specified domain names.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 2.1 Command was introduced.
Usage Examples
The following example specifies a domain name of adtran.com: (config)#ip dhcp-server pool MyPool (config-dhcp)#domain-name adtran.com
61200500L1-35E
487
The valid hardware types are as follows: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 10 Mb Ethernet Experimental 3 Mb Ethernet Amateur Radio AX.25 Proteon ProNET Token Ring Chaos IEEE 802 Networks ARCNET Hyperchannel Lanstar Autonet Short Address LocalTalk LocalNet (IBM PCNet or SYTEK LocalNet) Ultra link SMDS Frame Relay Asynchronous Transmission Mode (ATM) HDLC Fibre Channel Asynchronous Transmission Mode (ATM) Serial Line Asynchronous Transmission Mode (ATM)
61200500L1-35E
488
Default Values
By default, the hardware address type is set to 10 Mbps Ethernet.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 2.1 Command was introduced.
Usage Examples
The following example specifies an Ethernet client with a MAC address of ae:11:54:60:99:10: (config)#ip dhcp-server pool MyPool (config-dhcp)#hardware-address ae:11:54:60:99:10 Ethernet
61200500L1-35E
489
Default Values
By default, there are no specified host addresses.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 2.1 Command was introduced.
Usage Examples
The following examples show two different ways to specify a client with IP address 12.200.5.99 and a 21-bit subnet mask: (config)#ip dhcp-server pool MyPool (config-dhcp)#host 12.200.5.99 255.255.248.0 or (config)#ip dhcp-server pool MyPool (config-dhcp)#host 12.200.5.99/21
61200500L1-35E
490
Default Values
By default, an IP address lease is one day.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 2.1 Command was introduced.
Usage Examples
The following example specifies a lease of 2 days: (config)#ip dhcp-server pool MyPool (config-dhcp)#lease 2 The following example specifies a lease of 1 hour: (config)#ip dhcp-server pool MyPool (config-dhcp)#lease 0 1 The following example specifies a lease of 30 minutes: (config)#ip dhcp-server pool MyPool (config-dhcp)#lease 0 0 30
61200500L1-35E
491
Default Values
By default, there are no configured NetBIOS WINS name servers.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 2.1 Command was introduced.
Usage Examples
The following example specifies a primary NetBIOS WINS name server with an IP address of 172.45.6.99 and a secondary with an IP address of 172.45.8.15: (config)#ip dhcp-server pool MyPool (config-dhcp)#netbios-name-server 172.45.6.99 172.45.8.15
61200500L1-35E
492
netbios-node-type <type>
Use the netbios-node-type command to specify the type of NetBIOS node used with Dynamic Host Configuration Protocol (DHCP) clients. Use the no form of this command to remove a configured NetBIOS node type. Syntax Description
<type> Specifies the NetBIOS node type used with DHCP clients. Valid node types are as follows: b-node (1) - Broadcast node p-node (2) - Peer-to-Peer node m-node (4) - Mixed node h-node (8) - Hybrid node (Recommended) Alternately, the node type can be specified using the numerical value listed next to the nodes above.
Default Values
By default, the netbios-node-type is set to h-node (8) - Hybrid node.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 2.1 Command was introduced.
Usage Examples
The following example specifies a clients NetBIOS node type as h-node: (config)#ip dhcp-server pool MyPool (config-dhcp)#netbios-node-type h-node Alternately, the following also specifies the clients NetBIOS node type as h-node: (config-dhcp)#netbios-node-type 8
61200500L1-35E
493
Default Values
By default, there are no configured DHCP address pools.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 2.1 Command was introduced.
Usage Examples
The following examples show two different ways to configure an address pool subnet of 192.34.0.0 with a 16-bit subnet mask: (config)#ip dhcp-server pool MyPool (config-dhcp)#network 192.34.0.0 255.255.0.0 or (config)#ip dhcp-server pool MyPool (config-dhcp)#network 192.34.0.0 /16
61200500L1-35E
494
Default Values
By default, no NTP server is defined.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 9.1 Command was introduced.
Usage Examples
The following example specifies the IP address of the NTP server: (config)#ip dhcp pool MyPool (config-dhcp)#ntp-server 192.168.1.1
61200500L1-35E
495
Default Values
No default value necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 9.1 Command was introduced.
Usage Examples
The following example publishes DHCP options to the client: (config)#ip dhcp pool MyPool (config-dhcp)#option 100 ascii ascii_value (config-dhcp)#option 101 hex AB458E80 (config-dhcp)#option 102 ip 192.168.1.1
61200500L1-35E
496
tftp-server <server>
Use the tftp-server command to specify the IP address or DNS name of the TFTP server published to the client. Syntax Description
<server> Specifies the DNS name or dotted notation IP address of the server.
Default Values
By default, no tftp server is defined.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 9.1 Command was introduced.
Usage Examples
The following example specifies the IP address of the TFTP server: (config)#ip dhcp pool MyPool (config-dhcp)#tftp-server 192.168.1.1 The following example specifies the DNS name of the TFTP server: (config)#ip dhcp pool MyPool (config-dhcp)#tftp-server MyServer.adtran.com
61200500L1-35E
497
timezone-offset <offset>
Use the timezone-offset command to specify the timezone adjustment (in hours) published to the client. Syntax Description
<offset> Specifies the timezone adjustment (in hours) published to the client. Use an integer from -12 to 12.
Default Values
No default value necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 9.1 Command was introduced.
Usage Examples
The following example sets the timezone adjustment for the client to -3 hours. For example, if the server time is configured for eastern time and the client is configured for Pacific time, you can set the client timezone adjustment to -3 hours: (config)#ip dhcp pool MyPool (config-dhcp)#timezone-offset -3
61200500L1-35E
498
The following commands are common to multiple command sets and are covered in a centralized section of this guide. For more information, refer to the sections listed below: cross-connect <#> <from interface> <slot/port> <tdm-group#> <to interface> <slot/port> on page 26 description <text> on page 29 do on page 30 end on page 31 exit on page 32 shutdown on page 33 All other commands for this command set are described in this section in alphabetical order. server [acct-port <port number>| auth-port <port number>] on page 500
61200500L1-35E
499
Default Values
No defaults necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 5.1 Command was introduced.
Usage Examples
The following example adds a server to the myServers list: (config)#aaa group server radius myServers (config-sg-radius)#server 1.2.3.4 acct-port 786 auth-port 1812 (config-sg-radius)#server 4.3.2.1 (config-sg-radius)#exit (config)# or (config)#aaa group server radius myServers (config-sg-radius)#server 4.3.2.1 (config-sg-radius)#exit (config)#
61200500L1-35E
500
The following commands are common to multiple command sets and are covered in a centralized section of this guide. For more information, refer to the sections listed below: do on page 30 end on page 31 exit on page 32 All other commands for this command set are described in this section in alphabetical order. server <host> on page 502
61200500L1-35E
501
server <host>
Use the server command to specify a particular TACACS+ servers IP address or host name. Syntax Description
<host> Specifies a TACACS+ server IP address.
Default Values
No default is necessary for this command.
Applicable Platforms
This command applies to the NetVanta 300, 1000, 1000R, 2000, 3000, 4000, and 5000 and Total Access 900 Series units.
Command History
Release 11.1 Command was introduced.
Usage Examples
The following example specifies the IP address of the TACACS+ server: (config)#aaa group server tacacs+ TEST_GROUP (config-sg-tacacs+)#server 192.168.1.1 (config-sg-tacacs+)#
61200500L1-35E
502
Index
aaa processes 223 abort 461 access-class in 358, 366 accounting commands 345, 359, 367 alias 25 apply 462 arp arpa 224, 377, 433, 470 authorization commands 346, 360, 368
B
bandwidth 420 banner 227 basic 8 Basic Mode command set 14 boot system flash 228 bridge protocol 229
C
channel-group mode on 378 clear arp-cache 36 clear arp-entry 37 clear buffers max-used 38 clear counters 39 clear counters port-channel 40 clear counters vlan 41 clear dump-core 42 clear event-history 43 clear gvrp statistics 44 clear ip dhcp-server binding 45 clear lldp counters 46 clear lldp counters interface 47 clear lldp neighbors 48 clear mac address-table dynamic 49 clear port-security 50 clear port-security violation-count 51 clear processes cpu max 52 clear spanning-tree counters 53 clear spanning-tree detected-protocols 54 clear tacacs+ statistics 55 clear user 56 CLI
accessing with PC 7 error messages 12 introduction 7 shortcuts 9 client-identifier 482 client-name 484 clock auto-correct-dst 57, 230 clock no-auto-correct-dst 58 clock set 59, 231 clock timezone 60, 232 command descriptions 13 command level path 9
console port
configuring 7 receiving files 68 copy 64 copy console 65 copy flash 66 copy tftp 67 copy xmodem 68 cross-connect 26, 235 customer service 3
D
databits 347 debug 11 debug aaa 69 debug auto-config 70 debug data-call 71 debug dynamic-dns 72 debug gvrp bpdus 73 debug gvrp interface 74 debug gvrp vlans 75 debug interface 76 debug ip dhcp-client 77 debug ip dhcp-server 78 debug ip dns-client 79 debug ip dns-proxy 80 debug ip http 81 debug ip icmp 82 debug ip mrouting 83 debug ip tcp events 84 debug ip udp 86 debug lldp 88 debug port security 90 debug port-auth 89 debug radius 91 debug sntp 92 debug spanning-tree 94
61200500L1-35E
503
Index
debug spanning-tree bpdu 93 debug stack 95 debug system 96 default-router 485 description 29 DHCP Pool command set 481 dir 97, 98 disable, basic mode 15 disable, enable mode 99 dns-server 486 do 30 domain-name 487 dynamic-dns 379, 421
E
enable 15, 100 Enable Mode command set 34 enable password 238 enable, basic mode 15, 100 enable, enable mode 34 enable, understanding 8 end 31 erase 101 Ethernet Interface Configuration command set 374 Ethernet Sub-Interface Configuration command set 374 event-history on 240 event-history priority 240, 241 events 102 exception report 243 exception report generate 103 exit 32
F
flowcontrol 348 ftp authentication 244 full-duplex 381
G
garp timer 245 Gigabit-Ethernet Interface Configuration command set
374
interface port-channel 432 interface range 249, 374 interface vlan 469 ip access-group 423 ip access-list extended 250 ip access-list standard 256 ip address 424, 471 ip address dhcp 472 ip address secondary 424 ip default-gateway 260 ip dhcp 475 ip dhcp-server database local 261 ip dhcp-server excluded-address 262 ip dhcp-server ping packets 263 ip dhcp-server ping timeout 264 ip dhcp-server pool 265, 481 ip domain-lookup 266 ip domain-name 267 ip domain-proxy 268 ip ftp access-class 269 ip ftp agent 270 ip ftp source-interface 271 ip helper-address 425 ip host 272 ip http 273 ip mtu 476 ip name-server 274 ip radius source-interface 275 ip route-cache 427 ip scp server 276 ip snmp agent 277 ip sntp source-interface 278 ip ssh-server 279 ip telnet-server 279 ip tftp source-interface 280 ip unnumbered 428, 477
L
lease 491 Line (Console) Interface Configuration command set 344 Line (Ssh) Interface Configuration command set 357 Line (Telnet) Interface Configuration command set 365 line console 281, 344 line ssh 281, 357 line telnet 281, 365 line-timeout 349, 361, 369 lldp 283 lldp receive 384, 434 lldp send 385, 435 logging console 285 logging email address list 286 logging email address-list 288
H
half-duplex 383 hardware-address 488 host 490 hostname 247
I
interface 248 interface ethernet 374 interface ethernet sub 374 interface gigabit-ethernet 374 interface loopback 419
61200500L1-35E
504
Index
logging email exception-report address list 287 logging email on 288 logging email priority-level 289 logging email receiver-ip 290 logging email source-interface 292 logging facility 293 logging forwarding on 295 logging forwarding priority-level 295, 296 logging forwarding receiver-ip 297 logging forwarding source-interface 298 login 350, 362, 370 login authentication 351, 363, 371 login local-userlist 352, 364, 372 logout 16, 104 Loopback Interface Configuration command set 419
qos cos-map 307 qos dscp-cos 308 qos queue-type strict-priority 309 qos queue-type wrr 310
R
Radius Group command set 499 radius-server 311 radius-server host 313 reload 108 reset 463
S
server 500, 502 service password-encryption 314 shortcuts 9 show 464 show arp 109 show auto-config 110 show buffers 111 show buffers users 112 show channel-group 114 show clock 19, 115 show configuration 116 show debugging 118 show dynamic-dns 119 show event-history 120, 240 show flash 121 show garp timer 122 show gvrp configuration 123 show gvrp statistics interface 124 show hosts 125 show interfaces 126 show interfaces switchport 130 show ip arp 131 show ip dhcp-client lease 132 show ip dhcp-server binding 133 show ip interfaces 134 show ip traffic 135 show lldp 136 show lldp device 137 show lldp interface 138 show lldp neighbors interface 139 show lldp neighbors statistics 141 show mac address-table 142 show mac address-table address 144 show mac address-table aging-time 146 show mac address-table count 147 show mac address-table dynamic 148 show mac address-table interface 150 show mac address-table static 151 show memory 153 show monitor session 155
M
mac address-table aging-time 299 mac address-table static 300 mac-address 478 media 457 monitor session 301 mtu 429
N
name 458 netbios-name-server 492 netbios-node-type 493 network 494 no enable password 238 ntp-server 495
O
option 496
P
parity 353 password 354, 373 ping 17, 105 ping stack-member 107 port-auth auth-mode 387 port-auth control-direction 388 port-auth default 302 port-auth max-req 303 port-auth multiple-hosts 389 port-auth port-control 390 port-auth re-authentication 304 port-auth timeout 305 Port-Channel Interface Configuration command set 432 port-channel load-balance 306 power inline 391 preventing unauthorized users 8 product support 3
Q
qos 392, 437
61200500L1-35E
505
Index
show output-startup 156 show port-auth 157 show port-security 159 show power inline 160 show processes 162 show qos 164 show radius statistics 166 show running-config 167 show snmp 20, 169 show sntp 170 show spanning-tree active 172 show spanning-tree blockedports 173 show spanning-tree interface ethernet 175 show spanning-tree interface gigabit-ethernet 176 show spanning-tree interface port-channel 177 show spanning-tree pathcost method 178 show spanning-tree realtime 179 show spanning-tree root 181 show spanning-tree summary 182 show spanning-tree, status 171 show stack 183 show startup-config 186 show startup-config checksum 188 show tacacs+ statistics 189 show tcp info 190 show users 192 show version 21, 194 show vlan 195 shutdown 33 snmp trap 393, 430, 438, 479 snmp trap link-status 394, 431, 439, 480 snmp-server chassis-id 315 snmp-server community 316 snmp-server contact 317, 318 snmp-server enable traps 319 snmp-server host traps 320 snmp-server host traps version 321 snmp-server location 322 snmp-server management-url 323 snmp-server management-url-label 324 snmp-server source-interface 325 snmp-server view 326 sntp retry-timeout 327 sntp server 328 sntp wait-time 329 spanning-tree bpdufilter 395, 440 spanning-tree bpduguard 396, 441 spanning-tree bpduguard default 331 spanning-tree cost 442 spanning-tree edgeport 397, 443 spanning-tree edgeport bpdufilter default 330
spanning-tree edgeport default 332 spanning-tree forward-time 333 spanning-tree hello-time 334 spanning-tree link-type 398, 444 spanning-tree max-age 335 spanning-tree mode 336 spanning-tree pathcost 337 spanning-tree pathcost method 399 spanning-tree port-priority 400, 445 spanning-tree priority 338 speed 355, 401 stack 339 state 459 stopbits 356 storm-control 402, 446 storm-control action 404, 448 switchport access vlan 405 switchport gvrp 406, 450 switchport mode 407 switchport port-security 409 switchport port-security aging 410 switchport port-security expire 411 switchport port-security mac-address 412 switchport port-security maximum 413 switchport port-security violation 414 switchport protected 408 switchport trunk allowed vlan 415 switchport trunk fixed vlan 416, 453 switchport trunk native vlan 418
T
TACACS Plus Group Configuration command set 501 tacacs-server 341 telnet 22, 197 telnet stack-member 198 terminal length 199 tftp-server 497 timezone-offset 498 traceroute 23, 200 training 5
U
unauthorized users 8 undebug all 201 username password 342
V
vlan 343
command set 456 media 466 name 467 state 468 vlan id 465
61200500L1-35E
506
Index
vlan database 202 VLAN Database Configuration command set 460 VLAN Interface Configuration command set 469 VT100 configuration 7
W
warranty 3 write 204
61200500L1-35E
507