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 – |
N/A |
Before you perform the restore operation, verify that the destination device is in unmounted state. |