|
|
This chapter describes the general commands used in the Catalyst 5000 series ATM module CLI. For a summary of the ATM CLI commands, refer to the "ATM Command Quick Reference" chapter. For more information about the ATM CLI, refer to the "ATM Command-Line Interface" chapter.
Other commands are described elsewhere in this publication:
ATM module CLI:
show commands are described in the "ATM show Commands" chapter
Switch CLI:
Use the atm bind pvc vlan interface configuration command to bind a permanent virtual circuit (PVC) to a specified VLAN.
atm bind pvc vlan vcd vlan_num| vcd | Virtual circuit descriptor, a unique number for each switch that identifies which VPI/VCI to use for a particular packet. |
| vlan_num | Number of the VLAN. |
Cisco IOS ATM command.
Interface configuration.
You can bind any number of PVCs to the same VLAN. To prevent loops, each PVC must uniquely connect a VLAN group between two Catalyst 5000 series switches.
This example shows how to bind PVC 10 to VLAN 5 and PVC 11 to VLAN 5:
ATM(config-if)#atm bind pvc vlan 10 5 ATM(config-if)#atm bind pvc vlan 11 5
Use the atm ilmi-keepalive interface configuration command to enable ILMI keepalives. To disable ILMI keepalives, use the no form of this command.
[no] atm ilmi-keepalive seconds| seconds | Number of seconds between keepalives. |
The default is three seconds. Values less than three seconds are rounded to three seconds. There is no upper boundary to the range of values.
Cisco IOS ATM command.
Interface configuration.
This example shows how to set the number of seconds between ILMI keepalives:
ATM(config-if)#atm ilmi-keepalive 5
Use the atm preferred phy interface configuration command to change the preferred PHY to the one not currently in use.
atm preferred phy {A | B}| A | Keyword that indicates PHY A. |
| B | Keyword that indicates PHY B. |
The default is PHY A.
Cisco IOS dual-PHY ATM command.
Interface configuration.
Use this command with dual PHYs connected to the same or different switches.
This example shows how to specify PHY A as the preferred PHY:
ATM#configure terminal Enter configuration commands, one per line. End with Ctrl-Z. ATM(config)#interface atm0 ATM(config-subif)#atm preferred phy A ATM(config-subif)#end ATM#
show lane default-atm-addresses
Use the atm pvc interface configuration command to create a PVC on the Catalyst 5000 series switch interface. The no form of this command deletes the specified PVC.
[no] atm pvc vcd vpi vci [aal5snap | ilmi | qsaal]
| vcd | Virtual circuit descriptor; a unique number for each Catalyst 5000 series switch that identifies which VPI/VCI to use for a particular packet. |
| vpi | VPI for the PVC. The range of vpi is 0 to 255. The VPI value is unique only on a single interface, not throughout the ATM network. |
| vci | VCI for the PVC. The range of vci is 0 to 65535. The VCI value is unique only on a single interface, not throughout the ATM network. |
| aal5snap | (Optional) Keyword that specifies the use of AAL5 with LLC/SNAP encapsulation. |
| ilmi | (Optional) Keyword that specifies the use of ILMI. |
| qsaal | (Optional) Keyword that specifies signaling AAL. |
| peak_rate | (Optional) Maximum rate (in kbps) at which this virtual circuit can transmit. The range for peak_rate is 0 to 155000. Available in ATM PVC traffic-shaping software release 50.1(1) and later. The maximum rate for peak_rate in ATM PVC traffic-shaping software release 51.1(1) and later is 45000 kbps. |
| average_rate | (Optional) Average rate (in kbps) at which this virtual circuit can transmit. The range for average_rate is 0 to 1000. Available in ATM PVC traffic-shaping software release 50.1(1) and later, and 51.1(1) and later. |
| burst_size | (Optional) Burst cell size in number of cells. Acceptable values for burst_size is 0 to 1. Available in ATM PVC traffic shaping software releases 50.1(1) and later, and software release 51.1(1) and later. |
| oam seconds | (Optional) Keyword that specifies how often to generate an OAM 5 loopback cell from this virtual circuit. Available in ATM PVC traffic-shaping software releases 50.1(1) and later, and software release 51.1(1) and later. |
If the peak_rate and average_rate options are omitted, the PVC defaults to the highest bandwidth rate queue available. By default, the VC is configured to run as fast as possible. If the oam keyword is omitted, OAM cells are not generated. If the oam keyword is used without specifying seconds, the default value of 10 seconds is used.
Cisco IOS ATM command.
Interface configuration.
The atm pvc command creates a PVC and attaches it to the VPI and VCI specified. You cannot specify both vpi and vci as 0.
If you are configuring an SVC, you must use this command to configure the PVC that handles the SVC call setup and termination. In this case, specify the qsaal keyword.
The peak_rate argument determines the size of the rate queue used. ATM PVC traffic-shaping software release 50.1(1) and later, and software release 51.1(1) and later dynamically create rate queues to satisfy the specifications of atm pvc commands. When an atm pvc command specifies a peak rate that does not match any use-configured rate queue, a rate queue is created dynamically.
The oam keyword causes the Catalyst 5000 series switch to generate and echo OAM F5 loopback cells, used to verify connectivity. Once OAM cell generation is enabled, OAM cells are transmitted periodically. The remote end must respond by echoing back the cells.
This example shows how to create a PVC to be used for ATM signaling for an SVC, using VPI 0 and VCI 5:
ATM(config-if)# atm pvc 1 0 5 qsaal
This example shows how to create a PVC in ATM PVC traffic-shaping software release 50.1, specifying the peak and average rates and OAM cell generation:
ATM(config-if)# atm pvc 1 0 5 aal5snap 155000 1000 oam
Use the atm traffic-shape rate interface configuration command to configure output throttling on your Catalyst 5000 series switch ATM module. The no form of the command returns the output rate to the default.
[no] atm traffic-shape rate 1-155| 1-155 | Number between 1 and 155 indicating Mbps. |
The default is 155 Mbps.
Cisco IOS ATM command.
Interface configuration.
This example shows how to set the output throttle to 50:
ATM(config)# int atm0 ATM(config-if)# atm traffic-shape rate 50 ATM(config-if)# end
Use the atm uni-version interface configuration command to specify the UNI version (3.0 or 3.1) the switch should use when ILMI link autodetermination is unsuccessful or ILMI is disabled. The no form of this command restores the version to the default.
atm uni-version version_num| version_num | UNI version for the interface. Valid values are 3.0 or 3.1. |
The default UNI version is 3.0.
Cisco IOS ATM command.
Interface configuration.
This example shows how to set the UNI version to 3.1:
ATM(config)# atm uni-version 3.1
Use the atm vc-per-vp interface configuration command to set the maximum number of VCIs to support per VPI. The no form of this command restores the default value.
atm vc-per-vp number| number | Maximum number of VCIs to support per VPI. Valid values are 32, 64, 128, 256, 512, and 1024. |
By default, the maximum number of VCIs to support per VPI is 1024.
Cisco IOS ATM command.
Interface configuration.
This command controls the memory allocation in the Catalyst 5000 series switch for the VCI table. It defines the maximum number of VCIs to support per VPI; it does not designate the VCI numbers.
An invalid VCI causes a warning message to be displayed.
This example shows how to set the maximum number of VCIs to support per VPI to 512:
ATM(config-if)# atm vc-per-vp 512
Use the atmsig close EXEC command to disconnect a particular SVC.
atmsig close atm0 vcd| atm0 | Keyword used to specify the atm0 interface number to close the SVC, because VCs are numbered per interface. |
| vcd | Virtual circuit descriptor of the SVC to close. |
Cisco IOS ATM command.
EXEC.
This example shows how to close SVC 2 on the ATM module:
ATM#atmsig close atm0 2
Use the client-atm-address name database configuration command to add a LANE address entry to the configuration server's database. The no form of this command removes a client address entry from the table.
client-atm-address atm-address-template name elan-name| atm-address-template | Template that explicitly specifies an ATM address or a specific part of an ATM address and uses wildcard characters for other parts of the ATM address, making it convenient to specify multiple addresses matching the explicitly specified part.
Wildcard characters can replace any nibble or group of nibbles in the prefix, the ESI, or the selector fields of the ATM address. |
| name elan-name | Name of the ELAN. The maximum length of elan-name is 32 characters. |
By default, no address and no ELAN name are configured.
Database configuration.
Using this command binds to the specified ELAN any client whose address matches the specified template. When a client comes up, it consults the LANE configuration server, which responds with the ATM address of the LANE server for the ELAN. The client then initiates join procedures with the LANE server.
The ELAN specified by the elan-name argument must be created using the name server-atm-address command before the client-atm-address command is used.
If an existing entry in the configuration server's database binds the LANE client ATM address to a different ELAN, the new command is rejected.
This command affects only the bindings in the named configuration server database. It has no effect on the LANE components themselves.
A LANE ATM address has the same syntax as a NSAP, but is not a network-level address:
LANE ATM address templates can use two types of wildcards: an asterisk (*) to match any single character and an ellipsis (...) to match any number of leading or trailing characters.
In LANE, a prefix template explicitly matches the prefix but uses wildcards for the ESI and selector fields. An ESI template explicitly matches the ESI field but uses wildcards for the prefix and selector.
In our implementation of LANE, the prefix corresponds to the specific subinterface of the interface.
This example uses an ESI template to specify the part of the ATM address corresponding to an interface. This template allows any client on any subinterface of the interface that corresponds to the displayed ESI value, no matter which switch the router is connected to, to join the engineering ELAN:
ATM(lane-config-database)#client-atm-address ...0800.200c.1001.** name engineering
This example uses a prefix template to specify the part of the ATM address corresponding to the switch. This template allows any client on the subinterface of any interface connected to the switch that corresponds to the displayed prefix to join the marketing ELAN:
ATM(lane-config-database)#client-atm-address 47.000014155551212f.00.00... name marketing
default-name
lane database
name server-atm-address
Use the default-name database configuration command to provide an ELAN name in the configuration server's database for those client MAC addresses and client ATM addresses that do not have explicit ELAN name bindings. Use the no form of this command to remove the default name.
default-name elan-name| elan-name | Default ELAN name for any LANE client MAC address or LANE client ATM address not explicitly bound to any ELAN name. The maximum length of elan-name is 32 characters. |
By default, no name is configured.
Cisco IOS ATM command.
Database configuration.
This command affects only the bindings in the configuration server's database. It has no effect on the LANE components themselves.
The named ELAN must already exist in the configuration server's database before this command is used. If the default name-to-ELAN name binding already exists, the new binding replaces it.
client-atm-address name
lane database
name server-atm-address
Use the disable EXEC command to exit privileged EXEC mode and return to user EXEC mode. After executing this command, the angle-bracket (>) prompt appears.
disable [level]| level | (Optional) Indicates the privilege level to reduce to. |
This command has no default setting.
Cisco IOS ATM command.
EXEC.
Use this command with the level option to reduce the privilege level. If a level is not specified, it defaults to the user EXEC mode, which is level 1.
This example shows how to cause the system to exit privileged EXEC mode and return to user EXEC mode, as indicated by the angle bracket (>) prompt:
ATM#disable ATM>
Use the editing line configuration command to enable enhanced editing mode. Use the no form of this command to disable enhanced editing mode.
[no] editingThis command has no arguments or keywords.
Cisco IOS ATM command.
Enabled.
Line configuration.
Table 11-1 describes the keys used to enter and edit commands. CTRL indicates the Control key. You must press CTRL simultaneously with the associated letter key. Esc indicates the Escape key. ESC must be pressed first, followed by the associated letter key. Keys are not case sensitive.
| Keys | Function |
|---|---|
| Tab | Completes a partial command name entry. When you enter a unique set of characters and press the Tab key, the system completes the command name. If you enter a set of characters that could indicate more than one command, the system beeps to indicate an error. Enter a question mark (?) immediately following the partial command (no space). The system provides a list of commands that begin with that string. |
| Delete or Backspace | Erases the character to the left of the cursor. |
| Return | At the command line, pressing the Return key processes a command. At the "---More---" prompt on a terminal screen, pressing the Return key scrolls down a line. |
| Spacebar | Allows you to see more output on the terminal screen. Press the Spacebar when you see "---More---" on the screen to display the next screen. |
| Left Arrow1 | Moves the cursor one character to the left. When you enter a command that extends beyond a single line, you can press the left arrow key repeatedly to scroll back toward the system prompt and verify the beginning of the command entry. |
| Right Arrow1 | Moves the cursor one character to the right. |
| Up Arrow1 or Ctrl-P | Recalls commands in the history buffer, beginning with the most recent command. Repeat the key sequence to recall successively older commands. |
| Down Arrow1 or Ctrl-N | Returns to more recent commands in the history buffer after recalling commands with the up arrow or Ctrl-P. Repeats the key sequence to recall successively more recent commands. |
| Ctrl-A | Moves the cursor to the beginning of the line. |
| Ctrl-B | Moves the cursor back one character. |
| Ctrl-D | Deletes the character at the cursor. |
| Ctrl-E | Moves the cursor to the end of the command line. |
| Ctrl-F | Moves the cursor forward one character. |
| Ctrl-K | Deletes all characters from the cursor to the end of the command line. |
| Ctrl-L or Ctrl-R | Redisplays the system prompt and command line. |
| Ctrl-T | Transposes the character to the left of the cursor with the character located at the cursor. |
| Ctrl-U or Ctrl-X | Deletes all characters from the cursor back to the beginning of the command line. |
| Ctrl-V or Esc Q | Inserts a code to indicate to the system that the keystroke immediately following should be treated as a command entry, not as an editing key. |
| Ctrl-W | Deletes the word to the left of the cursor. |
| Ctrl-Y | Recalls the most recent entry in the delete buffer. The delete buffer contains the last ten items you have deleted or cut. Ctrl-Y can be used in conjunction with Esc Y. |
| Ctrl-Z | Ends configuration mode and returns to the EXEC prompt. |
| Esc B | Moves the cursor back one word. |
| Esc C | Capitalizes from the cursor to the end of the word. |
| Esc D | Deletes from the cursor to the end of the word. |
| Esc F | Moves the cursor forward one word. |
| Esc L | Changes to lowercase from the cursor to the end of the word. |
| Esc U | Capitalizes from the cursor to the end of the word. |
| Esc Y | Recalls the next buffer entry. The buffer contains the last ten items you have deleted. Press Ctrl-Y first to recall the most recent entry. Then press Esc Y up to nine times to recall the remaining entries in the buffer. If you bypass an entry, continue to press Esc Y to cycle back to it. |
This example shows how to disable enhanced editing mode on virtual terminal line 3:
ATM#config terminal Enter configuration commands, one per line. End with Ctrl-Z. ATM(config)# line vty 3 ATM(config-line)# no editing ATM(config-line)#
Use the enable EXEC command to enter privileged EXEC mode.
enableThis command has no arguments or keywords.
This command has no default setting.
Cisco IOS ATM command.
EXEC.
If the system administrator has set a password with the enable password global configuration command, you are prompted to enter the password before being allowed access to privileged EXEC mode. The password is case sensitive. The default password on the ATM module is atm.
This example shows how to cause the system to enter privileged command mode, as indicated by the pound sign (#):
ATM> enable Password: <password> ATM#
Use the end global configuration command to exit configuration mode.
endThis command has no arguments or keywords.
This command has no default setting.
Cisco IOS ATM command.
Global configuration.
You can also press Ctrl-Z to exit configuration mode.
This example shows how to exit configuration mode and return to EXEC mode:
ATM(config)# end ATM#
Use the exit command at the system prompt to exit any command mode or close an active terminal session and terminate the EXEC.
exitThis command has no arguments or keywords.
This command has no default setting.
Cisco IOS ATM command.
Available in all command modes.
When you enter the exit command at the EXEC level, the EXEC session is ended. Use the exit command at the configuration level to return to privileged EXEC mode. Use the exit command in interface and line command modes to return to global configuration mode. Use the exit command in subinterface configuration mode to return to interface configuration mode. You can also press Ctrl-Z in any configuration mode to return to privileged EXEC mode.
This example shows how to exit an active session:
ATM> exit
Use the help command to display a brief description of the help system.
helpThis command has no arguments or keywords.
Cisco IOS ATM command.
Available in all ATM command modes.
This example shows how to display a brief description of the context-sensitive help system:
Enter the help command for a brief description of the help system:
ATM#help Help may be requested at any point in a command by entering a question mark '?'. If nothing matches, the help list will be empty and you must backup until entering a '?' shows the available options. Two styles of help are provided: 1. Full help is available when you are ready to enter a command argument (e.g. 'show ?') and describes each possible argument. 2. Partial help is provided when an abbreviated argument is entered and you want to know what arguments match the input (e.g. 'show pr?'.)
This example shows how to use word help to display the privileged EXEC commands that begin with the letters co:
ATM#co? configure copy
Use the history line configuration command to enable the command history function or to change the command history buffer size for a particular line. Use the no form of this command to disable the command history feature.
[no] history [size number-of-lines]| size number-of-lines | (Optional) Specifies the number of command entries that the system will record in its history buffer. The range of number-of-lines is 0 to 256. |
By default, number-of-lines is set to 10.
Cisco IOS ATM command.
Line configuration.
The command history feature provides a record of EXEC commands you have entered. This feature is particularly useful for recalling long or complex commands or entries, such as access lists.
The history command enables the history function with the last buffer size specified or with the default of ten lines if there was not a prior setting. The history size number-of-lines command sets the number of command entries stored in the command history buffer.
The no history command disables the history feature but remembers the buffer size if it was set to a value other than the default. The no history size command resets the buffer size to the default.
Table 11-2 lists the keys and functions you can use to recall commands from the command history buffer.
| Key | Function |
|---|---|
| Up Arrow or Ctrl-P1 | Recalls commands in the history buffer in a backward sequence, beginning with the most recent command. Repeat the key sequence to recall successively older commands. |
| Down Arrow or Ctrl-N1 | Returns to more recent commands in the history buffer after recalling commands with the up arrow or Ctrl-P. Repeat the key sequence to recall successively more recent commands. |
This example shows how to configure virtual terminal line 4 with a history buffer size of 35 lines:
ATM#config terminal Enter configuration commands, one per line. End with Ctrl-Z. ATM(config)# line vty 4 ATM(config-line)# history size 35 ATM(config-line)#
Use the lane auto-config-atm-address interface configuration command to specify that the configuration server ATM address be computed by the automatic method. To remove the previously assigned ATM address, use the no form of this command.
[no] lane auto-config-atm-addressThis command has no keywords or arguments.
No specific ATM address or method is set.
Cisco IOS ATM command.
Interface configuration.
When applied to a subinterface, this command causes the LANE server and LANE client on the subinterface to use the automatically assigned ATM address (rather than the ATM address provided by the ILMI) to locate the configuration server.
If applied to a LANE configuration server on a major interface, this command assigns an ATM address to the configuration server configured on the interface.
Multiple commands that assign ATM addresses to the LANE configuration server can be issued on the same interface to assign different ATM addresses to the configuration server. Commands that assign ATM addresses to the LANE configuration server include lane auto-config-atm-address, lane config-atm-address, and lane fixed-config-atm-address.
The lane config command and at least one command that assigns an ATM address to the LANE configuration server are required to activate a LANE configuration server.
This example shows how to associate the LANE configuration server with the database name network1 and how to specify that the configuration server's ATM address be assigned using the automatic method:
ATM(config-if)# lane auto-config-atm-address lane database network1 name eng server-atm-address 39.0000014155551211.0800.AA00.1001.02 name mkt server-atm-address 39.0000014155551211.0800.AA00.4001.01 lane config network1 lane auto-config-atm-address
lane config database
lane config-atm-address
Use the lane client interface configuration command to activate a LANE client on the specified subinterface. To remove a previously activated LANE client on the subinterface, use the no form of this command.
lane client ethernet vlan_num [elan-name]| ethernet | Keyword that indicates the type of ELAN attached to the interface. |
| vlan_num | Number of the VLAN that corresponds to the specified ELAN. |
| elan-name | (Optional) Name of the ELAN. This argument is optional because the client obtains its ELAN name from the configuration server. Maximum length for elan-name is 32 characters. |
None.
Cisco IOS LANE command.
Interface configuration.
If a lane client command has already been entered on the subinterface for a different ELAN, the client initiates termination procedures for that ELAN and joins the new ELAN.
If you do not provide an elan-name value, the client contacts the server to find which ELAN to join. If you do provide an elan-name value, the client consults the configuration server to ensure that no conflicting bindings exist.
This example shows how to activate the LANE client for a VLAN 3 called eng:
ATM(config-if)# lane client ethernet vlan 3 eng
Use the lane client-atm-address interface configuration command to specify an ATM address and to override automatic ATM address assignment for the LANE client on the specified subinterface. To remove the ATM address previously specified for the LANE client on the specified subinterface and revert to automatic address assignment, use the no form of this command.
lane client-atm-address atm-address-template| atm-address-template | ATM address, or a template in which wildcard characters are replaced by any nibble or group of nibbles of the prefix bytes, the ESI bytes, or the selector byte of the automatically assigned ATM address. |
Automatic ATM address assignment.
Cisco IOS LANE command.
Interface configuration.
Use of this command on a selected subinterface, but with a different ATM address than was used previously, replaces the LANE client's ATM address.
A LANE ATM address has the same syntax as an NSAP (but it is not a network-level address):
LANE ATM address templates can use two types of wildcards: an asterisk (*) to match any single character and an ellipsis (...) to match any number of leading or trailing characters. The values of the characters replaced by wildcards come from the automatically assigned ATM address.
In LANE, a prefix template explicitly matches the ATM address prefix but uses wildcards for the ESI and selector fields. An ESI template explicitly matches the ESI field but uses wildcards for the prefix and selector.
In Cisco's implementation of LANE, the prefix corresponds to the switch, the ESI corresponds to the ATM interface, and the Selector field corresponds to the specific subinterface of the interface.
This example shows how to use an ESI template to specify the part of the ATM address corresponding to the interface; the remaining parts of the ATM address come from automatic assignment, designated by the double asterisks:
ATM(config-if)# lane client-atm-address...0800.200C.1001.**
This example shows how to use a prefix template to specify the part of the ATM address corresponding to the switch; the remaining parts of the ATM address come from automatic assignment, designated by the ellipses:
ATM(config-if)# lane client-atm-address 47.000014155551212f.00.00...
Use the lane config-atm-address interface configuration command to specify the ATM address of a given configuration server. To remove an assigned ATM address, use the no form of this command.
lane config-atm-address atm-address-template| atm-address-template | ATM address, or a template in which wildcard characters are replaced by any nibble or group of nibbles of the prefix bytes, the ESI bytes, or the selector byte of the automatically assigned ATM address. |
By default, no specific ATM address or method is set.
Cisco IOS LANE command.
Interface configuration.
This command causes the LANE client on the subinterface to use the specified ATM address (rather than the ATM address provided by the ILMI) to locate the configuration server.
A LANE ATM address has the same syntax as an NSAP (but it is not a network-level address):
LANE ATM address templates can use two types of wildcards: an asterisk (*) to match any single character, and an ellipsis (...) to match any number of leading or trailing characters. The values of the characters replaced by wildcards come from the automatically assigned ATM address.
In LANE, a prefix template explicitly matches the ATM address prefix but uses wildcards for the ESI and selector fields. An ESI template explicitly matches the ESI field but uses wildcards for the prefix and selector.
In Cisco's implementation of LANE, the prefix corresponds to the switch, the ESI corresponds to the ATM interface, and the Selector field corresponds to the specific subinterface of the interface.
This example shows how to specify the ATM address of the LANE configuration server:
ATM(config-subif)# lane config-atm-address 39.000000000000014155551211.0800200c1001.00
Use the lane config database interface configuration command to associate a named configuration table (database) with the configuration server on the selected ATM interface. To remove the association between a named database and the configuration server, use the no form of this command.
lane config database database-name| database-name | Name of the LANE database. |
By default, no configuration server is defined and no database name is provided.
Cisco IOS LANE command.
Interface configuration.
This command is valid only on a major interface, not a subinterface, because only one LANE configuration server can exist for a switch cloud.
The named database must exist before the lane config database command is entered. Refer to the lane database command for more information.
Multiple lane config database commands cannot be entered on the same interface. You must delete an existing association using the no form of this command before you can enter a new association.
Activating a LANE client requires the lane config database command and one of the following commands: lane fixed-config-atm-address, lane auto-config-atm-address, or lane config-atm address.
This example shows how to associate a named configuration database with the configuration server:
ATM(config)# int atm0 ATM(config-if)# lane config database test
lane auto-config-atm-address
lane config-atm-address
lane database
Use the lane database global configuration command to create a named configuration database that can be associated with a configuration server when one is configured. Use the no form of this command to delete all entries in the specified database.
[no] lane database database-name| database-name | Database name (32 characters maximum). |
By default, no name is provided.
Cisco IOS LANE command.
Global configuration.
A LANE database contains entries that bind an ELAN name to the ATM address of the LANE server; bind LANE client MAC addresses to an ELAN name; and bind LANE client ATM address templates to an ELAN name.
Issuing the lane database command places you in database configuration mode, in which you can use the client-atm-address name, default name, mac-address name, and name server-atm-address commands to create entries in the specified database. When you are done creating entries, type Ctrl-Z or exit to return to global configuration mode.
This example shows how to create a configuration database named test:
ATM(config)# int atm0 ATM(config-if)# lane database test ATM(lane-config-database)# end
client-atm-address name
default-name
name server-atm-address
Use the lane le-arp interface configuration command to add a static entry to the LE ARP table of the LANE client configured on the subinterface. To remove a static entry, use the no form of this command.
[no] lane le-arp mac-addr atm-addr| mac-address | MAC address to bind to the specified ATM address. |
| atm-address | ATM address to bind to the specified MAC address. |
By default, no static address bindings are provided.
Cisco IOS LANE command.
Interface configuration.
This command only adds or removes a static entry binding a MAC address to an ATM address. It does not add or remove dynamic entries. Removing the static entry for a specified ATM address from an LE ARP table does not release Data Direct VCCs established to that ATM address. However, clearing a static entry clears any fast-cache entries that were created from the MAC address-to-ATM address binding.
Static LE ARP entries are not aged and are not removed automatically.
To remove dynamic entries from the LE ARP table of the LANE client on the specified subinterface, use the clear lane le-arp command.
This command adds a static entry to the LE ARP table:
ATM(config-if)#lane le-arp 0800.aa00.0101 47.000014155551212f.00.00.0800.200C.1001.01
Use the lane register interface configuration command to register a LANE client connected by a PVC to the LANE server on the subinterface. To remove a prior entry, use the no form of this command.
lane register vcd mac-addr atm-addr| vcd | Virtual channel descriptor of the Server Direct PVC through which the LANE client is connected to the LANE server. |
| mac-addr | MAC address of the LANE client. |
| atm-addr | ATM address of the LANE client. |
By default, no PVC is defined and no MAC address and ATM address are provided.
Cisco IOS LANE command.
Interface configuration.
Ordinarily, SVCs are used instead of PVCs for communications within ELANs, and registration occurs dynamically via the LANE protocol. The lane register command is used only when PVCs are used.
When PVCs are used instead of SVCs for Server Direct circuits between the LANE server and LANE clients, use this command on the LANE server to identify the MAC address and the ATM address of the LANE client at the other end of a virtual circuit. If the client at the other end has a different ATM address, it is not allowed to join the ELAN. This can serve as a basic security check.
Use the lane pvc command on a LANE client and the lane register command on a LANE server to enable use of PVCs, instead of SVCs alone, for LANE. The vcd value in the lane register command must match the vcd value in a lane pvc command and in an atm pvc command.
If you use PVCs for the Control Direct VCCs, you must also use PVCs for the Control Distribute VCCs. If you use PVCs for the Multicast Send VCCs, you must also use PVCs for the Multicast Forward VCCs.
Use the lane server-bus interface configuration command to configure the LES and BUS for the specified ELAN on the subinterface. The no version of this command deletes the specified LES/BUS.
[no] lane server-bus ethernet elan_name| ethernet | Keyword used to specify an ethernet network. |
| elan_name | Name of the ELAN. |
The default is Ethernet.
Cisco IOS LANE command.
Interface configuration.
In the current software version, the LES and BUS of an ELAN must be co-located.
This example shows how to configure the LES and BUS for the default ELAN:
ATM(config)# int atm0.1 ATM(config-subif)# lane server-bus ethernet default ATM(config-subif)# end
Use the name server-atm-address database configuration command to assign a unique ELAN name to a LES. The no form of this command deletes the specified ELAN name.
[no] name elan_name server-atm-address atm-addr| elan_name | Name of the ELAN. |
| atm-addr | ATM address of the LANE client. |
Cisco IOS ATM command.
Database configuration.
Use this command when setting up the LECS database on Catalyst 5000 series switches or when configuring the address of a LES/BUS.
This example shows how to configure the LES ATM NSAP address for the default ELAN:
ATM#config terminal Enter configuration commands, one per line. End with Ctrl-Z. ATM(lane-config-database)# name default server-atm-address 47.0091810000000061705b7701.00400BFF0011.00 ATM(lane-config-database)# end
Use the reload EXEC command to reload the operating system.
reloadThis command has no arguments or keywords.
Cisco IOS Configuration command.
EXEC.
The reload command halts the ATM module. If the ATM module is set to restart on error, it reboots itself. Use the reload command after configuration information is entered into a file and saved to the startup configuration.
You cannot reload from a virtual terminal if the system is not set up for automatic booting. This prevents the system from dropping to the ROM monitor and thereby taking the system out of the remote user's control.
If you modify your configuration file, the system prompts you to save the configuration. During a save operation, the system asks you if you want to proceed with the save if the CONFIG_FILE environment variable points to a startup configuration file that no longer exists. If you say "yes" in this situation, the system goes to setup mode upon reload.
This example shows how to reload the system from the privileged EXEC prompt:
ATM#reload
Use the sscop cc-timer interface configuration command to change the SSCOP connection control timer value. Use the no form of this command to restore the default value.
sscop cc-timer seconds| seconds | Number of seconds between Begin messages. |
The default SSCOP connection control timer value is 10 seconds.
Cisco IOS ATM command.
Interface configuration.
The SSCOP connection control timer determines the time between transmission of SSCOP BGN, END, or RS PDUs as long as an acknowledgment has not been received.
This example shows how to set the SSCOP connection control timer value to 15 seconds:
ATM(config-if)# sscop cc-timer 15
Use the sscop keepalive-timer interface configuration command to change the SSCOP keepalive timer value. Use the no form of this command to restore the default value.
[no] sscop keepalive-timer seconds| seconds | Number of seconds the ATM module waits between transmission of poll PDUs when no SD or SDP PDUs are queued for transmission or are outstanding pending acknowledgments. |
The default SSCOP keepalive timer value is 30 seconds.
Cisco IOS ATM command.
Interface configuration.
This example shows how to set the SSCOP keepalive timer to 15 seconds:
ATM(config-if)# sscop keepalive-timer 15
Use the sscop max-cc interface configuration command to change the SSCOP connection control retry count. Use the no form of this command to restore the default value.
sscop max-cc retries| retries | Number of times that SSCOP will attempt to transmit BGN, END, or RS PDUs as long as an acknowledgment has not been received. The range of retries is 1 to 6000. |
The default SSCOP connection control retry count is 10 retries.
Cisco IOS ATM command.
Interface configuration.
This example shows how to set the SSCOP connection control retry count to 20:
ATM(config-if)# sscop max-cc 20
Use the sscop poll-timer interface configuration command to change the SSCOP poll timer value. Use the no form of this command to restore the default value.
sscop poll-timer seconds| seconds | Number of seconds the ATM module waits between transmission of POLL PDUs. |
The default SSCOP poll timer value is 10 seconds.
Cisco IOS ATM command.
Interface configuration.
The SSCOP poll timer controls the maximum time between transmission of POLL PDUs when SD or SDP PDUs are queued for transmission or are outstanding pending acknowledgments.
This example shows how to set the SSCOP poll timer to 15 seconds:
ATM(config-if)# sscop poll-timer 15
Use the sscop rcv-window interface configuration command to change the size of the SSCOP receiver window. Use the no form of this command to restore the default value.
sscop rcv-window packets| packets | Number of packets the interface will receive before it sends an acknowledgment to the ATM switch. The range of packets is 1 to 6000. |
The default size of the SSCOP receiver window is seven packets.
Cisco IOS ATM command.
Interface configuration.
This example shows how to set the size of the SSCOP receiver window to 10 packets:
ATM(config-if)# sscop rcv-window 10
Use the sscop send-window interface configuration command to change the size of the SSCOP transmitter window. Use the no form of this command to restore the default value.
sscop send-window packets| packets | Number of packets the interface can send before it must receive an acknowledgment from the ATM switch. The range of packets is 1 to 6000. |
The default size of the SSCOP transmitter window is seven packets.
Cisco IOS ATM command.
Interface configuration.
This example shows how to set the size of the SSCOP transmitter window to 10 packets:
ATM(config-if)# sscop send-window 10
Use the terminal EXEC command to set the number of lines displayed on-screen. Use the no form of this command to return the screen length to the default.
terminal length [screen-length]| screen-length | (Optional) Number of lines to display on-screen. The range of screen-length is 0 to 512. A value of 0 disables pausing between screens of output. |
The default screen length is 24 lines.
Cisco IOS ATM module interface command.
EXEC.
This example shows how to set the terminal length to 0 so that output scrolls on the screen without pausing:
ATM> terminal length 0
Use the write erase EXEC command to erase the configuration information in NVRAM. The NVRAM will then be filled with the default configuration.
write eraseThis command has no arguments or keywords.
Cisco IOS Configuration command.
EXEC.
This example shows how to erase the configuration in nonvolatile memory:
ATM#write erase
Use the write memory EXEC command to copy the configuration information in running memory to NVRAM.
write memoryThis command has no arguments or keywords.
Cisco IOS Configuration command.
EXEC.
If you issue the write memory command from a bootstrap system image, a warning is displayed stating that the previous NVRAM configuration will be overwritten and some of the configuration commands will be lost unless you answer no. This warning is not displayed if NVRAM does not contain a valid configuration or if the previous configuration in NVRAM was generated by a bootstrap system image.
This example shows how to copy the current configuration information to NVRAM:
ATM#write memory ### [OK]
Use the write terminal EXEC command to display the configuration information currently in running memory.
write terminalThis command has no arguments or keywords.
Cisco IOS Configuration command.
EXEC.
This example shows how to display the current configuration information:
ATM#write terminal
Building configuration...
Current configuration:
!
version 11.2
!
hostname ATM
!
!
!
interface ATM0
atm preferred phy A
atm pvc 1 0 5 qsaal
atm pvc 2 0 16 ilmi
lane client ethernet 100
!
!
line con 0
line vty 0 4
no login
!
end
ATM#
|
|