File System Commands on the Cisco IOS XR Software

The commands in this module should not be used to access or modify any Cisco IOS XR software or configuration files. Use only the documented commands for installing and configuring the router. Modifying, deleting, or moving configuration or software package files using the manual commands described in this module is not required and can result in router downtime, loss of service, and a corrupted database.

cd

To change the present working directory, use the cd command in EXEC mode.

cdfilesystem:

Syntax Description

filesystem:

(Optional) Location of the new present working directory. Include the file system alias for the filesystem argument, followed by a colon and optionally, the name of a directory.

Command Default

The default file directory is disk0:/usr.

Command Modes

EXEC

Command History

Release

Modification

Release 3.2

This command was introduced.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

The present working directory is the directory used when EXEC commands that have an optional filesystem argument are entered without that argument. Use the cd command to define the present working directory. For example, when the dir command is entered without specifying the filesystem argument, the files in the present working directory are displayed.

Use the pwd command to display the present working directory.

Use the showfilesystem command to display the available storage devices.

Enter the cd command without an argument to return the present working directory to disk0:/usr.

Task ID

Task ID

Operations

filesystem

read

Examples

The following example shows how to change the present working directory to the root directory on the hard disk. In this example, the pwd command confirms that the present working directory has changed to the root directory on the hard disk.

RP/0/0/CPU0:router# cd harddisk:RP/0/0/CPU0:router# pwd
harddisk:

The following example shows how to change the present working directory to the default file directory by specifying the cd command without a location. In this example, the pwd command confirms that the present working directory has changed to the default file directory.

cfs check

To perform a check of the Configuration File System (CFS), use the cfscheck command in EXEC or administration EXEC mode.

cfscheck

Syntax Description

This command has no keywords or arguments.

Command Default

No default behavior or values

Command Modes

EXEC

Administration EXEC

Command History

Release

Modification

Release 3.2

This command was introduced.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Use the cfscheck command to check the sanity of the configuration file system and attempt to recover from internal inconsistencies; one or more rollback points may be lost depending on the severity of the state of the file system.

Note

While this command runs, redundancy of the designated secure domain router shelf controller (DSDRSC) is disabled.

clear-classic-config

To clear or truncate the Cisco IOS software running configuration stored in NVRAM, use the clear-classic-config command in EXEC mode.

clear-classic-config

Command Default

No default behavior or values

Command Modes

EXEC

Command History

Release

Modification

Release 3.2

This command was introduced.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Use the clear-classic-config command to clear space on the NVRAM, if the Cisco IOS software configuration is no longer needed or to boot the Cisco IOS software with no configuration.

Task ID

Task ID

Operations

config-services

execute

Examples

The following example shows how to clear the Cisco IOS software running configuration stored in NVRAM:

RP/0/0/CPU0:router# clear-classic-config

copy

To copy a file from a source (such as a network server) to a destination (such as a flash disk), use the copy command in EXEC or administration EXEC mode.

Filename including the directory path or network location of the file.

locationnode-id

Specifies a node. The node-id argument is expressed in the rack/slot/module notation.

locationall

Copies to all nodes.

running-config

Applies the source configuration file to the running configuration of the system.

atomic

(Optional) Applies the changes to the running configuration only if there are no errors

Command Default

No default behavior or values

Command Modes

EXEC

Administration EXEC

Command History

Releases

Modifications

Release 3.2

This command was introduced.

Release 3.5.0

Support was added to copy XML schema files.

Release 3.6.0

The following file systems were added: disk0a:, disk1a:, and compactflasha: .

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Source and destination can each be a configuration file, a text file, or a file system. Enter source and destination URL information, usernames, and passwords and issue the copy command. The networking device prompts for any missing information.

The exact format of the source and destination arguments vary according to the file or directory location. Enter the device or network location for the file system type.

To copy a file from a source on the router to a destination on the router, specify a source locationnode-id and a destination locationnode-id. To copy the file to all nodes, use the locationall keywords.

In the alias syntax for the ftp:, rcp:, and tftp: keywords, the location is either an IP address or a hostname. The filename is specified relative to the directory used for file transfers.

