Table Of Contents

C Commands

callhome

callhome test

cd

cdp

cimserver

clear arp-cache

clear cdp

clear cores

clear counters

clear debug-logfile

clear fabric-binding statistics

clear fcanalyzer

clear fcflow stats

clear fcns statistics

clear fcs statistics

clear ficon

clear fspf counters

clear ip access-list counters

clear ips arp

clear ivr zone database

clear license

clear line

clear logging

clear ntp statistics

clear port-security

clear processes log

clear qos statistics

clear rlir

clear rscn statistics

clear screen

clear ssh hosts

clear system reset-reason

clear tlport alpa-cache

clear user

clear vrrp

clear zone

clock

code-page

clock set

code-page

configure terminal

copy

copy licenses

C Commands

---

The commands in this chapter apply to the Cisco MDS 9000 Family of multilayer directors and fabric switches. All commands are shown here in alphabetical order regardless of command mode. See the "About the CLI Command Modes" section to determine the appropriate mode for each command. For more information, refer to the Cisco MDS 9000 Family Configuration Guide.

•callhome

•callhome test

•cd

•cdp

•cimserver

•clear arp-cache

•clear cdp

•clear cores

•clear counters

•clear debug-logfile

•clear fabric-binding statistics

•clear fcanalyzer

•clear fcflow stats

•clear fcns statistics

•clear fcs statistics

•clear ficon

•clear fspf counters

•clear ips arp

•clear ivr zone database

•clear license

•clear line

•clear logging

•clear ntp statistics

•clear port-security

•clear processes log

•clear qos statistics

•clear rlir

•clear rscn statistics

•clear screen

•clear ssh hosts

•clear system reset-reason

•clear arp-cache

•clear user

•clear vrrp

•clear zone

•clock

•code-page

•configure terminal

•configure terminal

•copy

•copy licenses

callhome

To configure the Call Home function, use the callhome command in configuration mode. To set a command back to its factory defaults or negate the command, use the no form of the command.

callhome -->
contract-id contract-id |
customer-id customer-id |
destination-profile {profile-name | full-txt-destination | short-txt-destination | xml-destination} {alert-group {all | avanti | cisco-tac | environmental | inventory | license | linecard-hardware | supervisor-hardware | syslog-group-port | system | test } | email-addr email-address | message-level level | message-size size} |
disable |
enable |
email-contact email-address |
phone-contact number |
site-id site-number |
streetaddress street-address |
switch-priority priority-value |
transport email {from email-address | reply-to email-address | smtp-server ip address [port port-number]}

callhome -->
no contract-id contract-id |
no customer-id customer-id |
no destination-profile {profile-name | full-txt-destination | short-txt-destination | xml-destination} {alert-group {all | avanti | cisco-tac | environmental | inventory | license | linecard-hardware | supervisor-hardware | syslog-group-port | system | test } | email-addr email-address | message-level level | message-size size} |
no disable |
no enable |
no email-contact email-address |
no phone-contact number |
no site-id site-number |
no streetaddress street-address |
no switch-priority priority-value |
no transport email {from email-address | reply-to email-address | smtp-server ip address [port port-number]}

Syntax Description

contract-id contract-id	(Optional). Configures service contract ID of the customer. Allows up to 64 characters for contract number.
customer-id customer-id	(Optional). Configures the customer ID for the switch. Allows customer ID up to 64 alphanumeric characters in free format.
destination-profile	(Optional) Configures a destination e-mail address for a message sent in full text format. This text provides the complete, detailed explanation of the failure.
profile-name	Configures a user-defined user profile with a maximum of 32 alphanumeric characters.
alert-group	Specifies one or more of the alert groups
all	Specifies an alert group consisting of all CallHome messages.
avanti	Specifies an alert group consisting of events which are meant only for Avanti.
cisco-tac	Specifies an alert group consisting of events which are meant only for Cisco TAC.
environmental	Specifies an alert group consisting of power, fan, temperature-related events
inventory	Specifies an alert group consisting of inventory status events.
license	Specifies an alert group consisting of license status events.
linecard-hardware	Specifies an alert group consisting of module-related events.
supervisor-hardware	Specifies an alert group consisting of supervisor related events.
syslog-port-group	Specifies an alert group consisting of syslog port group status events.
system	Specifies an alert group consisting of software related events.
test	Specifies an alert group consisting of user-generated test events.
email-addr email-address	Configures email address. Uses a standard e-mail address that does not have any text size restrictions.
message-level level	Configures a message urgency level. Allows from 0 (lowest level of urgency) to 9 (highest level of urgency), and the default is 0 (all Call Home message are sent).
message-size size	Configures a destination message size for a message sent in full text format. Allows from 0 to 1,000,000 bytes for the message size and the default is 500,000. A value of 0 implies that a message of any size can be sent
full-txt-destination	Configures destination profile for plain text message.
short-txt-destination	(Optional). Configures a destination for a short text message.
xml-destination	(Optional). Configures destination profile for XML message.
disable	Disables callhome.
email-contact email-address	(Optional). Configures the customer's e-mail address. Allows up to 128 alphanumeric characters in e-mail address format.
enable	Enables callhome.
phone-contact number	(Optional). Configures the customer's phone number. Allows up to 20 alphanumeric characters international phone format. Note Do not use spaces. Use the + prefix before the number.
site-id site number	(Optional). Identifies the unit to the outsourced throughput. Allows up to 256 alphanumeric characters in free format.
streetaddress street-address	(Optional). Configures the customer's street address where the equipment is located. Allows up to 256 alphanumeric characters in free format for the street number, city, state, and zip (combined).
switch-priority priority-value	(Optional). Configures the switch priority. Specifies a priority value. 0 is the highest priority and 7 the lowest.
transport	Optional. Configure the e-mail address from the user.
email	Configure the e-mail address from the user.
from email-address	Configure from email address. Provide from email address, example: SJ-9500-1@xyz.com. The maximum size is 255 characters.
reply-to email-address	Configure reply to email address. Provide reply-to email address, example: admin@xyz.com. The maximum size is 255 characters.
smtp-server ip address	Configure SMTP server address. The SMTP server (DNS name or IP address) . The maximum size is 255 characters.
port port-number	(Optional). Changes depending on the server location. The port usage defaults to 25 if no port number is specified.

Defaults

Disabled.

Command Modes

Configuration mode.

Command History

This command was introduced in Cisco MDS SAN-OS Release 1.0(2).

Usage Guidelines

The Call Home configuration commands available in the (config-callhome) submode.

