Performing a single-file restore

Contributors Download PDF of this page

You can use the IBM Domino plug-in to perform point-in-time, up-to-the-minute, or selectable up-to-the-minute single-file restores for databases in NFS environments.

You must set the Data Restore Directoryparameter in the configuration file to the correct subdirectory on the Domino data volume.

Note You do not have to stop the Domino server for a single-file restore.

Single-file restore options are as follows:

Restore type Description

Single-file restore (point-in-time)

Restores a single file to its state at the time of the Snapshot copy (NFS only).

Single-file restore (up-to-the-minute)

Restores a single file to its state at the time of the Snapshot copy, then plays forward Domino transaction logs to the most recent copy (NFS only).

Single-file restore (selectable up-to-the-minute)

Restores a single file to its state at the time of the Snapshot copy, then plays forward Domino transaction logs to a specified time (NFS only).

Note For up-to-the-minute and selectable point-in-time restores, Domino transaction logging must be enabled.

Transaction logs can only be played forward. Selecting a time before the Snapshot copy was created causes a restore error.

  1. In the Profiles and Configurations pane, select the configuration file, and then click Actions > Restore.

    Selecting Restore automatically launches the Snap Creator Framework Restore wizard. Throughout the Restore wizard, click Next to advance to the next page and click Back to return to the previous page.

    Note If you are restoring from a SnapVault copy, you are prompted to restore from primary or secondary storage. Your selection depends on how you are handling the limitation described in concept_domino_database_restore_overview.md#GUID-4D864E27-DE54-43BF-9B9F-EF2F240F65D9.
  2. On the Restore details page, specify the restore details:

    For this field…​ Do this…​

    Controller/Vserver name

    Select the SVM on the storage system you want to restore from.

    Restore volume name

    Select the volume you want to restore from.

    Policy

    Select the policy for the backup you want to restore from.

    Snap Creator Snapshot Copies/All Snapshot Copies

    Leave the default.

    Restore Snapshot copy name

    Select the Snapshot copy you want to restore from.

    Restore type

    Select Single File Restore.

  3. On the following page, select the file you want to restore.

    The file is displayed with its full path name in the Source path field.

    Tip Copy the path name to your clipboard for later use.
  4. On the following page, select the directory to which you want to restore the file.

    The name of the parent subdirectory for the file must be identical to the name of the parent subdirectory in the source path. If, for example, the source path is /domino/data/mail/user1.nsf, the restore path is /domino/data/restore/mail/user1.nsf.

    The directory is displayed with its full path name in the Destination path field.

  5. On the following page, specify the single-file restore type:

    For this field…​ Do this…​

    Restore Type

    Click the single-file restore type. If you choose Selectable up the minute, new fields are displayed where you can specify the date and time to which you want to play forward Domino transaction logs. Click Ignore Validation if the time on the Snap Creator Server does not match the time on the storage controller.

    Disable Replication

    Select this box to set a new Domino replica ID for the restored database file.

  6. Review the summary, and then click Finish.

  7. In the Single File Restore dialog, click OK.

    Snap Creator starts the restore job. Job information is displayed in the Console pane.