Oracle Cloud Infrastructure Documentation

Manage Sources

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

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.

About Sources

In Classic Migration Service, a source refers to the environment from which you migrate an application. Classic Migration Service 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. Classic Migration Service connects to the source environment with the authentication credentials that you provide. If the connection is established, then Classic Migration Service 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, then 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, Classic Migration Service again attempts to connect to the source environment using the authentication credentials you provide.

Applications

An application is a combination of 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 an Oracle WebLogic-based application deployed on Oracle Java Cloud Service, a service instance includes one or more virtual machines representing the Oracle WebLogic cluster, a load balancer and security configuration, links to other resources such as database instances, and so on. When you migrate an application, Classic Migration Service stores an archive of the application artifacts and all the necessary configuration details. Classic Migration Service 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 are 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 do not have permission or are unauthorized, then confirm with your administrator the type of access you have and in which you should work.

If you are new to policies, then see Getting Started with Policies and Common Policies. If you want to dig deeper into writing policies for Classic Migration Service API resources, then 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 Classic Migration Service cannot connect to the source environment using the authorization credentials you provide, then verify that the information you provided is correct. If there are any changes in a source environment (such as changed user credentials), then you must update the source to provide the latest credentials.

  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. Click the name of the failed source to display its details page.
  3. On the source details page, click Authorize. This option is enabled only if authentication has failed for the selected source.
  4. Update the user credentials for the selected source, and then click Authorize.

The source is updated creating an update source work request. Classic Migration Service 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, then the status changes back to Inactive. If the connection is successful, then 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.

If the source is in the Active state, then view the list of applications in this source environment and 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 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. Select the compartment from the Compartment drop-down in which you have created the source, if you are not already in the correct compartment.
  3. Click the source for which you want to view a list of the associated applications.
Perform one of the following actions based on the state of the application.
Application Status Description Action
Ready You can migrate an application that 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 provided while creating the source does not 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 that you want to migrate, see About Service Administrator Roles.
Unsupported You cannot migrate this application as the current version of the application is not supported by Classic Migration Service. This status is visible only for unsupported versions of the 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 Classic Migration Service, 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 Classic Migration Service, and then you can migrate your application using Classic Migration Service.
Unknown You cannot migrate an application that is in the Unknown state. Check whether the source instance is undergoing maintenance or if it is not in the Running state. Verify that the source instance is configured correctly. If this issue persists even after you perform these checks and ensure that the source instance is in the running state, then contact My Oracle Support.
Failed You cannot migrate an application that is in the Failed state. Check whether the source instance is undergoing maintenance or if it is not in the Running state. Verify that the source instance is configured correctly. If this issue persists even after you perform these checks and ensure that the source instance is in the running state, then contact My Oracle Support.
To delete a source

Before you delete 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 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. Select the compartment from the Compartment drop-down in which you have created the source, if you are not already in the correct compartment.
  3. Locate the source that you want to delete in the list.
  4. Click the Actions icon (three dots) at the end of the row containing the source and click Delete.
    A confirmation message displays.
  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 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. Select the compartment from the Compartment drop-down in which you have created the source, if you are not already in the correct compartment.
  3. Locate and click the source for which you want to manage tags in the list.
  4. Click the Tags tab to view or edit the existing tags. Or click Apply tag(s) to add new tags.
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, you also move any existing migrations.

  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. Select the compartment from the Compartment drop-down in which you have created the source, if you are not already in the correct compartment.
  3. Locate the source that you want to move in the list.
  4. Click the Actions icon (three dots) at the end of the row containing the source and click Move Resource.
  5. Choose the destination compartment from the list.
  6. Click Move Resource.
For more information, see Moving Resources to a Different Compartment.