- Table of Contents
-
- 01-Fundamentals Command Reference
- 00-Preface
- 01-CLI commands
- 02-RBAC commands
- 03-Login management commands
- 04-FTP and TFTP commands
- 05-File system management commands
- 06-Configuration file management commands
- 07-Software upgrade commands
- 08-ISSU commands
- 09-Emergency shell commands
- 10-Device management commands
- 11-Tcl commands
- 12-License management commands
- 13-Password recovery control command
- 14-Python commands
- Related Documents
-
Title | Size | Download |
---|---|---|
05-File system management commands | 173.01 KB |
IMPORTANT: · Before managing storage media, files, and directories, make sure you know the possible impacts. · A file or directory whose name starts with a period (.) is considered a hidden file or directory. Do not give a common file or directory a name that starts with a period. · Some system files and directories are hidden. |
A file name must be specified in one of the file name formats allowed. For more information, see Fundamentals Configuration Guide.
Before you use the copy, delete, fixdisk, format, gunzip, gzip, mkdir, move, rename, rmdir, or undelete command on a USB disk, make sure the disk is not write protected.
The device supports the FIPS mode that complies with NIST FIPS 140-2 requirements. Support for features, commands, and parameters might differ in FIPS mode and non-FIPS mode. For more information about FIPS mode, see Security Configuration Guide.
cd
Use cd to change the current working directory.
Syntax
cd { directory | .. }
Views
User view
Predefined user roles
network-admin
mdc-admin
Parameters
directory: Specifies the name of the destination directory, in the [drive:/]path format. For more information about how to enter the drive and path arguments, see Fundamentals Configuration Guide. If no drive information is provided, the argument represents a folder or subfolder in the current directory.
..: Returns to an upper directory. If the current working directory is the root directory, an error message appears. No online help information is available for this keyword.
Examples
# Access the test folder after logging in to the device.
<Sysname> cd test
# Return to the upper directory.
<Sysname> cd ..
# (In standalone mode.) Change to the test folder in the root directory of the active MPU:
1. Display the number of the slot where the standby MPU resides.
<Sysname> display device
Slot No. Brd Type Brd Status Software Version
0 LST2MRPNC1 Master S12500-CMW710-A732003
1 LST2MRPNC1 Standby S12500-CMW710-A732003
2 LST1GT48LEC1 Normal S12500-CMW710-A732003
3 NONE Fault NONE
4 NONE Absent NONE
5 NONE Absent NONE
6 LST2SF08C1 Normal S12500-CMW710-A732003
7 NONE Absent NONE
8 LST2SF08C1 Normal S12500-CMW710-A732003
9 NONE Absent NONE
The output shows that the slot number of the standby MPU is 1.
2. Access the root directory of the Flash on the standby MPU.
<Sysname> cd slot1#flash:/
3. Change to the test folder in the root directory of the active MPU.
<Sysname> cd flash:/test
# (In IRF mode.) Change to the Flash root directory of the global standby MPU that resides in slot 1 of member device 2. Then, change to the test folder in the Flash root directory of the global active MPU:
1. Display the member IDs and slot numbers of all MPUs.
<Sysname> display irf
Member Slot Role Priority CPU-Mac Description
2 0 Standby 20 00e0-fc0f-8c0f ---
2 1 Standby 20 00e0-fc0f-8c1f ---
*+3 5 Master 20 00e0-fc0f-8c22 ---
3 6 Standby 20 00e0-fc0f-8c32 ---
--------------------------------------------------
* indicates the device is the master.
+ indicates the device through which the user logs in.
The Bridge MAC of the IRF is: 00e0-fc00-0a00
Auto upgrade : yes
Mac persistent : 6 min
Domain ID : 0
Auto merge : no
The output shows that the IRF fabric has two members and four MPUs.
¡ The global active MPU resides in slot 5 of member device 3.
¡ The three global standby MPUs reside in slot 0 and slot 1 of member device 2, and slot 6 of member device 3.
2. Access the test folder in the Flash root directory of the global active MPU.
<Sysname> cd flash:/test
3. Change to the Flash root directory of the global standby MPU that resides in slot 1 of member device 2.
<Sysname> cd chassis2#slot1#flash:/
4. Change to the test folder in the Flash root directory of the global active MPU.
<Sysname> cd flash:/
copy
Use copy to copy a file.
Syntax
In non-FIPS mode:
copy fileurl-source fileurl-dest [ vpn-instance vpn-instance-name ] [ source interface interface-type interface-number ]
In FIPS mode:
copy fileurl-source fileurl-dest
Views
User view
Predefined user roles
network-admin
mdc-admin
Parameters
fileurl-source: Specifies the name or URL of the file to be copied in non-FIPS mode, and specifies the name of the file to be copied in FIPS mode. If the file resides on an FTP or TFTP server rather than on the device, specify the URL of the file. Whether a URL is case sensitive depends on the server.
fileurl-dest: Specifies the name or URL of the destination file or directory in non-FIPS mode, and specifies the name of the destination file or directory in FIPS mode. To copy the source file to an FTP or TFTP server, specify a URL. If you specify a directory, the device copies the specified file to the directory and saves it with its original file name. Whether a URL is case sensitive depends on the server.
vpn-instance vpn-instance-name: Specifies the VPN instance to which the destination FTP or TFTP server belongs. The vpn-instance-name argument is a case-sensitive string of 1 to 31 characters. If the server belongs to the public network, do not specify this option.
source interface interface-type interface-number: Specifies the source interface used to connect to the server. After you specify the source interface, the device uses the primary IP address of the source interface as the source IP address for outgoing packets. If you do not specify this option, the device uses the outgoing interface as the source interface.
Usage guidelines
In non-FIPS mode, you can use the copy command to perform the following tasks:
· Copy a local file and save it locally.
· Copy a local file and save it to an FTP or TFTP server.
· Copy a file on an FTP or TFTP server and save it locally.
To specify a file or directory, use the following guidelines:
Location |
Name format |
Remarks |
On the device |
Use the file name guidelines in Fundamentals Configuration Guide. |
N/A |
On an FTP server |
Enter the URL in the format of ftp://FTP username[:password]@server address[:port number]/file path[/file name]. |
The username and password must be the same as those configured on the FTP server. If the server authenticates users only by the username, you are not required to enter the password. For example, to use the username 1 and password 1 and specify the startup.cfg file in the authorized working directory on FTP server 1.1.1.1, enter ftp://1:[email protected]/startup.cfg. To specify an IPv6 address, enclose the IPv6 address in square brackets ([ ]), for example, ftp://test:test@[2001::1]:21/test.cfg. |
On a TFTP server |
Enter the URL in the format of tftp://server address[:port number]/file path[/file name]. |
For example, to specify the startup.cfg file in the working directory on TFTP server 1.1.1.1, enter the URL tftp://1.1.1.1/startup.cfg. To enter an IPv6 address, enclose the IPv6 address in square brackets ([ ]), for example, ftp://test:test@[2001::1]:21/test.cfg. |
In FIPS mode, you can only use the copy command to copy a local file and save it locally.
Examples
# Copy the test.cfg file in the current folder and save it to the current folder as testbackup.cfg.
<Sysname> copy test.cfg testbackup.cfg
Copy flash:/test.cfg to flash:/testbackup.cfg?[Y/N]:y
Copying file flash:/test.cfg to flash:/testbackup.cfg...Done.
# Copy the 1.cfg file from the Flash's test folder to the CF card. Save the copy to the testbackup folder on the first partition with the file name 1backup.cfg.
<Sysname> copy flash:/test/1.cfg cfa0:/testbackup/1backup.cfg
Copy flash:/test/1.cfg to cfa0:/testbackup/1backup.cfg?[Y/N]:y
Copying file flash:/test/1.cfg to cfa0:/testbackup/1backup.cfg...Done.
# Copy test.cfg from the working directory on FTP server 1.1.1.1. Save the copy to the local current folder as testbackup.cfg. In this example, the FTP username and password are user and private.
<Sysname> copy ftp://user:[email protected]/test.cfg testbackup.cfg
Copy ftp://user:[email protected]/test.cfg to flash:/testbackup.cfg?[Y/N]:y
Copying file ftp://user:[email protected]/test.cfg to flash:/testbackup.cfg... Done.
# Copy test.cfg from the current folder. Save the copy to the working directory on FTP server 1.1.1.1 as testbackup.cfg. In this example, the FTP username and password are user and private.
<Sysname> copy test.cfg ftp://user:[email protected]/testbackup.cfg
Copy flash:/test.cfg to ftp://user:[email protected]/testbackup.cfg?[Y/N]:y
Copying file flash:/test.cfg to ftp://user:[email protected]/testbackup.cfg... Done.
# Copy test.cfg from the working directory on TFTP server 1.1.1.1. Save the copy to the local current folder as testbackup.cfg.
<Sysname> copy tftp://1.1.1.1/test.cfg testbackup.cfg
Copy tftp://1.1.1.1/test.cfg to flash:/testbackup.cfg?[Y/N]:y
Copying file tftp://1.1.1.1/test.cfg to flash:/testbackup.cfg... Done.
# Copy test.cfg from the current folder. Save the copy to the working directory on TFTP server 1.1.1.1 as testbackup.cfg.
<Sysname> copy test.cfg tftp://1.1.1.1/testbackup.cfg
Copy flash:/test.cfg to tftp://1.1.1.1/testbackup.cfg?[Y/N]:y
Copying file flash:/test.cfg to tftp://1.1.1.1/testbackup.cfg... Done.
# Copy test.cfg from the working directory on FTP server 1.1.1.1. Save the copy to the local current folder as testbackup.cfg. In this example, the FTP username and password are user and private, and the FTP server belongs to VPN instance vpn1.
<Sysname> copy ftp://user:[email protected]/test.cfg testbackup.cfg vpn-instance vpn1
Copy ftp://user:[email protected]/test.cfg to flash:/testbackup.cfg?[Y/N]:y
Copying file ftp://user:[email protected]/test.cfg to flash:/testbackup.cfg... Done.
# Copy test.cfg from the working directory on TFTP server 1.1.1.1. Save the copy to the local current folder as testbackup.cfg. In this example, the TFTP server belongs to VPN instance vpn1.
<Sysname> copy tftp://1.1.1.1/test.cfg testbackup.cfg vpn-instance vpn1
Copy tftp://1.1.1.1/test.cfg to flash:/testbackup.cfg?[Y/N]:y
Copying file tftp://1.1.1.1/test.cfg to flash:/testbackup.cfg... Done.
# Copy test.cfg from the working directory on FTP server 2001::1. Save the copy to the local current folder as testbackup.cfg. In this example, the FTP username and password are user and private, respectively.
<Sysname> copy ftp://user:private@[2001::1]/test.cfg testbackup.cfg
Copy ftp://user:private@[2001::1]/test.cfg to flash:/testbackup.cfg?[Y/N]:y
Copying file ftp://user:private@[2001::1]/test.cfg to flash:/testbackup.cfg... Done.
# Copy test.cfg from the working directory on TFTP server 2001::1. Save the copy to the local current folder as testbackup.cfg.
<Sysname> copy tftp://[2001::1]/test.cfg testbackup.cfg
Copy tftp://[2001::1]/test.cfg to flash:/testbackup.cfg?[Y/N]:y
Copying file tftp://[2001::1]/test.cfg to flash:/testbackup.cfg... Done.
# (In standalone mode.) Copy the active MPU's configuration file test.cfg to the standby MPU's Flash root directory.
<Sysname> copy test.cfg slot1#flash:/
Copy flash:/test.cfg to slot1#flash:/test.cfg?[Y/N]:y
Copying file flash:/test.cfg to slot1#flash:/test.cfg...Done.
# (In IRF mode.) Copy a configuration file of the global active MPU. Save the copy to the Flash root directory of the global standby MPU that resides in slot 1 of member device 1.
<Sysname> copy test.cfg chassis1#slot1#flash:/
Copy flash:/test.cfg to chassis1#slot1#flash:/test.cfg?[Y/N]:y
Copying file flash:/test.cfg to chassis1#slot1#flash:/test.cfg...Done.
# (In IRF mode.) Copy a configuration file of the global standby MPU that resides in slot 1 of member device 1. Save the copy to the Flash root directory of the global standby MPU that resides in slot 1 of member device 2.
<Sysname> copy chassis1#slot1#flash:/test.cfg chassis2#slot1#flash:/
Copy chassis1#slot1#flash:/test.cfg to chassis2#slot1#flash:/test.cfg?[Y/N]:y
Copying file chassis1#slot1#flash:/test.cfg to chassis2#slot1#flash:/test.cfg...Done.
delete
Use delete to delete a file.
Syntax
delete [ /unreserved ] file-url
Views
User view
Predefined user roles
network-admin
mdc-admin
Parameters
/unreserved: Permanently deletes the specified file. If you do not specify this keyword, the command moves the file to the recycle bin.
file-url: Specifies the name of the file to be deleted. Asterisks (*) are acceptable as wildcards. For example, to remove files with the .txt extension in the current directory, enter delete *.txt.
Usage guidelines
Use the delete /unreserved file-url command with caution. You cannot restore a file that was deleted with this command.
The delete file-url command (without /unreserved) moves the specified file to the recycle bin, except in the following two situations, where the file is permanently deleted:
· The device is running out of storage space.
· You are logged in to the default MDC and are using this command to delete a file from a non-default MDC.
A file moved to the recycle bin can be restored by using the undelete command.
Do not use the delete command to delete files from the recycle bin. To delete files from the recycle bin, use the reset recycle-bin command.
If you delete two files that have the same name but reside in different directories, both files are retained in the recycle bin. If you successively delete two files that have the same name from the same directory, only the file deleted last is retained in the recycle bin.
Examples
# (In standalone mode.) Remove file 1.cfg from the root directory of the active MPU's storage medium.
<Sysname> delete 1.cfg
Delete flash:/1.cfg? [Y/N]:y
Deleting file flash:/1.cfg...Done.
# (In standalone mode.) Permanently delete file 2.cfg from the root directory of the active MPU's storage medium.
<Sysname> delete /unreserved 2.cfg
The file cannot be restored. Delete flash:/2.cfg?[Y/N]:y
Deleting the file permanently will take a long time. Please wait...
Deleting file flash:/2.cfg...Done.
# (In standalone mode.) Remove file 1.cfg from the root directory of the storage medium on the standby MPU (in slot 1).
· Method 1:
<Sysname> delete slot1#flash:/1.cfg
Delete slot1#flash:/1.cfg?[Y/N]:y
Deleting file slot1#flash:/1.cfg...Done.
· Method 2:
<Sysname> cd slot1#flash:/
<Sysname> delete 1.cfg
Delete slot1#flash:/1.cfg?[Y/N]:y
Deleting file slot1#flash:/1.cfg...Done.
# (In IRF mode.) Remove file 1.cfg from the root directory of the storage medium on the global active MPU.
<Sysname> delete 1.cfg
Delete flash:/1.cfg?[Y/N]:y
Deleting file flash:/1.cfg...Done.
# (In IRF mode.) Permanently delete file 2.cfg from the root directory of the storage medium on the global active MPU.
<Sysname> delete /unreserved 2.cfg
The file cannot be restored. Delete flash:/2.cfg?[Y/N]:y
Deleting the file permanently will take a long time. Please wait...
Deleting file flash:/2.cfg...Done.
# (In IRF mode.) Remove file 1.cfg from the Flash root directory of the global standby MPU that resides in slot 1 of member device 1.
· Method 1:
<Sysname> delete chassis1#slot1#flash:/1.cfg
Delete chassis1#slot1#flash:/1.cfg?[Y/N]:y
Deleting file chassis1#slot1#flash:/1.cfg...Done.
· Method 2:
<Sysname> cd chassis1#slot1#flash:/
<Sysname> delete 1.cfg
Delete chassis1#slot1#flash:/1.cfg?[Y/N]:y
Deleting file chassis1#slot1#flash:/1.cfg...Done.
Related commands
· undelete
· reset recycle-bin
dir
Use dir to display files or folders.
Syntax
dir [ /all ] [ file-url | /all-filesystems ]
Views
User view
Predefined user roles
network-admin
mdc-admin
Parameters
/all: Displays all files and folders in the current directory, visible or hidden. If you do not specify this option, only visible files and folders are displayed.
file-url: Displays a specific file or folder. The file-url argument can use the asterisk (*) as a wildcard. For example, to display files with the .txt extension in the current directory, enter dir *.txt.
/all-filesystems: Displays files and folders in the root directory of all storage media on the device.
Usage guidelines
If no option is specified, the command displays all visible files and folders in the current directory.
The folder name of the recycle bin is .trash. To display files in the recycle bin, use either of the following methods:
· Execute the dir /all .trash command.
· Execute the cd .trash command and then the dir command.
Examples
# (In standalone mode.) Display information about all files and folders in the current directory.
<Sysname> dir /all
Directory of flash:/
...
# (In standalone mode.) Display files and folders in the root directory of all storage media on the device.
<Sysname> dir /all-filesystems
Directory of flash:/
...
Directory of cfa0:/
...
Directory of slot7#flash:/
...
Directory of slot7#cfa0:/
...
# (In standalone mode.) Display information about all files and folders in the storage medium of the standby MPU (in slot 1).
<Sysname> cd slot1#flash:/
<Sysname> dir /all
Directory of slot1#flash:/
...
# (In IRF mode.) Display information about all files and folders in the storage medium of the global active MPU.
<Sysname> dir /all
Directory of flash:/
...
# (In IRF mode.) Display files and folders in the root directory of every storage medium in the IRF fabric.
<Sysname> dir /all-filesystems
Directory of flash:/
...
Directory of chassis1#slot1#flash:/
...
# (In IRF mode.) Display information about all files and folders in the storage medium of the global standby MPU that resides in slot 1 of member device 1.
· Method 1:
<Sysname> dir /all chassis1#slot1#flash:/
Directory of chassis1#slot1#flash:/
...
· Method 2:
<Sysname> cd chassis1#slot1#flash:/
<Sysname> dir /all
Directory of chassis1#slot1#flash:/
...
Table 1 Command output
Field |
Description |
Directory of |
Current directory. |
0 -rwh 3144 Apr 26 2008 13:45:28 xx.xx |
File or folder information: · 0—File or folder number, which is automatically allocated by the system. · -rwh—Attributes of the file or folder. The first character is the folder indicator (d for folder and – for file). The second character indicates whether the file or folder is readable (r for readable). The third character indicates whether the file or directory is writable (w for writable). The fourth character indicates whether the file or directory is hidden (h for hidden, - for visible). Modifying, renaming, or deleting hidden files might affect functions. · 3144—File size in bytes. For a folder, a hyphen (-) is displayed. · Apr 26 2008 13:45:28—Last date and time when the file or folder was modified. · xx.xx—File or folder name. |
fdisk
Use fdisk to partition a storage medium.
Syntax
fdisk medium-name [ partition-number ]
Views
User view
Predefined user roles
network-admin
Parameters
medium-name: Specifies the name of the storage medium to be partitioned.
partition-number: Specifies the number of partitions, in the range of 1 to 4.
Usage guidelines
The Flash cannot be partitioned. A partition cannot be partitioned.
This command is supported only on the default MDC.
If the partition-number argument is specified, the storage medium is divided into the specified number of partitions. To partition a storage medium in an interactive way, do not specify the argument.
The specified partition size and the actual partition size might have an error less than 5% of the total memory.
Before partitioning a CF card or USB disk, perform the following tasks:
· Back up the files in the storage medium. The partition operation clears all data in the medium.
· If you are partitioning a USB disk, make sure the disk is not write protected. Otherwise, the partition operation will fail, and you must remount or reinstall the disk to restore access to the USB disk.
· Make sure no other users are accessing the medium. Otherwise, the partition operation fails.
Examples
# Divide the CF card on the device evenly into three partitions in simple mode.
<Sysname> fdisk cfa: 3
Capacity of cfa: : 256M bytes
Cfa: will be divided into the following partitions:
DeviceName Capacity
cfa0: 85MB
cfa1: 85MB
cfa2: 86MB
All data on cfa: will be lost, continue? [Y/N]:y
Partitioning cfa:...Done.
# Divide the CF card on the device into one partition in an interactive way.
<Sysname> fdisk cfa:
The capacity of cfa: : 256M bytes
Partition 1 (32MB~224MB, 256MB. Press CTRL+C to quit or Enter to use all available space):
// Press Enter or enter 256.
cfa: will be divided into the following partition(s):
DeviceName Capacity
cfa0: 256MB
All data on cfa: will be lost, continue? [Y/N]:y
Partitioning cfa:...Done.
# Divide the CF card on the device into three partitions and specify the size for each partition:
<Sysname> fdisk cfa:
The capacity of cfa: : 256M bytes
Partition 1 (32MB~224MB, 256MB, Press CTRL+C to quit or Enter to use all available space):128
// Enter 128 to set the size of the first partition to 128 MB.
Partition 2 (32MB~96MB, 128MB, Press CTRL+C to quit or Enter to use all available space):31
// Enter 31 to set the size of the second partition to 31 MB.
The partition size must be greater than or equal to 32MB.
Partition 2 (32MB~96MB, 128MB, Press CTRL+C to quit or Enter to use all available space):1000
// Enter 1000 to set the size of the second partition to 1000 MB.
The partition size must be less than or equal to 128MB.
Partition 2 (32MB~96MB, 128MB, Press CTRL+C to quit or Enter to use all available space):127
// Enter 127 to set the size of the second partition to 127 MB.
The remaining space is less than 32MB. Please enter the size of partition 2 again.
Partition 2 (32MB~96MB, 128MB, Press CTRL+C to quit or Enter to use all available space):56
// Enter 56 to set the size of the second partition to 56 MB.
Partition 3 (32MB~40MB, 72MB, Press CTRL+C to quit or Enter to use all available space):
// Press Enter to assign the remaining space to the third partition.
cfa: will be divided into the following partition(s):
DeviceName Capacity
cfa0: 128MB
cfa1: 56MB
cfa2: 72MB
All data on cfa: will be lost, continue? [Y/N]:y
Partitioning cfa:...Done.
file prompt
Use file prompt to set the operation mode for files and folders.
Syntax
file prompt { alert | quiet }
undo file prompt
Default
The operation mode is alert. The system prompts for confirmation when you perform a destructive file or folder operation.
Views
System view
Predefined user roles
network-admin
mdc-admin
Parameters
alert: Prompts for confirmation when a destructive file or folder operation is being performed.
quiet: Gives no confirmation prompt for file or folder operations.
Usage guidelines
In quiet mode, the system does not prompt for confirmation when a user performs a file or folder operation. The alert mode provides an opportunity to cancel a disruptive operation.
Examples
# Set the file and folder operation mode to alert.
<Sysname> system-view
[Sysname] file prompt alert
fixdisk
Use fixdisk to check a storage medium for damage and repair any damage.
Syntax
fixdisk medium-name
Views
User view
Predefined user roles
network-admin
Parameters
medium-name: Specifies the name of a storage medium name.
Usage guidelines
This command is supported only on the default MDC.
Use this command to fix a storage medium when space on the medium cannot be used or released.
Before you repair a storage medium, make sure no other users are accessing the medium. Otherwise, the repair operation fails.
Examples
# Restore the space of the Flash.
<Sysname> fixdisk flash:
Restoring flash: may take some time...
Restoring flash:...Done.
format
Use format to format a storage medium.
Syntax
format medium-name
Views
User view
Predefined user roles
network-admin
Parameters
medium-name: Specifies the name of a storage medium.
Usage guidelines
This command is supported only on the default MDC.
Formatting a storage medium permanently deletes all files on the storage medium. If a startup configuration file exists on the storage medium, back it up if necessary.
To format a storage medium that has been partitioned, you must format all the partitions individually, instead of formatting the medium as a whole.
You can format a storage medium only when no one is accessing the medium.
Examples
# Format the Flash.
<Sysname> format flash:
All data on flash: will be lost, continue? [Y/N]:y
Formatting flash:... Done.
# Format the third partition on the CF card. (In this example the CF card has been partitioned.)
<Sysname> format cfa2:
All data on cfa2: will be lost, continue? [Y/N]:y
Formatting cfa2:... Done.
gunzip
Use gunzip to decompress a file.
Syntax
gunzip filename
Views
User view
Predefined user roles
network-admin
mdc-admin
Parameters
filename: Specifies the name of the file to be decompressed. This argument must have .gz as the extension.
Usage guidelines
This command deletes the specified file after decompressing it.
Examples
# Decompress the file system.bin.gz:
1. Before decompressing the file, you can display files whose names start with the system. string.
<Sysname> dir system.*
Directory of flash:
1 -rw- 20 Jun 14 2012 10:18:53 system.bin.gz
472972 KB total (472840 KB free)
2. Decompress the file system.bin.gz.
<Sysname> gunzip system.bin.gz
Decompressing file flash:/system.bin.gz... Done.
3. Verify the decompress operation.
<Sysname> dir system.*
Directory of flash:
1 -rw- 0 May 30 2012 11:42:25 system.bin
472972 KB total (472844 KB free)
gzip
Use gzip to compress a file.
Syntax
gzip filename
Views
User view
Predefined user roles
network-admin
mdc-admin
Parameters
filename: Specifies the name of the file to be compressed. The compressed file will be saved to file filename.gz.
Usage guidelines
This command deletes the specified file after compressing it.
Examples
# Compress the file system.bin:
1. Before compressing the file, you can display files whose names start with system.
<Sysname> dir system.*
Directory of flash:
1 -rw- 0 May 30 2012 11:42:24 system.bin
472972 KB total (472844 KB free)
2. Compress the file system.bin.
<Sysname> gzip system.bin
Compressing file flash:/system.bin... Done.
3. Verify the compress operation.
<Sysname> dir system.*
Directory of flash:
1 -rw- 20 Jun 14 2012 10:18:53 system.bin.gz
472972 KB total (472840 KB free)
mkdir
Use mkdir to create a folder in the current directory.
Syntax
mkdir directory
Views
User view
Predefined user roles
network-admin
mdc-admin
Parameters
directory: Specifies the name of a folder.
Usage guidelines
The name of the folder to be created must be unique in the specified directory.
To use this command to create a folder, the specified directory must exist. For example, to create the flash:/test/mytest folder, the test folder must exist. Otherwise, the mytest folder is not created.
Examples
# Create the test folder in the current directory.
<Sysname> mkdir test
Creating directory flash:/test... Done.
# Create the test/subtest folder in the current directory.
<Sysname> mkdir test/subtest
Creating directory flash:/test/subtest... Done.
# (In standalone mode.) Create the test folder on the standby MPU (in slot 1).
<Sysname> mkdir slot1#flash:/test
Creating directory slot1#flash:/test... Done.
# (In IRF mode.) Create the test folder on the active MPU of the IRF fabric.
<Sysname> mkdir test
Creating directory flash:/test... Done.
# (In IRF mode.) Create the test folder on the standby MPU that resides in slot 1 of member device 2.
<Sysname> mkdir chassis2#slot1#flash:/test
Creating directory chassis2#slot1#flash:/test... Done.
more
Use more to display the contents of a text file.
Syntax
more file-url
Views
User view
Predefined user roles
network-admin
mdc-admin
Parameters
file-url: Specifies a file name.
Examples
# Display the contents of the test.txt file.
<Sysname> more test.txt
Have a nice day.
# Display the contents of the testcfg.cfg file.
<Sysname> more testcfg.cfg
#
version 7.10, Release 7305
#
sysname Sysname
#
vlan 2
#
return
<Sysname>
# (In standalone mode.) Display the contents of the testcfg.cfg file on the standby MPU (in slot 1).
<Sysname> more slot1#flash:/testcfg.cfg
#
version 7.10, Release 7305
#
sysname Test
#
---- More ----
# (In IRF mode.) Display the contents of the testcfg.cfg file on the global active MPU.
<Sysname> more testcfg.cfg
#
version 7.10, Release 7305
#
sysname Sysname
#
---- More ----
# (In IRF mode.) Display the contents of the testcfg.cfg file on the global standby MPU that resides in slot 1 of member device 2.
<Sysname> more chassis2#slot1#flash:/testcfg.cfg
#
version 7.10, Release 7305
#
sysname Sysname
#
---- More ----
mount
Use mount to mount a hot swappable storage medium.
Syntax
mount medium-name
Default
A storage medium is automatically mounted and in mounted state after being connected to the device, and you can use it without mounting it.
Views
User view
Predefined user roles
network-admin
Parameters
medium-name: Specifies the name of a storage medium.
Usage guidelines
This command is supported only on the default MDC.
To avoid file system corruption, do not perform the following tasks while the system is mounting a storage medium:
· Install or remove storage media or cards.
· Perform an active/standby switchover. (In standalone mode.)
· Perform a switchover between the global active MPU and a global standby MPU.
· Create, delete, start, or stop an MDC.
To mount a partitioned storage medium, you must mount all the partitions individually, instead of mounting the CF card as a whole.
Examples
# (In standalone mode.) Mount a CF card on the active MPU.
<Sysname> mount cfa0:
# (In standalone mode.) Mount a CF card on the standby MPU (in slot 1).
<Sysname> mount slot1#cfa0:
# (In IRF mode.) Mount a CF card on the master.
<Sysname> mount cfa0:
# (In IRF mode.) Mount a CF card on the MPU that resides in slot 1 of member device 2.
<Sysname> mount chassis2#slot1#cfa0:
Related commands
umount
move
Use move to move a file.
Syntax
move fileurl-source fileurl-dest
Views
User view
Predefined user roles
network-admin
mdc-admin
Parameters
fileurl-source: Specifies the name of the source file.
fileurl-dest: Specifies the name of the destination file or folder.
Usage guidelines
If you specify a destination folder, the system moves the source file to the specified folder without changing the file name.
Examples
# Move the flash:/test/sample.txt file to flash:/, and save it as 1.txt.
<Sysname> move test/sample.txt 1.txt
Move flash:/test/sample.txt to flash:/1.txt?[Y/N]:y
Moving file flash:/test/sample.txt to flash:/1.txt ...Done.
# Move the b.cfg file to the folder test2.
<Sysname> move b.cfg test2
Move flash:/b.cfg to flash:/test2/b.cfg?[Y/N]:y
Moving file flash:/b.cfg to flash:/test2/b.cfg... Done.
pwd
Use pwd to display the current working directory.
Syntax
pwd
Views
User view
Predefined user roles
network-admin
mdc-admin
Examples
# Display the current working directory.
<Sysname> pwd
flash:
rename
Use rename to rename a file or folder.
Syntax
rename fileurl-source fileurl-dest
Views
User view
Predefined user roles
network-admin
mdc-admin
Parameters
fileurl-source: Specifies the name of the source file or folder.
fileurl-dest: Specifies the name of the destination file or folder.
Usage guidelines
This command is not executed if the destination file or folder name is already used by an existing file or folder in the current working directory.
Examples
# Rename the copy.cfg file as test.cfg.
<Sysname> rename copy.cfg test.cfg
Rename flash:/copy.cfg as flash:/test.cfg?[Y/N]:y
Renaming flash:/copy.cfg as flash:/test.cfg... Done.
reset recycle-bin
Use reset recycle-bin to delete files from the recycle bin.
Syntax
reset recycle-bin [ /force ]
Views
User view
Parameters
/force: Deletes all files in the recycle bin without prompting for confirmation. If you do not specify this option, the command prompts you to confirm the deletion.
Usage guidelines
The delete file-url command only moves a file to the recycle bin. To permanently delete the file, use the reset recycle-bin command to clear the recycle bin.
If a file is corrupted, you might not be able to delete the file by using the reset recycle-bin command. In this case, use the reset recycle-bin /force command.
Examples
# Empty the recycle bin. (In this example there are two files in the recycle bin.)
<Sysname> reset recycle-bin
Clear flash:/a.cfg?[Y/N]:y
Clearing file flash:/a.cfg... Done.
Clear flash:/b.cfg?[Y/N]:y
Clearing file flash:/b.cfg... Done.
# Delete the b.cfg file from the recycle bin. (In this example there are two files in the recycle bin.)
<Sysname> reset recycle-bin
Clear flash:/a.cfg?[Y/N]:n
Clear flash:/b.cfg?[Y/N]:y
Clearing file flash:/b.cfg... Done.
Related commands
delete
rmdir
Use rmdir to remove a folder.
Syntax
rmdir directory
Views
User view
Predefined user roles
network-admin
mdc-admin
Parameters
directory: Specifies a folder name.
Usage guidelines
To remove a directory, you must delete all files and subfolders in the directory permanently or move them to the recycle bin. If you move them to the recycle bin, executing the rmdir command permanently deletes them.
Examples
# Remove the subtest folder.
<Sysname>rmdir subtest/
Remove directory flash:/test/subtest and the files in the recycle-bin under this directory will be deleted permanently. Continue?[Y/N]:y
Removing directory flash:/test/subtest... Done.
sha256sum
Use sha256sum to use the SHA-256 algorithm to calculate the digest of a file.
Syntax
sha256sum file-url
Views
User view
Predefined user roles
network-admin
mdc-admin
Parameters
file-url: Specifies the name of a file.
Usage guidelines
File digests are used to verify file integrity.
Examples
# Use the SHA-256 algorithm to calculate the digest of file system.bin.
<Sysname> sha256sum system.bin
SHA256 digest:
0851e0139f2770e87d01ee8c2995ca9e59a8f5f4062e99af14b141b1a36ca152
umount
Use umount to unmount a hot swappable storage medium.
Syntax
umount medium-name
Default
A storage medium is automatically mounted and placed in mounted state.
Views
User view
Predefined user roles
network-admin
Parameters
medium-name: Specifies the name of a storage medium.
Usage guidelines
This command is supported only on the default MDC.
Before removing a mounted storage medium from the system, unmount the medium to avoid medium damage.
Before unmounting a storage medium, make sure no other users are accessing the medium. Otherwise, the unmount operation fails.
When a storage medium is connected to a lower version system, the system might not be able to automatically recognize the device. In this case, you must first execute the mount command for the storage medium to operate correctly.
To avoid file system corruption, do not perform the following tasks while the system is unmounting a storage medium:
· Install or remove storage media or cards.
· Perform an active/standby switchover. (In standalone mode.)
· Perform a switchover between the global active MPU and a global standby MPU.
· Create, delete, start, or stop an MDC.
Examples
# (In standalone mode.) Unmount a CF card from the active MPU.
<Sysname> umount cfa0:
# (In standalone mode.) Unmount a CF card from the standby MPU (in slot 5).
<Sysname> umount slot5#cfa0:
# (In IRF mode.) Unmount a CF card from the global active MPU.
<Sysname> umount cfa0:
# (In IRF mode.) Unmount a CF card from the global standby MPU that resides in slot 5 of member device 2.
<Sysname> umount chassis2#slot5#cfa0:
Related commands
mount
undelete
Use undelete to restore a file from the recycle bin.
Syntax
undelete file-url
Views
User view
Predefined user roles
network-admin
mdc-admin
Parameters
file-url: Specifies the name of the file to be restored.
Usage guidelines
If a file with the same name already exists in the directory, the system prompts whether or not you want to overwrite the existing file. If you enter Y, the existing file is overwritten. If you enter N, the command is not executed.
Examples
# Restore the copy.cfg file, which was moved from the flash: directory to the recycle bin.
<Sysname>undelete copy.cfg
Undelete flash:/copy.cfg?[Y/N]:y
Undeleting file flash:/copy.cfg... Done.
# Restore the startup.cfg file, which was moved from the flash:/seclog directory to the recycle bin.
· Method 1:
<Sysname>undelete seclog/startup.cfg
Undelete flash:/seclog/startup.cfg?[Y/N]:y
Undeleting file flash:/seclog/startup.cfg... Done.
<Sysname>
· Method 2:
<Sysname> cd seclog
<Sysname> undelete startup.cfg
Undelete flash:/seclog/startup.cfg?[Y/N]:y
Undeleting file flash:/seclog/startup.cfg... Done.