Migrate Oracle Analytics Cloud Using Snapshots
Download and upload features enable you to save snapshots to your local file system and upload them back to the cloud. Use these features to migrate content between two different services, migrate between development, test, and production environments, and migrate service deployed on Oracle Cloud Infrastructure Classic to Oracle Cloud Infrastructure.
About Oracle Analytics Cloud Migration
It's easy to migrate content and settings from one Oracle Analytics Cloud environment to another using snapshots. You can migrate everything or you can migrate specific types of content.
Prerequisites for Migration
-
The source and target environment must both use Oracle Analytics Cloud 5.1.x or later. Snapshots taken from earlier versions don't capture the entire environment.
If you're not sure, ask your Oracle representative.
-
If you haven't done so already, create the target service on Oracle Cloud Infrastructure.
See Create a Service with Oracle Analytics Cloud in Administering Oracle Analytics Cloud on Oracle Cloud Infrastructure (Gen 2).
-
If you want to migrate file-based data, check the source and target environments are up and running, and configured with valid storage credentials.
Storage access issues can prevent data file migration using snapshots. If this happens, you can use the Data Migration utility to download your data files and then upload them separately.
Items Not Migrated
Some Oracle Analytics Cloud artifacts aren’t included in snapshots. Non-Oracle Analytics Cloud artifacts aren't included either.
Items Not Migrated | More Information |
---|---|
Virus scanner configuration | Record the virus scanner configuration used in your source environment and use the same information to configure your virus scanner on the target. See Configure a Virus Scanner. |
Mail server configuration | Record the SMTP mail server configuration used in your source environment and use the information to configure your mail server on the target. See Set Up an Email Server to Deliver Reports. |
Other saved snapshots in the source environment |
If required, download individual snapshots that you want to migrate, and then upload them to the target. See Import Snapshots. |
Users (and groups) |
Migrate from Oracle Cloud Infrastructure Identity and Access Management (IAM) Identity Domain Use export and import features in Oracle Cloud Infrastructure Console to migrate users and roles from one identity domain to another. See Transferring Data in Oracle Cloud Infrastructure documentation. Migrate from Oracle Identity Cloud Service Use export and import features in Oracle Identity Cloud Service Console to migrate users and roles from one identity domain to another. See Manage Oracle Identity Cloud Service Users and Manage Oracle Identity Cloud Service Groups. Migrate from Embedded WebLogic LDAP Server Use the script |
Identity management configuration |
Use Oracle Cloud Infrastructure Console in your target environment to reconfigure any user (or group) application role assignments that you configured on the source, reconfigure single sign-on (SSO), and so on. |
Network configuration | Set up your network requirements in the target environment, as required. |
Typical Workflow to Migrate Oracle Analytics Cloud
You use snapshots to migrate Oracle Analytics Cloud to another environment. Here's what you need to do.
Task | Description | More Information |
---|---|---|
Understand how to migrate using snapshots | Understand what you can and can't migrate in snapshots and any prerequisites. | |
Create the target service | Use Oracle Cloud Infrastructure Console to deploy a new service on Oracle Cloud Infrastructure. | |
Migrate users and groups |
Use export and import features in Oracle Cloud Infrastructure Console to migrate users and roles from one identity domain to another. The way you migrate users for Oracle Analytics Cloud depends whether identity domains are available in your cloud account. If you're not sure, see About Setting Up Users and Groups. If your source system uses an embedded WebLogic LDAP server for
identity management, use the |
|
Take a snapshot on the source |
Capture the content you want to migrate on the source system. |
|
Export the snapshot |
Download the snapshot that you want to migrate to your local file system or to a storage bucket on Oracle Cloud Infrastructure. |
|
Upload the snapshot to the target |
Sign in to the target system and upload the snapshot. |
|
Restore the snapshot content |
Select the newly uploaded snapshot in the list of saved snapshots and restore the content in the snapshot. |
|
Migrate data files |
Use the Data Migration utility to migrate data files from one environment to another. Only required when:
|
|
Reconfigure your virus scanner | Record the virus scanner configuration in your source environment and use it to configure your virus scanner on the target. | |
Reconfigure your mail server |
Record the SMTP mail server configuration in your source environment and use it to configure your mail server on the target. |
|
(Optional) Migrate other snapshots | Download individual snapshots that you want to migrate and then upload them to your target environment, as required. | |
Migrate identity management configuration | Use Oracle Cloud Infrastructure Console in your target environment to reconfigure any user (or group) application role assignments that you configured on the source, reconfigure single sign-on (SSO), and so on. |
Migrate File-based Data
Users upload data files, such as spreadsheets, to Oracle Analytics Cloud to create datasets. When you migrate to a new Oracle Analytics Cloud environment, you can take this file-based data with you. Sometimes, network connectivity or storage access issues might prevent you from migrating the data files in the snapshot. For such cases, Oracle Analytics Cloud offers a CLI utility (command-line interface) that enables you to move your data files to the new location. The snapshot CLI utility also moves any map-related plug-ins and extension files that users might upload for their data visualizations.
Restore
succeeded with errors - data restore failed
(or similar) when you try to restore
a snapshot that contains data files. This message occurs when:
- You migrate content from a different region.
- You migrate content from Oracle Analytics Cloud on Gen 1 or Oracle Cloud Infrastructure Classic to Oracle Analytics Cloud on Gen 2.
- The restore process fails due to some other network connectivity or storage access issue.
The CLI utility allows you to move data files directly from one environment to another in a single step. Or if you prefer, you can download your file-based data to a ZIP file and then upload the data files to your chosen environment in two separate steps.