A CallHome message is used to contact a support person or organization in case an urgent alarm is raised.

Once you have configured the contact information, you must enable the Call Home function. The enable command is required for the Call Home function to start operating. When you disable the Call Home function, all input events are ignored.

---

Note Even if Call Home is disabled, basic information for each Call Home event is sent to syslog.

---

Examples

The following examples assign contact informations:

switch# config t

switch# snmp-server contact personname@companyname.com 

switch(config)# callhome

switch(config-callhome)# email-contact username@company.com

switch(config-callhome)# phone-contact +1-800-123-4567

switch(config-callhome)# streetaddress 1234 Picaboo Street, Any city, Any state, 12345

switch(config-callhome)# switch-priority 0

switch(config-callhome)# customer-id Customer1234 

switch(config-callhome)# site-id Site1ManhattanNY

switch(config-callhome)# contract-id Company1234 

The following example configures full-text destination profiles:

switch(config-callhome)# destination-profile full-txt-destination email-addr 
person@place.com

switch(config-callhome)# destination-profile full-txt-destination message-size 1000000

The following example configures short-text destination profiles:

switch(config-callhome)# destination-profile short-txt-destination email-addr 
person@place.com

switch(config-callhome)# destination-profile short-txt-destination message-size 100000

The following example configures the from and reply-to e-mail addresses:

switch(config-callhome)# transport email from user@company1.com 

switch(config-callhome)# transport email reply-to person@place.com

The following example configures the SMTP server and ports:

switch(config-callhome)# transport email smtp-server 192.168.1.1 

switch(config-callhome)# transport email smtp-server 192.168.1.1 port 30

The following example enables and disables the CallHome function:

switch(config-callhome)# enable 

switch(config-callhome)# disable 

The following example configures a user-defined destination profile called test.

switch(config-callhome)# destination-profile test

switch(config-callhome)# destination-profile test alert-group all 

switch(config-callhome)# destination-profile test alert-group Cisco-TAC 

switch(config-callhome)# destination-profile test alert-group Environmental 

switch(config-callhome)# destination-profile test alert-group Inventory 

switch(config-callhome)# destination-profile test alert-group Linecard-Hardware 

switch(config-callhome)# destination-profile test alert-group Supervisor-Hardware 
switch(config-callhome)# destination-profile test alert-group test

switch(config-callhome)# destination-profile test email-addr 

switch(config-callhome)# destination-profile test email-addr user@company.com 

switch(config-callhome)# destination-profile test format full-txt 

switch(config-callhome)# destination-profile test message-level 5

switch(config-callhome)# destination-profile test message-size 100000

Related Commands

Command	Description
callhome test	Sends a dummy test message to the configured destination(s).
show callhome	Displays configured Call Home information.

callhome test

To simulate a CallHome message generation, use the callhome test command.

callhome test [inventory]

Syntax Description

inventory

Sends a dummy CallHome inventory.

Defaults

None.

Command Modes

EXEC mode.

Command History

This command was introduced in Cisco MDS SAN-OS Release 1.0(2).

Usage Guidelines

You can simulate a message generation by issuing a callhome test command.

Examples

The following example sends a test message to the configured destination(s):

switch# callhome test

trying to send test callhome message

successfully sent test callhome message

The following example sends a test inventory message to the configured destination(s)

switch# callhome test inventory

trying to send test callhome message

successfully sent test callhome message

Related Commands

Command	Description
callhome	Configures Call Home functions.
show callhome	Displays configured Call Home information.

cd

To change the default directory or file system, use the cd command.

cd {directory | bootflash:[directory] | slot0:[directory] | volatile:[directory]}

Syntax Description

directory	Name of the directory on the file system.
bootflash:	URI or alias of the bootflash or file system.
slot0:	URI or alias of the slot0 file system.
volatile:	URI or alias of the volatile file system.

Defaults

The initial default file system is flash:. For platforms that do not have a physical device named flash:, the keyword flash: is aliased to the default Flash device.

If you do not specify a directory on a file system, the default is the root directory on that file system.

Command Modes

EXEC mode

Command History

This command was introduced in Cisco MDS SAN-OS Release 1.0(2).

Usage Guidelines

For all EXEC commands that have an optional file system argument, the system uses the file system specified by the cd command when you omit the optional file system argument. For example, the dir command, which displays a list of files on a file system, contains an optional file system argument. When you omit this argument, the system lists the files on the file system specified by the cd command.

Examples

The following example sets the default file system to the Flash memory card inserted in slot 0:

switch# pwd 

bootflash:/

switch# cd slot0: 

switch# pwd 

slot0:/

Related Commands

Command	Description
copy	Copies any file from a source to a destination.
delete	Deletes a file on a Flash memory device.
dir	Displays a list of files on a file system.
pwd	Displays the current setting of the cd command.
show file systems	Lists available file systems and their alias prefix names.
undelete	Recovers a file marked deleted on a Class A or Class B Flash file system.

cdp

Use the cdp command to globally configure the Cisco Discovery Protocol parameters. Use the no form of this command to revert to factory defaults.

cdp {enable | advertise {v1 | v2} | holdtime holdtime-seconds | timer timer-seconds}

no cdp {enable | advertise | holdtime holdtime-seconds | timer timer-seconds}

Syntax Description

enable	Enables CDP globally on all interfaces on the switch.
advertise	Specifies the EXEC command to be executed.
v1	Specifies CDP version 1.
v2	Specifies CDP version 2.
holdtime	Sets the hold time advertised in CDP packets.
holdtime-seconds	Specifies the holdtime in seconds. The default is 180 seconds and the valid range is from 10 to 255 seconds.
timer	Sets the refresh time interval.
timer-seconds	Specifies the time interval in seconds. The default is 60 seconds and the valid range is from 5 to 255 seconds.

Defaults

CDP is enabled.

The hold time default interval is 180 seconds.

The refresh time interval is 60 seconds.

Command Modes

Configuration mode.

Command History

This command was introduced in Cisco MDS SAN-OS Release 1.1(1).

Usage Guidelines

Use the cdp enable command to enable the Cisco Discovery Protocol (CDP) feature at the switch level or at the interface level. Use the no form of this command to disable this feature. When the interface link is established, CDP is enabled by default

CDP version 1 (v1) and version 2 (v2) are supported in Cisco MDS 9000 Family switches. CDP packets with any other version number are silently discarded when received.

Examples

The following example disables the CDP protocol on the switch. When CDP is disabled on an interface, one packet is sent to clear out the switch state with each of the receiving devices.

