Create a Custom Oracle SOA Cloud Service Instance on Oracle Cloud Infrastructure Classic

You service instances by running the provisioning wizard. This section describes the pages that are displayed in the provisioning wizard.

Start the Create Instance Wizard

Not Oracle Cloud Infrastructure This topic does not apply to Oracle Cloud Infrastructure.

Start the provisioning process by creating a new service instance.
  1. Log in to the Oracle SOA Cloud Service console.
  2. Click Create Instance. Screenshot of the SOA Cloud Service Console window with the Create Service button outlined in a red box.
The Create New Instance page is displayed.

Specify Basic Service Instance Information

Not Oracle Cloud Infrastructure This topic does not apply to Oracle Cloud Infrastructure.

On the Instance page of the Instance Creation Wizard, enter basic information for your service instance, including service name, service level, metering frequency, software release, and software edition.
Service Type Components Installed

Service Name

Specify a name that you will use to identify the new service instance. The name must be unique within the identity domain and must meet the following conditions:

  • Must start with a letter

  • Cannot be longer than 50 characters

  • Cannot contain non-alphanumeric character other than the hyphen character — including spaces.

Service Description

You may add an optional description that can be used to help identify this new service. The description is only used during service list display and is not used internally.

Notification Email

(Optional) Specify an email address where you would like to receive a notification when the service instance provisioning has succeeded or failed.

Tags

(Not available on Oracle Cloud at Customer)

(Optional) Select existing tags or add tags to associate with the service instance.

To select existing tags, select one or more check boxes from the list of tags that are displayed on the pull-down menu.

To create tags, click Click to create a tag to display the Create Tags dialog box. In the New Tags field, enter one or more comma-separated tags that can be a key or a key:value pair.

If you do not assign tags during provisioning, you can create and manage tags after the service instance is created. See Creating, Assigning, and Unassigning Tags.

Region

(Available only if your account has regions) Select a region if you want to create the service instance in a specific region, or if you want to use a custom IP network. You must also select a region if you intend to assign reserved IP addresses to your service instance nodes.

Do not select us-phoenix-1, us-ashburn-1, or eu-frankfurt-1. These are Oracle Cloud Infrastructure regions.

The Oracle Database Cloud Service deployment that you intend to associate with your Oracle SOA Cloud Service instance must be in the same region that you select in this field.

If you select No Preference, Oracle SOA Cloud Service will select one of the available Oracle Cloud Infrastructure Classic regions. However, you will not be able to use an IP network or reserved IP addresses for your service instance.

IP Networks

If the regions and IP networks features are supported for your account, during provisioning you can attach the service instance to an IP network that is already created in Oracle Compute Cloud Service. A region name must be explicitly specified when you use an IP network. When you specify an IP network during provisioning, you must also specify a database deployment on Oracle Database Cloud Service or Oracle Database Exadata Cloud Service that is on an IP network. If your Oracle SOA Cloud Service and Oracle Database Cloud Service or Oracle Database Exadata Cloud Service are attached to different IP networks, then the two IP networks must be connected to the same IP network exchange. Access rules required for communication between the Oracle SOA Cloud Service instance and Oracle Database Cloud Service or Oracle Database Exadata Cloud Service deployment are created automatically when connected with IP exchange. See Creating an IP Network  in Using Oracle Compute Cloud Service (IaaS).

This field is not relevant to Oracle Cloud Infrastructure.

Creating IP Networks

  • If the IP Network field is not visible in the wizard for your account, IP network functionality is probably not enabled in your data center. Contact Oracle Support if you want to use the IP network feature for your account.

  • DBaaS Behavior:

    • When you do not choose Region/IP Network in the provisioning screens, Oracle SOA Cloud Service provisioning screens allow you to choose DBaaS that are not in an IP network. This is equivalent to non-IP network functionality.

    • When you choose the Regions/IP Network option in Oracle SOA Cloud Service provisioning screens:

      • The Oracle SOA Cloud Service provisioning screens list all DBaaS entries from all IP networks.

      • The Oracle SOA Cloud Service provisioning screens list DBaaS entries from the same subnet.

      • The provisioning screens do not list DBaaS entries from non-IP networks.

      • You must ensure that you use a DBaaS from an IP network with which your Oracle SOA Cloud Service instance can exchange packets –in other words Oracle SOA Cloud Service and DBaaS should be in the same IP network or in IP networks that are connected with an IP exchange.

      • Internal IP addresses from the IP network subnet are assigned to VMs when provisioning completes.

Updating IP Networks

  • When you update IP networks:

    • Make sure you do not change the IP address of a subnet, only change the IP prefix.

    • The IP prefix should be changed to expand the current IP network. For example, to change the prefix from /27 to /8 to expand the network.

    • Restart VMs from the Oracle SOA Cloud Service console as soon as you update an IP network prefix. Failing to restart the VMs causes console URLs not to work properly during backup..

Deleting IP Networks

  • If you plan to delete the IP network/IP exchange, make sure all VMs and instances are deleted.

  • Instances are no longer functional when the IP networks are deleted. Therefore, the Enterprise Manager, WebLogic and other Oracle SOA Cloud Service consoles are not accessible.

  • To re-enable instances, you can recreate the IP networks/IP exchange with the exact same name and IP subnet (with a similar prefix).

  • Every time an instance is deleted, the private IP address is reclaimed by the subnet.

SSH Public Key

Specify the value of the VM Public Key, or the name of the file that contains the public key value.

Define the public key for the secure shell (SSH). This key is used for authentication when connecting to the Oracle SOA Cloud Service instance using an SSH client.

Click Edit to display the public key input for VM access and specify the public key using one of the following methods:

  • Select Key File Name and click Browse to select a file that contains the public key for the secure shell (SSH).

  • Select Key Value and paste or type a key value in the text box.

  • Select Create a New Key and click Enter. The Provisioning Wizard generates a key for you. When prompted, save it as a file on your hard drive. Select Key File Name and click Browse to select the file.

Bring Your Own License

You may activate the Bring Your Own License (BYOL) version of Oracle SOA Cloud Service and you will be charged the BYOL rate for the activated Oracle SOA Cloud Service provided that you have sufficient supported on-premises licenses as required and specified in the Service Description for Oracle PaaS.

See Overview of Oracle Cloud Subscriptions.

Software Release

Version 12.2.1.3.0 of WebLogic Server and Fusion Middleware is supported.

Note:

  • The software image version 12.2.1.2.0 and 12.2.1.3.0 has replaced version 12.2.1. You cannot upgrade from 12.2.1 to 12.2.1.2.0 or 12.2.1.3.0. Instead, provision a new instance of 12.2.1.2.0 or 12.2.1.3.0, which provides multinode support.

  • If you provisioned version 12.1.3 and later decided to use version 12.2.1.3.0, the upgrade from version 12.1.3 to 12.2.1.3.0 is not done automatically. You must follow the process described in Upgrading to SOA Suite and Business Process Management 12c (12.2.1).

.

Metering Frequency

You will see the Metering Frequency field if you are using a metered account. The default metering frequency is Monthly.

Note: Hourly metering is not currently supported. If you choose the Hourly option you will receive a validation error stating that the service type and hourly metering frequency combination is not a valid entitlement.

Specify the Service Instance Details

Not Oracle Cloud Infrastructure This topic does not apply to Oracle Cloud Infrastructure.

You must configure the size, shape, and other important details for your instance.

Select Service Type

Not Oracle Cloud Infrastructure This topic does not apply to Oracle Cloud Infrastructure.

Select one of the available service types for your Oracle SOA Cloud Service instance.

Table 2-2 12.2.1.3.0 Services

Item Description
B2B with SOA and OSB

Install and configure Oracle SOA Suite, Oracle Service Bus, Oracle B2B, Oracle Technology Adapters, and Oracle Cloud Adapters. See Get Started With Oracle SOA Suite.

When you select this service type, the Enable B2B Adapter for EDI checkbox is presented below the dropdown list. You can choose to enable the B2B Adapter for EDI. See B2B Adapter for EDI.

Important:

Oracle SOA Cloud Service with Oracle Service Bus PS3 instances do not work with Oracle Insight 12.2.1.2

Configure Weblogic Server Access

Specify information about your Oracle WebLogic Server compute shape and administrator details.

Item Description

Compute Shape

Choose a CPU/memory pairing.

Select the number of Oracle Compute Units (OCPUs) and amount of RAM memory that you want to allocate for the load balancer. The larger the compute shape, the greater the processing power.

