Overview of Application Migration

You can use Application Migration to migrate applications, such as Oracle Java Cloud Service, SOA Cloud Service, and Integration Classic applications, from Oracle Cloud Infrastructure Classic to Oracle Cloud Infrastructure.

Application Migration simplifies the migration of applications from Oracle Cloud Infrastructure Classic to Oracle Cloud Infrastructure. An application is a combination of deployable artifacts and the applied configuration, which can be exported from a service instance running in a source environment and imported into a compatible service instance running on Oracle Cloud Infrastructure.

Application Migration performs the following actions:

  1. Connects to a specified Oracle Cloud Infrastructure Classic source environment and authenticates with that source environment using the specified credentials.
  2. Displays a list of applications that can be migrated from the source environment. You can select the application that you want to migrate.
  3. Discovers the artifacts and configuration of the application selected for migration. You can configure this application and provide details required for the application to be set up in the target environment. When the configuration is complete, you can start the migration.
  4. Launches a service instance on Oracle Cloud Infrastructure to host the migrated application.
  5. Deploys the exported artifacts and specified configuration on the target instance in Oracle Cloud Infrastructure.

When you're satisfied that your application has been successfully migrated and works as expected, you can delete the corresponding application and associated resources in the source environment. Remember that if the migration results in any application-specific changes such as changes in IP addresses or DNS names, then you might need to update objects that reference those resources.

Supported Applications

Use Application Migration to migrate the following applications to Oracle Cloud Infrastructure:

  • Oracle Java Cloud Service
  • Oracle SOA Cloud Service
  • Oracle Analytics Cloud - Classic
  • Oracle Integration
  • Oracle Process Cloud Service
  • Oracle Integration Cloud Service

Supported Regions

You can migrate your applications from all Oracle Cloud Infrastructure Classic regions to the supported regions in Oracle Cloud Infrastructure.

Application Migration is available in the following regions:

  • Australia East (Sydney)
  • Australia South (Melbourne)
  • Brazil East (Sao Paulo)
  • Germany Central (Frankfurt)
  • Japan East (Tokyo)
  • Netherlands Northwest (Amsterdam)
  • UK South (London)
  • US East (Ashburn)
  • US West (Phoenix)

Service Limits

Application Migration has various default limits. When you create a source or migration in Application Migration, the system ensures that your request is within the bounds of your limit. The limit that applies to you depends on your subscription.

The following limits apply to Application Migration resources, such as source and migration. These limits apply to resources in each region.

Resource

Monthly Universal Credits

Pay-as-You-Go or Promo

Total sources 100 50
Total migrations 100 50
Total active migrations 10 5
Total Oracle Java Cloud Service migrations 30 10
Total Oracle SOA Cloud Service migrations 30 10
Total Oracle Integration Classic migrations 30 10
Total Oracle Integration Cloud Service migrations 30 10
Total Oracle Process Cloud Service migrations 30 10
Total Oracle Analytics Cloud Service migrations 30 10

You can submit a request to increase the service limits for Application Migration resources. See Requesting a Service Limit Increase.

In addition, applications that you migrate use resources that the Application Migration service creates, such as database instances, Oracle Java Cloud Service instances, SOA Cloud Service instances, Compute instances, and networking resources. These resources are also subject to their respective service limits. For more information about the service limits that apply to other resources, see Service Limits.

Service Events

Actions that you perform on sources and migrations in Application Migration emit events. You can define rules that trigger a specific action when an event occurs. For example, you might define a rule that sends a notification to administrators when someone migrates an application. See Overview of Events and Get Started with Events.

Source Event Types

This table lists the source events that you can reference.

Event Name Event Type
Source - Create Begin com.oraclecloud.applicationmigration.createsource.begin
Source - Create End com.oraclecloud.applicationmigration.createsource.end
Source - Update Begin com.oraclecloud.applicationmigration.updatesource.begin
Source - Update End com.oraclecloud.applicationmigration.updatesource.end
Source - Delete End com.oraclecloud.applicationmigration.deletesource.end
Source - Change Compartment com.oraclecloud.applicationmigration.changesourcecompartment

