The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.
This chapter describes how to use the files systems on the Cisco NX-OS device.
This chapter includes the following sections:
•Information About the Device File Systems, Directories, and Files
•Licensing Requirements for Configuration Files
•Using the Tab Key for Completing Filenames
•Formatting External Flash Devices
•Examples of Using the File System
This section includes the following topics:
The syntax for specifying a local file system is filesystem:[//module/]. Table 6-1 describes file systems that you can reference on your device.
You can create directories on bootflash: and external Flash memory (slot0:, usb1:, and usb2:). You can navigate through these directories and use them for files.
You create and access files on bootflash:. volatile:, slot0:, usb1:, and usb2: file systems. You can only access files on the system: file systems. You can use the debug: file system for debug log files specified in the debug logfile command. You can also download files, such as system image files, from remote servers using FTP, Secure Copy (SCP), Secure Shell FTP (SFTP), and TFTP.
The following table shows the licensing requirements for this feature:
You can use the Tab key to complete partial filenames. When you type a partial filename and then press the Tab key, the NX-OS software completes the filename if the characters you typed are unique to a single file. If the partial name is not unique, the NX-OS software lists a selection of filenames that match the characters you typed, as shown in this example:
switch# show file bootflash:e<Tab>
bootflash:eem_logs bootflash:epld.tar.gz
bootflash:epld.scr bootflash:eth_span.log
switch# show file bootflash:e
You can then type enough characters to make the filename unique and NX-OS completes the filename for you.
You can format an external Flash device to erase the contents from the default VDC and restore it to its factory-shipped state.
Note For information on recovering corrupted bootflash using formatting, see the Cisco Nexus 7000 Series NX-OS Troubleshooting Guide, Release 4.0.
Ensure you are in the default VDC.
Insert the external Flash device in the active supervisor module.
1. dir {slot0: | usb1: | usb2:}
1. format {slot0: | usb1: | usb2:}
This section includes the following topics:
•Identifying the Current Directory
•Changing the Current Directory
•Displaying Directory Contents
•Accessing Directories on the Standby Supervisor Module
You can display the directory name of your current directory.
1. pwd
|
|
|
---|---|---|
Step 1 |
pwd Example:
switch# pwd |
Displays the name of your current default directory. |
You can change the current directory for file system operations. The initial default directory is bootflash:.
1. pwd
2. cd {directory | filesystem:[//module/][directory]}
You can create directories in the bootflash: and Flash device file systems.
1. pwd
2. cd {directory | filesystem:[//module/][directory]}
3. mkdir [filesystem:[//module/]]directory
You can display the contents of a directory.
1. dir [filesystem:[//module/][directory]]
You can remove directories from the file systems on your device.
Ensure that the directory is empty before you try to delete it (see the "Deleting Files" section).
1. pwd
2. dir [filesystem:[//module/][directory]]
3. rmdir [filesystem:[//module/]]directory
|
|
|
---|---|---|
Step 1 |
pwd Example: switch# pwd |
(Optional) Displays the name of your current default directory. |
Step 2 |
dir [filesystem:[//module/][directory]] Example: switch# dir bootflash:test |
(Optional) Displays the contents of the current directory. The file system, module, and directory names are case sensitive. If the directory is not empty, you must delete all the files before you can delete the directory (see the "Deleting Files" section). |
Step 3 |
rmdir [filesystem:[//module/]]directory Example: switch# mkdir test |
Deletes a directory. The file system and directory name are case sensitive. |
You can access all file systems on the standby supervisor module (remote) from a session on the active supervisor module. This feature is useful when copying files to the active supervisor modules requires similar files to exist on the standby supervisor module. To access the file systems on the standby supervisor module from a session on the active supervisor module, you specify the standby supervisor module in the path to the file using either filesystem://sup-remote/ or filesystem://sup-standby/.
This section includes the following topics:
•Compressing and Uncompressing Files
•Displaying the Last Lines in a File
•Redirecting show Command Output to a File
You can move a files from one directory to another directory.
Tip You can use the move command to rename a file by moving the file within the same directory.
1. pwd
2. dir [filesystem:[//module/][directory]]
3. move [filesystem:[//module/][directory/] | directory/]source-filename {{filesystem:[//module/][directory/] | directory/}[target-filename] | target-filename}
You can make copies of files, either within the same directory or on 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 unneeded files.
1. pwd
2. dir [filesystem:[//module/][directory]]
3. copy [filesystem:[//module/][directory/] | directory/]source-filename {{filesystem:[//module/][directory/]] | directory/}[target-filename]
You can delete a file or a directory and all its contents.
1. dir [filesystem:[//module/][directory]]
2. delete {filesystem:[//module/][directory/] | directory/}filename
You can display the contents of a file.
1. show file [filesystem:[//module/]][directory/]filename
|
|
|
---|---|---|
Step 1 |
show file [filesystem:[//module/]][directory/]filename Example: switch# show file bootflash:test-results |
Displays the file contents. |
You can display checksums to check the file integrity.
1. show file [filesystem:[//module/]][directory/]filename {cksum | md5sum}
You can compress and uncompress files on your NX-OS device using Lempel-Ziv 1977 (LZ77) coding.
1. dir [filesystem:[//module/][directory]]
2. gzip [filesystem:[//module/][directory/] | directory/]filename
gunzip [filesystem:[//module/][directory/] | directory/]filename.gz
You can display the last lines of a file.
1. tail [filesystem:[//module/]][directory/]filename [lines]
You can redirect show command output to a file on bootflash:, slot0:, volatile:, or on a remote server.
For information about saving configuration files, see Chapter 7, "Working with Configuration Files".
1. show-command > [filesystem:[//module/][directory/] | directory/]filename
You can find the files in the current working directory and its subdirectories that have names that begin with a specific character string.
1. pwd
2. cd {filesystem:[//module/][directory/] | directory}
3. find filename-prefix
This section includes the following topics:
•Accessing Directories on Standby Supervisor Modules
•Compressing and Uncompressing Files
This example shows how to list the files on the standby supervisor module:
switch# dir bootflash://sup-remote
12198912 Aug 27 16:29:18 2003 m9500-sf1ek9-kickstart-mzg.1.3.0.39a.bin
1864931 Apr 29 12:41:59 2003 dplug2
12288 Apr 18 20:23:11 2003 lost+found/
12097024 Nov 21 16:34:18 2003 m9500-sf1ek9-kickstart-mz.1.3.1.1.bin
41574014 Nov 21 16:34:47 2003 m9500-sf1ek9-mz.1.3.1.1.bin
Usage for bootflash://sup-remote
67747169 bytes used
116812447 bytes free
184559616 bytes total
This example shows how to delete a file on the standby supervisor module:
switch# delete bootflash://sup-remote/aOldConfig.txt
This example shows how to move a file on an external Flash device:
switch# move slot0:samplefile slot0:mystorage/samplefile
This example shows how to move a file in the default file system:
switch# move samplefile mystorage/samplefile
This example shows how to copy the file called samplefile from the root directory of the slot0: file system to the mystorage directory:
switch# copy slot0:samplefile slot0:mystorage/samplefile
This example shows how to copy a file from the current directory level:
switch# copy samplefile mystorage/samplefile
This example shows how to copy a file from the active supervisor module bootflash to the standby supervisor module bootflash:
switch# copy bootflash:system_image bootflash://sup-2/system_image
This example shows how to overwrite the contents of an existing configuration in NVRAM:
switch# copy nvram:snapshot-config nvram:startup-config
Warning: this command is going to overwrite your current startup-config:
Do you wish to continue? {y/n} [y] y
You can also use the copy command to upload and download files from the slot0: or bootflash: file system to or from a FTP, TFTP, SFTP, or SCP server:
This example shows how to delete a file from the current working directory:
switch# delete dns_config.cfg
This example shows how to delete a file from an external CompactFlash (slot0):
switch# delete slot0:dns_config.cfg
This example shows how to delete an entire directory and all its contents:
switch# delete bootflash:my-dir
This is a directory. Do you want to continue (y/n)? [y] y
This example displays the contents of a file on an external Flash device:
switch# show file slot0:test
config t
Int fc1/1
no shut
end
show int fc1/1
This example displays the contents of a file residing in the current directory:
switch# show file myfile
This example shows how to display the checksum of a file:
switch# show file bootflash:trunks2.cfg cksum
583547619
This example shows how to display the MD5 checksum of a file:
switch# show file bootflash:trunks2.cfg md5sum
3b94707198aabefcf46459de10c9281c
This example shows how to compress a file:
switch# dir
1525859 Jul 04 00:51:03 2003 Samplefile
...
switch# gzip volatile:Samplefile
switch# dir
266069 Jul 04 00:51:03 2003 Samplefile.gz
...
This example shows how to uncompress a compressed file:
switch# dir
266069 Jul 04 00:51:03 2003 Samplefile.gz
...
switch# gunzip samplefile
switch# dir
1525859 Jul 04 00:51:03 2003 Samplefile
...
This example shows how to direct the output to a file on the bootflash: file system:
switch# show interface > bootflash:switch1-intf.cfg
This example shows how to direct the output to a file on external Flash memory:
switch# show interface > slot0:switch-intf.cfg
This example shows how to direct the output to a file on a TFTP server:
switch# show interface > tftp://10.10.1.1/home/configs/switch-intf.cfg
Preparing to copy...done
This example directs the output of the show tech-support command to a file:
switch# show tech-support > Samplefile
Building Configuration ...
switch# dir
1525859 Jul 04 00:51:03 2003 Samplefile
Usage for volatile://
1527808 bytes used
19443712 bytes free
20971520 bytes total
This example shows how to find a file in the current default directory:
switch# find smm_shm.cfg
/usr/bin/find: ./lost+found: Permission denied
./smm_shm.cfg
./newer-fs/isan/etc/routing-sw/smm_shm.cfg
./newer-fs/isan/etc/smm_shm.cfg
Table 6-2 lists the default settings for the file system parameters.
|
|
---|---|
Default filesystem |
bootflash: |
For additional information related to the file systems, see the following sections:
|
|
---|---|
Licensing |
Cisco Nexus 7000 Series NX-OS Licensing Guide, Release 4.0 |
Command reference |
Cisco Nexus 7000 Series NX-OS Fundamentals Command Reference, Release 4.0 |