Step 4: Migrate Integrations and Processes

You can use the Application Migration Service to migrate Integrations and Processes design-time metadata in your instance to Oracle Integration Generation 2. Access to the Application Migration Service is included in the One Console of Oracle Cloud Infrastructure. A user that is an administrator of the tenancy (in the Administrators group) can perform the migration.



Visual Builder design-time metadata cannot be migrated with the Application Migration Service.

The Application Migration Service is also described in the Oracle Cloud Infrastructure Documentation Library. See Manage Migrations.

Create a Source

You must create a source migration to map your Oracle Integration Classic account and region to the Oracle Cloud Infrastructure tenancy. If migrating from multiple regions (for example, uscom-central-1 and uscom-east-1), a different source is required for each. Creating a source migration enables you to discover the list of applications (instances) that are available to migrate.


Ensure you have the required permissions to perform a migration. See Service Permissions.
  1. Sign in to the One Console of Oracle Cloud Infrastructure.
  2. In the upper left corner, select hamburger menu.
  3. Under Solutions and Platform, select Application Migration.
    The Overview page shows a workflow for using the Application Migration Service. The Application Migration Service also checks if you have satisfied migration perquisites and identifies any issues that must be satisfied before beginning.
  4. In the left pane under Application Migration, click Sources.
  5. From the Compartment list, select a compartment in which you have permission to work. The page updates to display only the resources in that compartment. If you're not sure which compartment to use, contact an administrator. For more information, see Access Control.
  6. Click Create Source.


    The Create Source option is also available in the workflow on the Overview page.
  7. Enter the following details, then click Create.
    Element Description
    Name Enter a name for the source (for this example, oicmigrationamsdemo is entered). This is not the name for your new migrated instance.
    Description Enter an optional description.
    Compartment Select the compartment to use for migration. By default, the compartment that you selected prior to clicking Create Source is displayed.
    Source Type Select Oracle Cloud Infrastructure - Classic to migrate an Oracle Integration Classic instance.
    Account Enter your Oracle Integration Classic account. This is the unique portion following the hyphen in Compute-xxxxxxxxx. This is the name associated with your Oracle Cloud Infrastructure Classic Compute service entitlement and is typically a nine digit number. If you use a traditional account for Oracle Integration Classic, enter the identity domain ID.
    Region Select the region in which the Oracle Integration Classic instance to migrate is located.
    Service Administrator Username Enter the service administrator username for the Oracle Integration Classic instance. This user must be assigned the INTEGRATIONCLOUD_ENTITLEMENT_ADMINISTRATOR role.
    Service Administrator Password Enter the service administrator password for this username.

    After creation, the source is displayed in the Sources section (for this example, named oicmigrationamsdemo). You are now ready to create a migration.

Create a Migration

When you create an Oracle Integration Classic migration, all applications (instances) available for you to migrate are discovered.

  1. In the Name column, click the source to migrate (for this example, named oicmigrationamsdemo).
  2. Wait for the page to refresh, then scroll down to view all the applications (instances) associated with this tenancy. Oracle Integration Classic applications are identified as OIC in the Type column.

  3. Identity the Oracle Integration Classic application (instance) to migrate.
  4. Go to the far right section of the row for this application and click Actions menu.
  5. Select Create Migration.
  6. Enter the following details, and click Create to begin the migration discovery. Several fields are automatically populated with details.
    Element Description
    Migration Name Accept the default name, which is appended with a timestamp, or enter a different name.
    Description Enter an optional description.
    Source Displays the name of the selected source migration.
    Application Displays the name of the selected application.
    Service Instance Username Enter the administrator username of the application to migrate. This user must have the ServiceAdministrator role.
    Service Instance Password Enter the instance administrator password.
    Target Instance Type Select the type of target instance in Oracle Cloud Infrastructure. The availability of this feature depends on your Oracle Cloud Infrastructure home region and your subscription. For Oracle Integration Classic, select Oracle Integration - Generation 2.

    The page shows a progress bar that indicates the status of the discovery process to gather details about the instance to migrate. Once your migration discovery completes, the status is displayed as Succeeded.
    Description of create_migration_complete.png follows
    Description of the illustration create_migration_complete.png

  7. You are now ready to create a configuration in which you provide details about the new target instance to create.

Configure the Migration Target Instance

Once discovery completes, you create a configuration that describes the new Oracle Integration Generation 2 target instance to create in Oracle Cloud Infrastructure. This configuration automatically creates an object storage bucket and new instance.

  1. Click Configure to provide target instance details.
  2. Review the overview page and click Configure.

    The Configure Target Oracle Integration Instance dialog is displayed.

  3. Enter the following details, then click Configure.
    Element Description
    Instance Name Enter a name for the new instance that is unique within your tenancy.
    Description Enter an optional description to help identify the new service instance.
    Bring Your Own License Select the checkbox to bring your own license option (BYOL) to the new instance if your organization already owns an Oracle Fusion Middleware software license for Oracle Integration Classic. Otherwise, leave the checkbox unselected to subscribe to a new Oracle Integration software license.
    Number of Message Packs The maximum number of message packs for an instance is based on your license type.
    • For BYOL, the instance can have between 1 and 3 message packs. Each message pack adds 20K messages per hour to your instance.
    • If you don’t have a BYOL license type, the instance can have between 1 to 12 message packs. Each message pack adds 5K messages per hour to your instance.
    Notification Email Enter an email address at which to be notified of migration status.
    IDCS Username Enter the PaaS username for the account. Ensure that account is assigned the following service entitlement:

    AUTONOMOUS_INTEGRATION: CLOUD_ENTITLEMENT_ADMINISTRATOR (Autonomous Integration Cloud entitlement administrator role)

    IDCS Password Enter the password for the PaaS username.

Start the Migration

Once scheduled, you can start the migration and execute the configuration. The Application Migration Service creates a new Oracle Integration Generation 2 instance in Oracle Cloud Infrastructure into which your design-time metadata is imported.

  1. Review your configuration details, then click Save or click Save and Run to run the migration now. This starts the migration to create a new Oracle Integration Classic Generation 2 instance. During this process, the design-time metadata of the instance is exported and imported into the new instance.
  2. Click Start when prompted to start the migration.

    Start and Cancel buttons at the bottom.

  3. Follow the progress of migration in the Percent Complete column.
  4. Click Migrate Application to view in-progress details about the entire migration process, including:
    • Creating an archive location in the object storage bucket for the design-time metadata.
    • Exporting the design-time metadata of the instance to the archive location.
    • Creating a new Oracle Integration Generation 2 instance.
    • Importing the design-time metadata archive from the object storage bucket into the new instance.
    • Deleting the archive from the object storage bucket when the import completes.
  5. If successful, Succeeded is displayed in the status column.
    1. Access your new instance by clicking the link shown at the top of the page:
      Application "instance_name" migrated successfully
      Access the Instance at Oracle Integration
    2. Go to the Integrations page to activate the migrated instance. See Verify Your Environment and Activate Your Integrations.
  6. If unsuccessful, Failed is displayed in the status column. The logs provide details about what failed.