Before you Begin

This 10-minute tutorial shows you how to create a snapshot of your Oracle Analytics Cloud environment and migrate the snapshot content using download, upload, and restore.

Background

Snapshots capture the state of your Oracle Analytics Cloud environment at point in time. You can use snapshots for backup and restore, to test the production environment, and to move or clone your Oracle Analytics application. If something goes wrong, you can roll back to a saved point-in-time by restoring a snapshot.

In this tutorial, you take a snapshot to capture content from one Oracle Analytics Cloud environment to migrate to another Oracle Analytics Cloud environment. This tutorial shows you how to use a snapshot to migrate, for example, from a pre-production environment to your production environment.

Restore overwrites existing content. Everything that you select is overwritten. Any content that you choose not to restore remains the same. Allow a few minutes for restored content to refresh through your system. For a large snapshot, allow approximately 15 to 20 minutes.

What Do You Need?

  • Oracle Analytics Cloud 105.x or later for both source and target environments
  • Service Administrator credentials on both environments

Create a Snapshot

In this section, you create a snapshot of the source environment that you want to migrate. You can create the snapshot of everything or select specific artifacts using the custom option.

  1. Sign in to the Oracle Analytics Cloud environment that you want to migrate with your service administrator credentials.
  2. On the Home Page, click Navigator Navigator icon, and click Console.
  3. In Console under Management and Administraion, click Snapshots.
  4. In Snapshots, click Create Snapshot.
  5. In Create Snapshot, enter a Name for the snapshot. From the Include list, select Everything, and then click Create.


    If you select Custom from the Content list, you can select the artifacts to include in the snapshot.

Download the Snapshot

  1. In Snapshots, select the snapshot to use for the migration to the production environment, click Snapshot actions menu Snapshot action menu icon, and then select Export.
  2. In Export Snapshot, enter a Snapshot Password, using 8 to 50 characters with an uppercase character, number, and a special character. In Confirm password, enter the same password, and then click Download.

    You need to use this password to import the snapshot to the target Oracle Analytics Cloud environment.

  3. In Opening bar_file_name.bar, with Save File selected, click OK.

    Export saves the snapshot bar file in your designated default download location.

Import the Snapshot

  1. Sign in to the target Oracle Analytics Cloud environment with your service administrator permissions.
  2. On the Home Page, click Navigator Navigator icon, and then click Console.
  3. In Console under Management and Administraion, click Snapshots.
  4. Click Snapshot actions menu Snapshot Actions icon, and click Import Snapshot.
  5. If the message, "No Virus Scanner Found" displays, click Proceed without a virus scanner.

    Oracle highly recommends that you set up the virus scanning servers used by your organization to scan any files that are uploaded to Oracle Analytics Cloud.

  6. In Import Snapshot, click Select, and then locate the snapshot bar file that you downloaded to your computer. In Snapshot Password, enter the password you used to create the snapshot, and then click Import.

Restore the Snapshot

In this section, use the custom restore option to move the elements that you need and exclude those that you want to keep in the target environment.

  1. In Snapshots, select the snapshot you created for migrating the content, click Snapshot actions menu Snapshot Actions icon, and then click Restore.
  2. In Restore Snapshot, enter a brief description in Restore Reason such as "migrating content from pre-production environment."
  3. From the Restore list, select Custom. Deselect Connection Parameters and User Folders to exclude these items, and then click Restore. In Restore Snapshot, click OK.

Learn More