Create an Oracle SOA Cloud Service Instance Attached to a Private Subnet

Use the REST API to create an Oracle SOA Cloud Service instance attached to a private subnet.

Note:

You cannot create an Oracle SOA Cloud Service on a private subnet using the Oracle SOA Cloud Service Console.

Before creating an Oracle SOA Cloud Service instance, create an Oracle Cloud Infrastructure native database in the same private subnet. See Create an Oracle Cloud Infrastructure Database for Oracle SOA Cloud Service.

  1. Create a request body in JSON format by using the following template, and save it in a plain-text file (for example, create-soacs-instance-on-oci.json).

    Notes:

    • This template includes only the minimum set of parameters required to create an instance of Oracle SOA Cloud Service running Oracle WebLogic Server Enterprise Edition.
    • This template creates an Oracle SOA Cloud Service instance with Oracle Traffic Director (OTD). If you do not want OTD to be provisioned along with the Oracle SOA Cloud Service instance, then set:
      "provisionOTD":"false",

      and remove the following under "components":

       "OTD":{
               "loadBalancingPolicy":"LEAST_CONNECTION_COUNT",
               "shape":"VM.Standard2.1"
            },
    {
       "region":"us-phoenix-1",
       "edition":"SUITE",
       "purchasePack":"soaosbb2b or mft",
       "vmPublicKeyText":"ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQDOOVKYC3NI6FQd63NTlEGhvGuk7+H69VCYXLC6JGIhaNQGb0DnEukcDVlONInrY0OFKD1NYFGPwuh+C65mgv3af+fCerUedWZwFKzuo+vNikQ9DOI7OIpCN3YHgZW43OmK51G2hfmi7QFjyNpJdUkw2GQb+IlP3lVAF4cQ5Pf1LZfn8oJVfDpAlZuIqR5MBDcoi/dNEO2a6o+Wm5tCOrkTuOLjOFqdWG0ugAsZyz/KwIZL9/ks4AGeM+RrJr8KA6Ck4XlSG62sMD4ph5GZSXQYsvodJjypC8XnAb6nW5LHEq6KYSooG/UBgzUVW0bsxFQoHO1nGtzZmn0KJd5Gu3rt",
       "availabilityDomain":"bcaH:PHX-AD-1",
       "provisionOTD":"true",
       "enableNotification":"false",
       "cloudStorageContainer":"https://swiftobjectstorage.us-ashburn-1.oraclecloud.com/v1/ocitenancey/soabackup",
       "cloudStorageUser":"user@example.com",
       "cloudStoragePassword":"authtoken",
       "serviceVersion":"12cRelease213 or 12cRelease214",
       "serviceLevel":"PAAS",
       "serviceName":"soacsInstanceName",
       "subnet":"ocid1.subnet.oc1.phx.aaaaaaaacukvw55crhp2ekd2f36vltcpsccx43igo3dlezejc3dqwft7dgga",
       "isBYOL":"false",
       "components":{
          "OTD":{
             "loadBalancingPolicy":"LEAST_CONNECTION_COUNT",
             "shape":"VM.Standard2.1"
          },
          "WLS":{
             "adminUserName":"user1",
                 "adminPassword":"password1",
                 "dbaName": "dbuser",
             "dbaPassword": "password2",
             "managedServerCount":"1",
             "connectString": "dbhost:1521/PDB1.subnet.vcn.oraclevcn.com",
             "shape":"VM.Standard2.1"
          }
       },
       "enableAdminConsole":"true",
       "meteringFrequency":"HOURLY"
    }

    For information about the REST API payload, see REST API for Oracle SOA Cloud Service.

  2. Send the REST API request.
    The following is an example of a REST API request to create an Oracle SOA Cloud Service instance:
    curl -X POST https://psm.us.oraclecloud.com/paas/api/v1.1/instancemgmt/identityServiceID/services/soa/instances \
    -u john.smith@example.com:password \
    -H 'X-ID-TENANT-NAME: identityServiceID' \
    -H 'Content-Type: application/vnd.com.oracle.oracloud.provisioning.Service+json' \
    -d @create-soacs-instance-on-oci.json
    • restEndpoint: The REST endpoint URL of Oracle SOA Cloud Service.

      To determine this URL, see "REST API Endpoints for Platform Services" in Getting Started with Oracle Platform Services in the Oracle Cloud Infrastructure documentation.

    • identityServiceID: The identity service ID of your Oracle Cloud account.

      You can find this information on the service details page for any service in the Oracle Cloud Infrastructure Console.

    • user: Your Oracle Cloud user name.

    • password: Your Oracle Cloud password.

    • requestBodyFile: The path and name of the file containing the request body.

    For information about the REST API payload, see REST API for Oracle SOA Cloud Service.

    A message similar to the following is displayed, indicating that the request was accepted.
    {
      "details": {
        "message": "Submitted job to create service [mySOACS] in domain [identityServiceID].",
        "jobId": "50572730"
      }
    }
  3. Wait for the instance to be created.

Notes:

  • If you followed all prerequisites and the instance creation fails, make sure that you don't have firewall settings blocking your request.

  • The compute nodes of Oracle SOA Cloud Service instances that are attached to private subnets in Oracle Cloud Infrastructure have private IP addresses. So you can’t ssh to the nodes or access the administration consoles of such instances from the public Internet.

  • You can access the administration consoles and connect to the nodes of such instances through a bastion host attached to a public subnet or through your on-premises network by using IPSec VPN connectivity. See Extend Your On-Premises Network with a VCN on Oracle Cloud Infrastructure.

    1. Connect to the Oracle SOA Cloud Service instance through SSH using the bastion node. Note that the bastion VM is in same VCN but in a different public subnet.
      ssh -i opc_key opc@publicBastionIP
    2. Inside the bastion node, run the following command to copy the private key to the bastion node, and connect to the Oracle SOA Cloud Service instance through SSH:
      ssh -i /tmp/opc_key opc@privateIP

      where privateIP is the WebLogic Server private IP address or the OTD private IP address.