Oracle Cloud Infrastructure Documentation

Migrate Oracle Integration Cloud, Oracle Integration Cloud Service, or Oracle Process Cloud Service

You can migrate Oracle Integration Cloud, Oracle Integration Cloud Service, and Oracle Process Cloud Service applications to an Oracle Integration - Generation 2 instance in Oracle Cloud Infrastructure.

Caution

Avoid entering confidential information when assigning descriptions, tags, or friendly names to cloud resources through the Oracle Cloud Infrastructure Console, API, or CLI.

Prerequisites

Ensure that you complete the prerequisites to set up and use Classic Migration Service. See Before You Begin. Additionally, complete the following tasks based on the type of application that you are migrating:

Next: After completing the prerequisites, plan your migration.

Plan the Migration

Use the information provided in this section to determine the scope of a migration and whether you want to migrate to an existing instance or create an instance.

  • Migrate all the resources or migrate specific resources: Using Classic Migration Service, you can migrate all of the resources in Oracle Integration Cloud and Oracle Integration Cloud Service applications or you can selectively migrate only specific resources to the target environment. When you migrate the entire application, all the application resources are migrated to the target environment. You can also migrate only specific resources, such as integrations, to an existing instance in the target environment. It is useful to migrate specific resources and not the entire instance in the following scenarios.
    Note

    When you migrate Oracle Process Cloud Service applications using Classic Migration Service, you can only migrate the entire application and you cannot migrate specific resources.
    • When you want to migrate specific integrations which are spread across several instances in the source environment to one or more existing instances in the target environment.
    • When the source environment contains several integrations which you no longer use and you want to migrate only those integrations that are currently used.
    • When source instances contain both production and test integrations. While migrating to the target environment, you can plan a migration so that the production integrations are migrated to a production instance and the test integrations are migrated to a test instance in the target environment.
  • New or existing target instance: Determine whether you want to use Classic Migration Service to migrate an application to an existing target instance or to create a target instance in Oracle Cloud Infrastructure.

    If you are using Classic Migration Service to create a target instance and migrate an application, then Classic Migration Service creates the target instance in a public subnet. It does not create the target instance in a private subnet.

    Note

    To migrate only specific resources to the target environment using Classic Migration Service, you must create and then use Classic Migration Service to migrate an application to the existing target instance.

Next: After planning a migration, provide information about the source environment to create an Classic Migration Service source.

Creating a Source

Create a source for Oracle Integration Cloud, Oracle Integration Cloud Service, or Oracle Process Cloud Service applications to migrate.

Before you create a source, ensure that you select the correct region in Oracle Cloud Infrastructure Console. This is the target region to which you want to migrate the application. For example, if you selected Australia South (Melbourne) as the region in Oracle Cloud Infrastructure Console, then you can migrate from certain Oracle Cloud Infrastructure Classic regions to Oracle Cloud Infrastructure region, Australia South (Melbourne). In the preceding example, you cannot migrate from US- East, Oracle Cloud Infrastructure Classic region, to Australia South (Melbourne), Oracle Cloud Infrastructure region. When you create a source, the Region menu displays only those Oracle Cloud Infrastructure Classic regions from which you can migrate applications to the current region that you have selected in Oracle Cloud Infrastructure Console.

