V11 SP8
Loading...

Performing an IBM i File System Agent Restore to a New Library, Directory or Folder

Use this procedure to restore files to a different folder from the source backup folder.

If you want to find and restore specific data, see Find.

Note: If you select more than one library to restore to a different single path, then the software restores all of the objects that are under the selected libraries to the same destination path. If this behavior is not your intention, perform an in-place restore to restore the data to the same library that you backed up, or select one library at a time and restore that library to a different library name.

About This Task

The operating system restrictions are applicable when you restore to a different location. For example

  • You cannot restore the system library "/QSYS.LIB" or its content to "/QDLS" or "/*". The same holds true if you try to restore "/QDLS" or "/*" to "/QSYS.LIB".
  • The restore of a library inside another library is restricted.
  • The restore of the journal object to a different library  is restricted.

Procedure

  1. From the CommCell Browser, expand Client Computers > client > Proxy 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 is displayed.

  6. On the General tab:
    1. Select the source computer from the Destination Client list.
    2. Clear the Restore to same folder check box
    3. In the Specify destination path box, type the new path that you want to restore the files to.
    4. Optional: Specify the path level restore options.
      • To specify the number of levels at the end of the source path, select the Preserve n levels from end of the source path check box.

        The default is 1 and keeps the lowest level.

        Note: If you use wildcards in the source path name, you must use the default value.

        For example,  if this value is set to 1, and the source path is \Documents\Memos\Sales, and the destination folder is temp, the data will be recovered to \temp\Sales.

      • To remove levels from the beginning of source path of the selected data, select the Remove n levels from beginning of the source path check box.

        The default is 1 and keeps the lowest level.

        For example, if this value is set to 1, and the source path is Documents\Memos\Sales, and the destination folder is temp, the data will be recovered to \temp\Sales.

  7. Optional: Select the advanced restore options.
    1. Click Advanced.

      The Advanced Restore dialog box appears.

      Option Parameter
      Restore to a different auxiliary storage pool (ASP) On the General tab:
      1. Select the ASP number from the Destination ASP list.

        Note: You do not need to set this configuration item when you restore to the IASP. You only need to supply the destination path. This is only applicable for the Library File System (LFS).

      2. Enter the destination path to restore the library/object.

      Example of non-IASP

      Destination ASP: 2

      Path: “/QSYS.LIB/XXXX.LIB”

      Example of IASP

      Path: “/IASP#/QSYS.LIB/XXXX.LIB”

      Restore the deleted items On the Browse Options tab:
      1.  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 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 file or directory.

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

      3. Click OK.
      Add a suffix to each file that you restore On the Maps tab, select the Rename all restore files with suffix check box.

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

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

      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 then select 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, from the Force Object Conversion list, select one of the following options:

      *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.

      Generate the job log output of the restored library file system objects. On the LOG Output tab, select whether the software creates a list that contains the information about the saved objects. You can print the information with the job's spooled output, or direct the information to a database file.

      If you select the option to direct the information to a database file, you can specify:

      • The database file where the output of the backup is directed
      • The database file member where the output of the backup is directed
      • How to handle the database member
      • the information that is printed or sent to the output file

      For a complete description of these options, see IBM i File System Agent Advanced Restore Options - Log Output.

      If you selected the "Library/Libraries" option, and you want to defer the restore of objects that depend on objects that are not yet available. Specify the identifier.

      On the General tab, in the Defer ID (DFRID) box, type the identifier to use.

      To complete a restore of the deferred objects, first restore the objects that they depend on, and specify the same Defer ID value. If any objects remain deferred when the other objects are available, use the Restore Deferred Objects (RSTDFROBJ) manually from the command line, and specify the same Defer ID value. Use this parameter to restore all objects in a set of libraries when you restore the libraries with dependent objects before the libraries with the objects they depend on. Deferred objects can be logical files, or SQL materialized query tables (MQTs). A deferred logical file is not created until the restore completes. A deferred MQT is created, but until the restore completes, any functions that are performed on the MQT and that require access to the based-on files fail.

      Notes

      If either of the following conditions are true, then the restore of a deferred object may be automatically completed when you restore the objects that it depends on.

      • You restore the deferred object to the library from which it was saved.
      • You specify the same Defer ID value for the restore operations for both the deferred object, and the objects that it depends on.

      The default value ,*NONE, means that objects are not restored or deferred if they depend on objects that are not available.

      Objects that are deferred during the restore are reported as failed, but the software can restore the objects during the next restore after the dependent objects are restored, when you manually run the “RSTDFROBJ <DFRID>” command that restores the dependent objects.

      Example

      If you use the Defer ID “CVDFRID” option during the restore of some dependent libraries/object, and then run the command “RSTDFROBJ DFRID(CVDFRID)” from IBM i command line after all the dependent libraries/objects restore jobs complete so that all the dependent objects (like logical files or SQL materialized query tables (MQTs) get restored.

      If you selected to restore a security object, select the authority information to restore On the General tab, from the Security data (SECDTA) list, select the authority information to restore.
      • *USRPRF: Restore the user profiles and their private authorities.
      • *PVTAUT: Restore the private authorities for the specified user profiles, and the auxiliary storage pools. The Restore Authority (RSTAUT) command uses this information to restore the authorities to the referenced objects.
      • *PWDGRP: Restore the specified user profiles, their private authorities, and their passwords and group linkages.
      • *DCM: Only restore the internal objects that the Digital Certificate Manager requires. The software does not restore any user profiles. If you select this value, then you must specify *NONE for the USRPRF parameter.
    2. Click OK to close the Advanced Restore Options dialog box.
  8. Click OK to close the Restore Options dialog box.

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

To view the job history, see Job History.