If you have Oracle Content and Experience instances running on OCI Classic, Oracle recommends that you migrate those instances to the new native OCI environment—Gen 2 OCI (that is, using Infrastructure Console to manage service instances). This will ensure that you’ll enjoy the benefits and advances of Oracle’s cloud platform in the future.
To initiate migration, you’ll need to perform a few steps prior to migration and work with Oracle Support to schedule the migration.
- Create a new instance of Oracle Content and Experience on OCI with Infrastructure Console. This will be the target instance your data will be migrated to. Do NOT use this instance until migration has been completed.
- If you're using a new Oracle Identity Cloud Service (IDCS) domain, migrate your users to the new domain using the IDCS user export and import features. Make sure to preserve the user names so that roles and permissions can be migrated appropriately as part of the migration process. In the exported CSV file, it's the "User Name" entry.
- Prepare for migration by collecting information you'll need for your service request and creating a list of any integrations you have for steps you'll need to take after migration.
- Submit a migration service request, and confirm the date and time of your migration.
- Watch the progress of the migration. Your service request will be updated as your migration progresses, and when it's done, you'll be asked to verify that your new instance is working as expected.
- Finalize the migration by completing any steps necessary to migrate any integrations that your instance has with other services or applications.
- Communicate the change to your users.
Prepare for Migration
You need to gather some information to prepare for migration:
- Make a note of the URL of the new instance (the target) you created, to include it in your migration request.
- Make a note the URL of your old instance (the source), to include it in your migration request.
- Make an inventory of all integrations that your old instance has with any other services or applications, either directly or through REST API calls. If there are any such integrations, then you’ll need to take some actions after the migration.
Submit a Migration Request
When you’re ready for your migration, you must submit a migration request to get the process started:
- Sign in to Oracle Cloud Support.
- Create a new service request.
- For the Problem Type, select Service Instance Migration, then choose From OCI-Classic to OCI-Native.
- Provide the following information in your service request:
- The URL of your source instance (the instance you’re migrating from)
- The URL of your target instance (the instance you’re migrating to)
- If you use Akamai delivered by Oracle, mention that so we can update the URLs in your Akamai configuration after migration
- Provide the preferred date you would like migration to start.
- Submit your service request.
After Oracle Support receives your migration service request, we'll schedule your migration based on the date you requested, and the service request will be updated with the date and time your migration will start.
- Confirm in the service request that you approve the migration start date and time.
Updates will be made to the service request to show how the migration is progressing. The data migration will be done at the back end; no action is required at your end other than to keep up with any service request updates, and to validate the migration after it's done.
The Migration Process
Here's what happens during the migration:
- Oracle Support updates the service request when migration begins.
Important:At this point, you must not make any changes to your old (source) instance. Any changes made after migration starts won't be migrated to your new instance.
- Your content and configuration data is exported from your old instance (the source), and imported into your new instance (the target).
- When the migration is complete, Oracle Support updates the service request, and you're asked to validate your new instance to make sure everything is working as expected.
- If you find any problems, note them in the service request. Oracle Support will work to resolve the issues, and will let you know through the service request when the instance is ready for validation.
- When everything is working as expected, note in the service request that you accept the migrated instance.
Note:The old instance will remain up for a while in case you need to refer back to it for any reason. After that time the instance will be terminated.
Finalize the Migration
If your old instance integrated or communicated with other services or applications, either directly or through REST API calls, you might need to perform post-migration tasks.
The following items apply service-wide:
- Credentials aren't migrated, so you'll need to reconfigure user credentials for all integrations that use them.
- The Oracle Content and Experience URL pattern is different, so you'll need to update the URLs in your integrations that use them.
The old URLs used the following pattern:
The new URLs used the following pattern:
|Integration||Things to Do After Migration|
|Oracle Commerce Cloud||
|Oracle Process Cloud Service||
|Oracle Eloqua Cloud Service||
|Oracle Policy Automation||
|Oracle Cobrowse Cloud Service||
|Visual Builder Cloud Service (VBCS)||
|REST API calls||
|Client SDK/CLI usage||
Note:Any bookmarks to content on your old instance will no longer work because the URL of your new instance has changed.