When no alias is specified, the networking device looks for a file in the current directory. To view the current directory, enter the pwd command.

Note

During processing of the copy command, you might see the “C” character. For all files being copied, “C” indicates that the copy process is taking place. The entire copying process might take several minutes and differs from protocol to protocol and from network to network.

TFTP is a simplified version of FTP that allows files to be transferred from one computer to another over a network, usually without the use of client authentication (for example, username and password).

ftp:

File Transfer Protocol

FTP is an application protocol, part of the TCP/IP protocol stack, and is used for transferring files between network nodes. FTP requires a username and password.

rcp:

Remote Copy Protocol

The rcp protocol allows users to copy files to and from a file system residing on a remote host or server on the network. The rcp protocol uses TCP to ensure the reliable delivery of data. The rcp protocol downloads require a username.

Additional usage guidelines are in the following sections.

Invalid Combinations of Source and Destination

Some combinations of source and destination are invalid. Specifically, you cannot copy the following:

From a running configuration to a running configuration

From a network device to a network device (for example, copyftp:rcp:)

Using TFTP

TFTP is a simplified version of FTP that allows files to be transferred from one computer to another over a network, usually without the use of client authentication (for example, username and password).

Some Cisco IOS XR images may be larger than 32 MB, and the TFTP services provided by some vendors may not support a file this large. If you do not have access to a TFTP server that supports files larger than 32 MB, download the software image using FTP or rcp as described in the following sections.

Using FTP

FTP servers require a username and password for each client request. Cisco IOS XR software sends the first valid username in the following list:

The username and password specified in the copy command, if a username is specified. The syntax is as follows: copy ftp://username:password@hostname or ipaddress/directory-path/pie-nametarget-device [location {node-id | all}]

An “anonymous” username and password. The anonymous password is “root@ip address,” where “ip address” is the IP address of the local networking device.

A password “username@iosname.domain” formed by the networking device. The variable “username” is the username associated with the current session, “iosname” is the configured hostname, and “domain” is the domain of the networking device.

The username and password must be associated with an account on the FTP server. If you are writing to the network server, the FTP server must be properly configured to accept the FTP write request from the user on the networking device.

If the network server has a directory structure, the configuration file or image is written to or copied from the directory associated with the username on the network server. For example, if the system image resides in the home directory of a user on the network server, specify the name of that user as the remote username.

Refer to the documentation for your FTP server for more details.

Using rcp

The rcp protocol requires a username upon each request. When you copy a configuration file or image between the networking device and an rcp server, the Cisco IOS XR software sends the first valid username in the following list:

The remote username specified in the copy command, if one is specified.

The username set by the rcpclientusername command, if the command is configured.

The networking device hostname.

For the rcp copy request to process successfully, an account must be defined on the network server for the remote username. If the network administrator of the destination server did not establish an account for the remote username, this command does not run successfully. If the network server has a directory structure, the configuration file or image is written to or copied from the directory associated with the remote username on the network server. For example, if the system image resides in the home directory of a user on the network server, specify the name of that user as the remote username.

If you are writing to the network server, the rcp server must be properly configured to accept the rcp write request from the user on the networking device. For UNIX systems, add an entry to the .rhosts file for the remote user on the rcp server. Suppose the networking device contains the following configuration lines:

hostname Rtr1
ip rcp remote-username User0

If the IP address of the networking device translates to company.com, then the .rhosts file for User0 on the rcp server should contain the following line:

company.com Rtr1

See the documentation for your rcp server for more details.

If you are using a personal computer as a file server, the computer must support remote shell (rsh) protocol.

Using xml-schema

Use the xml-schema keyword to obtain the most up-to-date XML schemas (.xsd files) from the router. Using this keyword is useful to prevent the use of outdated schemas in the event that router software updates include schema updates. The tar ball file includes all active schema files. It does not include schemas that are activated by specific package installation envelopes (PIEs) if those PIEs are not installed and activated on the router.

Copying to the Running Configuration

