01-Fundamentals Command Reference

HomeSupportSwitchesH3C S7500E Switch SeriesReference GuidesCommand ReferencesH3C S7500E Switch Series Command References-Release7178-6W10001-Fundamentals Command Reference
05-File system management commands
Title Size Download
05-File system management commands 122.18 KB

File system management commands

IMPORTANT

IMPORTANT:

·     Before managing storage media, file systems, directories, and files, 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.

You cannot access a storage medium that is being partitioned, or a file system that is being formatted or repaired. To access a storage medium after it is partitioned or a file system after it is formatted or repaired, use one of the following methods:

·     Use the absolute path to specify a file or directory. For example, use the dir flash:/ command to display the files and directories in the flash: file system.

·     Use the cd command to change the working directory to the root directory of the file system before accessing a file or directory in the file system. For example, to display the files and directories in the root directory of the flash: file system, perform the following tasks:

a.     Use the cd flash:/ command to change the working directory to the root directory of the file system.

b.     Execute the dir command.

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 destination directory.

..: Specifies the parent directory. If the current working directory is the root directory, an error message appears when you execute the cd .. command. No online help information is available for this keyword.

Examples

# Access the test directory after logging in to the device.

<Sysname> cd test

# Return to the upper directory.

<Sysname> cd ..

# (In standalone mode.) Change to the test directory in the root directory of the active MPU:

1.     Display the number of the slot where the standby MPU resides.

Slot No. Brd Type         Brd Status   Subslot Sft Ver                Patch Ver

 0       LSQM3MPUB0       Master       0       S7500E-7178            None     

 1       NONE             Absent       0       NONE                   None     

 2       LSQ1GP48EB       Normal       0       S7500E-7178            None     

 3       NONE             Absent       0       NONE                   None     

 4       NONE             Absent       0       NONE                   None     

 5       NONE             Absent       0       NONE                   None     

 6       NONE             Absent       0       NONE                   None     

 7       NONE             Absent       0       NONE                   None

The output shows that the slot number of the standby MPU is 1.

2.     Access the root directory of the flash memory on the standby MPU.

<Sysname> cd slot1#flash:/

3.     Change to the test directory in the root directory of the active MPU.

<Sysname> cd flash:/test

# (In IRF mode.) Change to the root directory of the flash memory on the global standby MPU that resides in slot 1 of member device 2. Then, change to the test directory in the root directory of the flash memory on the global active MPU:

1.     Display the member IDs and slot numbers of all MPUs.

<Sysname> display irf

MemberID  Slot  Role    Priority  CPU-Mac         Description                  

 *+1      7     Master  1         00e0-fc0f-8c08  ---                          

--------------------------------------------------                             

 * indicates the device is the master.                                         

 + indicates the device through which the user logs in.                        

                                                                               

 The Bridge MAC of the IRF is: 0000-fc00-2500                                  

 Auto upgrade                : yes                                              

 Mac persistent              : always                                          

 Domain ID                   : 0                                               

 Auto merge                  : yes

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 directory in the root directory of the flash memory on the global active MPU.

<Sysname> cd flash:/test

3.     Change to the root directory of the flash memory on the global standby MPU that resides in slot 1 of member device 2.

<Sysname> cd chassis2#slot1#flash:/

4.     Change to the test directory in the root directory of the flash memory on the global active MPU.

<Sysname> cd flash:/

copy

Use copy to copy a file.

Syntax

In non-FIPS mode:

copy source-file { dest-file | dest-directory } [ vpn-instance vpn-instance-name ] [ source interface interface-type interface-number ]

In FIPS mode:

copy source-file { dest-file | dest-directory }

Views

User view

Predefined user roles

network-admin

mdc-admin

Parameters

source-file: 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, TFTP, or HTTP server rather than on the device, specify the URL of the file. Whether a URL is case sensitive depends on the server.

dest-file: Specifies the name or URL for the destination file in non-FIPS mode, and specifies the name for the destination file in FIPS mode. To copy the source file to an FTP, TFTP, or HTTP server, specify a URL. Whether a URL is case sensitive depends on the server.