switch(config)# no cdp enable

Operation in progress. Please check global parameters

switch(config-console)# 	

The following example enables (default) the CDP protocol on the switch. When CDP is enabled on an 
interface, one packet is sent immediately. Subsequent packets are sent at the configured refresh time

switch(config)# cdp enable

Operation in progress. Please check global parameters

switch(config)# 

The following example configures the Gigabit Ethernet interface 8/8 and disables the CDP protocol on this interface. When CDP is disabled on an interface, one packet is sent to clear out the switch state with each of the receiving devices.

switch(config)# interface gigbitethernet 8/8

switch(config-if)# no cdp enable

Operation in progress. Please check interface parameters

switch(config-console)# 	

The following example enables (default) the CDP protocol on the selected interface. When CDP is enabled on this interface, one packet is sent immediately. Subsequent packets are sent at the configured refresh time.

switch(config-if)# cdp enable

Operation in progress. Please check interface parameters

switch(config)# 

The following example globally configures the refresh time interval for the CDP protocol in seconds. The default is 60 seconds and the valid range is from 5 to 255 seconds.

switch# config terminal

switch(config)# cdp timer 100

switch(config)# 	

The following example globally configures the hold time advertised in CDP packet in seconds. The default is 180 seconds and the valid range is from 10 to 255 seconds.

switch# config terminal

switch(config)# cdp holdtime 200

switch(config)# 	

The following example globally configures the CDP version. The default is version 2 (v2). The valid options are v1 and v2

switch# config terminal

switch(config)# cdp advertise v1

switch(config)# 

Related Commands

Command	Description
clear cdp	Clears global or interface-specific CDP configurations.
show cdp	Displays configured CDP settings and parameters.

cimserver

Use the cimserver command to configure the Common Information Models (CIM) parameters. Use the no form of this command to revert to factory defaults.

cimserver
{certificate {bootflash:filename | slot0:filename | volatile:filename} |
clearcertificate filename |
enable |
enablehttp |
enablehttps}

no cimserver
{certificate {bootflash:filename | slot0:filename | volatile:filename} |
clearcertificate filename
enable
enablehttp
enablehttps}

Syntax Description

certificate	Installs the Secure Socket Layer (SSL) certificate
bootflash:	Specifies the location for internal bootflash memory.
slot0:	Specifies the location for the CompactFlash memory or PCMCIA card.
volatile:	Specifies the location for the volatile file system.
filename	The name of the license file with a .pem extention.
clearcertificate	Clears a previously-installed SSL certificate.
enable	Enables and starts the CIM server.
enablehttp	Enables the HTTP (non-secure) protocol for the CIM server—(default).
enablehttps	Enables the HTTPS (secure) protocol for the CIM server.

Defaults

None.

Command Modes

Configuration mode.

Command History

This command was introduced in Cisco MDS SAN-OS Release 1.3(1).

Usage Guidelines

A CIM client is required to access the CIM server. The client can be any client that supports CIM.

Examples

The following example installs a Secure Socket Layer (SSL) certificate specified in the file named with a .pem extention.

switch# config t

switch(config)# cimserver certificateName bootflash:simserver.pem

The following example clears the specified SSL certificate.

switch(config)# cimserver clearCertificateName bootflash:simserver.pem

The following example enables HTTPS (secure protocol).

switch(config)# cimserver enablehttps

The following example disables HTTPS (default).

switch(config)# no cimserver enablehttps

The following example

switch(config)# cimserver enable

The following example disables the CIM server (default).

switch(config)# no cimserver enable

The following example enables HTTP and reverts to the switch default.

switch(config)# cimserver enablehttp 

The following example disables HTTP and reverts to the switch default.

switch(config)# no cimserver enablehttp 

Related Commands

Command	Description
show csimserver	Displays configured CIM settings and parameters.

clear arp-cache

To clear the ARP cache table entries, use the clear arp-cache command in EXEC mode.

clear arp-cache

Syntax Description

This command has no arguments or keywords.

Defaults

The ARP table is empty by default.

Command Modes

EXEC mode.

Command History

This command was introduced in Cisco MDS SAN-OS Release 1.0(2).

Examples

The following example shows how to clear the arp-cache table entries.

switch# clear arp-cache

Related Commands

Command	Description
show arp	Displays Address Resolution Protocol (ARP) entries.

clear cdp

Use the clear cdp command to delete global or interface-specific CDP configurations.

clear cdp {counters | table} [interface {gigabitethernet slot/port | mgmt 0}]

Syntax Description

counters	Enables CDP on globally or on a per-interfaces basis.
table	Specifies the EXEC command to be executed.
interface	Displays CDP parameters for an interface.
gigabitethernet	Specifies the Gigabit Ethernet interface.
slot/port	Specifies the slot number and port number separated by a slash (/).
mgmt 0	Specifies the Ethernet management interface.

Defaults

None.

Command Modes

Configuration mode.

Command History

This command was introduced in Cisco MDS SAN-OS Release 1.1(1).

Usage Guidelines

You can issue this command for a specified interface or for all interfaces (management and Gigabit Ethernet interfaces)

Examples

The following example clears CDP traffic counters for all interfaces.

switch# clear cdp counters

switch#

The following example clears CDP entries for the specified Gigabit Ethernet interface.

switch# clear cdp table interface gigabitethernet 4/1

switch#

Related Commands

Command	Description
cdp	Configures global or interface-specific CDP settings and parameters.
show cdp	Displays configured CDP settings and parameters.

clear cores

To clear all core dumps for the switch, use the clear cores command in EXEC mode.

clear cores

Syntax Description

This command has no arguments or keywords.

Defaults

None.

Command Modes

EXEC mode.

Command History

This command was introduced in Cisco MDS SAN-OS Release 1.0(2).

Usage Guidelines

The system software keeps the last few cores per service and per slot and clears all other cores present on the active supervisor module.

Examples

The following example shows how to clear all core dumps for the switch.

switch# clear cores

Related Commands

Command	Description
show cores	Displays core dumps that have been made.

clear counters

To clear the interface counters, use the clear counters command in EXEC mode.

clear counters { all | interface {fc | mgmt | port-channel | sup-fc | vsan} number}

Syntax Description

all	Clears all interface counters.
interface	Clears interface counters for the specified interface.
type	Specifies the interface type. See the Keywords table in the "Usage Guidelines" section.
number	Specifies the number of the slot or interface being cleared.

Defaults

None.

Command Modes

EXEC mode.

Command History

This command was introduced in Cisco MDS SAN-OS Release 1.0(2).

