Table Of Contents

D Commands

delete

dir

discover custom-list

discover scsi-target

do

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 the "Command Modes" section to determine the appropriate mode for each command. For more information, refer to the Cisco MDS 9000 Family Configuration Guide.

•delete

•dir

•discover scsi-target

•discover custom-list

•do

delete

To delete a specified file or directory on a Flash memory device, use the delete command in EXEC mode.

delete {bootflash:filename | slot0:filename | volatile:filename}

Syntax Description

bootflash:	Flash image that resides on the supervisor module.
slot0:	Flash image that resides on another module.
volatile:	Flash image that resides on the volatile file system.
filename	The name of the file to be deleted.

Defaults

None.

Command Modes

EXEC mode.

Command History

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

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.

---

Caution If 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.cfg 

The following example deletes a file from an external CompactFlash (slot0).

switch# delete slot0:dns_config.cfg 

The following example deletes the entire my-dir directory and all its contents:

switch# delete bootflash:my-dir 

Related Commands

Command	Description
cd	Changes the default directory or file system.
dir	Displays a list of files on a file system.
show boot	Displays the contents of the BOOT environment variable, the name of the configuration file pointed to by the CONFIG_FILE environment variable, the contents of the BOOTLDR environment variable, and the configuration register setting.

dir

To display the contents of the current directory or the specified directory, use the dir command in EXEC mode.

dir [bootflash:directory-or-ilename | slot0:directory-or-filename | volatile:directory-or-filename]

Syntax Description

bootflash:	(Optional) Flash image that resides on the supervisor module.
slot0:	(Optional) Flash image that resides on another module.
filename-or-directory	(Optional) Name of the file or directory to display on a specified device. The files can be of any type. You can use wildcards in the filename. A wildcard character (*) matches all patterns. Strings after a wildcard are ignored.
volatile:	Flash image on the volatile file system.

Defaults

The default file system is specified by the cd command.

Command Modes

EXEC mode.

Command History

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

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.bin

12456448     Jul 30 23:05:28 1980  kickstart-image1

12288     			 Jun 23 14:58:44 1980  lost+found/

27602159     Jul 30 23:05:16 1980  system-image1

12447232     Aug 05 15:08:30 1980  kickstart-image2

28364853     Aug 05 15:11:57 1980  system-image2

Usage for bootflash://sup-local

  135404544 bytes used

   49155072 bytes free

  184559616 bytes total

Related Commands

Command	Description
cd	Changes the default directory or file system.
delete	Deletes a file on a Flash memory device.

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

add	Add a targets to the customized list.
delete	Deletes a target from the customized list.
vsan vsan-id	Discovers SCSI targets for the specified VSAN ID. The range is 1 to 4093.
fcip fc-id	Discovers SCSI targets for the specified FC ID. The format is 0xhhhhhhh, where h is a hexadecimal digit.

Defaults

None.

Command Modes

EXEC mode.

Command History

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

Usage Guidelines

None.

Examples

The following example selectively initiates discovery for the specified VSAN and FC ID.

switch# discover custom-list add vsan 1 fcid 0X123456

The following example deletes the specified VSAN and FC ID from the customized list.

switch# discover custom-list delete vsan 1 fcid 0X123456

discover 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

custom-list	Discovers SCSI targets from the customized list.
local	Discovers local SCSI targets.
remote	Discovers remote SCSI targets.
vsan vsan-id	Discovers SCSI targets for the specified VSAN ID. The range is 1 to 4093.
fcip fc-id	Discovers SCSI targets for the specified FC ID. The format is 0xhhhhhhh, where h is a hexadecimal digit.
os	Discovers the specified operating system.
aix	Discovers the AIX operating system
all	Discovers all operating systems
hpux	Discovers the HPUX operating system
linux	Discovers the Linux operating system
solaris	Discovers the Solaris operating system
windows	Discovers the Windows operating system
lun	Discovers SCSI targets and LUNs.
target	Discovers SCSI targets .

Defaults

None.

Command Modes

EXEC mode.

Command History

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

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 all

discovery started

The following example shows how to discover remote targets assigned to the Windows OS.

switch# discover scsi-target remote os windows

discovery started

The following example shows how to discover SCSI targets for the specified VSAN (1) and FC ID (0x9c03d6).

switch# discover scsi-target vsan 1 fcid 0x9c03d6 

discover scsi-target vsan 1 fcid 0x9c03d6

VSAN:    1 FCID: 0x9c03d6 PWWN: 00:00:00:00:00:00:00:00

  PRLI 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 linux

discovery started

do

Use the do command to execute an EXEC-level command from any configuration mode or submode.

do command

Syntax Description

command

Specifies the EXEC command to be executed.

Defaults

None.

Command Modes

All configuration modes.

Command History

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

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 disables the terminal session-timeout command using the do command in configuration mode.

switch(config)# do terminal session-timeout 0

switch(config)#

The following example create, enables, and displays the interface from configuration mode.

switch(config)# int fc 3/1

switch(config-if)# no shut

switch(config-if)# do show interface fc 3/1

fc3/1 is trunking

    Hardware is Fibre Channel

    Port WWN is 20:81:00:05:32:00:4a:9e

    Peer port WWN is 20:43:00:0c:88:00:4a:e2

    Admin port mode is auto, trunk mode is on

    Port mode is TE

    Port vsan is 1

    Speed is 2 Gbps

    Transmit B2B Credit is 0

    Receive B2B Credit is 255

    Receive data field Size is 2112

    Beacon is turned off

    Trunk 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/sec

    5 minutes output rate 344 bits/sec, 43 bytes/sec, 0 frames/sec

      69390 frames input, 4458680 bytes

        0 discards, 0 errors

        0 CRC,  0 unknown class

        0 too long, 0 too short

      69458 frames output, 3086812 bytes

        0 discards, 0 errors

      2 input OLS, 1 LRR, 0 NOS, 2 loop inits

      1 output OLS, 1 LRR, 1 NOS, 1 loop inits