Example

This example shows information associated with the event Source - Create Begin.

{
  "eventType": "com.oraclecloud.applicationmigration.createsource.begin",
  "cloudEventsVersion": "0.1",
  "eventTypeVersion": "2.0",
  "source": "applicationmigration",
  "eventId": "<unique_ID>",
  "eventTime": "2019-12-13T05:51:25.412Z",
  "contentType": "application/json",
  "data": {
    "compartmentId": "ocid1.compartment.oc1..<unique_ID>",
    "compartmentName": "example-compartment",
    "resourceName": "example-source",
    "resourceId": "ocid1.amssource.oc1..<unique_ID>",
    "availabilityDomain": "<availability_domain>",
    "freeFormTags": {
      "Department": "Finance"
    },
    "definedTags": {
      "Operations": {
        "CostCenter": "42"
      }
    },
    "additionalDetails": {}
  }
}

Migration Event Types

This table lists the migration events that you can reference.

Event Name Event Type
Migration - Create Begin com.oraclecloud.applicationmigration.createmigration.begin
Migration - Create End com.oraclecloud.applicationmigration.createmigration.end
Migration - Update Begin com.oraclecloud.applicationmigration.updatemigration.begin
Migration - Update End com.oraclecloud.applicationmigration.updatemigration.end
Migration - Migrate Application End com.oraclecloud.applicationmigration.migrateapplication.end
Migration - Delete End com.oraclecloud.applicationmigration.deletemigration.end
Migration - Change Compartment com.oraclecloud.applicationmigration.changemigrationcompartment

Example

This example shows information associated with the event Migration - Create Begin:

{
  "eventType": "com.oraclecloud.applicationmigration.createmigration.begin",
  "cloudEventsVersion": "0.1",
  "eventTypeVersion": "2.0",
  "source": "applicationmigration",
  "eventId": "<unique_ID>",
  "eventTime": "2019-12-13T05:51:25.412Z",
  "contentType": "application/json",
  "data": {
    "compartmentId": "ocid1.compartment.oc1..<unique_ID>",
    "compartmentName": "example-compartment",
    "resourceName": "example-migration",
    "resourceId": "ocid1.amsmigration.oc1..<unique_ID>",
    "availabilityDomain": "availability_domain",
    "freeFormTags": {
      "Department": "Finance"
    },
    "definedTags": {
      "Operations": {
        "CostCenter": "42"
      }
    },
    "additionalDetails": {}
  }
}

Ways to Access Oracle Cloud Infrastructure

You can access Oracle Cloud Infrastructure using the Console (a browser-based interface) or the REST API. Instructions for the Console and API are included in topics throughout this guide. For a list of available SDKs, see Software Development Kits and Command Line Interface.

To access the Oracle Cloud Infrastructure Console, see Signing In to the Console.

Application Migration also supports private access from Oracle Cloud Infrastructure resources in a VCN through a service gateway. A service gateway allows connectivity to the Application Migration public endpoints from private IP addresses in private subnets. Set up a service gateway if you are using the REST API or CLI to access Oracle Cloud Infrastructure. If you are using the console to access Oracle Cloud Infrastructure, you need not set up a service gateway. You can optionally use IAM policies to control which VCNs or ranges of IP addresses can access Application Migration. See Access to Oracle Services: Service Gateway for details.

For general information about using the API, see REST APIs.

Authentication and Authorization

Each service in Oracle Cloud Infrastructure integrates with IAM for authentication and authorization, for all interfaces (the Console, SDK or CLI, and REST API).

An administrator in your organization needs to set up groups, compartments, and policies that control which users can access which services, which resources, and the type of access. For example, the policies control who can create users, create and manage the cloud network, and launch instances. For more information, see Getting Started with Policies. For specific details about writing policies for each of the different services, see Policy Reference.

If you’re a regular user (not an administrator) who needs to use the Oracle Cloud Infrastructure resources that your company owns, contact your administrator to set up a user ID for you. The administrator can confirm which compartment or compartments you should be using.