The Integration blog covers the latest in product updates, best practices, customer stories, and more.

Integration
October 26, 2018

How to migrate from ICS to OIC?

Muthu Palanisamy
Senior Director, Software Development

In this blog I'd like to show you how to migrate Metadata from an ICS (Integration Cloud Service) instance to OIC (Oracle Integration Cloud) instance. Metadata that will be migrated includes the following:

Integrations, Connections, Lookups, Libraries, Packages, Agent Groups, Custom Adapters etc.
- Integrations in any state (in-progress, activated etc) will be migrated.
- All resources such as Lookups, Connections that are not referenced by integrations also will be migrated.
Endpoint configuration (configured in connections).
Certificates.
Credentials stored in CSF store.
Settings such as Database, Notification.

The migration tool automates some of the below tasks that otherwise have to be done manually if using manual export and import:

Bulk export of all integrations along with their dependencies (such as Connections, Lookups etc) into a migration package.
Migration of endpoint configuration and credentials
Automatic replacement of host / port from source ICS instance to target OIC instance for "Integration calling Integration" use cases.
Automatic "Test Connection"
Automatic activation of previously activated integrations.

Enabling Migration in OIC

A feature flag has to be enabled in OIC to import content into OIC as part of migration. To turn on the feature flag, open a Service Request with Oracle support.

Migration Lifecycle

High level steps that need to be performed for the migration:

Create an object storage bucket in the underlying Oracle Cloud Infrastructure environment (If the migration target is OIC autonomous). This is needed to transfer the migration package between ICS and OIC.
1. Check this link for detailed steps on how to create a storage bucket.
Once the above step is completed, then using the storage URL and storage credentials, invoke the export REST API within ICS environment. This will copy the data from ICS into the storage service.
Invoke a REST API to provide the status of the export operation if needed.
For information on what objects have been exported or any error or warnings that were raised as part of the migration can be retrieved from a migration report.
Then perform the import operation in OIC environment passing the storage URL and storage credentials. This will import the content from storage into OIC.
Invoke a REST API to provide the status of the export operation if needed.
For information on what objects have been imported or any error or warnings that were raised as part of the migration can be retrieved from the migration report.

Exporting the data from ICS

Export the data from an ICS environment using the below steps: (Please see the section "Exporting the data from OIC" for exporting from OIC)

Using administrator access, execute the export REST API. A sample is shown below using Postman REST client:

Export Request:

Construct the storage URL based on the configuration done within the storage service based on the format "https://swiftobjectstorage.region.oraclecloud.com/v1/tenancy/bucket" passing the storage credentials as well.

Check this link for more details on creating a storage bucket.

Response:

Checking status:

Checking the migration archive:

Importing the data into OIC

Import the data from into an OIC environment using the below steps:

The migration utility supports different modes for the import process

No	importActivateMode value	Description
1	ImportOnly	This mode only imports the objects and doesn't activate integrations. Used in case a manual operation needs to be performed such as Adapter agent installation.
2	ImportActivate	This mode imports and activates all previously activated integrations.
3	ActivateOnly	This mode only activates previously activated integrations.