The valid compute shapes for Oracle Cloud Infrastructure Classic are:

  • OC1M: 1 OCPU and 15 GB memory

  • OC2M: 2 OCPUs and 30 GB memory

  • OC3M: 4 OCPUs and 60 GB memory

  • OC4M: 8 OCPUs and 120 GB memory

Note that you cannot change the compute shape after you have created the Oracle SOA Cloud Service instance.

Cluster Size

SOA Cloud service always creates a domain with one or more servers in a cluster.

Choose the cluster size. Choose between 1, 2, 4 or 8 virtual machines (nodes).

Note: If you configure more than one node, it is highly recommended that you enable the load balancer on the next page of the Provisioning Wizard.

Reserved IPs

Select reserved IP addresses for the nodes in your cluster, or leave the default value as Assign Automatically if you want Oracle to automatically assign IP addresses to these nodes. The number of IP addresses that you select must equal the number of nodes in the cluster.

If using Oracle Database Exadata Cloud Service, you must deselect Assign Automatically and explicitly select an IP address.

This option is displayed only if you selected a specific Region for this service instance.

This field is mandatory if you are using Oracle Database Exadata Cloud Service as your database and optional if you are using Oracle Database Cloud Service.

You create IP reservations by using the IP Reservations tab in the Oracle SOA Cloud Service Console or by clicking the + sign to the right of this field. If you do not see this tab on the console, click the gear icon next to this field and follow the instructions to create your first IP reservation. After creating IP reservations, you need to restart the instance creation wizard. See Create and Manage IP Reservations.

Assign IP Reservations

If you are provisioning an Oracle SOA Cloud Service instance and you associate your service instance with an Oracle Database Exadata Cloud Service database deployment, you must assign the previously reserved IP addresses for your instance nodes.

This task is only required if you plan to use an Oracle Database Exadata Cloud Service database deployment for either the Oracle Required Schema or Application Schema databases.

For information on reserving IP addresses, see Use an Oracle Database Exadata Cloud Service Database Deployment.

  1. Click the Assign IP Reservations button to open the IP Reservations for WebLogic dialog.

    Note that the Assign IP Reservations button is inactive until you specify an Oracle Database Exadata Cloud Service database deployment in the Database Configuration:Name field.

  2. On the dialog, move the IP addresses from the Available list to the Selected list.

    The number of IP addresses you select must be equal to the requested Cluster Size. The first IP address you select is used for the Administration Server node. Subsequent IP addresses are assigned to the remaining Managed Sever nodes.

  3. Click the checkbox adjacent to the text Check this box to confirm that selected IP are opened up on the Exadata firewall.

  4. Click Assign.

You will receive an error message if you click Next and have neglected to specify the reserved IP addresses.

If you need to scale out your service at a later time, you will first need to request another IP reservation.

User Name

The user name of the Oracle WebLogic Server administrator.

Note that you can change the user name through the WebLogic Server Administration Console after you have created the instance.

Password

Specify an Oracle WebLogic Server administrator password that meets the following criteria:
  • It must begin with a letter.

  • It must contain between 8 and 30 characters.

  • It must contain at least one number.

  • Optionally, it can contain any number of the following special characters: “$#_”. For example: Ach1z0#d.

Configure Backup and Recovery

Not Oracle Cloud Infrastructure This topic does not apply to Oracle Cloud Infrastructure.

Specify information about the storage container that will be used to store backups. It’s a good idea to create a separate container for each instance you create.

Note:

You must have a current subscription to Oracle Cloud Infrastructure Object Storage Classic.

Item Description

Storage Container Name

Enter the name of the Oracle Cloud Infrastructure Object Storage Classic container used to provide storage for your service instance backups using the following format:

Storage-storage_identitydomain/containername

For example:

Storage-us4l12opcsoa01/InsightBackup

Note: If the storage is used to back up the database, the name cannot include more than one “-” character in the name. If the name contains more than one “-” character the backup will fail.

By default, all backups that are more than seven days old are moved to the storage service at this URL.

Storage User Name

The name of the Oracle Cloud Infrastructure Classic administrator.

Cloud Storage Password

The password, generated in Oracle Cloud Infrastructure Classic, for the user who created the specified container.

Create Cloud Storage Container

Check this box to have the provisioning wizard use the information you specified above to automatically create the storage container for you.

Database Configuration

Not Oracle Cloud Infrastructure This topic does not apply to Oracle Cloud Infrastructure.