dest-directory: Specifies the destination directory or URL in non-FIPS mode, and specifies the destination directory in FIPS mode. To copy the source file to an FTP, TFTP, or HTTP server, specify a URL. The device copies the source file to the destination location and saves the file with its original file name. Whether a URL is case sensitive depends on the server.

vpn-instance vpn-instance-name: Specifies the MPLS L3VPN instance to which the destination FTP, TFTP, or HTTP server belongs. The vpn-instance-name argument represents the VPN instance name, 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 FIPS mode, the copy command can only copy a local file and save it locally.

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 from an FTP, TFTP, or HTTP 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 the username and password 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 a and password 1 and specify the startup.cfg file in the authorized working directory on the FTP server 1.1.1.1, enter ftp://a:1@1.1.1.1/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, tftp://[2001::1]:21/test.cfg.

On an HTTP server

Enter the URL in the format of http://[HTTP username[:password]@ ]server address[:port number]/filepath[/file name].

The username and password in the URL must be the same as the username and password configured on the server.

If only the username is required for authentication, you do not need to enter the password. If authentication is not required, you do not need to enter the username or password.

For example, the startup.cfg file is saved in the authorized directory on the HTTP server at 1.1.1.1. The HTTP account username and password are a and 1, respectively. To copy the file, enter the URL http://a:1@1.1.1.1/startup.cfg. If authentication is not required, enter the URL http://1.1.1.1/startup.cfg.

To enter an IPv6 address, enclose the IPv6 address in square brackets ([ ]), for example, http://test:test@[2001::1]:21/test.cfg.

 

Examples

# Copy the test.cfg file in the current directory and save it to the current directory 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 test.cfg from the working directory on FTP server 1.1.1.1. Save the copy to the local current directory as testbackup.cfg. In this example, the FTP username and password are user and private.

<Sysname> copy ftp://user:private@1.1.1.1/test.cfg testbackup.cfg

Copy ftp://user:private@1.1.1.1/test.cfg to flash:/testbackup.cfg? [Y/N]:y

Copying file ftp://user:private@1.1.1.1/test.cfg to flash:/testbackup.cfg... Done.

# Copy test.cfg from the current directory. 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, respectively.

<Sysname> copy test.cfg ftp://user:private@1.1.1.1/testbackup.cfg

Copy flash:/test.cfg to ftp://user:private@1.1.1.1/testbackup.cfg? [Y/N]:y

Copying file flash:/test.cfg to ftp://user:private@1.1.1.1/testbackup.cfg... Done.

# Copy test.cfg from the working directory on TFTP server 1.1.1.1. Save the copy to the local current directory 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 directory. 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 2001::1. Save the copy to the local current directory 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 directory 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 root directory of the flash memory on the standby MPU.

<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 root directory of the flash memory on 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 root directory of the flash memory on 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

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: 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 command with caution. You cannot restore a file that was deleted with this command.

The delete file 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 from 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 most recently deleted file is retained in the recycle bin.

Examples

# (In standalone mode.) Remove file 1.cfg from the root directory of the active MPU's flash memory.

<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 flash memory.

<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 flash memory 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 flash memory 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 flash memory 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 root directory of the flash memory on 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 directories.

Syntax

dir [ /all ] [ file | directory | /all-filesystems ]

Views

User view

Predefined user roles

network-admin

mdc-admin

Parameters

/all: Displays all files and directories in the current directory, visible or hidden. If you do not specify this option, only visible files and directories are displayed.

file: Displays a specific file. This argument can use the asterisk (*) as a wildcard. For example, to display files with the .txt extension in the current directory, enter dir *.txt.

directory: Displays a specific directory.

/all-filesystems: Displays files and directories in the root directories of all file systems on the device.

Usage guidelines

If no option is specified, the command displays all visible files and directories in the current directory.

The directory 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 directories in the current directory.

<Sysname> dir /all

Directory of flash:/

...

# (In standalone mode.) Display files and directories in the root directories of all file systems on the device.

<Sysname> dir /all-filesystems

Directory of flash:/

...

Directory of slot7#flash:/

...

# (In standalone mode.) Display information about all files and directories in the file systems 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 directories in the file systems of the global active MPU.