When you use the copy command to copy a configuration file to the running-config destination, the configuration in the file is applied to the running configuration of the system. This is a configuration operation. By default, the copy is carried out in a best-effort manner. This means that if some configuration lines from the file cannot be applied, the remaining configuration is still integrated into the system. In this case, a partial configuration is committed. When the atomic keyword is used, partial configurations are not committed. This means that even if one error occurs in the parsing or committing phase, no changes are made to the system. To view any errors when applying the configuration, use the showconfigurationfailed command.

Task ID

Task ID

Operations

filesystem

execute

Examples

The following example shows how to copy a file from a FTP server to disk1:

delete

Syntax Description

(Optional) Causes no prompt for confirmation before deleting the specified files.

/ena

(Optional) Deletes all files from and below the current working directory.

filesystem:

(Optional) Location of the file to be deleted. Include the file system alias for the filesystem argument, followed by a colon, and, optionally, the name of a directory.

filename

Filename of the file to be deleted.

location {node-id | all}

Deletes a file from a designated node. The node-id argument is entered in the rack/slot/module notation. The all keyword specifies to delete the file from all nodes.

Command Default

A filename must be specified. If a filename is entered without a file system or directory path, the present working directory is used.

Command Modes

EXEC

Administration EXEC

Command History

Release

Modification

Release 3.2

This command was introduced.

Release 3.6.0

The following file systems were added: disk0a:, disk1a:, and compactflasha: .

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

When a file is deleted, it is removed from the system and cannot be restored (undeleted).

Syntax Description

(Optional) Name of the directory containing the files to be displayed. Include the file system alias for the filesystem argument, followed by a colon, and, optionally, the name of a directory.

filename

(Optional) Name of the files to display. The files can be of any type. You can use wildcards in the filename. A wildcard character (*) matches all patterns. Strings following a wildcard are ignored.

location {node-id | all}

(Optional) Specifies the node from which to display a list of files. The node-id argument is entered in the rack/slot/module notation. The all keyword specifies to display files on all nodes.

Command Default

When the dir command is entered without keywords or arguments, the contents of the present working directory are displayed.

Command Modes

EXEC

Administration EXEC

Command History

Release

Modification

Release 3.2

This command was introduced.

Release 3.6.0

The following file systems were added: disk0a:, disk1a:, and compactflasha: .

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

If you enter the dir command without specifying a directory, the contents of the present working directory are displayed. The all keyword displays all files, including deleted files. The size associated with the directory name is the total size for all files in that directory.

Task ID

Task ID

Operations

filesystem

execute

Examples

The following example shows how to display the contents of a directory:

erase nvram:

To erase the NVRAM file system, use the erasenvram: command in EXEC mode.

erasenvram: [format] [ location
{ node-id | all } ]

Syntax Description

format

(Optional) Formats the entire NVRAM.

Command Default

No default behavior or values

Command Modes

EXEC

Command History

Release

Modification

Release 3.2

This command was introduced.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

erase nvram-raw:

To format the NVRAM raw data partition with a ‘0’ value, use the erasenvram-raw: command in EXEC or administration EXEC mode.

erasenvram-raw:
[ location
{ node-id | all } ]

Syntax Description

location{node-id | all}

(Optional) Specifies the node where the file system is located. The node-id argument is expressed in the rack/slot/module notation. Use the all keyword to indicate all nodes.

Command Default

No default behavior or values

Command Modes

EXEC

Administration EXEC

Command History

Release

Modification

Release 3.6.0

This command was introduced.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

The NVRAM is divided into two partitions. The first partition, consisting of 1 megabyte (MB), is used by the existing NVRAM file-system partition. The second partition, consisting of 1 MB, is a raw data partition and is used by the Kernel Dumper to store reboot historical logs, critical crash information, syslog, and Kernel Dumper traces. The erase nvram-raw: command formats the raw data partition of the NVRAM.

Task ID

Task ID

Operations

filesystem

execute

Examples

The following example shows how to erase the raw data partition of the NVRAM file system:

Syntax Description

Name of the file system to format, followed by a colon. Possible values are bootflash:, disk0:, disk0a:, disk1:, disk1a:, harddisk:, harddiska:, harddiskb:, compactflash:, and compactflasha:.

