This topic provides information about the file system components supported on a Cisco MDS device. (The syntax for specifying a local file system is filesystem: [// modules/ ] . )

Note	The default filesystem parameter is bootflash:.

Insert the external flash device into the active supervisor module in a Cisco MDS device.

To format an external flash device, run the following command:

format {slot0: | usb1: | usb2: }

Example:

switch# format slot0:

Note	You can format an external flash device to erase its contents and restore the device to its factory-shipped state. For information about recovering corrupted bootflash using formatting, see the Cisco MDS 9000 Family NX-OS Troubleshooting Guide.

Mount or unmount a USB drive automatically by plugging or unplugging the drive from a Cisco MDS device. You can also use the mount or unmount command in either the user EXEC mode or the privileged EXEC mode to mount or unmount the device, respectively.

• To mount a USB drive on a Cisco MDS device, run the following command:

  mount {usb1: | usb2: }

  Example:

  switch# mount usb1:

• To unmount a USB drive from a Cisco MDS device, run the following command:

  unmount {usb1: | usb2: }

  Example:

  switch# unmount usb1:

To display the name of the current directory, run the following command:

pwd

Example:

switch# pwd

You can change the current directory for file system operations. The default directory is bootflash:.

Note	The file system, module, and directory names are case sensitive.

To change to a new directory, run the following command:

cd {directory | filesystem: [// module/ ][directory]}

Example:

switch# cd slot0:

You can create directories in the bootflash: and flash device file systems.

Note	The file system, module, and directory names are case sensitive. The filesystem argument is case sensitive. The directory argument is alphanumeric, case sensitive, and can have a maximum of 64 characters.

To create a new directory, run the following command:

mkdir [filesystem: [// module/ ]]directory

Example:

switch# mkdir test

To display the contents of a directory, run the following command:

dir [directory | filesystem: [// module/ ][directory]]

Example:

switch# dir bootflash:

You can remove directories from the file systems on a Cisco MDS device.

Note	Ensure that the directory is empty before you delete it. If the directory is not empty, you must delete all the files before you delete the directory. The file system and directory names are case sensitive.

To delete a directory, run the following command:

rmdir [filesystem : [// module/ ]]directory

Example:

switch# rmdir test

Files can be moved from one directory to another directory.

You can use the move command to rename a file by moving the file within the same directory or to another directory.

Note	The file system, module, and directory names are case sensitive.

To move a file from one directory to another directory, run the following command:

move [filesystem: [// module/ ][directory / ] | directory/ ]source-filename {{filesystem: [// module/ ][directory / ] | directory/ }[target-filename] | target-filename}

Example:

switch# move test old_tests/test1

Note	The target-filename argument is alphanumeric, case sensitive, and can have a maximum of 64 characters. If the target-filename argument is not specified, the filename defaults to the source-filename argument value.

Caution

When you try to move a file from one directory to another, if a file with the same name already exists in the destination directory, that file is overwritten by the moved file.

You can make copies of files, either within the same directory or in another directory.

Note	Use the dir command to ensure that enough space is available in the target file system. If enough space is not available, use the delete command to remove the files that are no longer required. The file system, module, and directory names are case sensitive.

To copy a file, run the following command:

copy [filesystem: [// module/ ][directory/ ] | directory/ ]source-filename | {filesystem: [// module/ ][directory/ ]] | directory/ }[target-filename]

Example:

switch# copy test old_tests/test1

Note	The source-filename argument is alphanumeric, case sensitive, and can have a maximum of 64 characters. If the target-filename argument is not specified, the filename defaults to the source-filename argument value. The copy command supports FTP, SCP, SFTP, TFTP, and HTTP protocols.

Caution

If you specify a directory, the delete command deletes the entire directory and all of its contents.

Note	The file system name, directory name, and source-filename argument are case sensitive.

To delete a file, run the following command:

delete {filesystem: [// module/ ][directory/ ] | directory/ }filename

Example:

switch# delete test old_tests/test1

To display a file's contents, run the following command:

show file [filesystem: [// module/ ]][directory/ ]filename

Example:

switch# show file bootflash:test-results

You can use checksums to verify a file's integrity.

To display the checksum or MD5 checksum of a file, run the following command:

show file [filesystem: [// module/ ]][directory/ ]filename {cksum | md5sum }

Example:

switch# show file bootflash:trunks2.cfg cksum

You can compress and uncompress the files on a Cisco MDS device using Lempel-Ziv 77 (LZ77) coding.

Note	The file system and directory names are case sensitive.

• To compress a file, run the following command:

  gzip [filesystem: [// module/ ][directory/ ] | directory/ ]filename

  Example:

  switch# gzip show_tech

  Note	After a file is compressed, it has a .gz suffix.

• To uncompress a file, run the following command:

  gunzip [filesystem: [// module/ ][directory/ ] | directory/ ]filename .gz

  Example:

  switch# gunzip show_tech.gz

  Note	The file that has be uncompressed must have the .gz suffix. After the file is uncompressed, it does not have the .gz suffix.

• To display the contents of the current directory, run the following command:

  dir [filesystem : [// module/ ][directory]]

  Example:

  switch# dir bootflash:

Note	The default number of lines is 10. The range is from 0 to 80 lines.

To display the last lines in a file, run the following command:

tail [filesystem: [// module/ ]][directory/ ]filename [lines]

Example:

switch# tail ospf-gr.conf

You can redirect the show command output to a file on bootflash:, slot0:, volatile:, or on a remote server.

To redirect the output from a show command to a file, run the following command:

show command > [filesystem: [// module/ ][directory] | [directory / ]]filename

Example:

switch# show tech-support > bootflash:techinfo

You can find files that have names begining with a specific character string in the current working directory and its subdirectories.

To find all the files beginning with the filename prefix in the default directory and in its subdirectories, run the following command:

find filename-prefix

Example:

switch# find bgp_script

Note	The filename prefix is case sensitive.

You can create an archive file and add files to it. You can specify the following compression types:

• bzip2

• gzip

• Uncompressed

The default compression type is gzip.

Note	The filename is alphanumeric, not case sensitive, and can have a maximum of 240 characters.

To create an archive file and add files to it, run the following command:

tar create {bootflash: | volatile: }archive-filename [absolute ] [bz2-compress ] [gz-compress ] [remove ] [uncompressed ] [verbose ] filename-list

This example shows how to create a gzip compressed archive file:

switch# tar create bootflash:config-archive gz-compress bootflash:config-file

The absolute keyword specifies that the leading backslash characters (\) should not be removed from the names of the files added to the archive file. By default, the leading backslash characters are removed.

The bz2-compress , gz-compress , and uncompressed keywords determine the compression utility to use when files are added or later appended to the archive, and the decompression utility to use when extracting the files. If you do not specify an extension for the archive file, the default extensions are as follows:

• For bz2-compress , the extension is .tar.bz2.

• For gz-compress , the extension is .tar.gz.

• For uncompressed , the extension is .tar.

The remove keyword specifies that the Cisco MDS NX-OS software should delete the files from the file system after adding them to the archive. By default, the files are not deleted.

The verbose keyword specifies that the Cisco MDS NX-OS software should list the files as they are added to the archive. By default, the files are listed as they are added.

You can append files to an existing archive file on a Cisco MDS device.

Note	The archive filename is not case sensitive.

To add files to an existing archive file, run the following command:

tar append {bootflash: | volatile: }archive-filename [absolute ] [remove ] [verbose ] filename-list

Example:

switch# tar append bootflash:config-archive.tar.gz bootflash:new-config

The absolute keyword specifies that the leading backslash characters (\) should not be removed from the names of the files added to the archive file. By default, the leading backslash characters are removed.

The remove keyword specifies that the Cisco MDS NX-OS software should delete the files from the file system after adding them to the archive. By default, the files are not deleted.

The verbose keyword specifies that the Cisco MDS NX-OS software should list the files as they are added to the archive. By default, the files are listed as they are added.

You can extract files from an existing archive file on a Cisco MDS device.

Note	The archive filename is not case sensitive.

To extract files from an existing archive file, run the following command:

tar extract {bootflash: | volatile: }archive-filename [keep-old ] [screen ] [to {bootflash: | volatile: }[/ directory-name]] [verbose ]

Example:

switch# tar extract bootflash:config-archive.tar.gz

The keep-old keyword indicates that the Cisco MDS NX-OS software should not overwrite files with the same name as the files being extracted.

The screen keyword specifies that the Cisco MDS NX-OS software should display the contents of the extracted files to the terminal screen.

The to keyword specifies the target file system. You can include a directory name. The directory name is alphanumeric, case sensitive, and can have a maximum of 240 characters.

The verbose keyword specifies that the Cisco MDS NX-OS software should display the names of the files as they are extracted.

Note	The archive filename is not case sensitive.

To display the file names in an archive file, run the following command:

tar list {bootflash: | volatile: }archive-filename

Example:

switch# tar list bootflash:config-archive.tar.gz
config-file
new-config

This example shows how to perform an In-Service Software Upgrade (ISSU) or In-Service Software Downgrade (ISSD) using a system image or kickstart image from a USB drive:

switch# install all system usb1:m9300-s1ek9-mzg.6.2.13.FM.0.65.bin.S0 kickstart usb1:m9300-s1ek9-kickstart-mzg.6.2.13.FM.0.65.bin.S0