-
Cisco MDS 9000 Family Command Reference, Release 3.x
-
New and Changed Information
-
Preface
-
CLI Overview
-
A Commands
-
Advanced Services Modules Commands
-
B Commands
-
C Commands
-
Caching Services Module Commands
-
D Commands
-
Debug Commands
-
E Commands
-
F Commands
-
G Commands
-
H Commands
-
I Commands
-
J Commands
-
K Commands
-
L Commands
-
M Commands
-
N Commands
-
O Commands
-
P Commands
-
Q Commands
-
R Commands
-
S Commands
-
Show Commands
-
T Commands
-
U Commands
-
V Commands
-
W Commands
-
Z Commands
-
Feedback
Table Of Contents
deadtime (radius group configuration)
deadtime (tacacs+ group configuration)
device-alias (IVR fcdomain database configuration submode)
device-alias (SDV virtual device configuration submode)
D 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 "About the CLI Command Modes" section on page 1-3 to determine the appropriate mode for each command. For more information, refer to the Cisco MDS 9000 Family CLI Configuration Guide.
data-pattern-file
To configure data pattern file for a SAN tuner extension N port, use the data-pattern-file command in interface configuration submode. To remove data pattern file, use the no form of the command.
data-pattern-file filename
no data-pattern-file
Syntax Description
Defaults
All zero pattern.
Command Modes
SAN extension N port configuration submode.
Command History
Usage Guidelines
By default, an all-zero pattern is used as the pattern for data generated by the virtual N ports. You can optionally specify a file as the data pattern to be generated by selecting a data pattern file from one of three locations: the bootflash: directory, the volatile: directory, or the slot0: directory. This option is especially useful when testing compression over FCIP links. You can also use Canterbury corpus or artificial corpus files for benchmarking purposes.
Examples
The following example configures the data pattern file for an N port:
switch# san-ext-tunerswitch(san-ext)# nWWN 10:00:00:00:00:00:00:00switch(san-ext)# nport pwwn 12:00:00:00:00:00:00:56 vsan 13 interface gigabitethernet 1/2switch(san-ext-nport)# data-pattern-file bootflash://DataPatternFileRelated Commands
nport pwwn
Configures SAN extension tuner N port pWWNs.
san-ext-tuner
Enters SAN extension tuner configuration mode.
show san-ext-tuner
Displays SAN extension tuner information.
deadtime (radius group configuration)
To configure a periodic time interval where a nonreachable (nonresponsive) RADIUS server is monitored for responsiveness, use the deadtime command in RADIUS group configuration submode. To disable the monitoring of the nonresponsive server, use the no form of the command.
deadtime time
no deadtime time
Syntax Description
time
Specifies the time interval (in minutes) for monitoring the server. The time range is 1 to 1440 minutes.
Defaults
Zero.
Command Modes
RADIUS group configuration submode.
Command History
Usage Guidelines
If the dead time interval for an individual RADIUS server is greater than zero (0), that value takes precedence over the value set for the server group.
When the dead time interval is 0 minutes, RADIUS server monitoring is not performed unless the RADIUS server is part of a server group and the dead time interval for the group is greater than 0 minutes.
Examples
The following example shows the deadtime command in RADIUS group configuration submode.
switch# config terminalswitch(config)# aaa group server radius testgroupswitch(config-radius)# deadtime 10Related Commands
radius-server deadtime
Sets a time interval for monitoring a nonresponsive RADIUS server.
show radius-server
Displays RADIUS server information.
deadtime (tacacs+ group configuration)
To configure a periodic time interval where a nonreachable (nonresponsive) TACACS+ server is monitored for responsiveness, use the deadtime command in TACACS+ group configuration submode. To disable the monitoring of the nonresponsive server, use the no form of the command.
deadtime time
no deadtime time
Syntax Description
time
Specifies the time interval (in minutes) for monitoring the server. The time range is 1 to 1440 minutes.
Defaults
Zero.
Command Modes
TACACS+ group configuration submode.
Command History
Usage Guidelines
If the dead time interval for an individual TACACS+ server is greater than zero (0), that value takes precedence over the value set for the server group.
When the dead time interval is 0 minutes, TACACS+ server monitoring is not performed unless the TACACS+ server is part of a server group and the dead time interval for the group is greater than 0 minutes.
Examples
The following example shows the deadtime command in TACACS+ group configuration submode.
switch# config terminalswitch(config)# aaa group server tacacs mygroupswitch(config-tacacs)# deadtime 5Related Commands
tacacs-server deadtime
Sets a time interval for monitoring a nonresponsive TACACS+ server.
show tacacs-server
Displays TACACS+ server information.
delete
To delete a specified file or directory on a Flash memory device, use the delete command in EXEC mode.
delete {bootflash:filename | debug:filename | log:filename | modflash:filename | slot0:filename | volatile:filename}
Syntax Description
Defaults
None.
Command Modes
EXEC mode.
Command History
1.0(2
This command was introduced.
2.1(1a)
Added debug, log, and modflash keywords.
Usage Guidelines
When you delete a file, the software erases the file.
If you attempt to delete the configuration file or image specified by the CONFIG_FILE or BOOTLDR environment variable, the system prompts you to confirm the deletion. Also, if you attempt to delete the last valid system image specified in the BOOT environment variable, the system prompts you to confirm the deletion.
CautionIf you specify a directory, the delete command deletes the entire directory and all its contents.
Examples
The following example deletes the file named test from the Flash card inserted in slot 0.
switch# delete slot0:test Delete slot0:test? [confirm]The following example deletes a file from a directory.
switch# delete dns_config.cfgThe following example deletes a file from an external CompactFlash (slot0).
switch# delete slot0:dns_config.cfgThe following example deletes the entire my-dir directory and all its contents:
switch# delete bootflash:my-dirThe following example deletes the entire user created dk log file on the active supervisor:
switch# delete log://sup-active/log://sup-active/dk log://sup-active/dmesg log://sup-active/messagesswitch# delete log://sup-active/dkswitch# dir log:31 Feb 04 18:22:03 2005 dmesg14223 Feb 04 18:25:30 2005 messagesUsage for log://sup-local35393536 bytes used174321664 bytes free209715200 bytes totalswitch#Related Commands
delete ca-certificate
To delete certificate authority certificates, use the delete ca-certificate command in trust point configuration submode.
delete ca-certificate
Syntax Description
This command has no arguments or keywords.
Defaults
None.
Command Modes
Trust point configuration submode.
Command History
Usage Guidelines
This command deletes the CA certificate or certificate chain corresponding to the trust point CA. As a result, the trust point CA is no longer trusted. If there is an identity certificate form the CA, you should delete it before attempting to delete the CA certificate. Doing so prevents the accidental deletion of a CA certificate when you have not yet deleted the identity certificate from that CA. This action may be necessary when you do not want to trust the CA any more for a reason such as the CA is compromised or the CA certificate is already expired, with the latter being a very rare event.
Note
Use the copy running-config startup-config command to make the certificate and key pair deletions persistent.Examples
The following example shows how to delete a certificate authority certificate.
switch# config terminalswitch(config)# crypto ca trustpoint admin-caswitch(config-trustpoint)# delete ca-certificateRelated Commands
delete certificate
Deletes the identity certificate.
delete crl
Deletes the crl from the trustpoint.
delete certificate
To delete the identity certificate, use the delete certificate command in trust point configuration submode.
delete certificate [force]
Syntax Description
Defaults
None.
Command Modes
Trust point configuration submode.
Command History
Usage Guidelines
Use this command to delete the identity certificate from the trust point CA. This action may be necessary when the identity certificate expires or the corresponding key pair is compromised. Applications will be left without any identity certificate to use after the deletion of the last or the only identity certificate present. Accordingly, an error message is generated if the certificate being deleted is the last or only identity certificate present. If needed, the deletion can still be accomplished by forcing it using the force option.
Note
Use the copy running-config startup-config command to make the certificate and key pair deletions persistent.Examples
The following example shows how to delete the identity certificate.
switch# config terminalswitch(config)# crypto ca trustpoint admin-caswitch(config-trustpoint)# delete certificateThe following example shows how to force the deletion of the identity certificate.
switch(config-trustpoint)# delete certificate forceRelated Commands
delete ca-certificate
Deletes the certificate authority certificate.
delete crl
Deletes the crl from the trustpoint.
delete crl
To delete the crl from the trustpoint, use the delete crl command in trust point configuration submode.
delete crl
Syntax Description
This command has no argument or keywords.
Defaults
None.
Command Modes
Trust point configuration submode.
Command History
Usage Guidelines
None.
Examples
The following example shows how to delete the crl from the trustpoint.
switch# config terminalswitch(config)# crypto ca trustpoint admin-caswitch(config-trustpoint)# delete crlRelated Commands
delete ca-certificate
Deletes the certificate authority certificate.
delete certificate
Deletes the identity certificate.
deny (IPv6-ACL configuration)
To configure deny conditions for an IPv6 access control list (ACL), use the deny command in IPv6-ACL configuration submode. To remove the conditions, use the no form of the command.
deny {ipv6-protocol-number | ipv6}
{source-ipv6-prefix/prefix-length | any | host source-ipv6-address}
{dest-ipv6-prefix/prefix-length | any | host dest-ipv6-address}
[log-deny]deny icmp
{source-ipv6-prefix/prefix-length | any | host source-ipv6-address}
{dest-ipv6-prefix/prefix-length | any | host dest-ipv6-address}
[icmp-type [icmp-code]]
[log-deny]deny tcp
{source-ipv6-prefix/prefix-length | any | host source-ipv6-address}
[source-port-operator source-port-number |
range source-port-number source-port-number]
{dest-ipv6-prefix/prefix-length | any | host dest-ipv6-address}
[dest-port-operator dest-port-number |
range dest-port-number dest-port-number]
[established] [log-deny]deny udp
{source-ipv6-prefix/prefix-length | any | host source-ipv6-address}
[source-port-operator source-port-number |
range source-port-number source-port-number]
{dest-ipv6-prefix/prefix-length | any | host dest-ipv6-address}
[dest-port-operator dest-port-number |
range dest-port-number dest-port-number]
[log-deny]no deny {ipv6-protocol-number | ipv6 | icmp | tcp | udp}
Syntax Description
Defaults
None.
Command Modes
IPv6-ACL configuration submode.
Command History
Usage Guidelines
The following guidelines can assist you in configuring an IPv6-ACL. For complete information, refer to the Cisco MDS 9000 Family CLI Configuration Guide.
•
Caution
•
•
Examples
The following example configures an IPv6-ACL called List1, enters IPv6-ACL submode, and adds an entry to deny TCP traffic from any source address to any destination address.
switch# config terminalswitch(config)# ipv6 access-list List1switch(config-ipv6-acl)# deny tcp any anyThe following example removes a deny condition set for any destination prefix on a specified UDP host.
switch# config terminalswitch(config)# ipv6 access-list List1switch(config-ipv6-acl)# no deny udp host 2001:db8:200d::4000 anyThe following example removes the IPv6-ACL called List1 and all its entries.
switch# config terminalswitch(config)# no ipv6 access-list List1Related Commands
ipv6 access-list
Configures an IPv6 ACL and enters IPv6-ACL configuration submode.
permit
Configures permit conditions for an IPv6 ACL.
destination interface
To configure a switched port analyzer (SPAN) destination interface, use the destination interface command in SPAN session configuration submode. To disable this feature, use the no form of the command.
destination interface {fc slot/port | fc-tunnel tunnel-id}
no destination interface {fc slot/port | fc-tunnel tunnel-id}
Syntax Description
fc slot/port
Specifies the Fibre Channel interface ID at a slot and port.
fc-tunnel tunnel-id
Specifies the Fibre Channel tunnel interface ID.
Defaults
Disabled.
Command Modes
SPAN session configuration submode.
Command History
Usage Guidelines
The SPAN destination interface must be configured as SPAN destination port (SD port) mode using the switchport command before the interface can be associated with SPAN session as a destination interface.
Examples
The following example shows how to configure an interface as a SPAN destination port (SD port), create a SPAN session, and then configure the interface fc3/13 as the SPAN destination interface.
switch# config terminalEnter configuration commands, one per line. End with CNTL/Z.switch(config)# interface fc3/13switch(config-if)# switchport mode sdswitch(config)# span session 1switch(config-span)# destination interface fc3/13switch(config-span)# do show span session 1switch(config-span)# show span session 1Session 1 (inactive as destination is down)Destination is fc3/13No session filters configuredNo ingress (rx) sourcesNo egress (tx) sourcesswitch(config-span)#Related Commands
destination-profile
To configure the customer ID with the Call Home function, use the destination-profile command in Call Home configuration submode. To disable this feature, use the no form of the command.
destination-profile {profile-name | full-txt-destination | short-txt-destination | xml-destination} {alert-group {all | avanti | cisco-tac | environmental | inventory | license | linecard-hardware | rmon | supervisor-hardware | syslog-group-port | system | test}
no destination-profile {profile-name | full-txt-destination | short-txt-destination | xml-destination} {alert-group {all | avanti | cisco-tac | environmental | inventory | license | linecard-hardware | rmon | supervisor-hardware | syslog-group-port | system | test}
Syntax Description
Defaults
None.
Command Modes
Call Home configuration submode.
Command History
Usage Guidelines
None.
Examples
The following example configures full-text destination profiles.
switch# config terminalEnter configuration commands, one per line. End with CNTL/Z.switch(config)# callhomeswitch(config-callhome)# destination-profile full-txt-destination email-addr person@place.comswitch(config-callhome)# destination-profile full-txt-destination message-size 1000000The following example configures short-text destination profiles.
switch(config-callhome)# destination-profile short-txt-destination email-addr person@place.comswitch(config-callhome)# destination-profile short-txt-destination message-size 100000Related Commands
callhome
Configures the Call Home function.
callhome test
Sends a dummy test message to the configured destination(s).
show callhome
Displays configured Call Home information.
device-alias (IVR fcdomain database configuration submode)
To map a device alias to a persistent FC ID for IVR, use the device-alias command in IVR fcdomain database configuration submode. To remove the mapping for the device alias, use the no form of the command.
device-alias device-name fc-id
no device-alias device-name
Syntax Description
device-name
Specifies the device name. Maximum length is 64 characters.
fc-id
Specifies the FC ID for the device.
Defaults
None.
Command Modes
IVR fcdomain database configuration submode.
Command History
Usage Guidelines
Only one FC ID can be mapped to a device alias.
Examples
The following example shows how to map the device alias to the persistent FC ID.
switch# config tswitch(config)# ivr fcdomain database autonomous-fabric-num 10 vsan 20switch(config-fcdomain)# native-autonomous-fabric-num 20 native-vsan 30 domain 15switch(config-fcdomain-fcid)# device-alias SampleName 0x123456The following example shows how to remove the mapping between the device alias and the FC ID.
switch# config tswitch(config)# ivr fcdomain database autonomous-fabric-num 10 vsan 20switch(config-fcdomain)# native-autonomous-fabric-num 20 native-vsan 30 domain 15switch(config-fcdomain-fcid)# no device-alias SampleNameRelated Commands
device-alias (SDV virtual device configuration submode)
To add a device alias to a virtual device, use the device-alias command in SDV virtual device configuration submode. To remove a device alias, use the no form of the command.
device-alias device-name [primary]
no device-alias device-name [primary]
Syntax Description
device-name
Specifies the device name. Maximum length is 64 characters.
primary
Specifies the device as a primary device.
Defaults
None.
Command Modes
SDV virtual device configuration submode.
Command History
Usage Guidelines
None.
Examples
The following example shows how to configure a virtual target alias name and how to
switch# config terminalEnter configuration commands, one per line. End with CNTL/Z.switch(config)# sdv virtual-device name sqa1 vsan 1switch(config-sdv-virt-dev)# device-alias group1 primaryRelated Commands
sdv enable
Enables or disables SAN device virtualization.
show sdv statistics
Displays SAN device virtualization statistics.
device-alias abort
To discard a Distributed Device Alias Services (device alias) Cisco Fabric Services (CFS) distribution session in progress, use the device-alias abort command in configuration mode.
device-alias abort
Syntax Description
This command has no other arguments or keywords.
Defaults
None.
Command Modes
Configuration mode.
Command History
Usage Guidelines
None.
Examples
The following example shows how to discard a device alias CFS distribution session in progress.
switch# config terminalswitch(config)# device-alias abortRelated Commands
device-alias commit
To apply the pending configuration pertaining to the Distributed Device Alias Services (device alias) Cisco Fabric Services (CFS) distribution session in progress in the fabric, use the device-alias commit command in configuration mode.
device-alias commit
Syntax Description
This command has no other arguments or keywords.
Defaults
None.
Command Modes
Configuration mode.
Command History
Usage Guidelines
None.
Examples
The following example shows how to commit pending changes to the active DPVM database.
switch# config terminalswitch(config)# device-alias commitRelated Commands
device-alias database
To initiate a Distributed Device Alias Services (device alias) session and configure device alias database, use the device-alias database command. To deactivate the device alias database, use the no form of the command.
device-alias database
no device-alias database
Syntax Description
This command has no other arguments or keywords.
Defaults
Deactivated.
Command Modes
Configuration mode.
Command History
Usage Guidelines
The device-alias database command starts a device alias session that locks all the databases on all the switches in this fabrics. When you exit device alias database configuration submode, the device alias session ends and the locks are released.
You can only perform all modifications in the temporary device alias database. To make the changes permanent, use the device-alias commit command.
Examples
The following example shows how to activate a device alias session and enter device alias database configuration submode;.
switch# config terminalswitch(config)# device-alias databaseswitch(config-device-alias-db)#Related Commands
device-alias commit
Commits changes to the temporary device alias database to the active device alias database.
show device-alias
Displays device alias database information.
device-alias distribute
To enable Cisco Fabric Services (CFS) distribution for Distributed Device Alias Services (device alias), use the device-alias distribute command. To disable this feature, use the no form of the command.
device-alias distribute
no device-alias distribute
Syntax Description
This command has no other arguments or keywords.
Defaults
Enabled.
Command Modes
Configuration mode.
Command History
Usage Guidelines
Use the device-alias commit command to apply pending changes to the CFS distribution session.
Examples
The following example shows how to enable distribution for device alias information.
switch# config terminalswitch(config)# device-alias distributeRelated Commands
device-alias import fcalias
To import device alias database information from another VSAN, use the device-alias import fcalias command. To revert to the default configuration or factory defaults, use the no form of the command.
device-alias import fcalias vsan vsan-id
no device-alias import fcalias vsan vsan-id
Syntax Description
Defaults
None.
Command Modes
Configuration mode.
Command History
Usage Guidelines
You can import legacy device name configurations using this feature without losing data, if they satisfy the following restrictions:
•
•
If any name conflict exists, the fcaliases are not imported. The device name database is completely independent from the VSAN dependent fcalias database.
When the import operation is complete, the modified global fcalias table can distributed to all other switches in the physical fabric using the device-alias distribute command so that new definitions are available everywhere.
Examples
The following example shows how to import device alias information.
switch# config terminalswitch(config)# device-alias import fcalias vsan 10Related Commands
device-alias name
To configure device names in the device alias database, use the device-alias name command. To remove device names from the device alias database, use the no form of the command.
device-alias name device-name pwwn pwwn-id
no device-alias name device-name
Syntax Description
device-name
Specifies the device name. Maximum length is 64 characters.
pwwn pwwn-id
Specifies the pWWN ID. The format is hh:hh:hh:hh:hh:hh:hh:hh, where h is a hexadecimal number.
Defaults
None.
Command Modes
Device alias database configuration submode.
Command History
Usage Guidelines
None.
Examples
The following example shows how to configure a device name alias entry in the device name database.
switch# config terminalswitch(config)# device-alias databaseswitch(config-device-alias-db)# device-alias name Device1 pwwn 21:00:00:20:37:6f:db:bbRelated Commands
device-alias database
Enters device alias database configuration submode.
show device-alias
Displays device alias database information.
dir
To display the contents of the current directory or the specified directory, use the dir command in EXEC mode.
dir [bootflash:module | directory-or-filename | debug:directory-or-filename | log:module | directory-or-filename | modflash:module | directory-or-filename | slot0:directory-or-filename | volatile:module | directory-or-filename]
Syntax Description
Defaults
The default file system is specified by the cd command.
Command Modes
EXEC mode.
Command History
1.2(1)
This command was introduced.
2.1(1a)
Added debug, log, and modflash keywords.
Usage Guidelines
None.
Examples
The following example shows how to list the files on the bootflash directory.
switch# dir bootflash: 40295206 Aug 05 15:23:51 1980 ilc1.bin12456448 Jul 30 23:05:28 1980 kickstart-image112288 Jun 23 14:58:44 1980 lost+found/27602159 Jul 30 23:05:16 1980 system-image112447232 Aug 05 15:08:30 1980 kickstart-image228364853 Aug 05 15:11:57 1980 system-image2Usage for bootflash://sup-local135404544 bytes used49155072 bytes free184559616 bytes totalThe following example shows how to list the files in the debug directory.
switch# dir debug: Usage for debug://sup-local0 bytes used2097152 bytes free2097152 bytes totalswitch#The following example shows how to list the files in the log file directory.
switch# dir log:31 Feb 05 05:00:57 2005 dmesg8445 Feb 06 10:34:35 2005 messagesUsage for log://sup-local35196928 bytes used174518272 bytes free209715200 bytes totalswitch#Related Commands
cd
Changes the default directory or file system.
delete
Deletes a file on a Flash memory device.
disable
To disable the Call Home function, use the disable command in Call Home configuration submode.
disable
Syntax Description
This command has no other arguments or keywords.
Defaults
None.
Command Modes
Call Home configuration submode.
Command History
Usage Guidelines
To enable the Call Home function, use the enable command.
Examples
The following example shows how to disable the Call Home function.
switch# config terminalEnter configuration commands, one per line. End with CNTL/Z.switch(config)# callhomeswitch(config-callhome)# disableRelated Commands
callhome
Configures the Call Home function.
callhome test
Sends a dummy test message to the configured destination(s).
show callhome
Displays configured Call Home information.
discover
To initiate the discovery of hosts, use the discovery command. To disable this feature, use the no form of the command.
discover host host port target target port vsan vsan id fabric fabric name
no discover
Syntax Description
Defaults
None.
Command Modes
Cisco SME cluster configuration submode.
Command History
Usage Guidelines
None.
Examples
The following example discovers a host and specifies a target, a VSAN, and a fabric for discovery:
switch# config tswitch(config)# sme cluster clustername1switch(config-sme-cl)# discover host 20:00:00:00:c9:49:28:47 target 21:01:00:e0:8b:29:7e:0c vsan 2345 fabric sw-xyzThe following example disables the discovery feature:
switch# config tswitch(config)# sme cluster clustername1switch(config-sme-cl)# no discoverRelated Commands
discover custom-list
To selectively initiate discovery for specified domain IDs in a VSAN, use the discover custom-list command in EXEC mode.
discover custom-list {add | delete} vsan vsan-id fcid fc-id
Syntax Description
Defaults
None.
Command Modes
EXEC mode.
Command History
Usage Guidelines
None.
Examples
The following example selectively initiates discovery for the specified VSAN and FCID.
switch# discover custom-list add vsan 1 fcid 0X123456The following example deletes the specified VSAN and FCID from the customized list.
switch# discover custom-list delete vsan 1 fcid 0X123456discover scsi-target
To discover SCSI targets on local storage to the switch or remote storage across the fabric, use the discover scsi-target command in EXEC mode.
discover scsi-target {custom-list | local | remote | vsan vsan-id fcid fc-id} os {aix | all | hpux | linux | solaris | windows} [lun | target]
Syntax Description
Defaults
None.
Command Modes
EXEC mode.
Command History
Usage Guidelines
On-demand discovery only discovers Nx ports present in the name server database that have registered a FC4 Type = SCSI_FCP.
Examples
The following example shows how to discover local targets assigned to all OSs.
switch# discover scsi-target local os alldiscovery startedThe following example shows how to discover remote targets assigned to the Windows OS.
switch# discover scsi-target remote os windowsdiscovery startedThe following example shows how to discover SCSI targets for the specified VSAN (1) and FCID (0x9c03d6).
switch# discover scsi-target vsan 1 fcid 0x9c03d6discover scsi-target vsan 1 fcid 0x9c03d6VSAN: 1 FCID: 0x9c03d6 PWWN: 00:00:00:00:00:00:00:00PRLI RSP: 0x01 SPARM: 0x0012...The following example begins discovering targets from a customized list assigned to the Linux operating system.
switch# discover scsi-target custom-list os linuxdiscovery starteddistribute
To enable distribution of the Call Home function using CFS, use the distribute command in Call Home configuration submode. To disable this feature, use the no form of the command.
distribute
no distribute
Syntax Description
This command has no other arguments or keywords.
Defaults
None.
Command Modes
Call Home configuration submode.
Command History
Usage Guidelines
None.
Examples
The following example shows how to enable distribution of the Call Home function using CFS.
switch# config terminalEnter configuration commands, one per line. End with CNTL/Z.switch(config)# callhomeswitch(config-callhome)# distributeRelated Commands
callhome
Configures the Call Home function.
callhome test
Sends a dummy test message to the configured destination(s).
show callhome
Displays configured Call Home information.
do
Use the do command to execute an EXEC-level command from any configuration mode or submode.
do command
Syntax Description
Defaults
None.
Command Modes
All configuration modes.
Command History
3.4(1)
Modified the command output for 3.4(1) release.
1.1(1)
This command was introduced.
Usage Guidelines
Use this command to execute EXEC commands while configuring your switch. After the EXEC command is executed, the system returns to the mode from which you issued the do command.
Examples
The following example shows how to execute the EXEC commands:
switch(config)# port-monitor name ciscoswitch(config-port-monitor)# doswitch(config-port-monitor)#The following example disables the terminal session-timeout command using the do command in configuration mode:
switch(config)# do terminal session-timeout 0switch(config)#The following example creates, enables, and displays the interface from configuration mode:
switch(config)# int fc 3/1switch(config-if)# no shutswitch(config-if)# do show interface fc 3/1fc3/1 is trunkingHardware is Fibre ChannelPort WWN is 20:81:00:05:32:00:4a:9ePeer port WWN is 20:43:00:0c:88:00:4a:e2Admin port mode is auto, trunk mode is onPort mode is TEPort vsan is 1Speed is 2 GbpsTransmit B2B Credit is 0Receive B2B Credit is 255Receive data field Size is 2112Beacon is turned offTrunk vsans (admin allowed and active) (1-10)Trunk vsans (up) (1-10)Trunk vsans (isolated) ()Trunk vsans (initializing) ()5 minutes input rate 504 bits/sec, 63 bytes/sec, 0 frames/sec5 minutes output rate 344 bits/sec, 43 bytes/sec, 0 frames/sec69390 frames input, 4458680 bytes0 discards, 0 errors0 CRC, 0 unknown class0 too long, 0 too short69458 frames output, 3086812 bytes0 discards, 0 errors2 input OLS, 1 LRR, 0 NOS, 2 loop inits1 output OLS, 1 LRR, 1 NOS, 1 loop initsdpvm abort
To discard a dynamic port VSAN membership (DPVM) Cisco Fabric Services (CFS) distribution session in progress, use the dpvm abort command in configuration mode.
dpvm abort
Syntax Description
This command has no other arguments or keywords.
Defaults
None.
Command Modes
Configuration mode.
Command History
Usage Guidelines
To use this command, DPVM must be enabled using the dpvm enable command.
Examples
The following example shows how to discard a DPVM CFS distribution session in progress.
switch# config terminalswitch(config)# dpvm abortRelated Commands
dpvm database
Configures the DPVM database.
dpvm distribute
Enables CFS distribution for DPVM.
dpvm enable
Enables DPVM.
show dpvm
Displays DPVM information.
dpvm activate
To activate the dynamic port VSAN membership (DPVM) configuration database, use the dpvm activate command. To deactivate the DPVM configuration database, use the no form of the command.
dpvm activate [force]
no dpvm activate [force]
Syntax Description
force
Forces the activation or deactivation if conflicts exist between the configured DPVM database and the active DPVM database.
Defaults
Deactivated.
Command Modes
Configuration mode.
Command History
Usage Guidelines
To use this command, DPVM must be enabled using the dpvm enable command.
Activation might fail if conflicting entries are found between the configured DPVM database and the currently activated DPVM database. You can ignore the conflicts using the force option.
Examples
The following example shows how to activate the DPVM database.
switch# config terminalswitch(config)# dpvm activateThe following example shows how to deactivate the DPVM database.
switch# config terminalswitch(config)# no dpvm activateRelated Commands
dpvm database
Configures the DPVM database.
dpvm enable
Enables DPVM.
show dpvm
Displays DPVM database information.
dpvm auto-learn
To enable the automatic learning feature (autolearn) for the active dynamic port VSAN membership (DPVM) database, use the dpvm auto-learn command. To disable this feature, use the no form of the command.
dpvm auto-learn
no dpvm auto-learn
Syntax Description
This command has no other arguments or keywords.
Defaults
Disabled.
Command Modes
Configuration mode.
Command History
Usage Guidelines
To use this command, DPVM must be enabled using the dpvm enable command.
When autolearn is enabled, the system automatically creates the DPVM database by learning about devices currently logged or newly logged devices with a VSAN. This is a quick way to create the DPVM database, which can later be edited. Autolearn features include the following:
•
•
•
•
•
•
Examples
The following example shows how to enable autolearning for the DPVM database.
switch# config terminalswitch(config)# dpvm auto-learnThe following example shows how to disable autolearning for the DPVM database.
switch# config terminalswitch(config)# no dpvm auto-learnRelated Commands
dpvm commit
To apply the pending configuration pertaining to the dynamic port VSAN membership (DPVM) Cisco Fabric Services (CFS) distribution session in progress in the fabric, use the dpvm commit command.
dpvm commit
Syntax Description
This command has no other arguments or keywords.
Defaults
None.
Command Modes
Configuration mode.
Command History
Usage Guidelines
To use this command, DPVM must be enabled using the dpvm enable command.
Examples
The following example shows how to commit changes to the DPVM database.
switch# config terminalswitch(config)# dpvm commitRelated Commands
dpvm distribute
Enables CFS distribution for DPVM.
dpvm enable
Enables DPVM.
show dpvm
Displays DPVM information.
dpvm database
To activate and configure the dynamic port VSAN membership (DPVM) database, use the dpvm database command. To deactivate the database, use the no form of the command.
dpvm database
no dpvm database
Syntax Description
This command has no other arguments or keywords.
Defaults
Deactivated.
Command Modes
Configuration mode.
Command History
Usage Guidelines
To use this command, DPVM must be enabled using the dpvm enable command.
The DPVM database consists of a series of device mapping entries. Each entry consists of device pWWN or nWWN along with the dynamic VSAN to be assigned. Use the nwwn command or pwwn command to add the entries to the DPVM database. This database is global to the whole switch (and fabric) and is not maintained for each VSAN.
Examples
The following example shows how to activate the DPVM database and enter DPVM database configuration submode.
switch# config terminalswitch(config)# dpvm databaseswitch(config-dpvm-db)#Related Commands
dpvm database copy active
To copy the active dynamic port VSAN membership (DPVM) database to the config DPVM database, use the dpvm database copy active command.
dpvm database copy active
Syntax Description
This command has no other arguments or keywords.
Defaults
Disabled.
Command Modes
EXEC mode.
Command History
Usage Guidelines
To use this command, DPVM must be enabled using the dpvm enable command.
The following circumstances may require the active database to be copied to the config database:
•
•
Note
Examples
The following example shows how to copy the active DPVM database to the config DPVM database.
switch# dpvm database copy activeRelated Commands
dpvm database diff
To display the active dynamic port VSAN membership (DPVM) database, use the dpvm database diff command.
dpvm database diff {active | config}
Syntax Description
active
Displays differences in the DPVM active database compared to the DPVM config database.
config
Displays differences in the DPVM config database compared to the DPVM active database.
Defaults
Deactivated.
Command Modes
Configuration mode.
Command History
Usage Guidelines
To use this command, DPVM must be enabled using the dpvm enable command.
Examples
The following example displays the differences in the DPVM active database when compared with the DPVM config database.
switch# dpvm database diff activeLegend: "+" New Entry, "-" Missing Entry, "*" Possible Conflict Entry
---------------------------------------------------------------------
- pwwn 44:22:33:44:55:66:77:88 vsan 44
* pwwn 11:22:33:44:55:66:77:88 vsan 11The following example displays the differences in the DPVM config database when compared with the DPVM active database.
switch# dpvm database diff configLegend: "+" New Entry, "-" Missing Entry, "*" Possible Conflict Entry
---------------------------------------------------------------------
- pwwn 44:22:33:44:55:66:77:88 vsan 44
* pwwn 11:22:33:44:55:66:77:88 vsan 11Related Commands
dpvm distribute
To enable Cisco Fabric Services (CFS) distribution for dynamic port VSAN membership (DPVM), use the dpvm distribute command. To disable this feature, use the no form of the command.
dpvm distribute
no dpvm distribute
Syntax Description
This command has no other arguments or keywords.
Defaults
Enabled.
Command Modes
Configuration mode.
Command History
Usage Guidelines
To use this command, DPVM must be enabled using the dpvm enable command.
Temporary changes to the DPVM database must be committed to the active DPVM database using the dpvm commit command before being distributed to the fabric.
Examples
The following example shows how to disable distribution for the DPVM database.
switch# config terminalswitch(config)# no dpvm distributeThe following example shows how to enable distribution for the DPVM database.
switch# config terminalswitch(config)# dpvm distributeRelated Commands
dpvm enable
To enable dynamic port VSAN membership (DPVM), use to dpvm enable command. To disable DPVM, use the no form of the command.
dpvm enable
no dpvm enable
Syntax Description
This command has no other arguments or keywords.
Defaults
Disabled.
Command Modes
Configuration mode.
Command History
Usage Guidelines
The configuration and verification commands for DPVM are only available when DPVM is enabled on the switch. When you disable this feature, all related configurations are automatically discarded.
Examples
The following example shows how to enable DPVM.
switch# config terminalswitch(config)# dpvm enableRelated Commands
dpvm activate
Activates the DPVM database.
dpvm database
Configures the DPVM database.
show dpvm
Displays DPVM database information.
dscp
To configure a differentiated services code point (DSCP) in a QoS policy map class, use the dscp command in EXEC mode. To disable this feature, use the no form of the command.
dscp value
no dscp value
Syntax Description
Defaults
The default DSCP value is 0.
Command Modes
QoS policy map class configuration submode.
Command History
Usage Guidelines
Before you can configure a QoS policy map class you must complete the following:
•
•
•
•
Examples
The following example configures a DSCP value of 56 in QoS policy classMap1.
switch(config-pmap)# class classMap1switch(config-pmap-c)# dscp 56switch(config-pmap-c)#Related Commands
duplicate-message throttle
To enable throttling of duplicate Call Home alert messages, use the duplicate-message throttle command in Call Home configuration submode. To disable this feature, use the no form of the command.
duplicate-message throttle
no duplicate-message throttle
Syntax Description
This command has no other arguments or keywords.
Defaults
Enabled.
Command Modes
Call Home configuration submode.
Command History
Usage Guidelines
The rate of throttling is a maximum of thirty messages in 2 hours.
Examples
The following example shows how to enable throttling of duplicate Call Home alert messages.
switch# config terminalswitch(config)# callhomeswitch(config-callhome)# duplicate-message throttleRelated Commands
callhome
Configures the Call Home function.
callhome test
Sends a dummy test message to the configured destination(s).
show callhome
Displays configured Call Home information.