Usage Guidelines

The following table lists the keywords and number ranges for the clear counters interface types:

Keyword	Interface Type	Number
fc	Fibre Channel	1- 2 or 1 - 9 (slot)
gigabitethernet	Gigabit Ethernet	1- 2 or 1 - 9 (slot)
mgmt	Management	0-0 (management interface)
port-channel	PortChannel	1-128 (PortChannel)
sup-fc	Inband	0-0 (Inband interface)
vsan	VSAN	1- 4093 (VSAN ID)

This command clears counter displayed in the show interface command output.

Examples

The following example shows how to clear counters for a VSAN interface.

switch# clear counters interface vsan 13

Related Commands

Command	Description
show interface	Displays interface information.

clear debug-logfile

To delete the debug logfile, use the clear debug-logfile command in EXEC mode.

clear debug-logfile filename

Syntax Description

filename

The name (restricted to 80 characters) of the log file to be cleared. The maximum size of the log file is 1024 bytes.

Defaults

None.

Command Modes

EXEC.

Command History

This command was introduced in Cisco MDS SAN-OS Release 1.0(2).

Examples

The following example shows how to clear the debug logfile.

switch# clear debug-logfile debuglog

Related Commands

Command	Description
show debug logfilw	Displays the logfile contents.

clear fabric-binding statistics

To clear fabric binding statistics in a FICON enabled VSAN, use the clear fabric-binding statistics command in EXEC mode.

clear fabric-binding statistics vsan vsan-id

Syntax Description

vsan vsan-id

Specifies the FICON-enabled VSAN. The ID of the VSAN is from 1 to 4093.

Defaults

None

Command Modes

EXEC mode

Command History

This command was introduced in Cisco MDS SAN-OS Release 1.3(1).

Usage Guidelines

None.

Examples

The following example clears existing fabric binding statistics in VSAN 1.

switch# clear fabric-binding statistics vsan 1

Related Commands

Command	Description
show fabric-binding efmd statistics	Displays existing fabric binding statistics information.

clear fcanalyzer

To clear the entire list of configured hosts for remote capture, use the clear fcanalyzer command in EXEC mode.

clear fcanalyzer

Syntax Description

This command has no arguments or keywords.

Defaults

None.

Command Modes

EXEC.

Command History

This command was introduced in Cisco MDS SAN-OS Release 1.0(2).

Usage Guidelines

This command clears only the list of configured hosts. Existing connections are not terminated.

Examples

The following example shows how to clear the entire list of configured hosts for remote capture.

switch# clear fcanalyzer 

Related Commands

Command	Description
show fcanalyzer	Displays the list of hosts configured for a remote capture.

clear fcflow stats

To clear Fibre Channel flow statistics, use the clear fcflow stats command in EXEC mode.

clear fcflow stats [aggregated] module module-number index flow-number

Syntax Description

aggregated	Clears the Fibre Channel flow aggregated statistics.
module	Clears the statistics for a specified module.
module-number	Specifies the module number.
index	Clears the Fibre Channel flow counters for a specified flow index.
flow-number	Specifies the flow index number.

Defaults

None.

Command Modes

EXEC.

Command History

This command was introduced in Cisco MDS SAN-OS Release 1.0(2).

Examples

The following example shows how to clear aggregated Fibre Channel flow statistics for flow index 1 of module 2.

switch(config)# # clear fcflow stats aggregated module 2 index 1

Related Commands

Command	Description
show fcflow	Displays the fcflow statistics.

clear fcns statistics

To clear the name server statistics, use the clear fcns statistics command in EXEC mode.

clear fcns statistics vsan vsan-id

Syntax Description

vsan vsan-id

FCS statistics are to be cleared for a specified VSAN ranging from 1 to 4093.

Defaults

None.

Command Modes

EXEC.

Command History

This command was introduced in Cisco MDS SAN-OS Release 1.0(2).

Examples

The following example shows how to clear the name server statistics.

switch# show fcns statistics

Name server statistics for vsan 1

===================================

registration requests received = 0

deregistration requests received = 0

queries received = 23

queries sent = 27

reject responses sent = 23

RSCNs received = 0

RSCNs sent = 0

switch# clear fcns statistics vsan 1

switch# show fcns statistics

Name server statistics for vsan 1

===================================

registration requests received = 0

deregistration requests received = 0

queries received = 0

queries sent = 0

reject responses sent = 0

RSCNs received = 0

RSCNs sent = 0

switch#

Related Commands

Command	Description
show fcns statistics	Displays the name server statistics.

clear fcs statistics

To clear the fabric configuration server statistics, use the clear fcs statistics command in EXEC mode.

clear fcs statistics vsan vsan-id

Syntax Description

vsan vsan-id

FCS statistics are to be cleared for a specified VSAN ranging from 1 to 4093.

Defaults

None.

Command Modes

EXEC mode.

Command History

This command was introduced in Cisco MDS SAN-OS Release 1.0(2).

Examples

The following example shows how to clear the fabric configuration server statistics for VSAN 10.

switch# clear fcs statistics vsan 10

Related Commands

Command	Description
show fcs statistics	Displays the fabric configuration server statistics information.

clear ficon

Use the clear ficon command in EXEC mode to clear the FICON information for the specified VSAN.

clear ficon vsan vsan-id [allegiance | timestamp]

Syntax Description

vsan vsan-id	Specifies the FICON-enabled VSAN. The ID of the VSAN is from 1 to 4093.
allegiance	Clears FICON device allegiance.
timestamp	Clears FICON VSAN specific timestamp.

Defaults

None.

Command Modes

EXEC mode.

Command History

This command was introduced in Cisco MDS SAN-OS Release 1.3(1).

Usage Guidelines

The clear ficon vsan vsan-id allegiance command aborts the currently-executing session.

Examples

The following example clears the current device allegiance for VSAN 1.

switch# clear ficon vsan 1 allegiance

The following example clears the VSAN clock for VSAN 20.

switch# clear ficon vsan 20 timestamp

Related Commands

Command	Description
show ficon	Displays configured FICON details.

clear fspf counters

To clear the Fabric Shortest Path First statistics, use the clear fspf counters command in EXEC mode.

clear fspf counters vsan vsan-id [interface type]

Syntax Description

vsan	Indicates that the counters are to be cleared for a VSAN.
vsan-id	The ID of the VSAN is from 1 to 4093.
interface type	(Optional). The counters are to be cleared for an interface. The interface types are fc for Fibre Channel, and port-channel for PortChannel.

Defaults

None.

Command Modes

