1 Learn About Migrating to Oracle Cloud Infrastructure

These topics help you learn about the benefits to migrating your existing Oracle Java Cloud Service instances to Oracle Cloud Infrastructure, and also provide an overview of the migration process and tools.

Why Migrate to Oracle Cloud Infrastructure

Oracle encourages you to migrate your existing cloud resources to Oracle Cloud Infrastructure regions. You can gain several advantages by doing so.

In Oracle Cloud, you provision resources in specific regions, which are localized to geographic locations. Certain regions support the Oracle Cloud Infrastructure platform.

Oracle Cloud Infrastructure is Oracle's modern cloud platform that's based on the latest cloud technologies and standards. It provides more consistent performance and better features at lower costs. Oracle continues to invest in Oracle Cloud Infrastructure, including the addition of new regions, services, and features. See Data Regions for Platform and Infrastructure Services.

You can benefit from these additional administrative features when you migrate your cloud resources to Oracle Cloud Infrastructure:

  • Organize cloud resources into a hierarchy of logical compartments.
  • Create fine-grained access policies for each compartment.

To learn more, see Upgrade Your Classic Services to Oracle Cloud Infrastructure.

About the Migration Scope

Before you migrate your existing Oracle Java Cloud Service instances to Oracle Cloud Infrastructure, ensure that the service instance meets the prerequisites for the migration.

Oracle does not currently support the migration of Oracle Java Cloud Service instances that meet any of these conditions:

  • The service instance includes multiple domain partitions.
  • The service instance is running Oracle WebLogic Server 11g and includes Java Message Service (JMS) migratable targets.

This guide does not include detailed procedures on the configuration of basic Oracle Cloud Infrastructure security, network and storage resources that might be required to support your new WebLogic Server domain. Instead, this guide provides references to the Oracle Cloud Infrastructure documentation as appropriate.

Most service instances connect to one or more databases in order to access your application schemas. This guide does not include the detailed procedure for migrating these application databases from Oracle Cloud Infrastructure Classic to Oracle Cloud Infrastructure. One option is the Oracle Cloud Infrastructure Classic Database Backup Migration Tool, which uses Recovery Manager (RMAN). Another option is Oracle Data Guard. See Select a Method to Migrate Database Instances in Migrating Infrastructure Classic Workloads to Oracle Cloud Infrastructure.

Compare Oracle Cloud Infrastructure to Classic

This topic helps you get familiar with basic Oracle Cloud Infrastructure security, network, and storage concepts, and compare them to their equivalent concepts in Oracle Cloud Infrastructure Classic.

Cloud resources in Oracle Cloud Infrastructure are created in logical compartments. You also create fine-grained policies to control access to the resources within a compartment.

You create instances within an Oracle Cloud Infrastructure region. You also specify an availability domain (AD), if supported in the selected region. Oracle Cloud Infrastructure Classic does not use availability domains.

A virtual cloud network (VCN) is comprised of one or more subnets, and an instance is assigned to a specific subnet. In Oracle Cloud Infrastructure Classic, you assign instances to IP networks or the shared network. Typically, you create one subnet for the shared network, and create a separate subnet for each IP network in Oracle Cloud Infrastructure Classic. Note that unlike Oracle Cloud Infrastructure Classic, Oracle Cloud Infrastructure does not allow you to reserve IP addresses for platform services.

A subnet's security lists permit and block traffic to and from specific IP addresses and ports. In Oracle Cloud Infrastructure Classic, an instance's access rules provide similar capabilities, although security lists are configured at the subnet level.

Instances can communicate with resources outside of Oracle Cloud by using Oracle Cloud Infrastructure FastConnect, which provides a fast, dedicated connection to your on-premises network. This service is equivalent to Oracle Cloud Infrastructure FastConnect Classic. Alternatively, use IPSec VPN in Oracle Cloud Infrastructure as a replacement for VPN as a Service (VPNaaS) or Corente in Oracle Cloud Infrastructure Classic.

A bucket in Oracle Cloud Infrastructure Object Storage can be used to store files and share them with multiple instances. A user's generated authentication token (auth token) is required to access the bucket. Oracle Cloud Infrastructure Object Storage Classic provides the same service in Oracle Cloud Infrastructure Classic, but does not use auth tokens.

To learn more, see Key Concepts and Terminology in the Oracle Cloud Infrastructure documentation.

You can create rules that automatically scale an Oracle Java Cloud Service instance that's running in Oracle Cloud Infrastructure Classic. You must scale instances in Oracle Cloud Infrastructure manually.

About Oracle Cloud Infrastructure Users and Groups

Use the Identity and Access Management (IAM) system in Oracle Cloud Infrastructure to manage users, groups, and policies.

