|
|
The commands shown in this chapter apply to the Catalyst 8540 MSR, Catalyst 8510 MSR, and LightStream 1010 ATM switch routers. Where an entire command or certain attributes of a command have values specific to a particular switch or switch router, an exception is indicated by the following callouts:
Refer to Appendix D of this command reference for a detailed list of commands that have been removed, changed or replaced.
To configure the cable length for a channelized DS-3 (CDS3) Frame Relay port adapter, use the cablelength controller configuration command. To restore the default cable length, use the no form of this command.
Syntax Description
Defaults
Command Modes
Command History
Usage Guidelines
Although you can specify a cable length from 0 to 450 feet, the hardware only recognizes two ranges: 0 to 224, and 225 to 450.
For example, if you enter 150 feet, the 0 to 224 range is used. If you later change the cable length to 200 feet, there is no change because 200 is within the 0 to 224 range. However, if you change the cable length to 250, the 225 to 450 range is used. The actual number you enter is stored in the configuration file.
Examples
The following example configures the cable length on controller t3 to 450 feet.
To configure the address mask for identifying valid bits of the called NSAP address field, use the called-address-mask ATM signalling diagnostics configuration command. To return the address mask to the default, use the no form of this command.
Syntax Description
Defaults
Command Modes
ATM signalling diagnostics configuration
Command History
Usage Guidelines
To match this selection criteria, a failed connect setup must have a called party address value equal to the configured called party address for all bits that are 1 in the value of the mask specified with the command. When the default value is retained, the rejected call matches the filter criteria for any called address in the rejected call.
Examples
The following example shows configuring a called address mask string.
To configure the NSAP-format ATM address for the signalling diagnostics filter entry, use
the called-nsap-address ATM signalling diagnostics configuration command. To remove any configured address, use the no form of this command.
Syntax Description
Defaults
Command Modes
ATM signalling diagnostics configuration
Command History
Usage Guidelines
NSAP-format ATM end-system addresses have a fixed length of 40 hexadecimal digits. You should configure the address using the following dotted format:
 |