EXEC mode.

Command History

This command was introduced in Cisco MDS SAN-OS Release 1.0(2).

Usage Guidelines

If the interface is not specified, then all of the counters of a VSAN are cleared. If the interface is specified, then the counters of the specific interface are cleared.

Examples

The following example clears the FSPF t statistics on VSAN 1.

switch# clear fspf counters vsan 1

The following example clears FSPF statistics specific to the Fibre Channel interface in VSAN 1, Slot 9 Port 32.

switch#  clear fspf counters vsan 1 interface fc 9/32

Related Commands

Command	Description
show fspf	Displays global FSPF information for a specific VSAN.

clear ip access-list counters

To clear IP access list counters, use the clear ip access-list counters command in EXEC mode.

clear ip access-list counters list-name

Syntax Description

list-name

Specifies the IP access list name (maximum 64 characters).

Defaults

None.

Command Modes

EXEC.

Command History

This command was introduced in Cisco MDS SAN-OS Release 1.1(1).

Examples

The following example clears the counters for an IP access list.

switch# clear ip access-list counters adminlist

Related Commands

Command	Description
show ip access-list	Displays IP access list information.

clear ips arp

To clear ARP caches, use the clear ips arp command in EXEC mode.

clear ips arp {address ip-address| interface gigabitethernet module-number}

Syntax Description

address	Clears fcflow aggregated statistics.
ip-address	Enters the peer IP address.
interface gigabitethernet	Specifies the Gigabit Ethernet interface.
module-number	Specifies slot and port of the Gigabit Ethernet interface.

Defaults

None.

Command Modes

EXEC.

Command History

This command was introduced in Cisco MDS SAN-OS Release 1.1(1).

Examples

The ARP cache can be cleared in two ways: clearing just one entry or clearing all entries in the ARP cache.

The following example clears one ARP cache entry:

switch# clear ips arp address 10.2.2.2 interface gigabitethernet 8/7 

arp clear successful

The following example clears all ARP cache entries

switch# clear ips arp interface gigabitethernet 8/7

arp clear successful

clear ivr zone database

To clear the inter-VSAN routing (IVR) zone database, use the clear ivr zone database command in EXEC mode.

clear ivr zone database

Syntax Description

This command has no arguments or keywords.

Defaults

None.

Command Modes

EXEC.

Command History

This command was introduced in Cisco MDS SAN-OS Release 1.3(1).

Examples

The following example clears all configured IVZ information.

switch# clear ivr zone database 

clear license

To uninstall a license, use the clear license command in EXEC mode.

clear license filename

Syntax Description

filename

Specifies the license file to be uninstalled.

Defaults

None.

Command Modes

EXEC.

Command History

This command was modified in Cisco MDS SAN-OS Release 1.3(2).

Examples

The following example clears a specific license.

switch# clear license Ficon.lic 

Clearing license Ficon.lic:

SERVER this_host ANY

VENDOR cisco

# An example fcports license

INCREMENT SAN_EXTN_OVER_IP cisco 1.000 permanent 1 HOSTID=VDH=ABCD \

        NOTICE=<LicFileID>san_extn2.lic</LicFileID><LicLineID>1</LicLineID> \

        SIGN=67CB2A8CCAC2

Do you want to continue? (y/n) y

Clearing license ..done

switch# 

Related Commands

Command	Description
show license	Displays license information.

clear line

To clear VTY sessions, use the clear line command in EXEC mode.

clear line vty-name

Syntax Description

vty-name

Specifies the VTY name (maximum 64 characters).

Defaults

None.

Command Modes

EXEC.

Command History

This command was introduced in Cisco MDS SAN-OS Release 1.2(1).

Examples

The following example clears one ARP cache entry:

switch# clear line Aux

arp clear successful

Related Commands

Command	Description
show line	Displays line information.

clear logging

To delete the SYSLOG information, use the clear logging command in EXEC mode.

clear logging {logfile | nvram}

Syntax Description

logfile	Clears log file messages.
nvram	Clears NVRAM logs.

Defaults

None.

Command Modes

EXEC.

Command History

This command was introduced in Cisco MDS SAN-OS Release 1.0(2).

Examples

The following example shows how to clear the debug logfile.

switch# clear logging logfile

Related Commands

Command	Description
show logging	Displays logging information.

clear ntp statistics

To clear Network Time Protocol (NTP) statistics, use the clear ntp statistics command in EXEC mode.

clear ntp statistics {all-peers | io | local | memory}

Syntax Description

all-peers	Clears I/O statistics for all peers.
io	Clears I/O statistics for I/O devices.
local	Clears I/O statistics for local devices.
memory	Clears I/O statistics for memory.

Defaults

None.

Command Modes

EXEC mode.

Command History

This command was introduced in Cisco MDS SAN-OS Release 1.0(2).

Usage Guidelines

None mode.

Examples

The following example shows how to clear NTP statistics for all peers.

switch# clear ntp statistics all-peers

The following example shows how to clear NTP statistics for I/O devices.

switch# clear ntp statistics io

The following example shows how to clear NTP statistics for local devices.

switch# clear ntp statistics local

The following example shows how to clear NTP statistics for memory.

switch# clear ntp statistics memory

Related Commands

Command	Description
show ntp	Displays the configured server and peer associations.

clear port-security

To clear the log files on the switch, use the clear processes log command in EXEC mode.

clear
database auto-learn {interface fc slot/port | port-channel number vsan vsan-id |
statistics vsan vsan-id}

Syntax Description

database	Clears the port security active configuration database.
statistics	Clears the port security counters.
auto-learn	Clears the auto-learnt entries for a specified interface or VSAN.
interface fc slot/port	Clears entries for a specified interface.
port-channel number	Clears entries for a specified PortChannel.
vsan vsan-id	Clears entries for a specified VSAN.

Defaults

None.

Command Modes

EXEC mode.

Command History

This command was introduced in Cisco MDS SAN-OS Release 1.2(1).

Usage Guidelines

The active database is read-only and clear port-security database command can be used when resolving conflicts.

Examples

The following example clears all existing statistics from the port security database for a specified VSAN.

switch# clear port-security statistics vsan 1

The following example clears learnt entries in the active database for a specified interface within a VSAN.

switch# clear port-security database auto-learn interface fc1/1 vsan 1

The following example clears learnt entries in the active database up to for the entire VSAN.

switch# clear port-security database auto-learn vsan 1

Related Commands

Command	Description
show port-security	Displays the configured port security information.

clear processes log

To clear the log files on the switch, use the clear processes log command in EXEC mode.

