-
Cisco IOS XR System Management Command Reference, Release 3.7
-
Preface
-
Bulk Content Downloader (BCDL) Commands on Cisco IOS XR Software
-
Boot Commands on Cisco IOS XR Software
-
CDP Commands on Cisco IOS XR Software
-
Clock Commands on Cisco IOS XR Software
-
Configuration Management Commands on Cisco IOS XR Software
-
Distributed Route Processor Commands on Cisco IOS XR Software
-
Software Entitlement Commands on Cisco IOS XR Software
-
File System Commands on Cisco IOS XR Software
-
Hardware Redundancy and Node Administration Commands on Cisco IOS XR Software
-
Software Package Management Commands on Cisco IOS XR Software
-
Manageability Commands on Cisco IOS XR Software
-
NTP Commands on Cisco IOS XR Software
-
Object Tracking Commands on Cisco IOS XR Software
-
Process and Memory Management Commands on Cisco IOS XR Software
-
Secure Domain Router Commands on Cisco IOS XR Software
-
SNMP Server Commands on Cisco IOS XR Software
-
Terminal Services Commands on Cisco IOS XR Software
-
Utility Commands on Cisco IOS XR Software
-
Index
-
Table Of Contents
File System Commands on Cisco IOS XR Software
File System Commands on Cisco IOS XR Software
This chapter describes the Cisco IOS XR software commands used to manage file systems.
CautionThe commands in this chapter 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 chapter 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.
cd [filesystem:]
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.
Defaults
The default file directory is disk0:/usr.
Command Modes
EXEC
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
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 show filesystem 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
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/RP0/CPU0:router# cd harddisk:RP/0/RP0/CPU0:router# pwdharddisk: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.
RP/0/RP0/CPU0:router# cdRP/0/RP0/CPU0:router# pwddisk0:/usrRelated Commands
Displays the contents of a file system.
Displays the current working directory of the cd command.
Displays the layout and contents of a file system.
cfs check
To perform a check of the Configuration File System (CFS), use the cfs check command in EXEC or administration EXEC mode.
cfs check
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values
Command Modes
EXEC
Administration EXECCommand History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Use the cfs check 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
Task ID
Examples
The following example shows how to perform a CFS check:
RP/0/RP0/CPU0:router# cfs checkCreating any missing directories in Configuration File system...OKInitializing Configuration Version Manager...OKSyncing commit database with running configuration...OKRe-initializing cache files...OKUpdating Commit Database. Please wait...[OK]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
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values
Command Modes
EXEC
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
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
Examples
The following example shows how to clear the Cisco IOS software running configuration stored in NVRAM:
RP/0/0/CPU0:router# clear-classic-configcopy
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.
copy source {location node-id destination {location node-id | location all} | running-config [atomic]}
Syntax Description
Defaults
No default behavior or values
Command Modes
EXEC
Administration EXECCommand History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
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.
Filenames can include the following characters:
! # $ % & ' + 0 1 2 3 4 5 6 7 8 9 ; @ A B C D E F G H I J K L M N O P Q R S T U V W X Y Z [ ] ^ _ a b c d e f g h i j k l m n o p q r s t u v w x y z { } ~The following characters can be used with the stated limitations:
•
•
•
•
The following characters cannot be used in filenames:
" ( ) * , / : < > ? \ |The maximum length allowed by the Cisco CRS-1 router for a filename is 254 characters including the path. If a filename longer than 254 characters is specified, the filename is truncated to 254 characters.
To copy a file from a source on the router to a destination on the router, specify a source location node-id and a destination location node-id. To copy the file to all nodes, use the keywords location all.
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
Table 28 describes the network protocols supported by Cisco IOS XR software.
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:
•
•
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).
The syntax is as follows:
copy tftp://hostname | ipaddress/directory-path/pie-name target-device [location node-id | location all]
Example:
RP/0/RP0/CPU0:router# copy tftp://1.1.1.1/images/crs_software.pie disk1:
Note
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:
1.
The syntax is as follows:
copy ftp://username:password@hostname or ipaddress/directory-path/pie-name target-device [location node-id | location all]
Example:
RP/0/RP0/CPU0:router# copy ftp://john:secret@10.1.1.1/images/crs_software.pie disk1:2.
3.
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:
1.
2.
3.
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 Rtr1ip rcp remote-username User0If 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 Rtr1See 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.
Table 29 shows the syntax and example for the copy command when used with FTP, rcp, and TFTP network servers.
Using xml-schema
Use the xml-schema keyword to obtain the most up-to-date XML schemas (.xsd files) from the router. This 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 option 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 show configuaration failed command.
Task ID
Examples
The following example shows how to copy a file from a FTP server to disk1:
RP/0/RP0/CPU0:router# copy ftp://john:secret@10.1.1.1/images/comp-crs-full.pie disk1:Related Commands
Changes the default directory or file system.
Displays the contents of a file system.
Displays information about a configuration that failed during the last commit.
delete
To delete files, use the delete command in EXEC or administration EXEC mode.
delete [/noprompt] [/ena] [filesystem:] filename {location node-id | location all}
Syntax Description
Defaults
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 EXECCommand History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
When a file is deleted, it is removed from the system and cannot be restored (undeleted).
Use the dir command to display the list of files on a storage device.
Task ID
Examples
The following example shows how to delete a file:
RP/0/RP0/CPU0:router# delete rbtestDelete disk1:/rbtest[confirm]yRelated Commands
dir
To display a list of files on a file system or in a specific directory, use the dir command in EXEC or administration EXEC mode.
dir [/all | /ena | /recurse] [filesystem:] [filename] {location node-id | location all}
Syntax Description
Defaults
When the dir command is entered without keywords or arguments, the contents of the present working directory are displayed.
Command Modes
EXEC
Administration EXECCommand History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
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
Examples
The following example shows how to display the contents of a directory:
RP/0/RP0/CPU0:router# dir harddisk:/logDirectory of harddisk:/log5527 drwx 4096 Thu Aug 28 11:21:48 2003 boot_28_Aug_2003_11_21_495533 drwx 4096 Thu Aug 28 11:38:54 2003 boot_28_Aug_2003_11_38_545538 drwx 4096 Fri Sep 5 13:28:54 2003 boot_05_Sep_2003_13_28_545543 drwx 4096 Mon Sep 8 08:55:52 2003 boot_08_Sep_2003_06_59_08--More--Related Commands
Changes the default directory or file system.
Displays the current working directory of the cd command.
Displays the layout and contents of a file system.
erase nvram:
To erase the NVRAM file system, use the erase nvram: command in EXEC mode.
erase nvram: [format]
Syntax Description
Defaults
No default behavior or values
Command Modes
EXEC
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Caution
Task ID
Examples
The following example shows how to erase the NVRAM file system:
RP/0/RP0/CPU0:router# erase nvram:Erase operation will destroy IOS/ENA files in "nvram:":. Continue? [confirm]yRelated Commands
erase nvram-raw:
To format the NVRAM raw data partition with a `0' value, use the erase nvram-raw: command in EXEC or administration EXEC mode.
erase nvram-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.
Defaults
No default behavior or values
Command Modes
EXEC
Administration EXECCommand History
Release 3.6.0
This command was introduced on the Cisco CRS-1 and Cisco XR 12000 Series Router.
Release 3.7.0
No modification.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
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
Examples
The following example shows how to erase the raw data partition of the NVRAM file system:
RP/0/RP0/CPU0:router# erase nvram-raw:Related Commands
format
To format a file system, use the format command in EXEC or administration EXEC mode.
format filesystem: [partition] [monlib-filename] [location node-id | all] [spare spare-number] [force] [recover]
Syntax Description
Defaults
The default monlib file is the one included with the Cisco IOS XR software.
spare-number: 0Command Modes
EXEC
Administration EXECCommand History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Before you can use a new flash memory card, you must format it.
Caution
Note
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.
As of Cisco IOS XR Release 3.6.0, 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.
If you partition disk0:, disk1: or the compactflash:, the size of the partitions are as indicated in Table 30:
The size of the three hard disk partitions are as follows:
•
•
•
Task ID
Examples
The following example shows how to format disk1:
RP/0/RP0/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/RP0/CPU0:router# format disk1: recoverThis format operation will try to recover sectors with read errorThis operation may take a while. Continue? [confirm]Format will destroy all data on "disk1:". Continue? [confirm]
Note
Related Commands
fsck
To check a file system for damage, use the fsck command in EXEC or administration EXEC mode.
fsck filesystem: [location node-id]
Syntax Description
Defaults
No default behavior or values
Command Modes
EXEC
Administration EXECCommand History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Task ID
Examples
The following example shows how to check the file system on flash disk0: for damage:
RP/0/RP0/CPU0:router# fsck disk0:Phase 1 - Read and compare FATsPhase 2 - Check cluster chainsPhase 3 - Check directoriesPhase 4 - Check for lost files157280 kb used, 843344 kb free, 2541 files, 190 directoriesFilesystem is clean.Related Commands
mkdir
To create a new directory on a file system, use the mkdir command in EXEC or administration EXEC mode.
mkdir filesystem: [location node-id | location all]
Syntax Description
Defaults
No default behavior or values
Command Modes
EXEC
Administration EXECCommand History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
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
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.
RP/0/RP0/CPU0:router# mkdir harddisk:Create directory filename []?newdirCreated dir harddisk:/newdirRP/0/RP0/CPU0:router# dir harddisk:Directory of harddisk:11193 drwx 4096 Fri Feb 13 06:45:05 2004 newdir37146 drwx 4096 Sun Dec 14 15:30:48 2003 malloc_dump43030 drwx 4096 Wed Dec 24 11:20:52 2003 tracebacks43035 drwx 4096 Thu Jan 8 18:59:18 2004 sau51026 drwx 4096 Sat Dec 27 02:52:46 2003 tempA51027 drwx 4096 Sat Dec 27 02:04:10 2003 dir.not.del-430307552 -rwx 342 Fri Jan 16 10:47:38 2004 running-config-430305504 -rwx 39790 Mon Jan 26 23:45:56 2004 cf.dat39929724928 bytes total (39883231232 bytes free)Related Commands
Displays the contents of a file system.
Removes an existing directory in a flash file system.
pwd
To display the present working directory, use the pwd command in EXEC mode.
pwd
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values
Command Modes
EXEC
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Use the pwd command to show what directory or file system is specified as the default by the cd command.
Task ID
Examples
The following example shows how to display the present working directory:
RP/0/RP0/CPU0:router# pwddisk0:/usrRelated Commands
Changes the default directory or file system.
Displays the contents of a file system.
rmdir
To remove an existing directory, use the rmdir command in EXEC or administration EXEC mode.
rmdir filesystem: {location node-id | location all}
Syntax Description
Defaults
No default behavior or values
Command Modes
EXEC
Administration EXECCommand History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
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
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.
RP/0/RP0/CPU0:router# rmdir harddisk:Remove directory filename []?newdirDelete harddisk:/newdir[confirm]yRP/0/RP0/CPU0:router# dir harddisk:Directory of harddisk:37146 drwx 4096 Sun Dec 14 15:30:48 2003 malloc_dump43030 drwx 4096 Wed Dec 24 11:20:52 2003 tracebacks43035 drwx 4096 Thu Jan 8 18:59:18 2004 sau51026 drwx 4096 Sat Dec 27 02:52:46 2003 tempA51027 drwx 4096 Sat Dec 27 02:04:10 2003 dir.not.del-430307552 -rwx 342 Fri Jan 16 10:47:38 2004 running-config-430305504 -rwx 39790 Mon Jan 26 23:45:56 2004 cf.dat39929724928 bytes total (39883235328 bytes free)Related Commands
Deletes a file from a flash memory device.
Displays the contents of a file system.
Creates a new directory on a flash file system.
show filesystem
To display the layout and contents of file systems, use the show filesystem command in EXEC or administration EXEC mode.
show filesystem filesystem: [firmware | stats | verbose level] [location node-id | location all]
Syntax Description
Defaults
The file system for the active RP is displayed.
Command Modes
EXEC
Administration EXECCommand History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Use the show filesystem command to learn the alias names (prefixes) of the file systems supported by your networking device.
Task ID
Examples
The following is sample output from the show filesystem command:
RP/0/RP0/CPU0:router# show filesystemFile Systems:Size(b) Free(b) Type Flags Prefixes- - network rw qsm/dev/fs/tftp: tftp:- - network rw qsm/dev/fs/rcp: rcp:- - network rw qsm/dev/fs/ftp: ftp:39929724928 39852978176 harddisk rw harddisk:1024606208 863584256 flash-disk rw disk0:2092032 2059264 nvram rw nvram:62390272 62381260 flash rw bootflash:The following is sample output from the show filesystem command using the optional location keyword and node-id argument:
RP/0/RP0/CPU0:router# show filesystem location 0/rp0/cpu0File Systems:Size(b) Free(b) Type Flags Prefixes- - network rw qsm/dev/fs/tftp: tftp:- - network rw qsm/dev/fs/rcp: rcp:- - network rw qsm/dev/fs/ftp: ftp:39929724928 39883235328 harddisk rw harddisk:2092032 2019328 nvram rw nvram:1024606208 847888384 flash-disk rw disk0:62390272 62153616 flash rw bootflash:Table 31 describes the significant fields shown in the display.
show media
To display the current state of the disk storage media, use the show media command in EXEC or administration EXEC mode.
show media [location node-id | location all]
Syntax Description
Defaults
The disk storage media for the active RP is displayed.
Command Modes
EXEC
Administration EXECCommand History
Release 3.6.0
This command was introduced on the Cisco CRS-1 and Cisco XR 12000 Series Router.
Release 3.7.0
No modification.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Use the show media command to view the status of the storage media on your system.
Task ID
Examples
The following sample output disk displays the disk storage media for the active RP:
RP/0/RP0/CPU0:router# show mediaMedia Information for 0/RP0/CPU0.Mountpoint FsType State DrvrPid Mirror Flags======================================================================/disk0: FAT16 Mounted 0024598 Enabled/disk0a: FAT16 Not Present/disk1: FAT16 Mounted 0024599/disk1a: FAT16 Not Present/harddisk: FAT32 Mounted 0143421/harddiska: FAT32 Not Present/harddiskb: FAT32 Not PresentThe following sample output displays the disk storage media on all nodes:
RP/0/RP0/CPU0:router# show media location allMedia Information for 0/4/CPU0.Mountpoint FsType State DrvrPid Mirror Flags======================================================================/disk0: FAT16 Mounted 0024598 Enabled/disk0a: FAT16 Not Present/disk1: FAT16 Not Present/disk1a: FAT16 Not Present/harddisk: FAT32 Mounted 0061493/harddiska: FAT32 Not Present/harddiskb: FAT32 Not PresentMedia Information for 0/4/CPU1.Mountpoint FsType State DrvrPid Mirror Flags======================================================================/disk0: FAT16 Mounted 0024598 Enabled/disk0a: FAT16 Not Present/disk1: FAT16 Not Present/disk1a: FAT16 Not Present/harddisk: FAT32 Mounted 0036919/harddiska: FAT32 Not Present/harddiskb: FAT32 Not PresentMedia Information for 0/RP0/CPU0.Mountpoint FsType State DrvrPid Mirror Flags======================================================================/disk0: FAT16 Mounted 0024598 Enabled/disk0a: FAT16 Not Present/disk1: FAT16 Mounted 0024599/disk1a: FAT16 Not Present/harddisk: FAT32 Mounted 0143421/harddiska: FAT32 Not Present/harddiskb: FAT32 Not PresentMedia Information for 0/RP1/CPU0.Mountpoint FsType State DrvrPid Mirror Flags======================================================================/disk0: FAT16 Mounted 0024598 Enabled/disk0a: FAT16 Not Present/disk1: FAT16 Mounted 0024599/disk1a: FAT16 Not Present/harddisk: FAT32 Mounted 0131133/harddiska: FAT32 Not Present/harddiskb: FAT32 Not PresentTable 32 describes the significant fields shown in the display.
Related Commands
Configures disk mirroring on a node.
Temporarily pauses disk mirroring on a node.
squeeze
To permanently erase files tagged as "deleted" or "error" on a flash file system, use the squeeze command in EXEC mode.
squeeze filesystem:
Syntax Description
Defaults
No default behavior or values
Command Modes
EXEC
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
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
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
Examples
The following example shows how to permanently erase files tagged as "deleted" or "error" on the bootflash file system:
RP/0/0/CPU0:router# squeeze bootflash:All deleted files will be removed. Continue? [confirm] ySqueeze operation may take a while. Continue? [confirm] ySqueeze under progress 30Squeeze of bootflash: completeRelated Commands
Deletes a file from a flash memory device.
Displays the contents of a file system.
Recovers a file marked "deleted" on a flash file system.
undelete
To recover a file marked "deleted" on a flash file system, use the undelete command in EXEC mode.
undelete index filesystem:
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.
Defaults
The default file system is the one specified by the cd command.
Command Modes
EXEC
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
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
Examples
The following example recovers the deleted file whose index number is 1 on the bootflash file system:
RP/0/0/CPU0:router# undelete 1 bootflash:Related Commands
unmount
To render a media device safe to be removed, use the unmount command in EXEC or administration EXEC mode.
unmount filesystem: [location node-id] [undo]
Syntax Description
Defaults
No default behavior or values
Command Modes
EXEC
Administration EXECCommand History
Release 3.6.0
This command was introduced on the Cisco CRS-1 and Cisco XR 12000 Series Router.
Release 3.7.0
No modification.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
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
Examples
The following example unmounts the disk0: file system so that it can be safely removed:
RP/0/0/CPU0:router# unmount disk0:Related Commands
