Oracle Cloud Infrastructure Documentation

Create an Oracle Integration Instance

Create an Oracle Integration instance in a selected compartment.

Note

  • Your Oracle Integration Generation 2 instance is associated with the IDCS instance to which you are logged in during instance creation. You cannot change this association after instance creation.
  • The steps here apply to Oracle Integration Generation 2 and Oracle Integration for SaaS Generation 2. Differences in instance creation are noted. For more information about the SaaS version, see Oracle Integration for Oracle SaaS.
  • You cannot split a single instance into two parts (for example, into test and development parts). Instead, you must create separate instances for each part.
  1. After signing in to the Oracle Cloud Infrastructure Console, note your selected region.
    Once created, instances are visible only in the region in which they were created. For information about regions, see Regions and Availability Domains.

    Description of select_region.png follows

  2. Open the navigation menu and click Developer Services. Under Application Integration, click Integration.
  3. From the Compartment list, click through the hierarchy of compartments and select the one in which to create the instance. You may need to expand the + icon to find the compartment to use. Compartments can contain other compartments. It may take several minutes for the new compartment to appear after the policy has been created.
    Pick a Compartment list expanded to display a hierarchy of compartments

    Note

    Do NOT create your instance in the root or ManagedCompartmentForPaaS compartment.

    The page is refreshed to show any existing instances in that compartment.
  4. Click Create Integration Instance.
  5. Enter the following details, and click Create:
    Field Description
    Display Name Enter the display name for the instance. Note that the display name becomes part of the URL for accessing the instance.
    Consumption Model Lists consumption models available in this tenancy. Typically, one model is displayed, but multiple consumption models are listed if your tenancy is enabled for more than one. Available models include:
    • Metered (Universal Credits)
    • Subscription (OIC4SaaS)
    • Oracle Integration Government
    Edition Two editions are provided.

    See Oracle Integration Editions to see what's licensed in each edition.

    License Type

    Note: If you are provisioning Oracle Integration for SaaS, this field is not shown.

    • Select to create a new Oracle Integration license in the cloud. This provides you with packages of 5K messages per hour.
    • Select to bring an existing Oracle Fusion Middleware license to the cloud for use with Oracle Integration. This provides you with packages of 20K messages per hour. This option is also known as bring your own license (BYOL).
    Message Packs The message pack options available for selection are based on the version of Oracle Integration instance you are creating.
    • For Oracle Integration: Select the number of message packs. The total number of messages available per pack is based on the License Type option you selected. You can select up to 3 message packs if you bring an existing Oracle Fusion Middleware license (known as BYOL) to the cloud. You can select up to 12 message packs if you create a new Oracle Integration license in the cloud.
    • For Oracle Integration for SaaS: Select the number of message packs to use per month. Each message pack consists of one million messages. You can select up to 43 message packs.
    Notes:
    Access Token If this field is displayed, you are creating an instance as a non-federated user. Sign in as a federated user and restart creating an instance.
    Show Advanced Options
    Custom Endpoint: Configure this tab to use a custom endpoint URL for the instance. The custom hostname you want to map to the instance must already be registered on a DNS provider and its SSL certificate stored as a secret in an OCI Vault. See Configure a Custom Endpoint for an Instance.
    • Hostname: Enter the custom hostname chosen for the instance.
    • Certificate: Provide the location of the hostname's certificate in your OCI tenancy.
      • Compartment: Select the OCI compartment that contains your certificate vault.
      • Vault: Select the vault that contains the hostname’s certificate.
      • Secret: Select the secret corresponding to the hostname’s certificate.

    Tags: Enter a key and optional value. Tags enable you to track resources within your tenancy. See Resource Tags.

    • For Oracle Integration:

      Typically, the selected model is displayed after Consumption Model. If multiple consumption models are listed, choose the model you'd like used for this instance. Note that your dialog may differ, depending on options available for services purchased.

    • For Oracle Integration for SaaS:

      Typically, the selected model is displayed after Consumption Model. If multiple consumption models are listed, choose the model you'd like used for this instance. Note that your dialog may differ, depending on options available for services purchased.

    Instance creation takes some time. If you attempt to click the instance name and receive a 401: Authorization failed or a 404: Not Found error, but followed all the correct steps, instance creation has not completed. Wait a few more minutes.

  6. When instance creation completes successfully, the instance shows as Active in the State column.

Choose a License Type

Select a license type for your Oracle Integration instance.

Note: Choosing a license type applies when provisioning Oracle Integration only. It doesn't apply to Oracle Integration for SaaS.

  • Select to create a new Oracle Integration license in the cloud. This provides you with packages of 5K messages per hour.
  • Select to bring an existing Oracle Fusion Middleware license to the cloud for use with Oracle Integration. This provides you with packages of 20K messages per hour. This option is also known as bring your own license (BYOL).

Choose a Message Pack Number

When creating or editing an instance, specify the number of messages to use.

The message pack options available for selection are based on the version of Oracle Integration instance you are creating or editing. You are responsible for billing based on the message packs value you select.
  • For Oracle Integration: Select the number of message packs. The total number of messages available per pack is based on the License Type option you selected. You can select up to 3 message packs if you bring an existing Oracle Fusion Middleware license (BYOL) to the cloud. You can select up to 12 message packs if you create a new Oracle Integration license in the cloud.
  • For Oracle Integration for SaaS: Select the number of message packs to use per month. Each message pack consists of one million messages. You can select up to 43 message packs.
Note