Note The dots can be omitted. |
Examples
The following example shows setting a called NSAP address.
To configure the address mask for identifying valid bits of the calling-nsap-address field in the signalling diagnostics filter table entry, use the calling-address-mask ATM signalling diagnostics configuration command. To set to the default value, use the no form of this command.
Syntax Description
|
Defaults
Command Modes
ATM signalling diagnostics configuration
Command History
Usage Guidelines
To match this selection criteria, a failed connect setup must have a calling party address value equal to the configured calling party address for all bits that are 1 in the value of the mask specified through the command. When the default value is retained, the rejected call matches the filter criteria for any calling address in the rejected call.
Examples
The following example shows a calling address mask.
To configure the NSAP-format ATM address for the signalling diagnostics filter entry, use the calling-nsap-address ATM signalling diagnostics configuration command. To remove any configured address, use the no form of this command.
Syntax Description
Defaults
Command Modes
ATM signalling diagnostics configuration
Command History
Usage Guidelines
NSAP-format ATM end-system addresses have a fixed length of 40 hexadecimal digits. You should configure the address using the following dotted format:
|
Note The dots can be omitted. |
Examples
The following example shows setting a calling NSAP address.
To filter ATM signalling call failures by connection type (point-to-point or point-to-multipoint), use the cast-type ATM signalling diagnostics configuration command. To disable this feature, use the no form of this command.
Syntax Description
Defaults
Command Modes
ATM signalling diagnostics configuration
Command History
Examples
The following example shows call failures filtered by point-to-point connection.
To configure the AAL1 timing recovery clock for T1/E1 interfaces, use the ces aal1 clock interface configuration command. To revert to the default setting, use the no form of this command.
Syntax Description
Defaults
Command Modes
Command History
Usage Guidelines
The clock mode must be synchronous for structured mode. In unstructured mode, use adaptive when a network-derived clock is not available.
Use srts when a network-derived clock is available but devices attached to the CES port use a different clock reference. The srts keyword samples the incoming clock, subtracts from the network clock, and sends the remainder in an AAL1 header. The clock is reconstructed during output by adding the residual to the network reference.
Use synchronous for all other modes.
Examples
The following command shows setting the AAL1 timing recovery clock to adaptive mode.
To configure the type of ces service, use the ces aal1 service interface configuration command.
To revert to the default setting, use the no form of this command.
Syntax Description
|
|
Defaults
Command Modes
Command History
Usage Guidelines
The structured keyword means that each time slot is an independent entity grouped into circuits, where each circuit has an independent PVC.
The unstructured keyword reduces the incoming serial data on the receiving end of the ATM network. The keyword also sets the service to single circuit, single PVC, where all time slots are carried.
Examples
The following example shows changing the mode for the ces aal1 service command to structured.
To configure the CES connection attributes, use the ces circuit interface configuration command.
To revert to the default setting, use the no form of this command.
Syntax Description
|
Defaults
Command Modes
Command History
Usage Guidelines
Channel-associated signalling provides information about the time slot (on or off the hook) and is updated once per multiframe.
Examples
The following example shows setting the structured service CDV range to 5000 milliseconds.
To configure a transmit clock source to the T1/E1 CES port adapter, use the ces dsx1 clock source interface configuration command. To revert to the default value, use the no form of this command.
Syntax Description
|
Defaults
Command Modes
Command History
Examples
The following example shows setting the clock source to loop-timed.
Related Commands
To select the frame type for the E1 or T1 data line, use the ces dsx1 framing interface configuration command. To restore the default setting, use the no form of this command.
To restore the default setting, use the no form of these commands.
Syntax Description
|
|
Defaults
Command Modes
Command History
Usage Guidelines
Use this command in configurations where the switch router communicates with either the T1 or the E1 data line to configure the frame type for your circuit.
Examples
The following example shows setting the E1 data line frame type to e1_mfCAS_lt.
Related Commands
To configure T1 port parameters, use the ces dsx1 lbo interface configuration command. To revert to the default setting, use the no form of this command.
Syntax Description
|
|
Defaults
Command Modes
Command History
Usage Guidelines
Set the cable length to the desired number of feet on your system.
Examples
The following example shows setting the cable length to 440 feet using the ces dsx1 lbo interface configuration command.
To select the linecode type for the T1 or E1 line, use the ces dsx1 linecode interface configuration command. To restore the default setting, use the no form of this command.
To restore the default setting, use the no form of these commands.
Syntax Description
|
Defaults
Command Modes
Command History
Usage Guidelines
The T1 service provider determines which linecode type (ami or b8zs) is required for your circuit.
The E1 service provider determines which linecode type (ami or hdb3) is required for your circuit.
Examples
The following example specifies b8zs as the linecode type for the T1 interface.
To configure loopback for the T1 or E1 circuit emulation port adapter module, use the
ces dsx1 loopback interface configuration command. To revert to the default setting, use
the no form of this command.
Syntax Description
|
Defaults
Command Modes
Command History
Usage Guidelines
This command is useful when testing the circuit emulation port adapter module.
Examples
The following example shows setting the loopback to payload.
To configure the signalmode to robbedbit, use the ces dsx1 signalmode robbedbit interface configuration command. To restore the default setting, use the no form of this command.
Syntax Description
This command has no keywords or arguments.
Defaults
Command Modes
Command History
Usage Guidelines
A T1 frame consists of 24 time slots (DS0) that send at a rate of 64 kbps. T1 defines the ability to send signalling in-band on individual time slots by removing the low bit of each byte for signalling in robbedbit mode. This procedure allows 8 kbps for signalling and leaves 56 kbps for data.
In structured mode, you can send the T1 signalling information across the BISDN network. This means that after you set the port in robbedbit signalling mode, and enable CAS on individual circuits that need this type of service, you are robbing bits from the DS0. The system then puts the bits in the specified format to be sent across the BISDN network and reinserts them at the passive side on the CES-IWF connection.
Examples
Related Commands
To configure the destination port for the circuit, use the ces pvc (hard PVC) interface configuration command. To disable this feature, use the no form of this command.
Syntax Description
|
Defaults
Command Modes
Command History
Usage Guidelines
You must configure both sides of the CES circuits because the source (the active side in CES-IWF) time slots are not recognized at the destination (the passive side).
Each CES circuit has an ATM address. When configuring the source PVC, you need the destination ATM address. See the show ces address command.
Examples
The following example shows how to set a hard PVC on interface ATM 1/0/0.
The following example shows how to set an unstructured CES soft PVC.
The following example shows how to set a structured hard PVC.
Related Commands
To configure the destination port for the circuit, use the ces pvc (soft PVC) interface configuration command. To disable this feature, use the no form of this command.
Syntax Description
|
Defaults
Command Modes
Command History
Usage Guidelines
You must configure both sides of the CES circuits because the source (the active side in CES-IWF) time slots are not recognized at the destination (the passive side).
Each CES circuit has an ATM address. When configuring the source PVC, you need the destination ATM address. See the show ces address command.
Examples
The following example shows how to set a soft PVC with the follow-ifstate option enabled.
Related Commands
To enable the passive circuit to mirror the interface state, use the ces pvc passive command. To disable this feature, use the no form of this command.
Syntax Description
|
Defaults
Command Modes
Command History
Usage Guidelines
When it is determined that the parent interface transitions from the down state to up, the soft PVC setup sequence is started. When it is determined that the parent interface transitions from the up state to down, an established soft PVC is released. Any soft PVC setup sequence in progress is terminated.
Examples
The following example shows how to enable the passive circuit state to mirror the interface state.
Related Commands
To form a serial interface, or channel-group, by aggregating time slots on a channelized DS3 (CDS3) or channelized E1 (CE1) line, use the channel-group controller configuration command. To delete a serial interface or channel-group, use the no form of this command.
For the CDS3 Frame Relay line, use the following syntax:
For the CE1 Frame Relay line, use the following syntax:
Syntax Description
|
Defaults
Command Modes
Command History
Usage Guidelines
If the serial interface has encapsulation set to Frame Relay, then the no form of this command works only if you shut down the interface or the controller so that it tears down all soft VCs automatically. Otherwise, an error is returned.
Examples
The following example shows how to configure a channel group (#2), assigning time slots 6 to 31, and creating a logical serial port on interface 1/0/0:2.
Command History
To clear PNNI-related data, use the clear atm pnni privileged EXEC command.
Syntax Description
|
|
Command Modes
Command History
Examples
The following example shows how to clear the PNNI flooding statistics.
Related Commands
|
To clear existing ATM signalling statistics, use the clear atm signalling statistics EXEC command.
Syntax Description
Command Modes
Command History
Usage Guidelines
This command clears the statistics for all the interfaces or a specific interface.
Examples
The following example shows how to clear the ATM signalling statistics for interface 1/0/0.
Related Commands
To release a specified SVC, use the clear atm vc privileged EXEC command.
Syntax Description
Command Modes
Command History
Examples
The following is an example of the clear atm-vc command, which releases interface 3/1/0 on VPI 0 and VCI 99.
Related Commands
To configure the release cause code value in the signalling diagnostics filter table entry, use the clear-cause ATM signalling diagnostics configuration command. To disable this feature, use the
no format of this command.
Syntax Description
|
Defaults
Command Modes
ATM signalling diagnostics configuration
Command History
Usage Guidelines
Only the call failure records that match this configured clear-cause value are collected and stored.
The default value zero (0) means the cause code is not considered during filtering.
Examples
The following example shows setting a value of 100.
It is recommended that you only use this command for debugging purposes because it clears all counters displayed in the show interfaces and show controllers commands. To clear the interface counters, use the clear counters privileged EXEC command.
Syntax Description
|
Command Modes
Command History
Usage Guidelines
This command clears all the current interface counters from the interface unless the optional arguments type and card/subcard/port are specified to clear only a specific interface type such as ATM, Ethernet, and so on.
|
Note This command does not clear counters retrieved using SNMP. |
Examples
The following example illustrates how to clear all interface counters.
Related Commands
Use the clear facility-alarm command to clear alarm conditions and reset the alarm contacts.
Syntax Description
|
|
Defaults
Command Modes
Command History
Usage Guidelines
The clear facility-alarm command acts like an ACO. Only a reoccurrence of the original alarm source after the original alarm condition is removed can restart the alarm.
Examples
The following example shows how to clear minor facility alarms only.
The following example shows how to clear all facility alarms.
Related Commands
|
To delete entries from the host-name-and-address cache, use the clear host privileged EXEC command.
Syntax Description
Command Modes
Command History
Usage Guidelines
The host name entries are cleared in running memory.
Examples
The following example clears all entries from the host-name-and-address cache.
Related Commands
|
To reset the hardware logic on an interface, use the clear interface privileged EXEC command.
Syntax Description
|
Command Modes
Command History
Usage Guidelines
Under normal circumstances, you do not need to clear the hardware logic on interfaces.
Examples
The following example resets the interface logic on ATM interface 1/0/1.
|
Note This command or some of its parameters might not function as expected. |
To delete the cache table entries, use the clear ip cache privileged EXEC command.
Syntax Description
Command Modes
Command History
Related Commands
To redirect an IP cache, use the clear ip redirect privileged EXEC command.
Syntax Description
This command has no keywords or arguments.
Command Modes
Command History
Related Commands
|
To clear the LANE client counter configured on the specified LEC interface, use the
clear lane client privileged EXEC command.
Syntax Description
Command Modes
Command History
Usage Guidelines
If you do not specify an interface, this command clears all the counters of any LANE client in the switch.
When you specify an interface, this command clears all the LANE client counters on that interface.
Examples
The following example shows clearing the counters on ATM 1/0/0 interface using the clear lane client privileged EXEC command.
Related Commands
|
To clear the dynamic LE_ARP table or a single LE_ARP entry of the LANE client configured on the specified subinterface or emulated LAN, use the clear lane le-arp privileged EXEC command.
Syntax Description
|
Command Modes
Command History
Usage Guidelines
This command only removes dynamic LE_ARP table entries. It does not remove static LE_ARP table entries.
If you do not specify an interface or an emulated LAN, this command clears all the LANE ARP tables of any LANE client in the switch.
If you specify a major interface (not a subinterface), this command clears all the LANE ARP tables of every LANE client on all the subinterfaces of that interface.
This command also removes the fast-cache entries built from the LANE ARP entries.
Examples
The following example clears all the LANE ARP tables for all clients on the switch router.
The following example clears all the LANE ARP tables for all LANE clients on all the subinterfaces of interface atm 0.
The following example clears the entry corresponding to MAC address 0800.AA00.0101 from the LE_ARP table for the LANE client on the emulated LAN named red.
The following example clears all dynamic entries from the LE_ARP table for the LANE client on the emulated LAN named red.
The following example clears the dynamic entry from the LE_ARP table for the LANE client with next-hop router descriptor segment number 1, bridge number 1, on the emulated LAN named red.
|
Note MAC addresses are written in the same dotted notation for the clear lane le-arp command as they are for the global IP arp command. |
To force a LANE server on a specified subinterface or emulated LAN to drop the Control Direct and Control Distribute VCCs to a given LANE client and force the client to rejoin, subject to the new bindings, use the clear lane server privileged EXEC command.
Syntax Description
|
Command Modes
Command History
Usage Guidelines
After changing the bindings on the configuration server, enter this command on the LANE server.
The LANE server drops the Control Direct and Control Distribute VCCs to the LANE client. The client then asks the LANE configuration server for the location of the LANE server of the emulated LAN it is requesting to join.
If no LANE client is specified, all LANE clients attached to the LANE server are dropped.
Examples
The following example forces all the LANE clients on the emulated LAN named red to be dropped. When they try to join again, they are forced to join a different emulated LAN.
Related Commands
|
To clear the RIF cache, use the clear rif-cache privileged EXEC command.
Syntax Description
This command has no keywords or arguments.
Command Modes
Command History
Usage Guidelines
Some entries in the RIF cache are dynamically added, while others are static.
Related Commands
|
To clear all SGCP statistics, use the clear sgcp statistics privileged EXEC command.
Syntax Description
This command has no arguments or keywords.
Defaults
Command Modes
Command History
Usage Guidelines
This command clears global and per-endpoint statistics.
Examples
The following example clears the SGCP statistics.
Related Commands
|
To add a LANE client address entry to the configuration servers configuration database, use the client-atm-address name lane configuration server database command. To remove a client address entry from the table, use the no form of this command.
Syntax Description
|
Defaults
No address and no emulated LAN name are provided.
Command Modes
LANE configuration server database
Command History
Usage Guidelines
This command binds any client whose address matches the specified template into the specified emulated LAN. When a client comes up, it consults the LANE configuration server, which responds with the ATM address of the LANE server for the emulated LAN. The client then initiates join procedures with the LANE server.
Before this command is used, the emulated LAN specified by the elan-name argument must be created in the configuration server's database by using the national reserve (Catalyst 8510 MSR and LightStream 1010) command.
If an existing entry in the configuration server's database binds the LANE client ATM address to a different emulated LAN, 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.
The client-atm-address name command is a subcommand of the global lane database command. See the lane database command for information about creating the database, and the name server-atm-address command for information about binding the emulated LAN name to the servers ATM address.
ATM Addresses. A LANE ATM address has the same syntax as an NSAP but it is not a network-level address. It consists of the following:
Address Templates. LANE ATM address templates can use two types of wildcards: an asterisk (*) to match any single character (nibble), and an ellipsis (...) to match any number of leading, middle, 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 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.
With the Cisco 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.
Examples
The following example shows how to enter database configuration mode using the database lane_db.
The following example uses an ESI template to specify the part of the ATM address corresponding to the interface. This example allows any client on any subinterface of the interface that corresponds to the displayed ESI value, no matter where the switch is connected, to join the engineering emulated LAN.
The following example uses a prefix template to specify the part of the ATM address corresponding to the switch. This example allows any client on a subinterface of any interface connected to the switch that corresponds to the displayed prefix to join the marketing emulated LAN.
Related Commands
|
To select a transmit clock source for a channelized DS3 (CDS3) or a channelized E1 (CE1)
Frame Relay port adapter, or for a 16-port OC-3c MMF port adapter, use the clock source controller configuration command. To return the clock source to the default, use the no form of this command.
Syntax Description
|
Defaults
For CDS3 and CE1 Frame Relay port adapters: Default clock source is loop-timed.
For the OC-3c MMF port adapter: Default clock source is network-derived.
Command Modes
Command History
Usage Guidelines
Currently, all types of OC-12 port adapters do not support loop-timed mode.
When a transmit clock port is set to free-running, if there is a local oscillator present on the port adapter, the port uses the port adapter's oscillator as the clock source. If there is no local oscillator present on the port adapter, the port uses the route processor oscillator.
Examples
The following example shows how to enable the reference clocking mode on an E1 interface.
Related Commands
|
To select a transmit clock source for a physical device such as a port, use the clock source interface configuration command. To return the clock source to the default, use the no form of this command.
Syntax Description
|
Defaults
Command Modes
Command History
Usage Guidelines
This command applies to all interfaces except older versions of the DS3/E3 and the 25-Mbps interfaces.
This subcommand allows selection of the transmit clock source for the physical device of a port. Currently, all types of OC-12 port adapters do not support loop-timed mode.
When a transmit clock port is set to free-running, if there is a local oscillator present on the port adapter, the port uses the port adapter's oscillator as the clock source. If there is no local oscillator present on the port adapter, the port uses the route processor oscillator.
Examples
The following example shows how to enable the loop-timed clocking mode.
Related Commands
|
To select a transmit clock source for a physical device such as a port, use the clock source interface configuration command. To return the clock source to the default, use the no form of this command.
Syntax Description
|
Defaults
Command Modes
Command History
Usage Guidelines
This command applies to all interfaces except older versions of the DS3/E3 and the 25-Mbps interfaces.
This subcommand allows selection of the transmit clock source for the physical device of a port. Currently, all types of OC-12 port adapters do not support loop-timed mode.
When a transmit clock port is set to free-running, if there is a local oscillator present on the port adapter, the port uses the port adapter's oscillator as the clock source. If there is no local oscillator present on the port adapter, the port uses the route processor oscillator.
Examples
The following example shows how to enable the loop-timed clocking mode.
Related Commands
|
To initialize the collection mode and specify at what time accounting data is recorded in the accounting file, use the collection-modes ATM accounting file subcommand. To disable the collection mode, use the no form of this command.
Syntax Description
|
|
Command Modes
Command History
Examples
The following example initializes the collection mode and specifies that the accounting data is recorded on the release of a connection.
Related Commands
|
To filter ATM signalling call failures by virtual circuit category, use the connection-category ATM signalling diagnostics configuration command. To return the connection category to the default, use
the no form of this command.
Syntax Description
Defaults
Command Modes
ATM signalling diagnostics configuration
Command History
Usage Guidelines
Use the atm signalling diagnostics command to enter diagnostics configuration mode.
Examples
In the following example, call failures are filtered by soft virtual circuits.
To set types of connections for atm accounting selection, use the connection-types ATM accounting selection command. To return the connection-type to the default, use the no form of this command.
Syntax Description
|
|
Defaults
The default value for the connection type is svc-in, svc-out, and svp-out.
Command Modes
Command History
Usage Guidelines
Changes to connection-types take effect immediately.
Examples
The following example shows specifying the connection types for ATM accounting selection index 1 as spvc-originator and spvp-originator.
Related Commands
|
To select a port on a Frame Relay port adapter, use the controller global configuration command.
Syntax Description
|
Command Modes
Command History
Usage Guidelines
Specify the controller to configure by entering the controller subcommand, followed by e1 or t3, and card/subcard/port.
Examples
The following example begins configuration of the CE1 Frame Relay interface on card 11, subcard 0, and port 0 using the controller global configuration command.
Related Commands
To copy any file from a Flash device to another destination, use the copy privileged EXEC command.
Syntax Description
|
Defaults
If you omit the source or destination device, the switch uses the default device specified by
the cd command. If you omit the destination filename, the switch uses the source filename.
Command Modes
Command History
Usage Guidelines
The copy commands generally copy a file from a source to a destination. Some invalid combinations exist. Specifically, you cannot copy a running configuration to a running configuration, a startup configuration to a startup configuration, or TFTP to rcp.
When the destination is specified by the config_file or BOOTLDR environment variable, the switch prompts you for confirmation before proceeding with the copy. When the destination is the only valid image in the BOOT environment variable, the switch also prompts you for confirmation before proceeding with the copy.
The config_file environment variable specifies the configuration used during switch initialization. The BOOTLDR environment variable specifies the Flash device and filename containing the rxboot image for booting. The BOOT environment variable specifies a list of bootable images on various devices. To view the contents of environment variables, use the show bootvar command. To modify the config_file environment variable, use the boot config command. To modify the BOOTLDR environment variable, use the boot bootldr command. To modify the BOOT environment variable, use the boot system command. To save your modifications, use the copy running-config startup-config command.
If you do not specify a source or destination device, the switch uses the default device specified by the cd command.
Examples
The following example copies the switch-config1 file from the internal Flash memory of a switch router to the switch-backupconfg file on the Flash memory card inserted in the first slot of the route processor card.
In the following example, the switch copies the switch-config file from the Flash memory card inserted in slot 0 of the route processor card to the startup configuration.
Related Commands
|
To copy a file from Flash memory to another destination, use the copy flash privileged EXEC command.
Syntax Description
|
Defaults
If you omit the destination device, the switch router uses the default device specified by the cd command. If you omit the destination filename, the switch router uses the source filename.
Command Modes
Command History
Usage Guidelines
The copy flash command copies from one of the three Flash memory devices. The system prompts you to enter a specific device and filename. You can enter one of the following as the source device:
You must follow the source device with a colon (:) and a filename.
Use the copy flash rcp command to copy a system image from Flash memory to a network server using rcp. You can use the copy of the system image as a backup copy. You can also use it to verify that the copy in Flash memory is the same as the original file.
The rcp software requires that a client send the remote username on each rcp request to the server. When you issue the copy flash rcp command, by default the switch router software sends the remote username associated with the current TTY if that name is valid. For example, if the user is connected to the switch router through Telnet and was authenticated through the username command, the switch router software sends that username as the remote username.
If the TTY username is invalid, the switch router software uses the switch router host name as both the remote and local usernames.
|
Note TTYs are commonly used in Cisco communications servers. The concept of TTY originated with UNIX. For UNIX systems, each physical device is represented in the file system. Terminals are called TTY devices, which stands for teletype, the original UNIX terminal. |
To specify a different remote username to be sent to the server, use the ip rcmd remote-username command. You can also specify the path of an existing directory along with the remote username.
 |
Caution The remote username must be associated with an account on the destination server. If you do not use the ip rcmd remote-username command to specify the name of a remote user associated with an account on the server, the remote username associated with the current TTY process must be associated with an account on the server. If there is no username for the current TTY process, the switch router host name must be associated with an account on the server. If the network administrator of the destination server did not establish accounts for the remote username used, this command does not execute successfully when a default remote username is used. |
If you copy the system image to a personal computer used as a file server, the computer must support the rsh protocol.
Use the copy flash tftp command to copy a system image from Flash memory to a TFTP server. As with the copy flash rcp command, you can use the copy of the system image as a backup or verification that the copy in Flash is the same as the original file.
The copy commands generally copy a file from a source to a destination. Some invalid combinations exist. Specifically, you cannot copy a running configuration to a running configuration, a startup configuration to a startup configuration, or TFTP to rcp. If you do not specify a source or destination device, the switch router uses the default device specified by the cd command.
When the destination is also specified by the config_file environment variable, the switch router prompts you for confirmation before proceeding with the copy. The config_file environment variable specifies the configuration used during switch initialization. To view the contents of the config_file environment variable, use the show bootvar command. To modify the config_file environment variable, use the boot config command. To save your modifications to the config_file environment variable, use the copy running-config startup-config command.
Examples
The following example shows how to use the copy flash rcp command.
You see a spinning line during the copy process.
The following example illustrates how to use the copy flash rcp command when copying from a particular partition of Flash memory.
The system prompts you if there are two or more partitions. If the partition entered is not valid, the process terminates. You have the option to enter a partition number, a question mark (?) for a directory display of all partitions, or a question mark and a number (?number) for a directory display of a particular partition. The default is the first partition.
The file is copied from the partition given earlier by the user.
The following is sample output from the copy flash tftp command.
The following example illustrates how to use the copy flash tftp command when copying from a particular partition of Flash memory.
The system prompts you if there are two or more partitions. If the partition entered is not valid, the process terminates. You have the option to enter a partition number, a question mark (?) for a directory display of all partitions, or a question mark and a number (?number) for a directory display of a particular partition. The default is the first partition.
The file is copied from the partition given earlier by the user.
The following example shows how to use the copy flash command.
Related Commands
|
To copy a file from a network server to the switch router or to another destination using rcp, use the
copy rcp privileged EXEC command.
Syntax Description
|
Defaults
If you omit the destination device, the switch arouter uses the default device specified by the cd command. If you omit the destination filename, the switch router uses the source filename.
Command Modes
Command History
Usage Guidelines
The rcp protocol requires that a client send the remote username of an rcp request to the server. When you issue one of the copy rcp commands, by default the switch router software sends the username associated with the current TTY if that name is valid. For example, if the user is connected to the switch router through Telnet and the user was authenticated through the username command, the switch router software sends that username as the remote username.
|
Note For Cisco, TTYs are commonly used in communication servers. The concept of TTY originated with UNIX. For UNIX systems, each physical device is represented in the file system. Terminals are called TTY devices, which stands for teletype, the original UNIX terminal. |
If the TTY username is invalid, the switch router software uses the switch router host name as both the remote and local usernames. To specify a different remote username to be sent to the rcp server, use the
ip rcmd remote-username command. You can also specify the path of an existing directory along with the remote username.
|
Caution The remote username must be associated with an account on the destination server. If you do not use the ip rcmd remote-username command to specify the name of a remote user associated with an account on the server, the remote username associated with the current TTY process must be associated with an account on the server. If there is no username for the current TTY process, the switch router host name must be associated with an account on the server. If the network administrator of the destination server did not establish accounts for the remote username used, this command does not execute successfully when a default remote username is used. |
If you copy a bootstrap image, system image, or configuration file from a personal computer used as a file server, the remote host computer must support the rsh protocol.
Use the copy rcp bootflash command to copy a bootstrap image from a network server to Flash memory using rcp. The switch prompts for the name or address of the server and the name of the file to be copied. It provides an option to erase existing Flash memory before writing onto it and allows you to confirm the erasure. The entire copying process takes several minutes and differs from network to network.
Before loading the switch from Flash memory, verify that the checksum of the bootstrap image in Flash memory matches the checksum listed in the README file that was distributed with the system software image.
The checksum of the bootstrap image in Flash memory is displayed at the bottom of the screen when you issue the copy rcp bootflash command. The README file was copied to the server automatically when you installed the system software.
|
Caution If the checksum value does not match the value in the README file, do not reboot the switch. Reissue the copy rcp bootflash command and compare the checksums again. If the checksum is repeatedly wrong, copy the original bootstrap image back into Flash memory before you reboot the switch from Flash memory. If you have a corrupted image in Flash memory and try to boot from Flash, the switch router starts the system image (assuming booting from a network server is not configured). |
Use the copy rcp running-config command to copy a configuration file from a network server to the switch router's running configuration environment using rcp. You can copy either a host configuration file or a network configuration file. Accept the default value of host to copy and load a host configuration file containing commands that apply to one network server in particular. Enter value of network to copy and load a network configuration file containing commands that apply to all network servers on a network.
|
Note The copy rcp running-config command replaces the configure network command when using rcp. |
Use the copy rcp startup-configuration command to copy a host or network configuration file from a network server to the switch router's startup configuration environment using rcp. Accept the default value of host to copy and store a host configuration file containing commands that apply to one network server in particular. Enter value of network to copy and store a network configuration file containing commands that apply to all network servers on a network.
The command copies a configuration file from the network server to the location specified by the config_file environment variable. The config_file environment variable specifies the configuration used during switch router initialization.
|
Note The copy rcp startup-config command replaces the configure overwrite-network command when using rcp. |
The copy commands generally copy a file from a source to a destination. Some invalid combinations exist. Specifically, you cannot copy a running configuration to a running configuration, a startup configuration to a startup configuration, or TFTP to rcp.
The copy rcp command generally copies a file from a network server to another destination using rcp. If you do not specify a source or destination device, the switch uses the default device specified by the cd command.
When the destination is also specified by the config_file environment variable, the switch prompts you for confirmation before proceeding with the copy. To view the contents of the config_file environment variable, use the show bootvar command. To modify the config_file environment variable, use the boot config command. To save your modifications, use the copy running-config startup-config command.
Examples
The following example shows sample output resulting from copying a system image into a partition of Flash memory. The system prompts only if there are two or more read/write partitions or one read-only and one read/write partition and dual-Flash bank support in boot ROMs. If the partition entered is not valid, the process terminates. You have the option to enter a partition number, a question mark (?) for a directory display of all partitions, or a question mark and a number (?number) for a directory display of a particular partition. The default is the first read/write partition.
If the partition is read-only and has dual-Flash bank support in boot ROM, the session continues as shown in the following display.
The file is copied into the partition given by the user earlier.
If the partition is read-write, the session continues as follows.
The file is copied into the partition given by the user earlier.
The following example uses the copy rcp device command to copy the switch-image file from a network server using rcp to the Flash memory card inserted in slot 0 of the route processor card.
Related Commands
|
To copy the switch router's running configuration file to another destination, use the copy running-config privileged EXEC command.
Syntax Description
|
Defaults
If you omit the destination device, the switch router uses the default device specified by the cd command. If you omit the destination filename, the switch router uses the source filename.
Command Modes
Command History
Usage Guidelines
Save the configuration file to your startup configuration. This setup saves the configuration to the location specified by the config_file environment variable.
The copy running-config startup-config command replaces the write memory command.
The copy running-config rcp or copy running-config tftp command replaces the write network command.
Related Commands
|
To copy the switch router's startup configuration file to another destination, use the copy startup-config privileged EXEC command.
Syntax Description
|
Defaults
If you omit the destination device, the switch router uses the default device specified by the cd command. If you omit the destination filename, the switch router uses the source filename.
Command Modes
Command History
Usage Guidelines
The copy commands generally copy a file from a source to a destination. Some invalid combinations exist. Specifically, you cannot copy a running configuration to a running configuration, a startup configuration to a startup configuration, or TFTP to rcp.
This command copies the configuration file pointed to by the config_file environment variable to another destination. To view the contents of the config_file environment variable, use the show bootvar command. To modify the config_file environment variable, use the boot config command.
The rcp protocol requires that a client send the remote username of an rcp request to the server. When you issue the copy startup-config-rcp command, by default the switch router software sends the username associated with the current TTY if that name is valid. For example, if the user is connected to the switch router software through Telnet and the user was authenticated through the username command, the switch router sends that username as the remote username.
|
Note For Cisco, TTYs are commonly used in communication servers. The concept of TTY originated with UNIX. For UNIX systems, each physical device is represented in the file system. Terminals are called TTY devices, which stands for teletype, the original UNIX terminal. |
To specify a different remote username to be sent to the server, use the ip rcmd remote-username command. You can also specify the path of an existing directory along with the remote username.
|
Caution The remote username must be associated with an account on the destination server. If you do not use the ip rcmd remote-username command to specify the name of a remote user associated with an account on the server, the remote username associated with the current TTY process must be associated with an account on the server. If there is no username for the current TTY process, the switch router host name must be associated with an account on the server. If the network administrator of the destination server did not establish accounts for the remote username used, this command does not execute successfully when a default remote username is used. |
If you copy the configuration file to a personal computer used as a server, the computer must support the rsh protocol.
Examples
The following example uses the copy startup-config command to copy the startup configuration file (specified by the config_file environment variable) to a Flash memory card inserted in slot 0 of the route processor card.
The following is sample output from the copy startup tftp command.
Related Commands
|
To copy a file from a TFTP server to the switch router or to another destination, use the copy tftp privileged EXEC commands.
Syntax Description
|
Defaults
If you omit the destination device, the switch router uses the default device specified by the cd command. If you omit the destination filename, the switch router uses the source filename. If you enter a cd command to the device, then that device becomes the default. For example, if you enter cd slot0: and then enter copy tftp bootflash, then "flash" means slot0.
Command Modes
Command History
Usage Guidelines
Refer to the following guidelines:
Table 4-1 The following table describes the characters that you might see during processing of the
copy tftp command.
Table 4-1 copy tftp Character Descriptions
|
When you enter the copy tftp flash command, the Flash memory checksum image displays on the bottom of the screen. Before booting from Flash memory, verify that this checksum identifier matches the checksum listed in the README file that was distributed with the system software image. You can find the README file on the TFTP server.
|
Caution If the checksum value is not correct according to the value in the README file, do not reboot the switch. Enter the copy tftp flash command and compare the checksums again. If the checksum is wrong, copy the original system software image back into Flash memory before you reboot the switch from Flash memory. If you have a corrupted image in Flash memory and try to boot from Flash, the switch router starts the system image contained in ROM (assuming booting from a network server is not configured). If ROM does not contain a fully functional system image, the switch router cannot function and must be reconfigured through a direct console port connection. |
|
Note When using TFTP, the copy tftp running-config command replaces the configure network command and the copy tftp startup-config command replaces the configure overwrite-network command. |
The copy commands generally copy a file from a source to a destination. Some invalid combinations exist. Specifically, you cannot copy a running configuration to a running configuration, a startup configuration to a startup configuration, or TFTP to rcp.
The following example shows how to use the copy tftp bootflash command.
Related Commands
|
Posted: Tue Aug 12 17:35:10 PDT 2003
All contents are Copyright © 1992--2003 Cisco Systems, Inc. All rights reserved.
Important Notices and Privacy Statement.