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 create a source
  1. Open the navigation menu. Under Solutions and Platform, click Application Migration.
  2. Choose a compartment you have permission to work in (on the left side of the page). 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.
  3. Click Create Source.
  4. Enter the required 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.
    • Source Type: Select one of the following values depending on the applications that you want to migrate.
      • Oracle Cloud Infrastructure - Classic: Select this option if you want to migrate Oracle Java Cloud Service, Oracle Analytics Cloud - Classic, Oracle Integration, and Oracle SOA Cloud Service applications.
      • Internal Compute: Select this option if you have a traditional account and want to migrate Oracle Process Cloud Service or Oracle Integration Cloud Service applications.
    • Account: The name of your Oracle Cloud Infrastructure Classic account.

      If you are using a cloud account with Identity Cloud Service (IDCS), 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, enter your identity domain ID.

    • Region: Select the Oracle Cloud Infrastructure Classic region from which you want to migrate your applications. This field appears only when you select Oracle Cloud Infrastructure - Classic as the Source Type.
    • Service Administrator Username: Enter the username of the administrator who has the service administrator role in your Oracle Cloud Infrastructure Classic account for the applications that you want to migrate. For example, specify a user who has the JAAS_Administrator role to migrate the Oracle Java Cloud Service application. For information about the service administrator role that is specific to the application you want to migrate, see About Service Administrator Roles.
    • Service Administrator Password: The password for the specified user.
    • Tags: Optionally, you can add tags. If you have permissions to create a resource, 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, 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. Application Migration attempts to connect to the source environment using the information you have provided. If the connection is successful, 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 Application Migration is unable to connect to the source environment, the status of the source changes from creating to inactive and the status of the Create Source work request changes to failed.

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.

If the source is in the inactive state, click the Create Source workrequest to view the logs and errors to identify the issues. For example, you'll need to update the authorization details if the error message is, 'Failed to authorize customer in source environment.' See To update authorization credentials for a source.

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.