3 Migrate an Instance to Oracle WebLogic Server for Oracle Cloud Infrastructure Using Application Migration Service
Use Application Migration in Oracle Cloud Infrastructure to migrate your Oracle WebLogic Server domain resources and applications from your existing Oracle Java Cloud Service instance in Oracle Cloud Infrastructure Classic to a new domain in Oracle WebLogic Server for Oracle Cloud Infrastructure.
Note:
Oracle recommends migrating your existing domains in Oracle Java Cloud Service to Oracle WebLogic Server for Oracle Cloud Infrastructure.Application Migration is available only in specific Oracle Cloud Infrastructure regions. See Overview of Application Migration in the Oracle Cloud Infrastructure documentation.
Application Migration does not support the migration of WebLogic Server domains that include these types of resources:
- Custom Identity or Trust Keystore
- Foreign JNDI Provider
- Foreign JMS Server
- JMS Bridge Destination
- Storage-and-Forward (SAF) Context
- JavaMail Session
- WebLogic Diagnostic Framework (WLDF) REST Notification Endpoint
If your source Oracle Java Cloud Service instance uses these resource types, then Oracle recommends using the Oracle Cloud Infrastructure Classic Java Migration Tool instead of Application Migration. See Migrate an Instance to Oracle WebLogic Server for Oracle Cloud Infrastructure Using Classic Tools.
Before you begin the migration process, see Prepare to Migrate Oracle Java Cloud Service to Oracle Cloud Infrastructure.
When you migrate an Oracle Java Cloud Service instance, the following terms are used:
- Source: The connection to your Oracle Cloud Infrastructure Classic account in Application Migration.
- Source Instance: The Oracle Java Cloud Service instance in Oracle Cloud Infrastructure Classic.
- Target: The domain and related cloud resources in Oracle WebLogic Server for Oracle Cloud Infrastructure.
Topics:
- Perform Prerequisite Tasks for Oracle WebLogic Server for Oracle Cloud Infrastructure
- Create a Source
- Create a Migration
- Configure and Run a Migration
- Copy Supporting Files to the Target Instance
- Recreate Oracle Fusion Middleware Security Resources
- Migrate Oracle Identity Cloud Service Roles and Policies
- Integrate Fusion Middleware Components with Oracle Identity Cloud Service
Perform Prerequisite Tasks for Oracle WebLogic Server for Oracle Cloud Infrastructure
Before you use Application Migration Service to create a domain using Oracle WebLogic Server for Oracle Cloud Infrastructure, you must create the required infrastructure resources.
See Before You Begin with Oracle WebLogic Server for Oracle Cloud Infrastructure in Using Oracle WebLogic Server for Oracle Cloud Infrastructure.
Application Migration Service automatically creates an Oracle Cloud Infrastructure Database before it creates the target domain. Oracle WebLogic Server for Oracle Cloud Infrastructure provisions the required infrastructure schema to this database.
Create a Source
Use Application Migration to connect to your Oracle Cloud Infrastructure Classic account and region.
- From the Oracle Cloud Infrastructure console, navigate to Application Migration.
- Select the Compartment in which to create the source.
- Click Sources.
- Click Create Source.
- Enter a Name and Description for the source.
- For Source Type, select Oracle Cloud Infrastructure - Classic.
- For Account, enter the name of your Oracle Cloud Infrastructure Classic account.
- Select the Oracle Cloud Infrastructure Classic Region in which you created your source Oracle Java Cloud Service instance.
- Enter credentials for this Oracle Cloud Infrastructure Classic account that have access to Oracle Java Cloud Service.
- Click Create.
For more information, see Manage Sources in the Oracle Cloud Infrastructure documentation.
Create a Migration
Use Application Migration to connect to the WebLogic Server domain for the Oracle Java Cloud Service instance within your source.
- From the Oracle Cloud Infrastructure console, navigate to Application Migration.
- Select the Compartment that contains your source.
- Click Sources, and then select your source.
- Click Actions for the Oracle Java Cloud Service instance that you want to migrate, and then click Create Migration.
- Enter a Name and Description for the migration.
- Enter the WebLogic Server administrator credentials for the Oracle Java Cloud Service instance.
- Set the Target Instance Type to Oracle WebLogic Server for Oracle Cloud Infrastructure.
- Click Create.
For more information, see Manage Migrations in the Oracle Cloud Infrastructure documentation.
Configure and Run a Migration
Use Application Migration to create the target domain in Oracle WebLogic Server for Oracle Cloud Infrastructure. Specify a network, credentials, databases, and other details.
- From the Oracle Cloud Infrastructure console, navigate to Application Migration.
- Select the Compartment that contains your migration.
- Click Migrations, and then select your migration.
- Click Configure.
- In the Configure Service section, click Configure.
- Select the Availability Domain in which you want to create the target instance.
- Select the Virtual Cloud Network and Subnet in which you want to create the target instance.
- For Secrets OCID for Database Administrator Password, paste the OCID of the secret that contains the password for the new Oracle Cloud Infrastructure Database.
- Enter the same password in System Database Administrator Password.
- Upload or paste the public SSH Key to use for the target instance and database.
- Enter the WebLogic Server administrator credentials for the new domain.
- Enter the WebLogic Server Admin User Name.
- For Secrets OCID for WebLogic Server Admin Password, paste the OCID of the secret that contains the password.
- Enter the same password in WebLogic Server Admin Password.
- If your source instance uses Oracle Identity Cloud
Service (IDCS) for authentication, then provide details about the confidential application that you created for the target domain.
- Click Configure to return to the Configure Migration page.
- If your source instance includes custom Java Database Connectivity (JDBC) data sources, then provide the location and password of the new application databases in Oracle Cloud
Infrastructure.
- Click Save and Run.
- When prompted for confirmation, click Start.
Use Application Migration to monitor the progress of your work request. The target domain is provisioned as a Terraform stack using Resource Manager. To access the new domain, see these topics in Using Oracle WebLogic Server for Oracle Cloud Infrastructure:
If the work request indicates that the stack creation failed, use Resource Manager to view the log files. See Stack Creation Failed in Using Oracle WebLogic Server for Oracle Cloud Infrastructure.
If the work request indicates that the import step of the migration failed, you can get additional information by connecting to the first node in the target domain. Access the log files found at /u01/weblogic-deploy
and /u01/jcsmig
.
After correcting any problems, you can run the migration again.
For more information, see Manage Migrations in the Oracle Cloud Infrastructure documentation.
Copy Supporting Files to the Target Instance
Identify and copy any files to your target Oracle WebLogic Server for Oracle Cloud Infrastructure domain that are not automatically managed by Application Migration.
Application Migration migrates the following types of files from your source instance's domain configuration to your target domain's configuration:
- Application deployments
- Library deployments
- Custom keystores
Other files that your applications or domain resources require are not automatically managed by Application Migration, including files that are located outside the DOMAIN_HOME
directory. You must manually copy these files to the target instance.
Recreate Oracle Fusion Middleware Security Resources
If you created any custom users, groups, roles or policies in your source Oracle Java Cloud Service instance, then you must recreate them in the target Oracle WebLogic Server for Oracle Cloud Infrastructure domain.
Application Migration does not automatically migrate any Oracle Fusion Middleware security resources that you created to support your applications, including users, roles and policies. Perform this task if your source domain includes applications that use Oracle Fusion Middleware (FMW), Oracle Platform Security Services (OPSS), Oracle Application Development Framework (ADF) or Oracle Web Services Manager (WSM).
Migrate Oracle Identity Cloud Service Roles and Policies
If your source Oracle Java Cloud Service instance uses Oracle Identity Cloud Service for authentication, then you must migrate the administrator roles and web tier policy to the target domain in Oracle WebLogic Server for Oracle Cloud Infrastructure.
The source and target are each associated with a security application in Oracle Identity Cloud Service. The security application grants administrative rights for the WebLogic Server domain to specific users and groups in Oracle Identity Cloud Service.
Integrate Fusion Middleware Components with Oracle Identity Cloud Service
If your source Oracle Java Cloud Service instance uses Oracle Identity Cloud Service for authentication, then you can integrate certain Oracle Fusion Middleware components in the target domain with Oracle Identity Cloud Service.
If your source instance uses Oracle Web Services Manager to protect web service applications and clients, then see Secure Web Services Using Identity Cloud Service in Using Oracle WebLogic Server for Oracle Cloud Infrastructure.
If applications on your source instance use Oracle Platform Security Services APIs to look up user and group information, then see Integrate OPSS User and Group APIs with Identity Cloud Service in Using Oracle WebLogic Server for Oracle Cloud Infrastructure.