Map File Format for File System Restores

The map file is a comma separate value (CSV) file type that contains 2 entries per line:

  • The source file, or location

  • The destination file, or location

Note

If the destination file path does not exist when you start the restore, the Commvault software creates the file path when it runs the restore.

The file format is:

"source_path_folder", "destination_path_folder"

There must be no whitespaces between the quotes and the comma.

The table lists the valid map file entries:

Mapping

Type

source_folder_path

Value:

destination_folder_path

Value:

UNIX

Example

Windows

Example

Additional Information

File to file

The source file absolute path

Thee destination file absolute path

"/dir1/file1.txt","/dir2/file1.txt"

"C:\dir1\file1.txt","E:\dir2\file1.txt"

Directory to directory

The source file absolute path

Thee destination file absolute path

"/dir2/info/","/dir4/info/"

"C:\dir2", "C:\dir2"

Drive to drive

The source drive

The destination drive

"/"(root),"/mnt","/usr"

"C:\", "E:\"

Rename a file, or a folder when you restore it

The source file, or folder

The new file name, or folder

"/dir4/file2.txt","/dir5/file3.txt"

"C:\dir4\file2.txt","F:\dir5\file3.txt"

Filter a file

The source file

leave it blank

"/dir5",""

"C:\dir5"

Windows file to file mapping, with UNC path for source to UNC path for destination

The source file

Prefix the path with UNC-NT.

The destination file

Do not include UNC-NT as a prefix on the path.

Prefix the path with \\.

N/A

"UNC-NT_Filer\Share\source2","\\Filer\Share\destination2"

Windows source file that has a UNC path for the source

The source file

Add UNC-NT as a prefix on the path.

The destination file

N/A

"UNC-NT_Filer\Share\source2","E:destination2"

Unix Raw Device to Raw Device

The source device file, for example, /dev/dm-2.

The destination device file, for example, /dev/dm-3.

cat map.txt –
"/dev/mapper/vg01-lv01",""
"/dev/dm-2","/dev/dm-3"

N/A

Before you perform the restore operation, verify that the destination device is in unmounted state.

Loading...