1. Using Oracle SOA Suite on Marketplace in Oracle Cloud Infrastructure
  2. Create and View Oracle SOA Suite on Marketplace Instances
  3. Migrate or Upgrade to an Oracle SOA Suite on Marketplace Instance
  4. Migrate Oracle SOA Cloud Service Instances to Oracle SOA Suite on Marketplace Using the Migration Manager
  5. Prerequisites for Migration

Prerequisites for Migration

Prerequisites for Migration in the Source Oracle SOA Cloud Service

Before initiating migration, you must meet or compete the following prerequisites in the source Oracle SOA Cloud Service instance.

  • The source version of the Oracle SOA Cloud Service instance is 12.2.1.3 or higher, with the latest Oracle SOA bundle patch installed. If your Oracle SOA Cloud Service instance is 12.2.1.2 or earlier versions, upgrade to either 21.2.1.3 or 12.2.1.4. See Understand Migration and Side-by-Side Upgrade for SOA Cloud Service.

    Also, ensure that you apply the latest bundle patch. See Patches Installed By Release.

  • If your Oracle SOA Cloud Service instance has Oracle Traffic Director (OTD) load balancer, switch to OCI load balancer and configure the necessary SSL certificates before initiating the migration since OTD is not supported in Oracle SOA Suite on Marketplace. See Administer the Load Balancer for an Oracle SOA Cloud Service Instance.

  • The OCI load balancer is reused in the Oracle SOA Suite on Marketplace instance. After the migration, you must manually update the OCI load balancer’s backend sets with the Oracle SOA Suite on Marketplace virtual machine. See Editing a Load Balancer Backend Set.

  • If the source Oracle SOA Cloud Service instance is built on the Classic Database systems, migrate the RCU schemas to the OCI DBCS. The Oracle domains and RCU schemas are reused in the new Oracle SOA Suite on Marketplace instance, ensuring that the domain-level configurations and deployments remain intact. Make sure that you have the Oracle SOA Cloud Service VM’s SSH private key. The SSH private key must be specified while initiating the migration. Also, ensure that your SSH private key does not contain any passphrase.

  • Shut down the Oracle SOA Cloud Service servers before initiating the migration. See Shut Down and Start Server Process.

    The Oracle SOA Cloud Service Virtual Machines (VMs) must be up and running.

Prerequisites for Migration in the Target Oracle SOA Suite on Marketplace

Oracle recommends auto-provisioning the target Oracle SOA Suite on Marketplace instance. However, you can choose to manually provision the target instance.

If you choose to manually provision the target instance, before you initiate the migration, you must meet or complete the following prerequisites.

  • Provision a new Oracle SOA Suite on Marketplace instance with 23.2.2 or later versions. See SOAMP Provision an Oracle SOA Suite Instance.
    • Provision the target instance in the same subnet as the source instance.
    • Provision the target instance with the same cluster size as the source instance.
    • Provision the target instance with the same WLS admin username, password, domain name, cluster name, admin server name, managed server name, and machine names as the source instance. You can configure custom names in the Advanced Configuration section in the provisioning UI of Oracle SOA Suite on Marketplace.
  • Ensure that the database is accessible from the Oracle SOA Suite on Marketplace instance. The Oracle SOA Cloud Service domains, databases, and RCU schemas are reused by the new Oracle SOA Suite on Marketplace domain, ensuring that all the domain-level configurations and deployments remain intact.
  • Ensure that the database is accessible from the Oracle SOA Suite on Marketplace instance. The Oracle SOA Cloud Service domains, databases, and RCU schemas are reused by the new Oracle SOA Suite on Marketplace domain, ensuring that all the domain-level configurations and deployments remain intact.
  • Make sure you have the Oracle SOA Suite on Marketplace VM’s SSH private key. The SSH private key must be specified while initiating the migration. Also, ensure that your SSH private key does not contain any passphrase.
  • Manually replicate the following in the Oracle SOA Suite on Marketplace instance.
    • Move the custom logic deployments (libraries and web applications) outside the domain home in the source Oracle SOA Cloud Service instance to the same path in the target Oracle SOA Suite on Marketplace instance. The migration manager automatically migrates the custom XPath functions and the adapter configuration files.
    • Replicate the custom entries in the /etc/hosts file in Oracle SOA Cloud Service instance in the Oracle SOA Suite on Marketplace instance.