Manage Sources

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

Caution

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

Sources

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.

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.

Applications

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 update authorization credentials for a source

When authorization for a source fails, the status of the source displays as inactive. If Application Migration can't connect to the source environment using the authorization credentials you have provided, verify that the information you have provided is correct. If there are any changes in a source environment, for example, if user credentials have changed, then you must update the source to provide the latest credentials.

  1. Open the navigation menu. Under Solutions and Platform, click Application Migration.
  2. Click Sources.
  3. Click the source that you're interested in.
  4. On the source details page, click Authorize. This option is enabled only if authentication has failed for the selected source.
  5. Update the user credentials for the selected source, and then click Authorize.

The source is updated and the update source work request is created. Application Migration attempts to connect to the source environment using the updated credentials. The status of the migration source changes from Inactive to Updating. If the service is unable to connect to the source environment, the status changes to Inactive again. If the connection is successful, the status changes to Active and the service fetches the list of applications in the source environment that can be migrated.

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.

Next:

If the source is in the active state, view the list of applications in this source environment and then identify an application that you want to migrate to Oracle Cloud Infrastructure. See To view a list of applications.

To view a list of applications
  1. Open the navigation menu. Under Solutions and Platform, click Application Migration.
  2. Select the compartment in which you have created the source.
  3. Click Sources to view all the available sources in the selected compartment.
    You can only migrate applications from a source that is in the Active state.
  4. Click the source that you're interested in.
A list of applications is displayed.

Next: Perform one of the following actions based on the state of the application.

Application Status Description Action
Ready You can migrate an application which is in the Ready state. You can create a migration to migrate this application to Oracle Cloud Infrastructure.
Missing Role The server administrator user, that you have provided while creating the source, doesn't have the service administrator role in the source environment for the application that you want to migrate. Ensure that the username that you have provided has the required role in Oracle Cloud Infrastructure Classic. For information about the service administrator role that is specific to the application you want to migrate, see About Service Administrator Roles.
Unsupported You can't migrate this application as the current version of the application is not supported by Application Migration. This status is visible only for unsupported versions of Oracle Java Cloud Service application in the source environment. Upgrade your application, in the source environment, to a supported version. For information about versions supported by Application Migration, see Plan Oracle Java Cloud Service Migration.

After you upgrade the application in the source environment, the status of the application changes to Ready in Application Migration, and then you can migrate your application using Application Migration.

To delete a source

Before deleting a source, you must delete all the migrations associated with the source. When you have migrated all the required applications in a source or for any other reason you no longer require a source to be displayed on the web console, then you can delete the relevant source.

  1. Open the navigation menu. Under Solutions and Platform, click Application Migration.
  2. Click Sources.
  3. Find the source in the list.
  4. Click the Actions icon (three dots), and then click Delete.
    A confirmation message is displayed.
  5. If you are sure that you want to delete the source, click Delete.
To manage tags for a source

  1. Open the navigation menu. Under Solutions and Platform, click Application Migration.
  2. Click the source that you're interested in.
  3. Click the Tags tab to view or edit the existing tags. Or click Apply tag(s) to add new ones.

For more information, see Resource Tags.

To move a source to a different compartment

You can move a source from one compartment to another. When you move a source, it move any existing migrations in Application Migration.

  1. Open the navigation menu. Under Solutions and Platform, click Application Migration.
  2. Click Sources.
  3. Find the source in the list. Click the Actions icon (three dots), and then click Move Resource.
  4. Choose the destination compartment from the list.
  5. Click Move Resource.
For more information, see Moving Resources to a Different Compartment.