See also Source Management for more information about source operations.

    1. Open the navigation menu on the Oracle Cloud Infrastructure Console, click OCI Classic Services, and then click Sources in the Classic Migration section to display the Sources in compartment page and a list of sources in the compartment.
    2. Choose a compartment from the Compartment menu in which you have permission to work. The page updates to display only the resources in that compartment. If you are not sure which compartment to use, then contact an administrator. For more information, see Access Control.
    3. Click the Create Source button.
    4. Enter the following information.
      • Name: Enter a user-friendly name for the source environment.
      • Description: Optionally, provide a description to help you identify the source environment.
      • Compartment: Select the compartment where you want to create the source.
      • From the Source type menu, select one of the following and provide the corresponding information:
        • Oracle Cloud Infrastructure - Classic

          Account: The name of your Oracle Cloud Infrastructure Classic account.

          Region: Select the Oracle Cloud Infrastructure Classic region from which you want to migrate the application. Only the source regions and legacy zones from which you can migrate applications using Classic Migration Service display. If you do not see a source region where your Oracle Cloud Infrastructure Classic account exists, then create a service request using My Oracle Support.

          Choose an authentication method, either Access token (the more secure choice) or User credentials. If you select Access token, then you must provide a client-specific URL endpoint and an OAuth access token for the PaaS Service Manager application.

          If you select User credentials, then you must provide the service administrator username and password.

        • Internal Compute

          Account: The name of your Oracle Cloud Infrastructure Classic account.

          Provide the service administrator username and password of the user who has the INTEGRATIONCLOUD_ENTITLEMENT_ADMINISTRATOR (Integration Cloud entitlement administrator role) and AUTONOMOUS_INTEGRATIONCLOUD_ENTITLEMENT_ADMINISTRATOR (Autonomous Integration Cloud entitlement administrator role) in your Oracle Cloud Infrastructure Classic account..

        • Oracle Cloud@Customer

          Account: Enter the service instance ID for your Oracle Cloud@Customer with Identity Cloud Service account.

          Provide the service administrator username and password.

        • Imported

          To create an imported source, you must use the export tool to create a file containing the application you want to migrate, and then upload the file to the Console. See Classic Migration Service Export CLI Tool for more information about the export tool.

          Select the bucket that contains the source information. Click the Change Compartment link to select the compartment that contains the required bucket, if necessary.

      • Account: The name of your Oracle Cloud Infrastructure Classic account.

        If you are using a cloud account with Oracle Identity Cloud Service, then enter the service instance ID. For example, if Compute-567890123 is the account name of your Oracle Cloud Infrastructure Classic Compute service entitlement, then enter 567890123.

        If you are using a traditional cloud account, then enter your identity domain ID.

      • Tags: Optionally, you can add tags. If you have permissions to create a resource, then you also have permissions to add free-form tags to that resource. To add a defined tag, you must have permissions to use the tag namespace. For more information about tagging, see Resource Tags. If you are not sure if you should add tags, then skip this option (you can apply tags later) or ask your administrator.

    5. Click Create.

    A source is created. The Work Requests page appears and it displays the status of the Create Source work request. To track the progress of the operation, you can monitor the associated work request. For more information, see Viewing the State of a Work Request. Classic Migration Service attempts to connect to the source environment using the information you have provided. If the connection is successful, then the status of the source changes from creating to active and the service fetches the list of applications in the source environment that can be migrated.

    If Classic Migration Service is unable to connect to the source environment, then the status of the source changes from creating to inactive and the status of the Create Source work request changes to failed.

    If the source is in the active state, then click the source to view the list of applications. Identify an application that you want to migrate to Oracle Cloud Infrastructure, and then create a migration. You can only migrate an application which is in the Ready state. If the application is in any other state, then you must perform corrective actions. See Viewing a List of Applications.

    If the source is in the inactive state, then click the Create Source work request to view the logs and errors to identify the issues. For example, you must update the authorization details if the error message is Failed to authorize customer in source environment. See Updating Authorization Credentials for a Source.

  • Run the CreateSource operation to create an Oracle Integration Cloud, Oracle Integration Cloud Service, or Oracle Process Cloud Service application source.

  • Use the create command and required parameters to create an Oracle Integration Cloud, Oracle Integration Cloud Service, or Oracle Process Cloud Service application source:

    oci application-migration source create [OPTIONS]

    For a complete list of flags and variable options for CLI commands, see the CLI Command Reference.

Creating a Migration

Create a migration for Oracle Integration Cloud, Oracle Integration Cloud Service, or Oracle Process Cloud Service applications to migrate.

You can use a migration to migrate a single application to Oracle Cloud Infrastructure. While creating a migration, select the source and then the application that you want to migrate. If prompted, then provide the credentials of the service administrator in the source environment. Classic Migration Service uses this information to access the application and discover application artifacts and dependencies.

See also Migration Management for more information about migration operations.

    1. Open the navigation menu on the Oracle Cloud Infrastructure Console, click OCI Classic Services, and then click Migrations in the Classic Migration section to display the Migrations in compartment page and a list of migrations in the compartment.
    2. Choose a compartment from the Compartment menu in which you have permission to work. The page updates to display only the resources in that compartment. If you are not sure which compartment to use, then contact an administrator. For more information, see Access Control.
    3. Click the Create Migration button to display the Create Migration dialog.

      Alternatively, you can access the Create Migration dialog from the details page of a source that contains the application that you want to migrate.

      Note

      You can migrate applications only from a source that is in the Active state.
      1. On the source details page, display a list of applications for the source by clicking Applications in the Resources section.
      2. Click the ellipsis at the end of the row containing the application that you want to migrate.
      3. Click Create Migration.
        Note

        Some fields are filled in, by default, on the Create Migration page, when you choose this workflow.
    4. On the Create Migration page:
      • In the Migration Name field, enter a user-friendly name for the migration.
      • Enter a description in the Description field to help you identify the application being migrated.
      • Select an existing, active source from the Source drop-down that contains the Oracle Integration Cloud, Oracle Integration Cloud Service, or Oracle Process Cloud Service application.
      • Select the application you want to migrate from the Application drop-down.
      • Enter the Oracle Integration instance administrator username and password in the corresponding fields.
      • Optionally, you can choose to use an existing target instance by checking the Use Existing Target Instance box.

        Choose whether you want to migrate the entire application or specific resources by selecting the corresponding radio button.

      • Tags: Optionally, you can add tags. If you have permissions to create a resource, then you also have permissions to add free-form tags to that resource. To add a defined tag, you must have permissions to use the tag namespace. For more information about tagging, see Resource Tags. If you are not sure if you should add tags, then skip this option (you can apply tags later) or ask your administrator.

    5. Click Create to create the migration.
    Use the Configure Migration wizard to provide information about the target environment. You can initiate the process to migrate an application using Classic Migration Service only after you provide this information.

  • Run the CreateMigration operation to create an Oracle Integration Cloud, Oracle Integration Cloud Service, or Oracle Process Cloud Service application migration.

  • Use the create command and required parameters to create an Oracle Integration Cloud, Oracle Integration Cloud Service, or Oracle Process Cloud Service application migration:

    oci application-migration migration create [OPTIONS]

    For a complete list of flags and variable options for CLI commands, see the CLI Command Reference.