clear processes log {all | pid pid-number}

Syntax Description

all	Deletes all of the log files.
pid	Deletes the log files of a specific process.
pid-number	Specifies the process ID, which must be from 0 to 2147483647.

Defaults

None.

Command Modes

EXEC mode.

Command History

This command was introduced in Cisco MDS SAN-OS Release 1.0(2).

Usage Guidelines

None.

Examples

The following examples show how to clear all of the log files on the switch.

switch# clear processes log all

Related Commands

Command	Description
show processes	Displays the detailed running or log information of processes or high availability applications.

clear qos statistics

To clear the quality of services statistics counters, use the clear qos statistics command in EXEC mode.

clear qos statistics

Syntax Description

This command has no arguments or keywords.

Defaults

None.

Command Modes

EXEC mode.

Command History

This command was introduced in Cisco MDS SAN-OS Release 1.0(2).

Usage Guidelines

None.

Examples

The following examples shows how to clear the quality of service counters.

switch# clear qos statistics

Related Commands

Command	Description
show qos statistics	Displays the current QoS settings, along with a number of frames marked high priority.

clear rlir

To clear the Registered Link Incident Report (RLIR), use the clear rlir command in EXEC mode.

clear rlir {history | recent {interface fc slot/port | portnumber port-number} |
statistics vsan vsan-id}

Syntax Description

history	Clears RLIR link incident history.
recent	Clears recent link incidents.
interface fc slot/port	Clears entries for a specified interface.
portnumber port-number	Displays the port number for the link incidents.
statistics	Clears RLIR statistics.
vsan vsan-id	Specifies the VSNA ID for which the RLIR statistics are to be cleared.

Defaults

None.

Command Modes

EXEC mode.

Command History

This command was introduced in Cisco MDS SAN-OS Release 1.3(1).

Usage Guidelines

None.

Examples

The following example clears all existing statistics for a specified VSAN.

switch# clear rlir statistics vsan 1

The following example clears the link incident history.

switch# clear rlir history 

The following example clears recent RLIR information for a specified interface.

switch# clear rlir recent interface fc 1/2

The following example clears recent RLIR information for a specified port number.

switch# clear rlir recent portnumber 16

Related Commands

Command	Description
show rscn	Displays RSCN information.

clear rscn statistics

To clear the registered state change notification statistics for a specified VSAN, use the clear rscn statistics command in EXEC mode.

clear rscn statistics vsan vsan-id

Syntax Description

vsan	The RSCN statistics are to be cleared for a VSAN.
vsan-id	The ID for the VSAN for which you want to clear RSCN statistics.

Defaults

None.

Command Modes

EXEC mode.

Command History

This command was introduced in Cisco MDS SAN-OS Release 1.0(2).

Usage Guidelines

None.

Examples

The following example shows how to clear rcsn statistics for VSAN 1.

switch# clear rscn statistics 1

Related Commands

Command	Description
show rscn	Displays RSCN information.

clear screen

To clear the terminal screen, use the clear screen command in EXEC mode.

clear screen

Syntax Description

This command has no arguments or keywords.

Defaults

None.

Command Modes

EXEC mode.

Command History

This command was introduced in Cisco MDS SAN-OS Release 1.0(2).

Usage Guidelines

None.

Examples

The following example shows how to clear the terminal screen.

switch# clear screen

clear ssh hosts

To clear trusted SSH hosts, use the clear ssh hosts command in EXEC mode.

clear ssh hosts

Syntax Description

This command has no arguments or keywords.

Defaults

None.

Command Modes

EXEC mode.

Command History

This command was introduced in Cisco MDS SAN-OS Release 1.2(1).

Usage Guidelines

None.

Examples

The following example shows how to clear reset-reason information from NVRAM and volatile storage.

switch# clear ssh hosts

Related Commands

Command	Description
show ssh hosts	Displays SSH host information.

clear system reset-reason

To clear the reset-reason information stored in NVRAM and volatile persistent storage, use the clear system reset-reason command in EXEC mode.

clear system reset-reason

Syntax Description

This command has no arguments or keywords.

Defaults

None.

Command Modes

EXEC mode.

Command History

This command was introduced in Cisco MDS SAN-OS Release 1.3(2a).

Usage Guidelines

Use this command as listed below:

•In a Cisco MDS 9500 Series switch, this command clears the reset-reason information stored in NVRAM and volatile persistent storage in the active and standby supervisor modules.

•In a Cisco MDS 9200 Series switch, this command clears the reset-reason information stored in NVRAM and volatile persistent storage in the active supervisor module.

Examples

The following example shows how to clear trusted SSH hosts.

switch# clear system reset-reason

Related Commands

Command	Description
show system reset-reason	Displays system reset-reason information.

clear tlport alpa-cache

To clear the entire contents of the alpa-cache, use the clear tlport alpa-cache command in EXEC mode.

clear tlport alpa-cache

Syntax Description

This command has no arguments or keywords.

Defaults

None.

Command Modes

EXEC mode.

Command History

This command was introduced in Cisco MDS SAN-OS Release 1.3(5).

Usage Guidelines

None.

Examples

The following example shows how to clear a TL port ALPA cache.

switch# clear tlport alpa-cache

Related Commands

Command	Description
show tlport alpa-cache	Displays TL port alpa-cache information.

clear user

To clear trusted SSH hosts, use the clear user command in EXEC mode.

clear user username

Syntax Description

username

Specifies the user name to clear.

Defaults

None.

Command Modes

EXEC mode.

Command History

This command was introduced in Cisco MDS SAN-OS Release 1.2(1).

Usage Guidelines

None.

Examples

The following example shows how to log out a specified user.

switch# clear user vsam

Related Commands

Command	Description
show users	Displays user information.

clear vrrp

To clear all the software counters for the specified virtual router, use the clear vrrp command in EXEC mode.

clear vrrp {statistics | vr number interface {gigabitethernet port/slot | mgmt 0 |
port-channel portchannel-id | vsan vsan-id}}

Syntax Description

statistics	Clears global VRRP statistics.
vr	Clears specific VR statistics.
number	Specifies a VR number from 1 to 255.
interface	Specifies an interface.
gigabitethernet port/slot	Specifies a gigabitethernet interface.
mgmt 0	Specifies the management interface.
port-channel portchannel-id	Specifies a port-channel interface.The ID of the port-channel interface is from 1 to 128.
vsan vsan-id	Specifies a VSAN. The ID of the VSAN is from 1 to 4093.

Defaults

None.

Command Modes

