Manage Sources

This topic describes how to create and manage a source in Application Migration.


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


In Application Migration, a source refers to the environment from which the application is migrated. Application Migration supports migration from Oracle Cloud Infrastructure Classic to Oracle Cloud Infrastructure. A source connects an Oracle Cloud Infrastructure Classic account and region to Oracle Cloud Infrastructure.

You can create one or more sources depending on the following factors:

  • The region from which you want to migrate applications. If you want to migrate applications from more than one Oracle Cloud Infrastructure Classic account and region, then create multiple sources. For example, if you want to migrate applications from uscom-central-1 and uscom-east-1 to Oracle Cloud Infrastructure, then create a source for each region.
  • The type of application that you want to migrate. If you want to migrate Oracle SOA Cloud Service and Oracle Process Cloud Service applications, you must create one source to migrate Oracle Process Cloud Service applications and another to migrate Oracle SOA Cloud Service applications.
  • Roles associated with the service administrator credentials that you provide to access the source environment. If the service administrator username that you specify while creating an Application Migration source has the required roles to access multiple applications, then you can use a single source to migrate these applications. For example, if the service administrator that you specify while creating a source has both JaaS_Administrator and SOA_Administrator roles, then the source you've created retrieves details of both Oracle Java Cloud Service and Oracle SOA Cloud Service applications.

While creating a source, assign an appropriate name and provide a description. This helps you to identify the appropriate source environment when you have multiple sources defined. If required, enter the username and password of the administrator who has the service administrator role in your Oracle Cloud Infrastructure Classic account for the applications that you want to migrate.

When you create a source, it is in the creating state. Application Migration connects to the source environment with the authentication credentials that you have provided. If the connection is established, Application Migration fetches the list of applications that are available for migration in the source environment. All the discovered applications are listed on the source details page. Next, select an application that you want to migrate to Oracle Cloud Infrastructure and create a migration.

If the authentication fails, the source transitions into the inactive state. Identify the issues with authentication and fix those issues before proceeding. For example, you may need to update the source to provide the correct credentials. When you update a source, Application Migration again attempts to connect to the source environment using the authentication credentials you have provided.


An application is a combination of the artifacts and configuration deployed on one or more service instances running in the source environment. A service instance represents the complete infrastructure required to host a component of the application. For example, in the case of a WebLogic-based application deployed on Oracle Java Cloud Service, a service instance includes one or more virtual machines (VMs) representing the WebLogic cluster, a load balancer and security configuration, links to other resources such as database instances, and so on. When you migrate this application, Application Migration stores an archive of the application artifacts and all the necessary configuration details. Application Migration uses these details to import the application into Oracle Cloud Infrastructure.

Required IAM Policy

To use Oracle Cloud Infrastructure, you must be given the required type of access in a policy written by an administrator, whether you're using the Console or the REST API with an SDK, CLI, or other tool. If you try to perform an action and get a message that you don’t have permission or are unauthorized, confirm with your administrator the type of access you've been granted and which you should work in.

If you're new to policies, see Getting Started with Policies and Common Policies. If you want to dig deeper into writing policies for Application Migration API resources, see Manage Service Access and Security.

Creating Automation for Sources Using the Events Service

You can create automation based on state changes for your Oracle Cloud Infrastructure resources by using event types, rules, and actions. For more information, see Overview of Events.

Tagging Sources

You can add tags to your resources to help you organize them according to your business needs. You can add tags at the time you create a resource, or you can update the resource later with the desired tags. For general information about applying tags, see Resource Tags.

Using the Console

To create a source
To update authorization credentials for a source
To view a list of applications that can be migrated
To delete a source
To manage tags for a source
To move a source to a different compartment