<Sysname> dir /all

Directory of flash:/

...

# (In IRF mode.) Display files and directories in the root directory of every file system 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 directories in the file systems 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 directory information:

·     0File or directory number, which is automatically allocated by the system.

·     -rwhAttributes of the file or directory. The first character is the directory indicator (d for directory and for file). The second character indicates whether the file or directory 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 directory, a hyphen (-) is displayed.

·     Apr 26 2008 13:45:28—Last date and time when the file or directory was modified.

·     xx.xx—File or directory name.

 

fdisk

Use fdisk to partition a storage medium.

Syntax

fdisk medium [ partition-number ]

Views

User view

Predefined user roles

network-admin

Parameters

medium: Specifies the name of the storage medium to be partitioned.

partition-number: Specifies the number of partitions, in the range of 1 to 4. If you specify this argument, the storage medium is divided evenly into the specified number of partitions. To customize the sizes of partitions, do not provide this argument.

Usage guidelines

This command is supported only on the default MDC.

The flash memory cannot be partitioned. A partition cannot be partitioned.

The actual partition size and the specified partition size might have a difference of less than 5% of the storage medium's total size.

Before partitioning a USB disk, perform the following tasks:

·     Back up the files in the storage medium. The partition operation clears all data on the medium.

·     Make sure no other users are accessing the medium.

·     Make sure the USB disk to be partitioned is not write protected. If the USB disk is write protected, the operation will fail, and you must remount or reinstall the disk to restore access to the USB disk.

Examples

# Divide the USB disk on the device evenly into three partitions.

<Sysname> fdisk usba: 3

Capacity of usba: : 245M bytes                                                 

usba: will be divided into the following partition(s):                         

DeviceName               Capacity                                              

usba0:                     78MB                                                

usba1:                     78MB                                                

usba2:                     88MB

All data on usba : will be lost, continue? [Y/N]:y

Partitioning usba:...Done.

# Divide the USB disk on the device into one partition.

<Sysname> fdisk usba:

Capacity of usba: : 245M bytes                                                 

Partition 1 (32MB~213MB, 245MB. Press CTRL+C to quit or Enter to use all availab

le space):

// Press Enter or enter 245.

usba: will be divided into the following partition(s):                         

DeviceName               Capacity                                              

usba0:                    245MB                                                

All data on usba: will be lost, continue? [Y/N]:y                              

Partitioning usba:....... Done.

# Divide the USB disk on the device into three partitions and specify the size for each partition:

<Sysname> fdisk usba:

Capacity of usba: : 245M bytes                                                 

Partition 1 (32MB~213MB, 245MB. Press CTRL+C to quit or Enter to use all availab

le space): 128

// Enter 128 to set the size of the first partition to 128 MB.

Partition 2 (32MB~85MB, 117MB. Press CTRL+C to quit or Enter to use all availabl

e 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~85MB, 117MB. Press CTRL+C to quit or Enter to use all availabl

e space): 1000

// Enter 1000 to set the size of the second partition to 1000 MB.

The partition size should be less than or equal to 117MB.

Partition 2 (32MB~85MB, 117MB. Press CTRL+C to quit or Enter to use all availabl

e space): 56

// Enter 56 to set the size of the second partition to 56 MB.

Partition 3 (61MB. Press CTRL+C to quit or Enter to use all available space): 61

// Press Enter to assign the remaining space to the third partition.

usba: will be divided into the following partition(s):                         

DeviceName               Capacity                                              

usba0:                    125MB                                                

usba1:                     54MB                                                

usba2:                     65MB                                                

All data on usba: will be lost, continue? [Y/N]:y                              

Partitioning usba:............ Done.

file prompt

Use file prompt to set the operation mode for files and directories.

Use undo file prompt to restore the default.

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 directory operation.

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

alert: Prompts for confirmation when a destructive file or directory operation is being performed.

quiet: Gives no confirmation prompt for file or directory operations.

Usage guidelines

In quiet mode, the system does not prompt for confirmation when a user performs a file or directory operation. The alert mode provides an opportunity to cancel a disruptive operation.

Examples

# Set the file and directory operation mode to alert.

