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?
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.
- 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. |
Using administrator access, execute the import REST API. A sample is shown below using Postman REST client:
ImportOnly 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.
ImportActivate Request:
ActivateOnly Request:
. Response:
Checking the import status:
Note: The jobId returned in the payload of the Import request is passed in as part of the resource, in the example below the jobId is "405"
Checking the migration report
The result of the migration import process can be checked using the below steps:
Migration report location:
Sample report:
Exporting the data from OIC
Export the data from an OIC environment using the below steps:
Using administrator access, execute the export REST API. A sample is shown below using Postman REST client:
Export Request:
Export Response:
Checking status:
