FeedbackTable Of Contents
summer-time <California 1 Sun Apr 02:00 5 Sun Oct 02:00 60>
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. Please see the Command Mode section to determine the appropriate mode for each command. For more information, see the Cisco MDS 9000 Family Configuration Guide.
•
callhome
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
callhome
To configure the callhome function, use the callhome command.
callhome [ email-contact email_address] [ phone-contact number ] [ streetaddress street number, city, state, zip ] [ switch-priority priority value ] customer-id customer_ id ] [ site-id site number ] [ contract-id contract_id ] [ destination-profile full-txt-destination email-addr email_address | message-size size ] [ destination-profile short-txt-destination email-addr email_address | message-size size ] [ destination-profile XML-destination email-addr email_address | message-size size ] [ transport email from email_address |reply-to email_address | smtp-server ip address port number ] [ enable ] [ disable ] [ exit ] [ no ]
Syntax Description
Defaults
None
Command Modes
callhome command available in config t command mode. Callhome configuration commands available in callhome submode.
Usage Guidelines
A call home message is used to contact a support person or organization in case a significantly urgent alarm is raised.
Examples
switch# config tswitch(config)# callhomeswitch-config-callhome#switch-config-callhome# email-contact username@company.comsuccessfully updated the informationswitch-config-callhome#switch-config-callhome# phone-contact +1-800-123-4567successfully updated the informationswitch-config-callhome#switch-config-callhome# streetaddress 1234 Picaboo Street, Any city, Any state, 12345successfully updated the informationswitch-config-callhome#switch-config-callhome# switch-priority 0successfully updated the informationswitch-config-callhome#switch-config-callhome# customer-id Customer1234successfully updated the informationswitch-config-callhome#switch-config-callhome# site-id Site1ManhattanNYsuccessfully updated the informationswitch-config-callhome#switch-config-callhome# contract-id Company1234successfully updated the informationswitch-config-callhome#switch-config-callhome# destination-profile full-txt-destination email-addr person@place.comsuccessfully updated the informationswitch-config-callhome#switch-config-callhome# transport email from user@company1.comsuccessfully updated the informationswitch-config-callhome#Related Commands
cd
To change the default directory or file system, use the cd command.
cd {directory | bootflash:[directory] | slot0:[directory] | volatile:[directory]}
Syntax Description
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
Usage Guidelines
For all EXEC commands that have an optional filesystem argument, the system uses the file system specified by the cd command when you omit the optional filesystem argument. For example, the dir command, which displays a list of files on a file system, contain an optional filesystem 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 the slot 0:
switch# pwdbootflash:/switch# cd slot0:switch# pwdslot0:/Related Commands
clear arp-cache
To clear the arp-cache table entries, use the clear arp-cache command.
clear arp-cache
Syntax Description
This command has no keywords or arguments.
Defaults
The ARP table is empty by default.
Command Modes
EXEC
Usage Guidelines
None.
Examples
switch# clear arp-cacheswitch#Related Commands
clear cores
To clear all core dumps for the switch, use the clear cores command.
clear cores
Syntax Description
This command has no keywords or arguments.
Defaults
None.
Command Modes
EXEC
Usage Guidelines
The software keeps the last few cores per service and per slot and clears all other cores present on the active supervisor module.
Examples
switch# clear coresswitch#Related Commands
clear counters
To clear the counters, use the clear counters commands.
clear counters {statistics vrrp | interface {fc | mgmt | port-channel | sup-fc | vsan} number}
Syntax Description
Defaults
None.
Command Modes
EXEC
Usage Guidelines
None.
Examples
switch# clear counters statistices vrrpswitch#switch# clear counters interface vsan 13switch#clear debug-logfile
To clear the debug logfile, use the clear debug-logfile command.
clear debug-logfile filename
Syntax Description
Defaults
None.
Command Modes
EXEC
Usage Guidelines
None.
Examples
switch# clear debug-logfileswitch#clear fcanalyzer
To clear the entire list of configured hosts for remote capture, use the clear fcanalyzer command.
clear fcanalyzer
Syntax Description
This command has no arguments or keywords.
Defaults
None.
Command Modes
EXEC
Usage Guidelines
This command clears only the list of configured hosts. Existing connections are not terminated.
Examples
switch# clear fcanalyzerswitch#Related Commands
clear fcflow stats
To clear fcflow counters, use the clear fcflow stats command.
clear fcflow stats {[aggregated] module module-number index flow-number}
Syntax Description
Defaults
None.
Command Modes
EXEC
Usage Guidelines
None.
Examples
switch(config)# # clear fcflow stats aggregated module 2 index 1switch(config)#Related Commands
clear fcns statistics
To clear the name server statistics, use the clear fcns statistics command.
clear fcns statistics [vsan vsan-id]
Syntax Description
Defaults
None.
Command Modes
EXEC
Usage Guidelines
None.
Examples
switch# show fcns statisticsName server statistics for vsan 1===================================registration requests received = 0deregistration requests received = 0queries received = 23queries sent = 27reject responses sent = 23RSCNs received = 0RSCNs sent = 0switch# clear fcns statisticsswitch# show fcns statisticsName server statistics for vsan 1===================================registration requests received = 0deregistration requests received = 0queries received = 0queries sent = 0reject responses sent = 0RSCNs received = 0RSCNs sent = 0switch#Related Commandsexcal-113# show fcns statistics
Related Commands
Related CommandsName server statistics for vsan 1
Related Commands===================================
Related Commandsregistration requests received = 0
Related Commandsderegistration requests received = 0
Related Commandsqueries received = 23
Related Commandsqueries sent = 27
Related Commandsreject responses sent = 23
Related CommandsRSCNs received = 0
Related CommandsRSCNs sent = 0
Related Commandsexcal-113# clear fcns statistics
Related Commandsexcal-113# show fcns statistics
Related Commands
Related CommandsName server statistics for vsan 1
Related Commands===================================
Related Commandsregistration requests received = 0
Related Commandsderegistration requests received = 0
Related Commandsqueries received = 0
Related Commandsqueries sent = 0
Related Commandsreject responses sent = 0
Related CommandsRSCNs received = 0
Related CommandsRSCNs sent = 0
Related Commandsexcal-113#
clear fcs statistics
To clear the Fabric Configuration Server statistics, use the clear fib statistics command.
clear fcs statistics [vsan vsan-range]
Syntax Description
vsan
Indicates that FCS statistics are to be cleared for a specified VSAN.
vsan-range
The range of the VSANs (1-4093).
Defaults
None.
Command Modes
EXEC
Usage Guidelines
None.
Examples
switch# clear fcs statisticsswitch#Related Commands
clear fspf counters
To clear the fspf statistics, use the clear fspf counters command.
clear fspf counters vsan vsan-id [interface interface]
Syntax Description
vsan
Indicates that the counters are to be cleared for a VSAN.
vsan int
The id of the VSAN (1-4093).
interface
fc for Fibre Channel, port-channel for Port Channel
Defaults
None.
Command Modes
EXEC
Usage Guidelines
If the interface is not specified all the counters of a VSAN are cleared. If the interface is specified the counters of the specific interface is cleared.
Examples
switch# clear fspf counters vsan 1switch#Related Commands
clear ntp statistics
To clear NTP statistics, use the clear ntp statistics command.
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
Usage Guidelines
None.
Examples
switch# clear ntp statistics all-peersswitch#switch# clear ntp statistics ioswitch#switch# clear ntp statistics localswitch#switch# clear ntp statistics memoryswitch#Related Commands
clear processes log
To clear the log files on the switch, use the clear processes log command.
clear processes log {all | pid integer}
Syntax Description
all
Deletes all the log files.
pid integer
Deletes the log files of a specific process. The process ID must be from 0-2147483647.
Defaults
None
Command Modes
EXEC
Usage Guidelines
None.
Examples
switch# clear processes log allswitch#Related Commands
show processes
Displays the detail running or log information of processes or high availability applications.
clear qos statistics
To clear the QOS statistics counters, use the clear qos statistics command.
clear qos statistics
Syntax Description
This command has no arguments or keywords.
Defaults
None
Command Modes
EXEC
Usage Guidelines
None.
Examples
swtich# clear qos statisticsswitch#Related Commands
show qos statistics
Displays the current QoS settings, along with a the number of frames marked high priority.
clear rscn statistics
To clear the RSCN statistics for a specified VSAN, use the clear rscn statistics command.
clear rscn statistics vsan vsan-range
Syntax Description
vsan
Indicates that statistics are to be cleared for a VSAN range.
vsan-range
The range of IDs for the VSANs for which you want to clear RSCN statisics.
Defaults
None
Command Modes
EXEC
Usage Guidelines
None.
Examples
switch# clear rscn statisticsswitch#Related Commands
clear screen
To clear the terminal screen, use the clear screen command.
clear screen
Syntax Description
This command has no arguments or keywords.
Defaults
None
Command Modes
EXEC
Usage Guidelines
None.
Examples
switch# clear screenswitch#clear vrrp
To clear all the software counters for the specified virtual router, use the clear vrrp command.
clear vrrp integer interface interface [vsan-id|mgmt-int]
Syntax Description
Defaults
None
Command Modes
EXEC
Usage Guidelines
None.
Examples
switch# clear vrrp 7 interface vsan2switch#Related Commands
clear zone
To clear all configured information in the zone server for a specified VSAN, use the clear zone command.
clear zone {database | statistics} vsan range
Syntax Description
Defaults
None.
Command Modes
EXEC
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
switch# clear zone database vsan 1switch#Related Commands
clock
To configure the time zone and the summer time of day, use the clock command.
clock [ summer-time <California 1 Sun Apr 02:00 5 Sun Oct 02:00 60 > | 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> > ]
The no form of this command disables the daylight saving time adjustment feature.
Syntax Description
Defaults
Coordinated Universal Time (UTC), which is same as Greenwich Mean Time (GMT).
Command Modes
Configuration mode
Usage Guidelines
Use this command if you need to change the UTC or GMT time or time zone
Examples
switch# config tswitch(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 California 1 Sun Apr 02:00 5 Sun Oct 02:00 60switch(config)# no clock summer-timeswitch(config)# exitswitch#Related Commands
clock set
To change the default time on a Cisco 9000 Family switch, use the clock set command from configuration mode.
clock set <HH>:<MM>:<SS> <DD> <Month> <YYYY>
Syntax Description
Defaults
None
Command Modes
EXEC
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 command changes are saved across system resets.
Examples
The following example displays the clock set command:
switch# clock set 15:58:15 12 August 2002Mon Aug 12 15:58:00 PDT 2002Related Commands
copy
To save a backup of the system software, issue the copy command. This command makes the running and the backup copy of the software identical.
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.
Defaults
None
Command Modes
EXEC
Usage Guidelines
A file can only be copied from "active" to "standby" (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. Ensure to 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.
Examples
The following example saves your configuration to the startup configuration:
switch# copy system:running-config nvram:startup-config switch#This example copies the file called samplefile from the slot0 directory to the mystorage directory.
switch# copy slot0:samplefile slot0:mystorage/samplefileswitch#This example copies a file from the current directory level.switch# copy samplefile mystorage/samplefileswitch#If the current directory is slot0:mydir, this command copies slot0:mydir/samplefile to slot0:mydir/mystorage/samplefile.Use the following command to download a configuration file from an external CompactFlash to the running configuration.
switch copy slot0:dns-config.cfg system:running-configswitch#Use the following command to download a configuration file from an external CompactFlash to the startup configuration.
switch# copy slot0:dns-config.cfg nvram:startup-configswitch#Use the following command to save a running configuration file to an external CompactFlash.
switch# copy system:running-config slot0:dns-config.cfgswitch#Use the following command to save a startup configuration file to an external CompactFlash.
switch# copy system:startup-config slot0:dns-config.cfgswitch#To create a copy of the binary configuration in NVRAM, enter the following command:
switch# copy system:running-config nvram:startup-configswitch#To create a backup copy of the binary configuration, enter the following command:
switch# copy nvram:startup-config nvram:snapshot-configswitch#To overwrite the contents of an existing configuration in NVRAM, enter the following command:
switch# copy nvram:snapshot-config nvram:startup-configWarning: Snapshot file is going to override the current startup-config. Do you wish to proceed anyway? {y/n} [y] yTo copy an image in bootflash on the active supervisor to the bootflash on the standby supervisor, enter the following command.
switch# copy bootflash:myimage bootflash://sup-2/myimageswitch#To create a running configuration copy in bootflash, enter the following command:
switch# copy system:running-config bootflash:my-configswitch#To create a startup configuration copy in bootflash, enter the following command:
switch# copy nvram:startup-config bootflash:my-configswitch#Related Commands