Manage Migrations

This topic describes how to create and manage a 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.

About Migrations

A migration represents the end-to-end workflow of moving an application from a source environment to Oracle Cloud Infrastructure. Each migration moves a single application from a specified source to a specified compartment in Oracle Cloud Infrastructure.

To perform a migration, you first create a migration source by specifying the source environment and providing credentials for Application Migration to access the source environment. Application Migration discovers the resources in the source environment.

After you've created a source, you can select the application that you want to migrate. Applications that can be migrated are listed on the Applications page for each source. Before you start the migration, you must provide application-specific information including a name for the migrated application in the target environment and user credentials to access the application in the source environment. Application Migration uses this information to access the application and export the complete domain configuration along with data sources and other dependencies. Application Migration uses this information to access the application and discover application artifacts and dependencies. For example, Application Migration access the Oracle Java the WebLogic Server domain configuration and its data sources.

Next, you create a migration. To create a migration, select a source environment and then select the application in that source environment that you want to migrate. After creating a migration, wait for Application Migration to complete the create migration work request which is associated with this task. The process of migrating the application to the target environment has not yet started.

Next, provide configuration information about the application in the target environment. Application Migration migrates the application to the target environment only after you provide this information. The Configure Migration wizard lets you specify information about the target environment and the application that you are migrating. The information that you must provide varies depending on the type of application that you are migrating.

Next, start the migration. Application Migration migrates the specified application from the source environment to Oracle Cloud Infrastructure.

The name of the migrated application is the same as its name in its source environment. If there are any dependencies, such as an associated database system, Application Migration creates an Oracle Cloud Infrastructure Database System. To name the database system, Application Migration suffixes db to the name of the application. Let's consider that you want to migrate an Oracle Java Cloud Service application named MyApp in the source environment. Application Migration creates the application with the same name, MyApp, in Oracle Cloud Infrastructure and the associated database system is named MyAppdb.

A migration is successful when:

  • The target service instance is started and is healthy.
  • The service instance has been configured with all the dependencies required by the application.
  • The application has been deployed to the service instance and is reported to be in a healthy state.

After a migration completes successfully, ensure that you validate the behavior of the application in terms of its business logic. Application Migration does not perform this validation.

If the migration fails, look at the work request errors and logs to diagnose the issues. After resolving the issues, you can restart the migration.

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.

Tagging Migrations

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 start a migration

You can start a migration only after you've provided the configuration information for the target environment. When you start a migration, Application Migration migrates the application and its dependencies to Oracle Cloud Infrastructure.

After providing configuration information for the target environment, you can start the migration whenever you are ready. Application Migration validates the details you have provided while creating and configuring the migration. You can migrate the application only after the validation is complete. The migration is in the ready state when the validation is complete. You can now start the migration.

While configuring the migration, if you selected the option to start the migration, then no further action is required. Application Migration updates the migration with the configuration information that you have provided for the target environment, and then migrates the application.

  1. Open the navigation menu. Under Solutions and Platform, click Application Migration.
  2. Click Migrations to view the list of migrations and their status.
  3. Click the migration that you're interested in.
  4. Click Start on the migration details page.

The status of the migration changes to migrating. The Work Requests page appears and displays the status of the migrate application 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. When this work request is processed successfully, Application Migration creates the required resources in the target environment and the status of the migration changes to migration succeeded.

If the migration fails, the status of the migration changes to Migration failed. You can look at the logs and errors for the migrate application work request to troubleshoot the issues. After resolving the issues, you can restart the migration whenever you are ready.

To delete a migration

If you have migrated the application or for any other reason if you no longer require a migration, then you can delete the relevant migration. When you delete a migration, it does not delete any resources that Application Migration had created while migrating the application.

You can delete a migration, irrespective of its state. If any work request is being processed for the migration that you are deleting, then the associated work requests are canceled and the migration is deleted.

  1. Open the navigation menu. Under Solutions and Platform, click Application Migration.
  2. Click Migrations to view the list of migration and their status.
  3. Find the migration that you're interested in.
  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 migration, click Delete.
To manage tags for a migration

  1. Open the navigation menu. Under Solutions and Platform, click Application Migration.
  2. Click the migration 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 migration to a different compartment

You can move a migration from one compartment to another. For more information, see Moving Resources to a Different Compartment.

  1. Open the navigation menu. Under Solutions and Platform, click Application Migration.
  2. On the Application Migration page, click Migrations.
  3. Find the migration 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.