> CommCell Console > Backup and Restore Agents > Backup Agents > IBM i Agent > Restores

Performing a Restore by Using a Map File

Use a map file when you have a list of files to restore when:

  • Each file has a different destination

  • A subset of the files have different destinations

Best Practice: Use a map file when the number of files that you want to restore is more than 10 files, and at least half of the files that you want to restore have different restore destinations.

Before You Begin

Create the map file on the access node assigned to the destination IBM i client.

Procedure

  1. From the CommCell Browser, expand Client Computers> client> File System > backup_set.

  2. Right-click the subclient, point to All Tasks and then click Browse and Restore.

  3. On the Browse and Restore Options dialog box, select Latest Backup and then click View Content.

  4. Optional: Use non-default Browse and Restore options. See Browse and Restore.

  5. From the Browse window, select the data to restore in the right pane and then click Recover All Selected.

    The Restore Options dialog box appears.

  6. On the General tab, make the following selections:

    1. From the Destination Client list, select the restore destination computer.

    2. Select the restore options.

      For more information about general restore options, see Restore/Recover Options (General).

    3. Click Advanced.

      The Advanced Restore Options dialog box appears.

  7. On the Map tab, select the map file options.

    1. Select the Use map file check box.

    2. In the Map File Path box, type the full path name to the map file.

    3. Select whether to restore unmapped files.

      • To restore all the files to a different destination, clear the Restore unmapped file check box.

      • To restore a subset of the file to a different destination, select the Restore unmapped file check box .

    4. To add a suffix to each file that you restore, select the Rename all restore files with suffix check box.

      On Windows, the suffix is added before the file type extension.

      On UNIX and Mac, the suffix is added after the file type extension.

  8. Optional: Select the advanced restore options.

    Option

    Parameter

    Restore the deleted items

    1. On the Browse Options tab, select the Restore deleted items check box.

    2. Select the Specify Time Range check box.

    3. Select the Start Time and End Time check boxes and then enter the time range for the deleted files.

    Exclude files and directories from the restore

    1. On the Paths/Filters Options tab, in the Filter Item section:

      1. Click the Add button.

      2. Enter the file, or directory that you want to exclude. You can use wildcards to specify the path, or file.

        For information on the supported wildcards, see Supported Wildcards for the IBM i Agent.

      3. Click OK.

    Restore the private authority with the object

    On the General tab, select the Restore Private authority (PVTAUT) check box.

    Restore the spool files.

    On the General tab, select the Restore Spooled file data (SPLFDTA) check box.

    Allow object differences

    On the General tab, select the Allow object differences (ALLOWOBJDIF) check box and one of the following options:

    None

    There can be no difference between the saved data and the restored data.

    *ALL

    Allow all differences between the saved data and the restored data.

    Note: This option does not guarantee compatibility with the existing databases, so you may need to correct the database after the restore.

    *COMPATIBILE

    Allow differences that are compatible with the existing databases.

    Note: This option is available only when the operating system is version V7Rx or later.

    Best Practice: Use this option instead of *ALL because it guarantees compatibility with the existing databases.

    Other

    Allow a combination of the following parameter differences:

    *AUTL

    Allow authorization list differences.

    *FILELVL

    Allow file level ID and member level ID differences.

    *OWNER

    Allow file ownership differences.

    *PGP

    Allow primary group differences.

    Convert the user objects to the format that the current operating system version requires or to be compatible with the current machine.

    On the General tab, select an option from the Force Object Conversion list.

    *SYSVAL

    Convert the objects by using the QFRCCVNRST system value.

    *NO

    Prevent the user options from being converted.

    *YES*RQD

    Convert the user objects that must be converted to be compatible with the current machine.

    *YES*ALL

    Convert all the user objects.

  9. Click OK to close the Advanced Restore Options dialog box .

  10. Click OK to close the Restore Options dialog box and start the restore.

To monitor the progress of the restore job, see Job Controller.

To view the job history, see Job History.

×

Loading...