Create an Oracle Integration Classic (User-Managed) Instance

You can create the following type of Oracle Integration Classic (user-managed) instance.

Recommended Minimum Values for Creating an Instance

The recommended minimum values for creating service instances that include Integrations, Processes, and Integration Analytics are as follows:

  • Managed servers: Two (for high availability)

  • Enterprise Edition Database:

    • Shape: 1 OCPU (OC1M) for each pair of managed servers. Therefore, OC1M for up to two managed servers, OC2M for up to four managed servers, OC3M for up to six managed servers, and so on.

    • Usable Database Storage: 125 GB per managed server

  • Cloud storage: 1 TB

Note:

Oracle Integration Classic does not support the use of an Oracle Real Application Clusters (RAC) database.

Create a Complete Production Instance

You can create a complete production environment instance that provides Integrations, Processes, Integration Analytics, and Visual Builder. There are two options. The option to select is based on whether you want Oracle to create a database for you or you have an existing database that you want to use.

Create a Complete Production Instance that Automatically Creates Your Database

You can create an Oracle Integration Classic (user-managed) instance that automatically creates an Oracle Database Cloud Service instance with the Oracle Cloud Stack template.

What are the Capabilities of this Instance

This option enables you to complete a template that automatically provisions the required set of services together (Oracle Integration Classic, preconfigured Oracle Database Cloud Service, and Oracle Cloud Infrastructure Object Storage Classic container). A stack is an actual provisioned instance of a template.