For example, the following Oracle Cloud Infrastructure policy grants members of the group MyGroup all privileges to all resources in the compartment MyCompartment:
Allow group MyGroup to manage all-resources in compartment MyCompartment

By default, this system is also configured to use Oracle Identity Cloud Service as a federated identity provider. Therefore, when you define policies in Oracle Cloud Infrastructure, you can reuse existing users and groups in Oracle Identity Cloud Service. You can either add users to a new group in Oracle Cloud Infrastructure, or map an existing Oracle Identity Cloud Service group to an Oracle Cloud Infrastructure group.

While policies control access to resources and services in Oracle Cloud Infrastructure, administrator roles control access to platform services. Assign Oracle Identity Cloud Service users and groups to administrator roles in order to grant them access to platform services.

About Oracle WebLogic Cloud

Oracle WebLogic Cloud is available as a set of applications in the Oracle Cloud Infrastructure Marketplace. After launching one of these applications, you use a simple wizard interface to configure and provision an Oracle WebLogic Server domain along with any supporting cloud resources like compute instances, networks and load balancers.

You track and monitor the progress of an Oracle WebLogic Cloud stack using Resource Manager in Oracle Cloud Infrastructure. A stack also provides a convenient method of deleting the cloud resources for a domain when you no longer require them.

Like Oracle Java Cloud Service, you can administer the domain and deploy Java EE applications to it just like on-premises domains. Use standard Oracle WebLogic Server tools like the administration console and WebLogic Scripting Tool (WLST). You can also administer the operating system on the compute instances using a secure shell (SSH) client and standard Linux tools.

Like Oracle Java Cloud Service, Oracle WebLogic Cloud can create a domain that includes the Java Required Files (JRF) components. A JRF-enabled domain requires an existing database in Oracle Cloud Infrastructure. All Oracle WebLogic Server 11g domains created with Oracle WebLogic Cloud include the JRF components and require a database.

See About the Components of Oracle WebLogic Cloud in Using Oracle WebLogic Cloud.

About the Migration Task Flow

Get an overview of the process that you use to migrate your existing Oracle Java Cloud Service instances to Oracle Cloud Infrastructure.

The following diagram shows the migration topology for a Oracle Java Cloud Service instance. The migration target in Oracle Cloud Infrastructure can be an Oracle Java Cloud Service instance or a domain created with Oracle WebLogic Cloud.

Description of jcs_diagram_migrate_oci.png follows
Description of the illustration jcs_diagram_migrate_oci.png

At a high level, the migration process is comprised of these tasks:

  1. Prepare for the migration and perform any prerequisite tasks in Oracle Cloud Infrastructure.
  2. Migrate any application databases in Oracle Cloud Infrastructure Classic regions to Oracle Cloud Infrastructure Database.
  3. Create a migration controller instance, Control-S, in your Oracle Cloud Infrastructure Classic account. Oracle Cloud Infrastructure Classic Java Migration Tool is installed on this compute instance.
  4. Export the domain configuration, applications and other supporting files from your source Oracle Java Cloud Service instance.
  5. Create the target WebLogic Server domain in an Oracle Cloud Infrastructure region, using either Oracle Java Cloud Service or Oracle WebLogic Cloud.
  6. Import the domain configuration and applications to your target in Oracle Cloud Infrastructure.
  7. Test your applications on the target instance, and perform any other post-migration tasks.

About the Migration Tooling

You can use various tools to automate many of the tasks involved in migrating an Oracle Java Cloud Service instance to Oracle Cloud Infrastructure.

Oracle WebLogic Server Deploy Tooling is an open-source project. It provides scripts that enable you to discover and export the configuration and application files from one Oracle WebLogic Server domain, and then import the configuration and applications into another existing domain.

Oracle WebLogic Server Deploy Tooling exports a domain configuration as a metadata file, and automatically excludes sensitive information like passwords. When updating a domain, you also provide a metadata file. This file needs to describe only the resources that you want to add or update. If an application is already deployed, the tool compares the binaries and determines whether the application needs to be redeployed.

Oracle Cloud Infrastructure Classic Java Migration Tool automates the discovery of Oracle Cloud Infrastructure Classic resources in your account, and generates Terraform configuration files that you can use to recreate these resources in Oracle Cloud Infrastructure. It also automates the installation and execution of the Oracle WebLogic Server Deploy Tooling on both the source and target Oracle Java Cloud Service instances.


Oracle Cloud Infrastructure Classic Java Migration Tool cannot be used to create a domain with Oracle WebLogic Cloud.

Oracle Cloud Infrastructure Classic Java Migration Tool is included in a custom compute image named Oracle Cloud Infrastructure Classic Migration Tools.