Create an Instance Using the Command Line

You can provision an Oracle Integration instance using the command line.

You can use the command line in one of two ways:
  • Configure the Command Line Interface (CLI) as described in the Oracle Cloud Infrastructure (OCI) documentation.
  • Use the OCI Cloud Shell, which is preconfigured with the CLI and is accessible from the Oracle Cloud Console.

CLI Command

Use the following CLI command to create an Oracle Integration instance: 

oci integration integration-instance create -c <compartment_ocid> --display-name "Test Instance" --is-byol false --message-packs 1 --domain-id <domain_ocid>
</domain_ocid></compartment_ocid>

For more information, see create in the OCI CLI Command Reference documentation.

Required Parameters

You must include the following parameters.

Parameter name Description Parameter
Compartment Enter the compartment in which you want to create the instance. -c or –compartment-id
Name Enter a name for this instance. The name becomes part of the URL for accessing the instance. –display-name
License type Set this option to TRUE if you want to use an existing Oracle Fusion Middleware license.

See License Types.

–is-byol

Allowed values are TRUE and FALSE.

Message packs Enter the number of message packs you want to subscribe to.

See Edit the Number of Message Packs Using the User Interface.

–message-packs
Edition Enter the edition you want this instance to be.

See Oracle Integration Editions.

–type

Allowed values are STANDARDX, ENTERPRISEX, and HEALTHCARE.

Identity domain This parameter isn't listed as required, but you must included it. Enter the OCID of the identity domain to which you want to associate the instance.

You can't use an identity domain outside your tenancy.

 –domain-id
Shape This parameter isn't required, but it's recommended; it defaults to Production. Enter the shape you want to use for this instance.

See Shapes.

–shape

Allowed values are DEVELOPMENT and PRODUCTION.

Optional Parameters

The following are optional parameters.

Parameter name Description Parameter
Consumption model This parameter is only required if you have both Subscription and UCM entitlements. –consumption-model

Allowed values are GOV, OIC4SAAS, and UCM.

Namespace tags Enter predefined keys scoped to namespaces. –defined-tags

Sample parameter value: 

{"Enterprise-OIC":{"Environment":"Non-Production"}}
Freeform tags Optionally, add tags to help you organize your resources in your tenancy.

See Resource Tags.

–freeform-tags

Sample parameter value: 

{"SampleTag":"TagValue", "SampleTag2":"TagValue2"}
Disaster recovery Set this option to TRUE if you want to configure disaster recovery. This installs a primary instance in one region and a secondary instance in another region. You must have selected ENTERPRISEX or HEALTHCARE as the edition and PRODUCTION as the shape, and you must be in a region that supports disaster recovery pairing.

See Introduction to Oracle-Managed Disaster Recovery in Configuring an Oracle-Managed Disaster Recovery Solution for Oracle Integration 3.

–is-disaster-recovery-enabled

Allowed values are TRUE and FALSE.

Network access Configure an allowlist for your instance. See Configure an Allowlist for Your Instance. –network-endpoint-details

Sample parameter value:

{
  "networkEndpointType":"PUBLIC",
  "allowlistedHttpIps":["129.1.2.0/24","1.2.3.0/24"],
  "allowlistedHttpVcns":["<vcn_ocid1>", "<vcn_ocid2>"],
  "isIntegrationVcnAllowlisted":true
}</vcn_ocid2></vcn_ocid1>