Restore from a Snapshot

If something goes wrong, you can easily restore your content to a previous working state from a snapshot. You also restore snapshots when you migrate content between environments.

Before you start, read these tips about restoring snapshots.

• As you start to restore the snapshot, users currently signed in have their session terminated.

• After you restore from a snapshot, allow time for the restored content to refresh (for example, approximately 15 to 30 minutes for a large snapshot).

• Delivery schedules aren’t automatically restored or activated when you restore catalog content from a snapshot. This is so you can restore and activate deliveries at a time that suits you. See Restore and Enable Delivery Schedules.

• You can restore snapshots taken at the same version (or earlier version) as the target environment. For example, if you take a snapshot of an Oracle Analytics environment that includes the May 2022 update, you can restore it on other Oracle Analytics environments that include the May 2022 update or a later update (such as July 2022).

  You might experience unexpected results if you try to restore from a snapshot that was taken from a more recent update of Oracle Analytics. For example, if you take a snapshot of an Oracle Analytics environment that includes the September 2022 update, don't restore this snapshot in Oracle Analytics environments that include an earlier update, such as June 2022.

• When you restore a snapshot taken from a different environment, you must upload the data associated with your file-based datasets to the target environment.

• You can take and restore snapshots using the Console or REST API. The Snapshots page in the Console lists the snapshots that you take using the Console. Snapshots that you take and register using the REST API don't display in the Snapshots page. See Manage Snapshots using REST APIs.

To restore a snapshot:

1. Click Console.
2. Click Snapshots.
3. Select the snapshot that you want to use to restore your system.
4. Click Snapshot Actions .
5. Click Restore to return your system to the state when this snapshot was taken.
6. In the Restore Snapshot dialog, select only those elements you want to restore.

   For example, you may not want to include application roles if you’re restoring a snapshot taken from a pre-production environment, to a production environment. Pre-production roles often have different members to the production environment. If so, select Custom and deselect Application Roles before you restore.

   1. Select the Restore option you want.
      • Replace Snapshot Content Only - Replace all the content types included in snapshot (listed in the description field) with the content inside the snapshot.

        The restore process replaces entire content types on the target. For example, if your target includes workbooks A and B and the snapshot contains workbook A, only workbook A will exist on the target after you restore the snapshot.

        Select this option if you don't want to replace or remove any other content types that exist on the target, that is, only replace the content types inside the snapshot.

      • Replace Everything - Overwrite all your existing content. Replace your existing content with the content included in this snapshot (listed in the description field).

        Any content types not included in the snapshot, excluding file-based datasets, plug-ins and extensions, are removed and restored with default settings.

      • Custom - Select only the content types you want to restore. You can restore with content saved inside the snapshot or restore content with default settings if that content is missing from the snapshot.

        • Content saved inside the snapshot is listed in the description field.
        • Content not included in the snapshot is marked with a warning icon . Only restore content marked with a warning icon if you want to restore that content with default settings.

        If you don’t want to restore everything, deselect all the items you want to keep.

   2. If you select Custom, select only those items you want to restore.
7. For auditing purposes, enter the reason why you’re restoring.

   It's good practice to include a restore reason. Later on you might want to analyze the restore history, and this information can help you remember why you restored the snapshot.

8. Click Restore.

   A warning message is displayed because restoring a snapshot can be very disruptive.

9. Click Yes to restore the selected snapshot, or click No to abandon the restore.
10. Wait for the restore to complete, and then wait a few more minutes for the restored content to refresh through your system.
    The time it takes to restore your system depends on the size of your snapshot. For a large snapshot, allow approximately 15 to 30 minutes.
11. Sign out and then sign back in to see the restored content and inherit newly restored application roles, if any.