Specify information about your database.

You must have a current subscription to the Oracle Database Cloud Service.

Oracle SOA Cloud Service currently supports the following versions of Oracle Database Cloud Service:

  • Oracle Database 11g release 2

  • Oracle Database 12c release 1 (12.1.0.2)

  • Oracle Database 12c release 2 (12.2.0.1)

Item Description
Name

Select an existing Oracle Database Cloud Service or Oracle Database Exadata Cloud Service instance name. Note that only the Oracle Database Cloud Service in the selected region are available for selection.

PDB Name

Enter an optional pluggable database (PDB) name. If a pluggable database name is not specified, the pluggable database name specified during Oracle Database Cloud Service provisioning is used as the default.

Note:
  • This field is mandatory if using an Oracle Database Exadata Cloud Service instance.

  • Oracle SOA Cloud Service supports the use of only a single pluggable database.

Administrator User Name

Your Oracle Database Cloud Service user name. This value must be set to a database user with SYSDBA system privileges. You can use the default user SYS or any user that has been granted the SYSDBA privilege.

Password

The database administrator password specified when the Oracle Database Cloud Service instance was created.

Note:

Oracle SOA Suite automatically creates SOA schemas in this database, such as SOAINFRA and MDS. The SOA schemas take the same password that you specified in the WebLogic section of this wizard.

Configure Load Balancer

Not Oracle Cloud Infrastructure This topic does not apply to Oracle Cloud Infrastructure.

Specify whether or not you want to use the load balancer.

Note:

If you do not select a load balancer, then the managed server URLs (b2bconsole, worklistapp) are not accessible using the load balancer IP address. You will have to create SSH tunnels to access these URLs.
Item Description

Provision Load Balancer

Choose whether or not to use the load balancer. A load balancer delivers the following benefits:

  • Manages the routing of requests across all managed servers.

  • Enables you to configure the routing policy.

  • Enables you to suspend an Oracle SOA Cloud Service instance temporarily to perform routine maintenance, as described in Suspending an Oracle SOA Suite Cloud Service Instance.

If you have more than one node in your cluster and do not choose a load balancer, then only one server receives all of the work requests, while the other server(s) in the cluster are idle.  The server that receives all of the HTTP requests might become overloaded, while the other servers are under utilized.

Note that you can add a load balancer later if you did not configure a load balancer while you created your Oracle SOA Cloud Service instance. For information on adding a load balancer, see Add a Load Balancer to an Oracle SOA Cloud Service Instance.

Load Balancer Policy

  • Least Connection Count. Passes each new request to the managed server with the least number of connections. This policy is useful for smoothing distribution when managed servers slow down. managed servers with greater processing power receive more connections over time.

  • Least Response Time. Passes each new request to the managed server with the fastest response time. This policy is useful when managed servers are distributed across networks.

  • Round Robin. Passes each new request to the next managed server in line, evenly distributing requests across all managed servers regardless of the number of connections or response time.

Compute Shape

Select the number of Oracle Compute Units (OCPUs) and amount of RAM memory that you want to allocate to the VM for the load balancer. The larger the compute shape, the greater the processing power.

The valid compute shapes for Oracle Cloud Infrastructure Classic are:

  • OC3M: 1 OCPU, 7.5GB RAM

  • OC4M: 2 OCPU, 15.0GB RAM

  • OC5M: 4 OCPU, 30.0GB RAM

  • OC6M: 8 OCPU, 60.0GB RAM

Note that you cannot change the compute shape after you have created the Oracle SOA Cloud Service instance.

Reserved IPs

Select a reserved IP address.

If using Oracle Database Exadata Cloud Service, you must deselect Assign Automatically and select an IP address. You must select a different IP address from what you selected in the WebLogic section of the wizard. That IP address is disabled from selection in this list.

Confirm Your Selections

Not Oracle Cloud Infrastructure This topic does not apply to Oracle Cloud Infrastructure.

The confirmation page displays the configuration values you choose in the provisioning wizard.
Review the service details. If you need to change the service details, use the navigation bar or Previous button at the top of the wizard to step back through the pages in the wizard. Click Cancel to cancel out of the wizard without creating a new service instance. If you are satisfied with your choices on the Confirmation page, click Create.

Note:

It takes about an hour and a half to create the instance. You are notified by email when it has been created.