partition

(Optional) Creates a partition on a filesystem. This option is not available when the bootflash: filesystem is specified.

unpartition

(Optional) Specifies to remove the partitioning on the specified filesystem.

filesystemfilesystem-type

Specifies the filesystem type used to format the specified device. Options include fat16, fat32 and qnx4, depending in the device being formatted.

monlib-filename

(Optional) Name of the ROM monitor library (monlib) file to use for formatting the file system. The default monlib file is the one bundled with the system software.

Note

The monlib is used by ROMMON for accessing the file system on the media.

This option is available on the bootflash: only.

location{node-id | all}

(Optional) Specifies the node where the file system is located. The node-id argument is expressed in the rack/slot/module notation. Use the all keyword to indicate all nodes.

sparespare-number

(Optional) Reserves spare sectors as specified by the
spare-number argument when formatting flash memory. Valid values are from 0 to 16.

Note

This option is available on the bootflash: only.

force

(Optional) Forces a monlib update, without verifying the monlib version on the device.

recover

(Optional) Recovers any sector read errors on a flash disk.

Command Default

The default monlib file is the one included with the Cisco IOS XR software.

spare-number: 0

Command Modes

EXEC

Administration EXEC

Command History

Release

Modification

Release 3.2

This command was introduced.

Release 3.6.0

The following file systems were added: disk0a:, disk1a:, and compactflasha: .

Release 3.8.2

The ability to format a standby bootdisk was introduced.

The unpartition keyword was supported.

The ability to specify the file system type was supported.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Before you can use a new flash memory card, you must format it.

Caution

Formatting a storage device deletes all data on that device.

Use the online help (?) function to display the file systems available to be formatted on the router and the formatting options available for a file system.

You cannot format an active boot disk. However, you can format the standby boot disk. Verify that the boot disk you want to format is on the standby RP, then use the format command.

Disk0: and disk1: can be partitioned into two partitions each: disk0: and disk0a:, disk1: and disk1a:. The harddisk: can be partitioned into three partitions: harddisk:, harddiska:, and harddiskb:. The primary partitions are used to store critical data. The secondary partitions are used to store noncritical data.

Table 1 shows the size of the partitions if you partition disk0: , disk1: or the compactflash:,:

Table 2 Size of Disk Partitions in Relation to Size of Disk

Size of Disk

Primary Partition Percentage

Secondary Partition Percentage

less than 900 MB

Partitioning not supported

Partitioning not supported

900 MB to 1.5 GB

80%

20%

1.5 GB to 3 GB

60%

40%

more than 3 GB

50%

50%

The size of the three hard disk partitions are as follows:

Primary partition (harddisk:)—30%

Secondary partition (harddiska:)—60%

Third partition (harddiskb:)—10%

Task ID

Task ID

Operations

root-lr (EXEC)

execute

root-system (administration EXEC)

execute

Examples

The following example shows how to format disk1:

RP/0/0/CPU0:router# format disk1:

The following example shows how to format disk1: with instructions to recover any sectors on the device that have read errors:

RP/0/0/CPU0:router# format disk1: recover
This format operation will try to recover sectors with read error
This operation may take a while. Continue? [confirm]
Format will destroy all data on "disk1:". Continue? [confirm]

Note

When the console returns to the EXEC prompt, the new flash disk has been formatted and is ready for use.

fsck

To check a file system for damage, use the fsck command in EXEC or administration EXEC mode.

fsckfilesystem:
[ locationnode-id ]

Syntax Description

filesystem:

Name of the file system to check, followed by a colon. Possible values are disk0:, disk0a:, disk1:, disk1a:, harddisk:, harddiska:, harddiskb:, compactflash:, compactflasha:.

location node-id

(Optional) Specifies the node where the file system is located. The node-id argument is expressed in the rack/slot/module notation.

Command Default

No default behavior or values

Command Modes

EXEC

Administration EXEC

Command History

Release

Modification

Release 3.2

This command was introduced.

Release 3.6.0

The following file systems were added: disk0a:, disk1a:, and compactflasha: .