EXEC mode.

Command History

This command was introduced in Cisco MDS SAN-OS Release 1.0(2).

Usage Guidelines

None.

Examples

The following examples shows how to clear all the software counters for virtual router 7 on VSAN 2.

switch# clear vrrp 7 interface vsan2 

Related Commands

Command	Description
show vrrp	Displays VRRP configuration information.

clear zone

To clear all configured information in the zone server for a specified VSAN, use the clear zone command in EXEC mode.

clear zone {database | statistics {lun-zoning | read-only-zoning}} vsan vsan-id

Syntax Description

database	Clears zone server database information.
statistics	Clears zone server statistics.
lun-zoning	Clears LUN-zoning related statistics.
read-only-zoning	Clears read-only zoning related statistics.
vsan	Clears zone information for a VSAN.
vsan-id	The ID of the VSAN is from 1 to 4093.

Defaults

None.

Command Modes

EXEC mode.

Command History

This command was introduced in Cisco MDS SAN-OS Release 1.0(2).

Usage Guidelines

After issuing a clear zone database command, you need to explicitly issue the copy running-config startup-config to ensure that the running configuration is used when you next start the switch.

Examples

The following examples shows how to clear all configured information in the zone server for VSAN 1.

switch# clear zone database vsan 1

Related Commands

Command	Description
show zone	Displays zone information for any configured interface.

clock

To configure the time zone and the summer time of day, use the clock command in configuration mode. To disable the daylight saving time adjustment, use the no form of this command.

clock {summer-time | time-zone daylight-timezone-name start-week start-day start-month start-time end-week end-day end-month end-time daylight-offset-to-be-added-in-minutes}

no clock {summer-time | time-zone daylight-timezone-name start-week start-day start-month start-time end-week end-day end-month end-time daylight-offset-to-be-added-in-minutes}

Syntax Description

summer-time	Adjusts the daylight savings time for the Pacific time zone by 60 minutes starting the first sunday in April at 2 a.m. and ending the last Sunday in October at 2 a.m.
time-zone	Sets the time zone for a specified time zone name.
daylight-timezone-name	The 8-character name of the time zone
start-week end-week	The week ranging from 1 through 5
start-day end-day	The day ranging from Sunday through Saturday
start-month end-month	The month ranging from January through December
start-time end-time	The time ranging from
daylight-offset-to-be-added-in-minutes	The daylight offset ranges from1 through 1440 minutes that will be added to the start time and deleted from the end time

Defaults

Coordinated Universal Time (UTC), which is the same as Greenwich Mean Time (GMT).

Command Modes

Configuration mode.

Command History

This command was introduced in Cisco MDS SAN-OS Release 1.0(2).

Usage Guidelines

Use this command if you need to change the UTC or GMT time or time zone.

Examples

The following example shows how to configure the time zone and summer time of day.

switch# config t

switch(config)# clock timezone <daylight timezone name> <start week> <start day> <start 
month> <start time> <end week> <end day> <end month> <end time> <daylight offset to be 
added in minutes> 

switch(config)# clock summer-time Pacific 1 Sun Apr 02:00 5 Sun Oct 02:00 60

switch(config)# no clock summer-time

switch(config)# exit

switch# 

Related Commands

Command	Description
clock set	Changes the default time on the switch.
show clock	Displays the current date and time.
show run	Displays changes made to the time zone configuration along with other configuration information.

code-page

Use the code-page command to configure the EBCDIC format. To disable the configuration or to revert to factory defaults, use the no form of the command.

code-page brazil |france | france | international-5 | italy | japan | spain-latinamerica | uk | us-canada

Syntax Description

code-page	Configures code page on a FICON-enabled VSAN
brazil	Configures the brazil EBCDIC format.
france	Configures the france EBCDIC format.
international-5	Configures the international-5 EBCDIC format.
italy	Configures the italy EBCDIC format.
japan	Configures the japan EBCDIC format.
spain-latinamerica	Configures the spain-latinamerica EBCDIC format.
uk	Configures the uk EBCDIC format.
us-canada	Configures the us-canada EBCDIC format.

Defaults

None.

Command Modes

Configuration mode.

Command History

This command was introduced in Cisco MDS SAN-OS Release 1.3(1).

Usage Guidelines

This is an optional configuration. If you are not sure of the EBCDIC format to be used, we recommend retaining the us-canada (default) option.

Examples

The following example configures the italy EBCDIC format.

switch(config)# ficon vsan 2

switch(config-ficon)# code-page italy

The following example reverts to the factory default of using the us-canada EBCDIC format.

switch(config-ficon)# no code-page

Related Commands

Command	Description
show ficon	Displays configured FICON details.
ficon vsan vsan-id	Enables FICON on the specified VSAN.

clock set

To change the system time on a Cisco MDS 9000 Family switch, use the clock set command in EXEC mode.

clock set HH:MM:SS DD Month YYYY

Syntax Description

HH	The two-digit time in hours in military format (15 for 3 p.m.).
MM	The two-digit time in minutes (58).
SS	The two-digit time in seconds(15).
DD	The two-digit date (12).
Month	The month in words (August).
YYYY	The four-digit year (2002).

Defaults

None.

Command Modes

EXEC mode.

Command History

This command was introduced in Cisco MDS SAN-OS Release 1.0(2).

Usage Guidelines

Generally, if the system is synchronized by a valid outside timing mechanism, such as an NTP clock source, or if you have a switch with calendar capability, you do not need to set the system clock. Use this command if no other time sources are available. The time specified in this command is relative to the configured time zone.

The clock set command changes are saved across system resets.

Examples

The following example displays the clock set command:

switch# clock set 15:58:15 12 August 2002

Mon Aug 12 15:58:00 PDT 2002

code-page

Use the code-page command to configure the EBCDIC format. To disable the configuration or to revert to factory defaults, use the no form of the command.

code-page {brazil | france | france | international-5 | italy | japan | spain-latinamerica | uk | us-canada}

Syntax Description

brazil	Specifies brazil EBCDIC format.
france	Specifies france EBCDIC format.
international-5	Specifies international-5 EBCDIC format.
italy	Specifies italy EBCDIC format.
japan	Specifies japan EBCDIC format.
spain-latinamerica	Specifies spain-latinamerica EBCDIC format.
uk	Specifies uk EBCDIC format.
us-canada	Specifies us-canada EBCDIC format.

Defaults

us-canada

Command Modes

Configuration mode.

Command History

This command was introduced in Cisco MDS SAN-OS Release 1.3(1).

Usage Guidelines