<Sysname> system-view

[Sysname] file prompt alert

fixdisk

Use fixdisk to check a file system for damage and repair any damage.

Syntax

fixdisk filesystem

Views

User view

Predefined user roles

network-admin

Parameters

filesystem: Specifies the name of a file system.

Usage guidelines

This command is supported only on the default MDC.

Use this command to fix a file system when space on the medium cannot be used or released due to abnormal operations.

You can repair a file system only when no other users are accessing the medium.

Examples

# Repair the flash: file system.

<Sysname> fixdisk flash:

Restoring flash: may take some time...

Restoring flash:...Done.

format

Use format to format a file system.

Syntax

format filesystem

Views

User view

Predefined user roles

network-admin

Parameters

filesystem: Specifies the name of a file system.

Usage guidelines

This command is supported only on the default MDC.

Formatting a file system permanently deletes all files on the file system. If a startup configuration file exists on the file system, back it up if necessary.

You can format a file system only when no other users are accessing the file system.

Examples

# Format the flash: file system.

<Sysname> format flash:

All data on flash: will be lost, continue? [Y/N]:y

Formatting flash:... Done.

gunzip

Use gunzip to decompress a file.

Syntax

gunzip file

Views

User view

Predefined user roles

network-admin

mdc-admin

Parameters

file: 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 system.bin.gz file:

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 system.bin.gz file.

<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 file

Views

User view

Predefined user roles

network-admin

mdc-admin

Parameters

file: Specifies the name of the file to be compressed. The compressed file will be saved to file filename.gz.

Usage guidelines

This command saves the compressed file to the file.gz file and deletes the source file.

Examples

# Compress the system.bin file:

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

<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)

md5sum

Use md5sum to use the MD5 algorithm to calculate the digest of a file.

Syntax

md5sum file

Views

User view

Predefined user roles

network-admin

network-operator

Parameters

file: Specifies the name of a file.

Usage guidelines

You can use file digests to verify file integrity.

Examples

# Use the MD5 algorithm to calculate the digest of file system.bin.

<Sysname> md5sum system.bin

MD5 digest:

4f22b6190d151a167105df61c35f0917

mkdir

Use mkdir to create a directory in the current directory.

Syntax

mkdir directory

Views

User view

Predefined user roles

network-admin

mdc-admin

Parameters

directory: Specifies the name of a directory.

Usage guidelines

The name of the directory to be created must be unique in the specified directory.

You can create a directory only in an existing directory. For example, to create the flash:/test/mytest directory, make sure the test directory already exists.

Examples

# Create the test directory in the current directory.

<Sysname> mkdir test

Creating directory flash:/test... Done.

# Create the test/subtest directory in the current directory.

<Sysname> mkdir test/subtest

Creating directory flash:/test/subtest... Done.

# (In standalone mode.) Create the test directory on the standby MPU (in slot 1).

<Sysname> mkdir slot1#flash:/test

Creating directory slot1#flash:/test... Done.

# (In IRF mode.) Create the test directory on the global active MPU.

<Sysname> mkdir test

Creating directory flash:/test... Done.

# (In IRF mode.) Create the test directory on the global 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

Views

User view

Predefined user roles

network-admin

mdc-admin

Parameters

file: 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.1.045, Feature 2110L06

#

mdc Admin id 1

#

 sysname Sysname

#

telnet server enable

#

---- More ----

<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.1.045, Feature 2110L06

#

 mdc Admin id 1

#

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.1.045, Feature 2110L06

#

  mdc Admin id 1

#

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.1.045, Feature 2110L06

#

 mdc Admin id 1

#

 sysname Sysname

#

  ---- More ----

mount

Use mount to mount a file system.

Syntax

mount filesystem

Views

User view

Predefined user roles

network-admin

Parameters

filesystem: Specifies the name of a file system.

Usage guidelines

This command is supported only on the default MDC.

Generally, file systems on a hot-swappable storage medium are automatically mounted when the storage medium is connected to the device. If the system cannot recognize a file system, however, you must mount the file system before you can access it.

To avoid file system corruption, do not perform the following tasks while the system is mounting a file system:

·     Install or remove storage media.

