Create an Oracle Integration Instance

Create an Oracle Integration instance in a selected compartment.

Some restrictions exist for creating instances. See Restrictions.
Note

  • Your Oracle Integration 3 instance is associated with an IDCS instance during instance creation. You cannot change this association after instance creation.
  • The steps here apply to Oracle Integration 3 and Oracle Integration for SaaS. 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 shapes (for example, into test and development shapes). Instead, you must create separate instances for each shape.
  1. After signing in to the Oracle Cloud Infrastructure Console, note your selected region.

    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.
  5. Enter the following details:
    Field Description

    Name

    Enter a name for this instance. The name becomes part of the URL for accessing the instance.

    Version

    Select the version you want to use for this instance:

    • Oracle Integration 3 is the latest generation of Oracle Integration, providing the latest features and infrastructure technology including Integrations, Process Automation, robotic process automation, healthcare, Visual Builder, B2B for Oracle Integration, File Server, and our portfolio of adapters.
    • Oracle Integration Generation 2 is the full-featured premier service, providing features and infrastructure technology including Integrations, Processes, Integration Insight, Visual Builder, B2B for Oracle Integration, File Server, and our portfolio of adapters.

      If you choose to create an Oracle Integration Generation 2 instance, see Provisioning and Administering Oracle Integration Generation 2.

    Note: This field appears only if you can provision both Oracle Integration Generation 2 and Oracle Integration 3 instances. Everyone can provision an Oracle Integration 3 instance. You can create a new Oracle Integration Generation 2 instance only if you have an existing Oracle Integration Generation 2 instance in the region.

    Consumption model

    Typically, only one consumption model is displayed, but if multiple consumption models are available in your tenancy, select the one you want to use for this instance:

    • Metered (universal credit)

      Note: The Healthcare edition is available only in tenancies that use Universal Credits.

    • Subscription (OIC4SaaS)
    • Oracle Integration Government

    Edition

    Select the edition you want to use for this instance:

    • Standard: Includes integrations, standard adapters, recipes and accelerators, Visual Builder, and File Server.
    • Enterprise: Includes all the features of Standard edition, plus additional technologies and services, including enterprise adapters, and enables you to design, automate, and manage your business processes in the cloud with Process Automation, perform UI-based automation with robots using robotic process automation, and support business-to-business communications using B2B for Oracle Integration. This edition also supports disaster recovery.
    • Healthcare: Includes all the features of Enterprise edition, plus additional technologies for Health Level 7 (HL7), including an MLLP adapter, a FHIR adapter, and healthcare action. This edition also supports disaster recovery.

      Note: The Healthcare edition is available only in tenancies that use Universal Credits.

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

    Shape

    Select a shape for this instance. The shape determines when the instance receives updates, which happen every other month.

    • Development: Instances with this shape receive updates two weeks before instances with a Production shape.
    • Production: Instances with this shape receive updates two weeks after instances with a Development shape.

      If you're setting up disaster recovery, you must choose the Production shape.

    Only some regions allow you to choose a shape. If you don't see the option to choose a shape, your instance is created in the Production shape. For details about the shapes that each region supports, see Availability.

    Note: You can't change the shape after you create the instance. However, you can move data to another instance using the export and import features.

    License type

    Subscribe to a new Oracle Integration license

    Note: If you are provisioning Oracle Integration for SaaS, this field is read-only and displays Subscribe to a new Oracle Integration license. The message pack description in this entry—License type, doesn't apply to Oracle Integration for SaaS. For information on Oracle Integration for SaaS message packs, see the next entry—Message packs.

    Select a license type for this instance.

    • Subscribe to a new Oracle Integration license: Select this option if you want to purchase a new license. With this option, each message pack includes 5,000 messages per hour.
    • Existing Oracle Fusion Middleware license (BYOL): Select this option if you want to use your existing license. With this option, each message pack includes 20,000 messages per hour. (This option isn't available for the Healthcare edition.)

    Message packs

    Message pack options are based on the type of Oracle Integration license you have.

    • For Oracle Integration:
      If you created a new Oracle Integration license in the cloud:
      • Each message pack includes 5,000 messages per hour.
      • You can select up to 12 message packs in the user interface.
      If you brought an existing Oracle Fusion Middleware license to the cloud (BYOL):
      • Each message pack includes 20,000 messages per hour.
      • You can select up to 3 message packs in the user interface.
    • For Oracle Integration for SaaS:
      • Each message pack includes one million messages per month.

        Note that usage is tracked on a monthly basis instead of hourly, which keeps costs predictable even when you have unpredictable hourly volumes.

      • You can select up to 43 message packs in the user interface.
    Note:

    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

    Identity domain: (Available only if you are provisioning an Oracle Integration 3 instance that uses identity domains. See Differences Between Tenancies With and Without Identity Domains.) Configure this tab to associate this instance with a secondary identity domain—an identity domain other than the one you're signed into. This allows you to manage all your instances in your tenancy from one domain, rather than having to sign into each domain to manage the associated instances.

    • Change compartment: The compartment you select here is the one that includes the secondary identity domain, not the one in which the instance will be created. The instance will be created in the compartment you selected in step 3.
    • Domain: Select the secondary identity domain you want to associate with this instance.

      Note: You must have read permission for the secondary identity domain. If you don't, the secondary identity domain administrator needs to add an IAM policy such as the following:

      Allow group primary_identity_domain/group_name to read domains in compartment secondary_identity_domain_compartment

      See Managing Policies and Details for IAM with Identity Domains.

    If you configure a secondary identity domain, Oracle Integration creates an Oracle Identity Cloud Service (IDCS) application in the secondary identity domain when it provisions your Oracle Integration 3 instance. If you don't configure a secondary identity domain, the IDCS application is created in the primary identity domain—the one you're signed into.

    After the Oracle Integration 3 instance has been created in the secondary identity domain, you need to assign administrators the ServiceAdministrator role in the IDCS application that was created. See Assign Oracle Integration Roles to Groups in an Identity Domain.

    Network access: Configure an allowlist for your instance. See Configure an Allowlist for Your Instance.

    Disaster recovery: If you want to configure disaster recovery, select Enable disaster recovery. This installs a primary instance in one region and a secondary instance in another region. See Introduction to Oracle-Managed Disaster Recovery in Configuring an Oracle-Managed Disaster Recovery Solution for Oracle Integration 3.

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

    Note: If you want to configure a custom endpoint URL for this instance, you do so after the instance is created. See Configure a Custom Endpoint for an Instance.

  6. Click Create.
    If you have any issues trying to create an instance, see Troubleshoot Oracle Integration Instance Creation.
  7. When instance creation completes successfully, the instance shows as Active in the State column.
    Once created, an instance is visible only in the region in which it was created.

Choose a License Type

Select a license type for your Oracle Integration instance.

  • Subscribe to a new Oracle Integration license: Select this option if you want to purchase a new license. With this option, each message pack includes 5,000 messages per hour.
  • Existing Oracle Fusion Middleware license (BYOL): Select this option if you want to use your existing license. With this option, each message pack includes 20,000 messages per hour. (This option isn't available for the Healthcare edition.)

Note: If you are provisioning Oracle Integration for SaaS, this field is read-only and displays Subscribe to a new Oracle Integration license. The message pack description in this entry—License type, doesn't apply to Oracle Integration for SaaS. For information on Oracle Integration for SaaS message packs, see the next entry—Message packs.

Choose a Message Pack Number

Select a suitable number of message packs to handle the message usage you expect for your instance.

Message pack options are based on the type of Oracle Integration license you have.

  • For Oracle Integration:
    If you created a new Oracle Integration license in the cloud:
    • Each message pack includes 5,000 messages per hour.
    • You can select up to 12 message packs in the user interface.
    If you brought an existing Oracle Fusion Middleware license to the cloud (BYOL):
    • Each message pack includes 20,000 messages per hour.
    • You can select up to 3 message packs in the user interface.
  • For Oracle Integration for SaaS:
    • Each message pack includes one million messages per month.

      Note that usage is tracked on a monthly basis instead of hourly, which keeps costs predictable even when you have unpredictable hourly volumes.

    • You can select up to 43 message packs in the user interface.
Note:

Troubleshoot Oracle Integration Instance Creation

This topic provides some tips for troubleshooting Oracle Integration instance creation.

Oracle Integration 3 is not available to all users or Missing parameter (isByol)

If you receive the error "Missing parameter (isByol)" when you click Create, perform the following steps:
  1. Ensure you can see the Oracle Integration service in the Oracle Cloud Infrastructure Console.
    1. In the Oracle Cloud Infrastructure Console, open the navigation menu and click Identity & Security. Under Identity, click Domains.
    2. Open your domain. The default domain is OracleIdentityCloudService.
    3. On the left, click Oracle Cloud Services.
    4. Search for Integration for the Oracle Integration service:
      • For Oracle Integration, you should see INTEGRATIONCAUTO.
      • For Oracle Integration for SaaS, you should see INTEGRATIONSUB.
    5. If you see the Oracle Integration service, submit a Service Request to Oracle Support.

      If you don't see it, move on to the next step.

  2. If you don't see the Oracle Integration service, confirm that your Cloud Account Administrator activated the Oracle Integration service (by clicking the link in the email titled "XXX").
  3. If the administrator didn't activate the service, have them do so, then try again to create an Oracle Integration instance.
  4. If your Cloud Account Administrator already tried to activate the service or didn't receive the email, contact your account manager to confirm you have a subscription for Oracle Integration.

401: Authorization failed or 404: Not Found

If you click the Oracle Integration instance name just after creating the instance and receive a 401: Authorization failed or a 404: Not Found error, instance creation might still be in progress. Wait a minute and try again.