This is an optional configuration. If you are not sure of the EBCDIC format to be used, we recommend retaining the us-canada (default) option.

Examples

The following example configures the italy EBCDIC format.

switch(config)# ficon vsan 2

switch(config-ficon)# code-page italy

The following example reverts to the factory default of using the us-canada EBCDIC format.

switch(config-ficon)# no code-page

Related Commands

Command	Description
show ficon	Displays configured FICON details.
ficon vsan vsan-id	Enables FICON on the specified VSAN.

configure terminal

To enter the configuration mode, use the configure terminal command in EXEC mode.

configure terminal

Syntax Description

This command has no arguments or keywords.

Defaults

None.

Command Modes

EXEC mode.

Command History

This command was introduced in Cisco MDS SAN-OS Release 1.0(2).

Usage Guidelines

None.

Examples

The following example enters the configuration mode:

switch# configure terminal

switch(config)# 

The following example enters the configuration mode using an abbreviated format of the command:

switch# config t

switch(config)# 

copy

To save a backup of the system software, use the copy command in EXEC mode.

copy source-URL destination-URL

Syntax Description

source-URL	The location URL or alias of the source file or directory to be copied.
destination-URL	The destination URL or alias of the copied file or directory.

The following table lists the aliases for source and destination URLs.

running-config	Specifies the configuration currently running on the switch. The system:running-config keyword represents the current running configuration file.
startup-config	Specifies the configuration used during initialization (startup). You can copy the startup configuration from NVRAM. The nvram:startup-config keyword represents the configuration file used during initialization.
bootflash:	Specifies the location for internal bootflash memory.
slot0:	Specifies the location for the CompactFlash memory or PCMCIA card.
volatile:	Specifies the location for the volatile file system.
system	Specifies the location for system memory, which includes the running configuration.
tftp:	Specifies the location for a Trivial File Transfer Protocol (TFTP) network server. The syntax for this alias is tftp:[[//location]/directory]/filename.
ftp:	Specifies the location for a File Transfer Protocol (FTP) network server. The syntax for this alias is ftp:[[//location]/directory]/filename.
scp:	Specifies the location for a secure copy (scp) network server. The syntax for this alias is scp:[[//location]/directory]/filename.
sftp:	Specifies the location for a Secure Trivial File Transfer Protocol (SFTP) network server. The syntax for this alias is sftp:[[//location]/directory]/filename.
log:	Specifies the location for log files stored in the same directory.
debug:	Specifies the location for the debug files stored in the debug partition
nvram:	Specifies the switch NVRAM.
core:	Specifies the location of the cores from any switching or supervisor module to an external flash (slot 0) or a TFTP server.
filename	The name of the Flash file.
sup-1 sup-2	The number of the supervisor module, where sup-1 is the slot 5 supervisor (active) and sup-2 is the slot 6 supervisor (standby).

Defaults

None.

Command Modes

EXEC mode.

Command History

This command was modified in Cisco MDS SAN-OS Release 1.3(4).

Usage Guidelines

This command makes the running and the backup copy of the software identical.

A file can only be copied from an active supervisor to a standby supervisor, not from standby to active.

This command does not allow 127.x.x.x IP addresses.

The copy function will not be completed if the required space is not available in the directory. First change to the required directory (for example, cd bootflash:) and verify the available space (for example, dir bootflash:).

The entire copying process may take several minutes.

Do not copy a file from an external source directly to the standby supervisor. You must copy from the external source to the active supervisor, and then copy the saved file to the standby supervisor.

You can save cores (from the active supervisor module, the standby supervisor module, or any switching module) to an external flash (slot 0) or to a TFTP server in one of two ways:

•On demand—to copy a single file based on the provided process ID.

•Periodically—to copy core files periodically as configured by the user.

You copy the logfile to a different location using the copy log:messages command.

The debug partition contains debugging files created by the software for troubleshooting purposes.

Examples

The following example saves your configuration to the startup configuration.

switch# copy system:running-config nvram:startup-config 

The following example copies the file called samplefile from the slot0 directory to the mystorage directory.

switch# copy slot0:samplefile slot0:mystorage/samplefile

The following example copies a file from the current directory level.

switch# copy samplefile mystorage/samplefile

If the current directory is slot0:mydir, this command copies slot0:mydir/samplefile to slot0:mydir/mystorage/samplefile.

The following example downloads a configuration file from an external CompactFlash to the running configuration.

switch copy slot0:dns-config.cfg system:running-config

The following example saves a running configuration file to an external CompactFlash.

switch# copy system:running-config slot0:dns-config.cfg

The following example saves a startup configuration file to an external CompactFlash.

switch# copy system:startup-config slot0:dns-config.cfg

The following example creates a backup copy of the binary configuration.

switch# copy nvram:startup-config nvram:snapshot-config

The following example copies an image in bootflash on the active supervisor to the bootflash on the standby supervisor.

switch# copy bootflash:myimage bootflash://sup-2/myimage

The following example creates a running configuration copy in bootflash.

switch# copy system:running-config bootflash:my-config

The following examples creates a startup configuration copy in bootflash.

switch# copy nvram:startup-config bootflash:my-config

Related Commands

Command	Description
cd	Changes the default directory or file system.
dir	Displays a list of files on a file system.
reload	Reloads the operating system.
show version	Displays the version of the running configuration file.

copy licenses

To save a backup of the installed license files, use the copy licenses command in EXEC mode.

copy licenses source-URL destination-URL

Syntax Description

source-URL	The location URL or alias of the source file or directory to be copied.
destination-URL	The destination URL or alias of the copied file or directory.

The following table lists the aliases for source and destination URLs.

bootflash:	Specifies the location for internal bootflash memory.
slot0:	Specifies the location for the CompactFlash memory or PCMCIA card.
volatile:	Specifies the location for the volatile file system.
filename	The name of the license file with a .tar extention.

Defaults

None.

Command Modes

EXEC mode.

Command History

This command was introduced in Cisco MDS SAN-OS Release 1.3(4).

Usage Guidelines

The copy function will not be completed if the required space is not available in the directory. First change to the required directory (for example, cd bootflash:) and verify the available space (for example, dir bootflash:).

We recommend backing-up your license files immediately after installing them and just before issuing a write erase command.

Examples

The following example saves a file called Enterprise.tar to the bootflash: directory.

switch# copy licenses bootflash:/Enterprise.tar

Backing up license done

Related Commands

Command	Description
cd	Changes the default directory or file system.
dir	Displays a list of files on a file system.
install license	Installs a license file.