Step 4: Migrate Oracle Integration Cloud Service and Oracle Process Cloud Service Design-Time Metadata into Oracle Integration

You can use the Application Migration Service to migrate your Oracle Integration Cloud Service and Oracle Process Cloud Service design-time metadata into 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.

Topics:

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 Cloud Service or Oracle Process Cloud Service account 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.

Note:

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 prerequisites 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.

    Note:

    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. This is not the name for your new migrated application (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 Internal Compute to migrate an Oracle Integration Cloud Service or Oracle Process Cloud Service application (instance). You cannot migrate both services at the same time. However, both Oracle Integration Cloud Service and Oracle Process Cloud Service applications (instances) can be discovered. A single source can list multiple Oracle Integration Cloud Service and Oracle Process Cloud Service applications. When you create a migration, you must create a migration for each application.
    Account Enter your Oracle Integration Cloud Service or Oracle Process Cloud Service account. The account number is used to identify the location of your Oracle Integration Cloud Service or Oracle Process Cloud Service application (instance). If you use a traditional account for Oracle Integration Cloud Service and Oracle Process Cloud Service, enter the identity domain ID.
    Service Administrator Username Enter the service administrator username for the Oracle Integration Cloud Service or Oracle Process Cloud Service application (instance). This user must be assigned the INTEGRATIONCLOUD_ENTITLEMENT_ADMINISTRATOR role.
    Service Administrator Password Enter the service administrator password for this username.


Create a Migration

When you create an Oracle Integration Cloud Service or Oracle Process Cloud Service migration source, all applications (instances) available for you to migrate are discovered.

  1. Wait for the page to refresh, then scroll down to view the instances in this tenancy. Oracle Integration Cloud Service or Oracle Process Cloud Service applications are identified as ICS and PCS, respectively, in the Type column.

  2. In the far right section of the row of the Oracle Integration Cloud Service or Oracle Process Cloud Service application to migrate, click Actions menu. For this example, an Oracle Integration Cloud Service application that is available for migration is selected.
  3. Select Create Migration.
  4. Enter the following details, and click Create. 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 User Enter the service instance username for the application to migrate. This user must have the ServiceAdministrator role.
    Service Instance Password Enter the service instance 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 Cloud Service or Oracle Process Cloud Service, select Oracle Integration - Generation 2.


  5. View migration creation in the Percent Complete column.
    When migration creation completes, you are ready to create a configuration in which you provide details about the new target instance to create.

Configure the Migration Target Instance

Once migration creation 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. For this example, an Oracle Integration Cloud Service instance is being migrated.


    The Configure Target Integration Cloud Service Instance dialog is displayed because Oracle Integration Cloud Service is being migrated for this example. If you are migrating Oracle Process Cloud Service, the name of the dialog is Configure Target Process Cloud Service Instance.

  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 Cloud Service or Oracle Process Cloud Service. 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. This user must be a user with Oracle Integration roles in Oracle Cloud Infrastructure tenant:
    • Service: INTEGRATIONCAUTO
    • Service Role: AUTONOMOUS_INTEGRATIONCLOUD_ENTITLEMENT_ADMINISTRATOR (Autonomous Integration Cloud entitlement administrator role)

    This service role is granted to the AMS_AllServices_Admins group already in the tenant AMSTESTROLLOUT (EMEA) and Amstestapac (APAC). Ensure your user is either in this group or has the Oracle Integration role explicitly.

    IDCS Password Enter the password for the PaaS username.

Start and Complete 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 Oracle Integration Cloud Service or Oracle Process Cloud Service 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 Generation 2 instance. During this process, the Oracle Integration Cloud Service (or Oracle Process Cloud Service, if you were migrating that service) design-time metadata of the application is exported and imported into the new instance.
  2. Follow the progress of migration in the Percent Complete column.
  3. 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 Oracle Integration Cloud Service or Oracle Process Cloud Service design-time metadata.
    • Exporting the Oracle Integration Cloud Service or Oracle Process Cloud Service design-time metadata of the application to the archive location.
    • Creating a new Oracle Integration Generation 2 instance.
    • Importing the Oracle Integration Cloud Service or Oracle Process Cloud Service 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.
  4. If successful, Succeeded is displayed in the status column and the following message is displayed in the banner at the top of the page.
    Application "instance_name" migrated successfully
    1. Access your new instance by clicking the link immediately below the above message.
    2. See Complete the Post-Migration Tasks for any tasks for your service.
  5. If unsuccessful, Failed is displayed in the status column. The logs provide details about what failed.