The command checks the file system, but does not repair the file system.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Task ID

Task ID

Operations

filesystem

execute

Examples

The following example shows how to check the file system on flash disk0: for damage:

mkdir

To create a new directory on a file system, use the mkdir command in EXEC or administration EXEC mode.

mkdirfilesystem: [ location
{ node-id | all } ]

Syntax Description

filesystem:

File system on which to create a new directory.

location{node-id | all}

(Optional) Specifies the node where the file system is located. The node-id argument is expressed in the rack/slot/module notation. Use the all keyword to indicate all nodes.

Command Default

No default behavior or values

Command Modes

EXEC

Administration EXEC

Command History

Release

Modification

Release 3.2

This command was introduced.

Release 3.6.0

The following file systems were added: disk0a:, disk1a:, and compactflasha: .

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

After you issue the mkdir command, Cisco IOS XR software prompts you to specify the name of the directory to be created. When specifying the name of the new directory, include the directory path where you want the new directory to reside. If you do not specify a directory path, the new directory is created in the /usr directory of the file system specified for the filesystem: argument.

Task ID

Task ID

Operations

filesystem

execute

Examples

The following example shows how to create a directory named newdir. The dir command is used to verify that the directory has been added.

pwd

To display the present working directory, use the pwd command in EXEC mode.

pwd

Syntax Description

This command has no keywords or arguments.

Command Default

No default behavior or values

Command Modes

EXEC

Command History

Release

Modification

Release 3.2

This command was introduced.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Use the pwd command to show what directory or file system is specified as the default by the cd command.

Task ID

Task ID

Operations

filesystem

read

Examples

The following example shows how to display the present working directory:

rmdir

To remove an existing directory, use the rmdir command in EXEC or administration EXEC mode.

rmdirfilesystem:location
{ node-id | all }

Syntax Description

filesystem

Name of the file system from which to delete a directory, followed by a colon.

location {node-id | all}

Specifies the node where the file system is located. The node-id argument is expressed in the rack/slot/module notation. Use the all keyword to indicate all nodes.

Command Default

No default behavior or values

Command Modes

EXEC

Administration EXEC

Command History

Release

Modification

Release 3.2

This command was introduced.

Release 3.6.0

The following file systems were added: disk0a:, disk1a:, and compactflasha: .

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Use the rmdir command to remove directories (for example, to free up disk space) from a file system. After you issue the rmdir command, the Cisco IOS XR software prompts you to specify the name of the directory to be deleted.

When a directory contains files, you must remove the files before deleting the directory. Use the delete command to remove files.

Task ID

Task ID

Operations

filesystem

execute

Examples

The following example shows how to delete a subdirectory from the hard disk. The dir command is used to verify that the directory has been deleted.

Syntax Description

Name of the file system for which to display information, followed by a colon. Possible values are: disk0:, disk1:, harddisk:, compactflash:.

firmware

(Optional) Displays the firmware level.

stats

(Optional) Displays device statistics.

verboselevel

(Optional) Changes the device driver verbose level.

location{node-id | all}

(Optional) Specifies the node where the file system is located. The node-id argument is expressed in the rack/slot/module notation. Use the all keyword to indicate all nodes.

Command Default

The file system for the active RP is displayed.

Command Modes

EXEC

Administration EXEC

Command History

Release

Modification

Release 3.2

This command was introduced.

Release 3.6.0

The following file systems were added: disk0a:, disk1a:, and compactflasha: .

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Use the showfilesystem command to learn the alias names (prefixes) of the file systems supported by your networking device.

Task ID

Task ID

Operations

basic-services

read

Examples

The following example shows sample output from the showfilesystem command:

show media

To display the current state of the disk storage media, use the showmedia command in EXEC or administration EXEC mode.

showmedialocation
{ node-id | all }

Syntax Description

location{node-id | all}

(Optional) Specifies the node where the file system is located. The node-id argument is expressed in the rack/slot/module notation. Use the all keyword to indicate all nodes.

Command Default

The disk storage media for the active RP is displayed.

Command Modes

EXEC

Administration EXEC

Command History

Command History

Release