·     Install or remove cards.

·     Perform an active/standby switchover. (In standalone mode.)

·     Perform a switchover between the global active MPU and a global standby MPU. (In IRF mode.)

To avoid file system corruption, do not create, delete, start, or stop an MDC while the system is mounting or unmounting a file system.

Examples

# (In standalone mode.) Mount the usba0: file system on the active MPU.

<Sysname> mount usba0:                                                              

Mount usba0: successfully.

# (In standalone mode.) Mount the usba0: file system on the standby MPU (in slot 6).

<Sysname> mount slot6#usba0:                                                        

Mount slot6#usba0: successfully.

# (In IRF mode.) Mount the usba0: file system on the global MPU.

<Sysname> mount usba0:

Mount usba0: successfully.

# (In IRF mode.) Mount the usba0: file system on the global standby MPU that resides in slot 6 of member device 2.

<Sysname> mount chassis2#slot6#usba0:

Mount chassis2#slot6#usba0: successfully.

Related commands

umount

move

Use move to move a file.

Syntax

move source-file { dest-file | dest-directory }

Views

User view

Predefined user roles

network-admin

mdc-admin

Parameters

source-file: Specifies the name of the source file.

dest-file: Specifies the name of the destination file.

dest-directory: Specifies the name of the destination directory.

Usage guidelines

If you specify a destination directory, the system moves the source file to the specified directory 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 test2 directory.

<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 working directory.

Syntax

pwd

Views

User view

Predefined user roles

network-admin

mdc-admin

Examples

# Display the working directory.

<Sysname> pwd

flash:

rename

Use rename to rename a file or directory.

Syntax

rename { source-file | source-directory } { dest-file | dest-directory }

Views

User view

Predefined user roles

network-admin

mdc-admin

Parameters

source-file: Specifies the name of the source file.

source-directory: Specifies the name of the source directory.

dest-file: Specifies the name of the destination file.

dest-directory: Specifies the name of the destination directory.

Usage guidelines

This command is not executed if the destination file or directory name is already used by an existing file or directory in the 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

Predefined user roles

network-admin

mdc-admin

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 operation for each file.

Usage guidelines

The delete file 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 delete a directory.

Syntax

rmdir directory

Views

User view

Predefined user roles

network-admin

mdc-admin

Parameters

directory: Specifies a directory name.

Usage guidelines

To delete a directory, you must delete all files and subdirectories 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

# Delete the subtest directory.

<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

Views

User view

Predefined user roles

network-admin

mdc-admin

Parameters

file: Specifies the name of a file.

Usage guidelines

You can use file digests 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

tar create

Use tar create to archive files and directories.

Syntax

tar create [ gz ] archive-file dest-file [ verbose ] source { source-file | source-directory }&<1-5>

Views

User view

Predefined user roles

network-admin

mdc-admin

Parameters

gz: Uses gzip to compress the files and directories before archiving them. If you do not specify this keyword, the command archives the files and directories without compressing them.

archive-file dest-file: Specifies the archive file name. If you specified the gz keyword, the suffix of the archive file name must be .tar.gz. If you did not specify the gz keyword, the suffix of the archive file name must be .tar.

verbose: Displays the names of the successfully archived files and directories. If you do not specify this keyword, the command does not display the names of the successfully archived files and directories.

source { source-file | source-directory }&<1-5>: Specifies the files and directories to be archived. The argument can be a space-separated list of up to five items. Each item can be a file or directory name.

Examples

# Archive the 1.cfg and  2.cfg files and the test directory to file a.tar.

<Sysname> tar create archive-file a.tar source 1.cfg 2.cfg test

Creating archive flash:/a.tar Done.

# Compress and archive the 1.cfg and 2.cfg files and the test directory to b.tar.gz.

<Sysname> tar create gz archive-file b.tar.gz source 1.cfg 2.cfg test

Creating archive flash:/b.tar.gz Done.

# Compress and archive files and directories, and display the successfully archived files and directories.

<Sysname> tar create gz archive-file c.tar.gz verbose source 1.cfg 2.cfg test

1.cfg

2.cfg

test/

test/a.log

test/subtest/

test/subtest/aa.log

Related commands

·     tar extract

·     tar list

tar extract

Use tar extract to extract files and directories.

Syntax

tar extract archive-file file [ verbose ] [ screen | to directory ]

Views

User view

Predefined user roles

network-admin

mdc-admin

Parameters

archive-file file: Specifies the archive file name. The suffix can be .tar or .tar.gz.

verbose: Displays the names of the successfully extracted files and directories.

screen: Displays the content of the extracted files and directories on the screen. The extracted files are not saved.

to directory: Saves the extracted files and directories to a different directory. The directory argument specifies the directory.

Usage guidelines

If you do not specify the screen keyword or the to directory option, the command saves the extracted files and directories to the working directory.

The command saves the extracted files and directories by using their original names. If a file or directory that has the same name as an extracted file or directory already exists in the destination directory, the file or directory is overwritten.

Examples

# Extract files and directories from archive file a.tar.

<Sysname> tar extract archive-file a.tar

Extracting archive flash:/a.tar Done.

# Extract files and directories from archive file a.tar, and display the names of the successfully extracted files and directories.

<Sysname> tar extract archive-file b.tar.gz verbose

1.cfg

2.cfg

test/

test/a.log

test/subtest/

test/subtest/aa.log

# Extract files and directories from archive file a.tar, and display the content of the files on the screen.

<Sysname> tar extract archive-file c.tar.gz screen

#

 version 7.1.045, Feature 2110L06

#

 sysname Sysname

#

...

Related commands

·     tar create

·     tar list

tar list

Use tar list to display the names of archived files and directories.

Syntax

tar list archive-file file

Views

User view

Predefined user roles

network-admin

mdc-admin

Parameters

archive-file file: Specifies the archive file name. The suffix can be .tar or .tar.gz.

Examples

# Display the names of archived files and directories.

<Sysname> tar list archive-file a.tar

1.cfg

2.cfg

test/

test/a.log

test/subtest/

test/subtest/aa.log

Related commands

·     tar create

·     tar extract

umount

Use umount to unmount a file system.

Syntax

umount filesystem

Views

User view

Predefined user roles

network-admin

Parameters

filesystem: Specifies the name of a file system.

Usage guidelines

This command is supported only on the default MDC.

File systems on a storage medium are automatically mounted when the storage medium is connected to the device. To remove a hot-swappable storage medium from the device, you must first unmount all file systems on the storage medium. Removing a mounted hot-swappable storage medium might damage files on the storage medium or even the storage medium.

You can unmount a file system only when no other users are accessing the file system.

To avoid file system corruption, do not perform the following tasks while the system is unmounting a file system:

·     Install or remove storage media or cards.

·     Perform active/standby switchover. (In standalone mode.)

·     Perform a switchover between the global active MPU and a global standby MPU. (In IRF mode.)

Examples

# (In standalone mode.) Unmount the usba0: file system from the active MPU.

<Sysname> umount usba0:

Umount usba0: successfully.

# (In standalone mode.) Unmount the usba0: file system from the standby MPU (in slot 6).

<Sysname> umount slot7#usba0:

Umount slot7#usba0: successfully.

# (In IRF mode.) Unmount the usba0: file system from the global active MPU.

<Sysname> umount usba0:

Umount usba0: successfully.

# (In IRF mode.) Unmount the usba0: file system from the global standby MPU that resides in slot 6 of member device 2.

<Sysname> umount chassis2#slot6#usba0:

Umount chassis2#slot6#usba0: successfully.

Related commands

mount

undelete

Use undelete to restore a file from the recycle bin.

Syntax

undelete file

Views

User view

Predefined user roles

network-admin

mdc-admin

Parameters

file: 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.

  • Cloud & AI
  • InterConnect
  • Intelligent Computing
  • Security
  • SMB Products
  • Intelligent Terminal Products
  • Product Support Services
  • Technical Service Solutions
All Services
  • Resource Center
  • Policy
  • Online Help
All Support
  • Become a Partner
  • Partner Resources
  • Partner Business Management
All Partners
  • Profile
  • News & Events
  • Online Exhibition Center
  • Contact Us
All About Us
新华三官网