The template provides two options for provisioning an instance:

  • Use the Oracle-provided template directly without modifications. This option creates an Oracle Cloud Infrastructure Object Storage Classic container and Oracle Database Cloud Service instance with default settings.

  • Create your own customized template by exporting an existing template, customizing the database and storage container settings, and importing it back into the Oracle Cloud Stack. You can configure specific details such as the shape (number of nodes), number of CPUs, amount of memory, database version, database edition (standard (SE) or enterprise (EE), database administrator password, and more.

See Oracle Cloud Stack Manager.

Prerequisites

An Oracle Cloud Infrastructure Object Storage Classic account name is automatically created for you when you purchase your universal credits. You must copy this storage account name from within the Storage Classic tile of your Dashboard page before provisioning Oracle Integration Classic.
  1. Click the hamburger menu menu on the Storage Classic tile.

    Storage Classic tile with hamburger menu at lower right.
  2. Select View Details.

  3. On the Overview tab, scroll to the Additional Information section at the bottom and copy the entire storage account name URL value from the REST Endpoint field. You enter this value when creating an instance with the stack template.

Note:

  • The template does not permit you to reuse databases.

  • The template provides a restricted set of databases, unlike the options provided by provisioning Oracle Database Cloud Service separately.

Creating an Instance

  1. Sign in to your Oracle Cloud account.

  2. On the My Services Console Dashboard page, click Navigation menu icon in the top left corner of the My Services Console Dashboard.

  3. Click Services > Cloud Stack.

  4. Click the Templates tab.

  5. Find the Oracle Integration Classic template named Oracle-IntegrationCloud-CM-Template in the list. You can also search for the name.

    There are two types of templates available. The template icon identifies the type of template:
    • Oracle-created template: Template was created and automatically provided by Oracle.

    • User-created template: Template was created by a user and imported into the Oracle Cloud Stack. For example, you exported the Oracle-provided template, customized the database and storage container settings, and imported it back into the Oracle Cloud Stack.

  6. To view a graphical representation of the components in a template (for example, Oracle Integration Classic, Oracle Database Cloud Service, and Oracle Cloud Infrastructure Object Storage Classic), click the template icon or the template name. You can perform the following tasks from the graphic:

    1. Click the Template tab to view the contents of the template in YAML format. This is the stack template file used to create your instance. This template provides configuration information such as backup and recovery, database backup container, backup container, and database details.



    2. If you want to export the file for customizing, click Export. When customizing is complete, click Import on the Templates page to import the file back into the Oracle Cloud Stack.

      Tutorial icon Tutorial

    3. Click Done when complete.

  7. To create a stack from an Oracle-provided or custom template, click the Create Stack menu icon at the far right of the template to use. This example describes how to edit the Oracle-provided template.

    In the Provision New Oracle Cloud Stack page, the template is prepopulated with information for automatically provisioning Oracle Database Cloud Service and the Oracle Cloud Infrastructure Object Storage Classic container during stack template provisioning.
    Description of stack_templates_wizard.png follows
    Description of the illustration stack_templates_wizard.png

  8. Specify the following details:

    Field Description

    Stack Details

    • Service Name: Enter a stack name. Upon Oracle Integration Classic creation, the stack name points to all instances created and the database created.

    • Description: Enter a description.

    • Template: Displays the template used to create the stack. This field cannot be edited.

    • Notification Email: Enter an email address at which to be notified of instance provisioning progress (for example, when provisioning completes).

    • Tags: Select available tags for assignment or click the icon to define new tags and assign to the service instance. You can use tags to search for and categorize your instances.

    • On Failure Retain Resources: Select to retain all services, even if a failure occurs during provisioning. For example, if selected and Oracle Database Cloud Service was successfully provisioned, but the Oracle Cloud Infrastructure Object Storage Classic container was not, both are retained. This action enables you to debug service failures. If not selected, no services are retained if a failure occurs, even those services that were provisioned successfully.

    Backup and Recovery Configuration

    Enter the following details to automatically create an Oracle Cloud Infrastructure Object Storage Classic container instance for backup and recovery.

    • Cloud Storage Account Name: Enter the storage account name URL value (for example, https://storage_url/Storage-bjones) that you copied from the REST Endpoint field of the Overview tab. This storage account name URL is automatically created when you purchase your universal credits. Do not enter the actual storage container name because the storage container is automatically created during stack template provisioning.

      Note: See the Prerequisites section to copy the automatically-created storage account name from the Storage Classic tile of your My Services page.

    • Cloud Storage User Name: Enter the storage container user name.

    • Cloud Storage User Password: Enter the password for the user name.

    Configuration Parameters

    Select the compute region.

    Service

    • SSH Public Key: Create a new key or upload an existing key.

    • Feature Set: Select the feature set that you want to provision. Visual Builder is automatically installed with each feature set.
      • Integration: Provisions only the Integrations feature of Oracle Integration Classic.

      • Integration and Process: Provisions the Integrations and Processes features of Oracle Integration.

      • Integration and Process + Integration Analytics: Provisions the Integrations, Processes, and Integration Analytics features of Oracle Integration Classic. This selection creates two Oracle Integration Classic services, each having many nodes. Each node shares the same database.

        Note: When provisioning is complete, you must link these two instances together in the Registration page of Oracle Integration Classic. See Register an Integration Analytics Instance to Connect Integration Insight to Integrations.

    • Bring Your Own License: Select to bring an existing Oracle Fusion Middleware license to the cloud for use with Oracle Integration Classic.
    • Initial Number of Nodes: Enter the number of nodes. You can add nodes (scale out) and remove nodes (scale in) later in the Oracle Integration Classic My Services Console.

    Database Administrator Password

    • Database Administrative Password: Enter the password to administer the database. The password must be between 8 and 30 characters with at least one lower case letter, one upper case letter, one number, and one special character (_,#). For example, Ach1z0#d.
    • Confirm Database Administrative Password: Enter the same password again.
  9. When complete, click Next.

  10. Confirm your selections, then click Confirm. If you used the Oracle-provided template instead of a custom template, a database with the following default settings is automatically created.

    • Service name: db

    • Database Edition: Enterprise Edition

    • Subscription type: Hourly

    • SID: ORCL

    • Failover database enabled: No

    • Disaster Recovery enabled: No

    • RAC enabled: No

      Note:

      You must change the default database password listed in the YAML file for the SYS administrator after provisioning completes.
      When provisioning completes, a stack is displayed, a new database is displayed, and one or two new Oracle Integration Classic instances are displayed, each in their own respective My Services Console. You must go to these consoles to perform life cycle management operations such as scaling out, scaling in, and other tasks.

      Note:

      To delete the stack, you must use the Oracle Cloud Stack My Services page to delete all of the related services. For example, if you delete a stack, the Oracle Database Cloud Service, Oracle Cloud Infrastructure Object Storage Classic container, and Oracle Integration Classic instances are all deleted. These instances cannot be deleted individually.

Create a Complete Production Instance that Uses Your Existing Database

You can create an Oracle Integration Classic (user-managed) instance that uses your existing database with the provisioning wizard.

What are the Capabilities of this Instance?

This option provides a simple wizard in which to specify Oracle Database Cloud Service, Oracle Cloud Infrastructure Object Storage Classic, and other details.

This option requires that you first provision Oracle Database Cloud Service before using the wizard. An Oracle Cloud Infrastructure Object Storage Classic subscription and storage account are needed. A storage container can be provisioned before or during use of the provisioning wizard.

Prerequisites

You must complete certain prerequisites before using the provisioning wizard.

Prerequisite Description For More Information...

Create an Oracle Database Cloud Service instance.

This is because during Oracle Integration Classic creation, you are prompted to specify the Oracle Database Cloud Service login credentials and service name.

All Oracle Database Cloud Service configurations are possible.

Tutorial icon Tutorial

Obtain the Oracle Cloud Infrastructure Object Storage Classic account name.

An Oracle Cloud Infrastructure Object Storage Classic account name is automatically created for you when you purchase your universal credits. You must copy this storage account name from within the Storage Classic tile of your Dashboard page before provisioning Oracle Integration Classic. You then specify the Oracle Cloud Infrastructure Object Storage Classic account name when prompted in the provisioning wizard. This action automatically creates an Oracle Cloud Infrastructure Object Storage Classic instance for you.

  1. Click the hamburger menu menu on the Storage Classic tile.

    Storage Classic tile with hamburger menu at lower right.
  2. Select View Details.

  3. On the Overview tab, scroll to the Additional Information section at the bottom and copy the entire storage account name URL value from the REST Endpoint field. You enter this value when creating an instance in the provisioning wizard.

Note: If you want, you can also separately provision the Oracle Cloud Infrastructure Object Storage Classic container before provisioning Oracle Integration Classic. In this case, you specify the existing account and storage container details when prompted in the provisioning wizard.

See Oracle Storage Cloud Service.

Create a Service Instance

Start the provisioning process by creating a new instance:

  1. Sign in to your Oracle Cloud account.
  2. On the My Services Console Dashboard page, click Navigation menu icon in the top left corner of the My Services Console Dashboard.
  3. Click Services > Integration Classic.
    The Oracle Integration My Services Console is displayed.
  4. Click Create Instance.
The Instance page appears.
Specify Service Instance Information

Provide basic information about your new Oracle Integration instance.

Field Description

Instance Name

Specify a name to identify the new service instance. The name must be unique within the tenant domain. You cannot have two instances with the same name at the same time; one instance must be deleted. The service name must meet the following conditions:

  • Must start with a letter [a-zA-Z][a-zA-Z0-9].

  • Cannot be longer than 30 characters.

Description

Optionally add a description to help identify the purpose of this new service. The description is only used during service list display.

Notification Email

Enter an email address at which to be notified of instance provisioning progress (for example, when provisioning completes).

Region

Select the region in which to provision your instance. Otherwise, select No Preference.

Tags

Select available tags for assignment or click + to create new tags to assign to the service instance. You use tags to search for and categorize your instances.

SSH Public Key

Select an option for accessing service host access. This key is used for authentication when connecting to the instance using a secure shell (SSH) client. The same public key is used for all VMs configured for this service instance.

  • Browse for the file containing the VM public key file.

  • Provide a value for an existing VM public key.

  • Create a new private/public key pair. A new key is generated for you. When prompted, save the key as a file on your hard drive.

License Type

Select an option:

  • Select to bring an existing Oracle Fusion Middleware license to the cloud for use with Oracle Integration.

  • Select to create a new Oracle Integration license.

Specify the Feature Set and Database and Storage Details

Specify the Oracle Integration feature set, Oracle Database Cloud Service details, and Oracle Cloud Infrastructure Object Storage Classic container details.

Field Description

Feature Set

Select the feature set:

  • Integration: Installs the Standard Edition of Oracle Integration. This feature set includes Integrations and Visual Builder. This selection uses Standard Edition pricing.

  • Integration and Process: Installs the Enterprise Edition of Oracle Integration. This feature set includes Integrations, Processes, and Visual Builder. This selection uses Enterprise Edition pricing.

  • Integration Analytics: Installs Integration Analytics, which includes Stream Analytics and Integration Insight.

Node Configuration

Select the number of nodes to configure.

Backup and Recovery Configuration

Specify the Oracle Cloud Infrastructure Object Storage Classic container in which to store backups. You can specify an existing storage container or automatically create a new storage container during this Oracle Integration provisioning session.

  • Cloud Storage Container: Specify the container name using the following format:
    Storage-storage_account_name/container_name
    For example:
    Storage-jsmith/JaasBackup
    where:
    • Storage-storage_account_name: Storage container account name. This account is automatically created when you purchase your universal credits.

      Note: See the Prerequisites section to copy the automatically-created storage account name from the Storage Classic tile of your My Services page.

    • container_name: Storage container name of an existing storage container or the name to use to create a new storage container.

  • Cloud Storage User Name: Specify the username.

  • Cloud Storage User Password: Specify the password.

  • Create Cloud Storage Container: Select this check box to automatically create a storage container during Oracle Integration provisioning. If you have already provisioned an Oracle Cloud Infrastructure Object Storage Classic container, leave this check box deselected.

Database Configuration

Specify Oracle Database Cloud Service details.

Note: You must provision Oracle Database Cloud Service before you can use this wizard. Otherwise, no databases are available for selection from the Service Name list and you cannot proceed with Oracle Integration provisioning.

  • Service Name: Select the service name of the database you want to use. Only the service name is displayed. The type of database is not displayed (for example, data guard). For specific details about the database, go to the Oracle Database Cloud Service My Services Console and look for the service name.

  • Pluggable Database Service name: Optionally specify the service name of the pluggable database (PDB). This field is only for version 12c databases. A PDB is a multitenant container database (CDB) consisting of a portable collection of schemas, schema objects, and nonschema objects that appear to an Oracle Net client as a non-multitenant container database (CDB). A non-CDB is a traditional Oracle database that cannot contain PDBs.

  • Database Administrator User Name: Specify the 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.

  • Database Administrator User Password: Specify the password for the administration user. The administrator password was specified when the Oracle Database Cloud Service instance was created.

    Note: Do not specify a password that includes a hyphen.

Instance Administrator Responsibility Acknowledgment

Click to acknowledge that you are responsible for provisioning and administering your own instance, including:

  • Patching

  • Starting stopping instances and individual VMs

  • Starting/stopping Oracle WebLogic Server

  • Scaling in/scaling out

  • Backups

  • Database management

  • Operating system management, including ensuring that you have enough swap space

See Manage Oracle Integration.

Confirm Your Selections

The confirmation page displays the configuration values you selected in the provisioning wizard.

Review the service details and make a copy or a screen capture. 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:

You are notified by email when your Oracle Integration instance has been created.