Modification

Release 3.6.0

This command was introduced.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Use the show media command to view the status of the storage media on your system.

Task ID

Task ID

Operations

filesystem

read

Examples

The following sample output displays the disk storage media for the active RP:

squeeze

To permanently erase files tagged as “deleted” or “error” on a flash file system, use the squeeze command in EXEC mode.

squeezefilesystem:

Syntax Description

filesystem:

Name of the file system.

Command Default

No default behavior or values

Command Modes

EXEC

Command History

Release

Modification

Release 3.2

This command was introduced.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

When flash memory is full, you might need to rearrange the files so that the space used by the files marked “deleted” can be reclaimed. (This “squeeze” process is required for linear flash memory cards to make sectors contiguous; the free memory must be in a “block” to be usable.)

When you enter the squeeze command, the router copies all valid files to the beginning of flash memory and erases all files marked “deleted.” After the squeeze process is completed, you can write to the reclaimed flash memory space.

Caution

After performing the squeeze process you cannot recover deleted files using the undelete command.

In addition to removing deleted files, the squeeze command removes any files that the system has marked as “error.” An error file is created when a file write fails (for example, the device is full). To remove error files, you must use the squeeze command.

Rewriting flash memory space during the squeeze operation may take several minutes.

Task ID

Task ID

Operations

basic-services

execute

Examples

The following example shows how to permanently erase files tagged as “deleted” or “error” on the bootflash file system:

undelete

To recover a file marked “deleted” on a flash file system, use the undelete command in EXEC mode.

undeleteindexfilesystem:

Syntax Description

index

Number that indexes the file in the dir command output.

filesystem:

File system containing the file to undelete, followed by a colon.

Command Default

The default file system is the one specified by the cd command.

Command Modes

EXEC

Command History

Release

Modification

Release 3.2

This command was introduced.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

For flash file systems, when you delete a file, Cisco IOS XR software simply marks the file as deleted, but it does not erase the file. The undelete command allows you to recover a deleted file on a specified flash memory device. You must undelete a file by its index, because you could have multiple deleted files with the same name. For example, the “deleted” list could contain multiple configuration files with the name router-config. You undelete by index to indicate which of the many router-config files from the list to undelete. Use the dir command to learn the index number of the file you want to undelete.

You cannot undelete a file if a valid (undeleted) file with the same name exists. Instead, you first delete the existing file and then undelete the file you want. For example, if you had an undeleted version of the router-config file and you wanted to use a previous, deleted version instead, you could not simply undelete the previous version by index. You would first delete the existing router-config file and then undelete the previous router-config file by index. You can delete and undelete a file up to 15 times.

On flash file systems, if you try to recover the configuration file pointed to by the CONFIG_FILE environment variable, the system prompts you to confirm recovery of the file. This prompt reminds you that the CONFIG_FILE environment variable points to an undeleted file. To permanently delete all files marked “deleted” on a flash memory device, use the squeeze command.

Task ID

Task ID

Operations

filesystem

execute

Examples

The following example recovers the deleted file whose index number is 1 on the bootflash file system:

Permanently erases files tagged as “deleted” or “error” on a flash file system.

unmount

To render a media device safe to be removed, use the unmount command in EXEC or administration EXEC mode.

unmountfilesystem:
[ locationnode-id ]
[undo]

Syntax Description

filesystem:

File system to unmount, followed by a colon. Possible values are disk0:, disk1:, harddisk:, compactflash:.

locationnode-id

(Optional) Specifies a node. The node-id argument is expressed in the rack/slot/module notation.

undo

(Optional) Remounts the device if it is not removed and reinserted.

Command Default

No default behavior or values

Command Modes

EXEC

Administration EXEC

Command History

Release

Modification

Release 3.6.0

This command was introduced.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Use the unmount command before removing the media device. The command unmounts all partitions and ensures that no further access is made to the device. Use the undo option to remount the device if it is not removed and reinserted.

Task ID

Task ID

Operations

root-lr (EXEC)

execute

root-system (administration EXEC)

execute

Examples

This example unmounts the disk0: file system so that it can be safely removed: