Learn about how to migrate your existing Oracle Analytics Cloud - Classic instances to Oracle Cloud Infrastructure using a snapshot.
This Guide describes how to migrate your content from Oracle Cloud Infrastructure - Classic to any region on Oracle Cloud Infrastructure, using a snapshot. An alternative tool called Application Migration is available from the Oracle Cloud Infrastructure console. Application Migration can discover your Oracle Analytics Cloud - Classic instances, create Oracle Analytics Cloud instances on Oracle Cloud Infrastructure, and migrate your content. Application Migration is available only in specific Oracle Cloud Infrastructure regions. To find out whether Application Migration is available in your region and how to use this tool, see Overview of Application Migration in the Oracle Cloud Infrastructure documentation.
About the Migration Scope
Before migrating Oracle Analytics Cloud - Classic instances to Oracle Cloud Infrastructure, consider the scope and constraints of this migration path.
- Migration scenarios covered in this Guide
Source Oracle Analytics Cloud - Classic instance: Data Visualization or Business Intelligence
Source Oracle Analytics Cloud - Classic instance: 5.3 or later
- Source identity management: Oracle Identity Cloud Service (Cloud accounts) or embedded LDAP server (traditional accounts)
- Target Oracle Analytics Cloud instance: 5.3 or later
- Not covered in the Guide
- Oracle Analytics Cloud - Classic instances deployed with Essbase
- Database migration
Migration scenarios covered in this Guide
With Oracle Analytics Cloud - Classic, you can deploy services with several different feature sets:
- Data Visualization
- Business Intelligence (includes Data Visualization)
This Guide only describes how to migrate services deployed with Data Visualization or Business Intelligence. Before you start migration, Oracle recommends that you patch your service on Oracle Cloud Infrastructure Classic with the latest available version. The migration tools you need aren't available in earlier versions.
You can verify the current version of your source and target environments in Oracle Cloud Infrastructure Console. If you're not sure, check with your administrator.
Not covered in this GuideThis Guide doesn’t describe how to migrate Oracle Analytics Cloud - Classic instances deployed with the Essbase or non-Oracle Analytics Cloud artifacts, such as associated databases, security configuration, and so on. You must migrate non-Oracle Analytics Cloud artifacts separately or re-create them on the target instance.
About the Migration Task Flow
You use migration tools to migrate Oracle Analytics Cloud - Classic instances on Oracle Cloud Infrastructure Classic to Oracle Cloud Infrastructure. Before you start the migration, you need to prepare and set up a target Oracle Analytics Cloud instance on Oracle Cloud Infrastructure. Here's what you need to do.
Prepare to Migrate
|Plan your new service||Plan your Oracle Analytics Cloud deployment on Oracle Cloud Infrastructure. Think about what you want before you start.|
|Complete your order and sign in to your Oracle Cloud account||
You must have a subscription for Oracle Analytics Cloud (or Oracle Analytics Cloud Subscription) to create services on Oracle Cloud Infrastructure.
As Cloud Account Administrator, you can complete all setup tasks.
|Migrate users and groups
|Reconfigure single-sign on||(Optional) If SAML Single Sign-on (SSO) is
configured in your source environment using
|Integrate Oracle Identity Cloud Service with other identity providers||
(Optional) Use Oracle Identity Cloud Service in your target environment to integrate with your identity provider. For example:
|Create a service on Oracle Cloud Infrastructure||Create an Oracle
Analytics Cloud instance with the required size and shape on Oracle Cloud
If you subscribe through Universal Credits, create the service with Oracle Analytics Cloud on Oracle Cloud Infrastructure (Gen 2).
If you have a non-metered subscription, create the service with Oracle Analytics Cloud Subscription.
|Verify your service||Verify that your service is up and running on Oracle Cloud Infrastructure and that you can sign in.||Verify Your Service and Sign In|
|Reconfigure connections to your data||
Update connection information on the target Oracle Analytics Cloud instance.
If your data is stored in a database on Oracle Cloud Infrastructure Classic you must move the data to Oracle Cloud Infrastructure.
|Connect to Your Data|
|Add the IP address of your service to allowlists||If you registered the IP address of your Oracle Analytics Cloud - Classic instances in any data source allowlists, you must perform this task again for the new Oracle Analytics Cloud instance on Oracle Cloud Infrastructure.||Find the IP or Host Name of Your Oracle Analytics Cloud Instance|
Migrate Your Service
|Understand snapshot options||Understand what you can include or exclude when you take a snapshot.|
|Check your target is ready for migration and take a backup||Verify that the required users and roles are available in your target service and take a snapshot in case you need to roll back.||Back Up Your Target Service Before Migration|
Take a snapshot of the source
Capture the content you want to migrate on the source system.
Download the snapshot locally
Download the snapshot that you want to migrate to your local file system.
|Edit database connections||
(Only if you migrated your data from Oracle Cloud Infrastructure Classic to Oracle Cloud Infrastructure)
Extract the data model file (RPD) from the snapshot (BAR), add the new connection string, and then upload the updated data model to the target system.
|Edit Connections and Upload Data Model|
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
(Only if the restore process fails due to connection issues)
Use the Data Migration utility to migrate and restore data files from another environment.
|Reconfigure data replication connections||
(Only if you migrated replicated data from Oracle Cloud Infrastructure Classic to Oracle Cloud Infrastructure)
Verify that the replicated tables and the required system tables exist on the new target database, and then edit the data replication connections to point to the new database.
|Reconfigure service settings||Verify various administrative settings on the target service.|
Disable deliveries on the source service and start delivering content from the target service.
|(Optional) Migrate other snapshots||Download individual snapshots that you want to migrate and then upload them to your target environment, as required.|
Complete Post-Migration Tasks
|Test the migrated service||Check the content you migrated is available on Oracle Cloud Infrastructure and everything works as you expect.||Test Your Migrated Service|
|Clean up services on Oracle Cloud Infrastructure Classic||Remove any resources that you don't need.||Clean Up Infrastructure and Platform Resources in Oracle Cloud Infrastructure Classic|
About the Migration Tools
You use a snapshot to migrate your Oracle Analytics Cloud - Classic instance to Oracle Cloud Infrastructure. In certain situations, you might also use the Data Migration Utility or Developer Client Tool.
- Snapshots: Migrates your content, file-based data, and settings from your Oracle Analytics Cloud - Classic instance to Oracle Cloud Infrastructure.
- Data Migration Utility: Migrates your file-based data to Oracle Cloud Infrastructure. Only required if network connectivity or storage access issues prevents data file migration with the snapshot.
- Developer Client Tool for Oracle Analytics Cloud: Download the latest client tool to modify connection information for your data models before you migrate to Oracle Cloud Infrastructure. Only required if you move your data from Oracle Cloud Infrastructure Classic to Oracle Cloud Infrastructure.