9 Adding Components to a Quick Start Installation

You can add Oracle Enterprise Scheduler, Oracle B2B, Oracle SOA Suite for healthcare integration, Oracle Business Activity Monitoring, and Oracle Managed File Transfer to your Quick Start installation. You can also obtain an Oracle Stream Analytics runtime environment.

Use this section to walk through the installation process for each component that you can add to a Quick Start installation, or to add components to a completely configured compact domain.

9.1 Orientation

This is where you are in the Quick Start installation and configuration roadmap.

Step Description

Plan your installation.

You used Chapter 1 to decide which distribution and configuration path suits your goals.

Download and install a Quick Start distribution

You downloaded and installed Quick Start for Oracle SOA Suite or Oracle Business Process Management Suite.

Configure a compact domain.

You are configuring or reconfiguring a compact domain.

Develop or test an application.

You will develop or test an application.

9.2 About Adding Components to a Quick Start Installation

To add Oracle B2B, Oracle Healthcare, and Oracle Managed File Transfer to your Quick Start installation, you need to download their independent installers These installers are discussed in Installing Oracle B2B, Oracle SOA Suite for Healthcare Integration, or Oracle Managed File Transfer for Quick Start.

Oracle Business Activity Monitoring and Oracle Enterprise Scheduler do not have separate installers. The compact domain can be configured for these components directly in the domain configuration wizard. Using the domain configuration wizard to update a compact domain is covered in Updating a Compact Domain.

Tip:

To minimize the number of times you have to invoke the Repository Creation Utility and the Fusion Middleware Configuration Wizard, run all installers for all of the components that you want to add before launching the RCU or the Configuration Wizard. Each installer will activate a set of product-specific schemas and provide a set of product-specific configuration templates.

You may also want a runtime environment that can run applications using Oracle Stream Analytics components. This process is reviewed in Understanding Oracle Stream Analytics Design Time.

9.3 Installing Oracle B2B, Oracle SOA Suite for Healthcare Integration, or Oracle Managed File Transfer for Quick Start

This section describes how to add Oracle B2B, Oracle SOA Suite for Healthcare Integration, or Oracle Managed File Transfer to your Quick Start distribution.

9.3.1 Installing Oracle B2B for Quick Start

This section covers how to install Oracle B2B for Quick Start. Make sure you understand the installation options for Oracle B2B, as described in About Oracle B2B.

9.3.1.1 Activating a Limited Oracle B2B Interface without a Full Installation

To activate a limited Oracle B2B user interface without running the full B2B installer, set the following property in Oracle Enterprise Manager Fusion Middleware Control:

b2b.docPluginList=Custom

If you do not set this property, inbound documents will fail with an XEngine lookup error. You will be able to use Custom Documents with this interface.

For more information about using the MBean browser, see Getting Started Using the Fusion Middleware Control MBean Browsers in Oracle Fusion Middleware Administering Oracle Fusion Middleware.

9.3.1.2 Installing Oracle B2B for Quick Start

Oracle B2B and Oracle SOA Suite for Healthcare Integration share the same installer. Obtain the installer zip file labeled fmw_12.2.1.2.0_b2b_Disk1_1of1.zip.

Using the command prompt, navigate to the directory where you downloaded the installer. Unzip the contents. You may have several .jar files, but you will only need to launch fmw_12.2.1.3.0_b2bhealthcare_generic.jar.

Launch the installation wizard with the appropriate command.

Installer Run Command

Generic Installer for UNIX

%JAVA_HOME/bin/java -jar fmw_12.2.1.3.0_b2bhealthcare_generic.jar 

Generic Installer for Windows

Search for cmd.exe in the Start Menu. Right-click the cmd.exe and select Run as Administrator.

In the command prompt, use the Java executable from the JDK on your system. Your command may look like this:

%JAVA_HOME%\bin\java -jar fmw_12.2.1.3.0_b2bhealthcare_generic.jar

Once you have launched the installer, the installation wizard displays the screens listed and described sequentially in Table 9-1.

Table 9-1 Oracle B2B Install Screens

Screen Description

Welcome

This screen introduces you to the product installer.

Installation Location

Use this screen to specify the location of your Quick Start's Oracle home. You are not creating a new Oracle home.

Installation Type

Select the B2B option. This will install the Oracle B2B user interface and XEngine

Prerequisite Checks

This screen verifies that your system meets the minimum necessary requirements.

Installation Summary

Use this screen to verify the installation options you selected. If you want to save these options to a response file, click Save Response File and provide the location and name of the response file. Response files can be used later in a silent installation situation.

Installation Progress

This screen allows you to see the progress of the installation.

Installation Completed

This screen appears when the installation is complete. Review the information on this screen.

When you have exited the installation wizard, an Oracle B2B template will now be a selectable option on the Templates screen during domain configuration.

9.3.2 Installing Oracle SOA Suite for Healthcare Integration for Quick Start

This section covers how to configure your Quick Start installation for Oracle SOA Suite for Healthcare Integration. Make sure you have understood the different configuration options for Oracle SOA Suite for Healthcare Integration described in About Oracle SOA Suite for Healthcare Integration before proceeding.

9.3.2.1 Installing Oracle SOA Suite for Healthcare Integration for Quick Start

Oracle B2B and Oracle SOA Suite for Healthcare Integration share the same installer. Obtain the installer zip file labeled fmw_12.2.1.2.0_b2b_Disk1_1of1.zip.

Using the command prompt, navigate to the directory where you downloaded the installer. Unzip the contents. You may have several .jar files, but you will only need to launch fmw_12.2.1.3.0_b2bhealthcare_generic.jar.

Launch the installation wizard with the appropriate command.

Installer Run Command

Generic Installer for UNIX

%JAVA_HOME/bin/java -jar fmw_12.2.1.3.0_b2bhealthcare_generic.jar

Generic Installer for Windows

Search for cmd.exe in the Start Menu. Right-click the cmd.exe and select Run as Administrator.

In the command prompt, use the Java executable from the JDK on your system. Your command may look like this:

%JAVA_HOME%\bin\java -jar fmw_12.2.1.3.0_b2bhealthcare_generic.jar

Once you have launched the installer, the installation wizard displays the screens listed and described sequentially in Table 9-2.

Table 9-2 Oracle SOA Suite for Healthcare Install Screens

Screen Description

Welcome

This screen introduces you to the product installer.

Installation Location

Use this screen to specify the location of your Quick Start's Oracle home. You are not creating a new Oracle home.

Installation Type

Select B2B with Healthcare to install the B2B user interface, the Healthcare user interface, XEngine, and Healthcare libraries.

Prerequisite Checks

This screen verifies that your system meets the minimum necessary requirements.

Installation Summary

Use this screen to verify the installation options you selected. If you want to save these options to a response file, click Save Response File and provide the location and name of the response file. Response files can be used later in a silent installation situation.

Installation Progress

This screen allows you to see the progress of the installation.

Installation Completed

This screen appears when the installation is complete. Review the information on this screen.

When you exit the installation wizard, an Oracle SOA Suite for Healthcare Integration template will now be available on the Templates screen during domain configuration.

If you want to use the Oracle SOA Suite for Healthcare Integration user interface to exchange healthcare documents, you should review all of the post-installation steps required to activate the Healthcare user interface in Activating the Oracle SOA Suite for Healthcare Integration User Interface.

9.3.2.2 Activating the Oracle SOA Suite for Healthcare Integration User Interface

This section describes how to activate the Oracle SOA Suite for Healthcare Integration user interface to replace the default Oracle B2B interface. Make sure you understand the user interface options described in About Oracle SOA Suite for Healthcare Integration before proceeding.

You should have already run the Oracle SOA Suite for Healthcare Integration installer and chosen the B2B with Healthcare installation option. Now complete the following steps:

  1. Run the RCU. On the Custom Variables screen, input Yes for the Healthcare Integration variable. This creates additional materialized views required by the Healthcare integration software.

    If you do not set this custom variable when creating the SOA schemas for your domain, the Healthcare Integration User Interface will not function properly.

    Note:

    If you already ran the RCU for a previous component and did not input YES for the Healthcare Integration custom variable, you can still set this variable by running the following SQL script on the database:

    ORACLE_HOME/common/sql/soainfra/sql/oracle/b2b_mv.sql

    For more information about the Healthcare Integration variable you set in RCU, see About the Custom Variables Required for the SOA Suite Schemas in Oracle Fusion Middleware Installing and Configuring Oracle SOA Suite and Business Process Management

  2. Run the domain configuration wizard. On the Templates screen, select the Oracle SOA Suite for healthcare integration - 12.2.1.2.0 [soa] template. This changes the default message delivery mode from AQ to JMS, as Healthcare is not supported in AQ mode.

For more information on the Oracle SOA Suite for Healthcare Integration user interface, see Using the Oracle SOA Suite for Healthcare Integration User Interface in Oracle Fusion Middleware Healthcare Integration User's Guide for Oracle SOA Suite.

9.3.3 Installing Oracle Managed File Transfer for Quick Start

This section reviews the installation process for Oracle Managed File Transfer. You need to run this installer before you can configure a Quick Start compact domain with Oracle Managed File Transfer runtime components.

Obtain the installer zip file labeled fmw_12.2.1.2.0_mft_Disk1_1of1.zip.

Using the command prompt, navigate to the directory where you downloaded the installer. Unzip the contents. You may have several .jar files, but you will only need to launch fmw_12.2.1.3.0_mft_generic.jar.

Launch the installation wizard with the appropriate command.

Installer Run Command

Generic Installer for UNIX

%JAVA_HOME/bin/java -jar fmw_12.2.1.3.0_mft_generic.jar

Generic Installer for Windows

Search for cmd.exe in the Start Menu. Right-click the cmd.exe and select Run as Administrator.

In the command prompt, use the Java executable from the JDK on your system. Your command may look like this:

%JAVA_HOME%\bin\java -jar fmw_12.2.1.3.0_mft_generic.jar

Once you have launched the installer, the installation wizard displays the screens listed and described sequentially in Table 9-3.

Table 9-3 Oracle Managed File Transfer Install Screens

Screen Description

Welcome

This screen introduces you to the product installer.

Installation Location

Use this screen to specify the location of your Quick Start's Oracle home. You are not creating a new Oracle home.

Prerequisite Checks

This screen verifies that your system meets the minimum necessary requirements.

Installation Summary

Use this screen to verify the installation options you selected. If you want to save these options to a response file, click Save Response File and provide the location and name of the response file. Response files can be used later in a silent installation situation.

Installation Progress

This screen allows you to see the progress of the installation.

Installation Completed

This screen appears when the installation is complete. Review the information on this screen.

When you have exited the installation wizard, an Oracle Managed File Transfer template will now be a selectable option on the Templates screen during domain configuration.

9.4 Creating Schemas for Quick Start Components

Once you have finished running the installers for the components that you want, run the RCU.

If you have not finished configuring a compact domain for the first time, you should return to Configuring a Compact Domain or Configuring a Compact Domain.

If you are adding components to an existing compact domain, see Updating a Compact Domain.

9.5 Updating a Compact Domain

This section describes the actions you can take to reconfigure your compact domain to add new components.

To add Oracle B2B, Healthcare, or Managed File Transfer, you must have run their separate installers as described in Installing Oracle B2B, Oracle SOA Suite for Healthcare Integration, or Oracle Managed File Transfer for Quick Start before proceeding to the following steps:

9.5.1 Launching the Domain Configuration Wizard

Go to ORACLE_HOME/oracle_common/common/bin for your Quick Start distribution and launch the configuration wizard.

If you have set the ORACLE_HOME environment variable to your Oracle home, you can enter commands similar to the following examples:

Operating System Command

UNIX

cd $ORACLE_HOME/oracle_common/common/bin
./config.sh

Windows

cd %ORACLE_HOME\oracle_common\common\bin
config.cmd

Then navigate through the following configuration screens.

9.5.2 Selecting the Domain Type and Domain Home Location

On the Configuration Type screen, select Update an existing domain.

In the Domain Location field, select the location of the compact domain that you want to update.

9.5.3 Selecting the Configuration Templates

On the Templates screen, make sure Update Domain Using Product Templates is selected. The templates that you have installed already will be greyed out.

Select the templates for the components you want to add to your installation:

  • Oracle SOA Suite for healthcare integration - 12.2.1.2.0 [soa]

    Note:

    For HIPAA documents, you need to select both the Oracle SOA Suite for healthcare integration - 12.2.1.2.0 [soa] template and Oracle B2B - 12.2.1.2.0 [soa] template.

    For HL7 documents, you only need to select both the Oracle SOA Suite for healthcare integration - 12.2.1.2.0 [soa] template.

  • Oracle B2B - 12.2.1.2.0 [soa]

  • Oracle Managed File Transfer - 12.2.1.2.0 [mft]

  • Oracle Business Activity Manager - 12.2.1.2.0 [soa]

  • Oracle Enterprise Scheduler Service Basic - 12.2.1.2.0 [oracle_common]

  • Oracle Enterprise Manager Plugin for ESS - 12.2.1.2.0 [em]

9.5.4 Specifying the Datasource Configuration Type

Select RCU Data to activate the fields on this screen. All of the fields should auto-populate with the values you specified when you first configured your domain.

Click Get RCU Configuration. The following output in the Connection Result Log indicates that the operation succeeded:

Connecting to the database server...OK
Retrieving schema data from database server...OK
Binding local schema components with retrieved data...OK

Successfully Done.

Note:

More information about the RCU Data option can be found in About the Service Table Schema in Oracle Fusion Middleware Creating Schemas with the Repository Creation Utility.

More information about the other options on this screen can be found under Database Configuration Type in Oracle Fusion Middleware Creating WebLogic Domains Using the Configuration Wizard

9.5.5 Verifying the Component Datasources

Verify that the values on the Component Datasource screen are correct for all schemas. If you selected RCU Data on the previous screen, the schema table should already be populated appropriately.

9.5.6 Testing the JDBC Connections

Use the JDBC Component Schema Test screen to test the datasource connections you have just configured. A green check mark in the Status column indicates a successful test.

If you encounter any issues, see the error message in the Connection Result Log section of the screen, fix the problem, then try to test the connection again.

Tip:

More information about the other options on this screen can be found under JDBC Component Schema Test in Oracle Fusion Middleware Creating WebLogic Domains Using the Configuration Wizard

9.5.7 Selecting Advanced Configuration

You do not need any advanced configuration for a compact domain. You can skip through this screen without selecting anything.

9.5.8 Configuring the Domain

This screen shows you the final directory structure and the components and extensions with which your compact domain will be configured.

Review this information and click Update. The configuration progress bar will appear on the next screen.

9.5.9 Reviewing Your Domain Location

Upon successful configuration, the wizard will give you the directory location of your domain and the URL for your administration console access. Take note of both and click Close.

9.6 Understanding Oracle Stream Analytics Design Time

Oracle Stream Analytics design time is included as a JDeveloper extension when you install a Quick Start distribution.

However, Oracle Stream Analytics does not run on the Integrated WebLogic Server.

You must install a separate Oracle Stream Analytics Oracle home and launch the Oracle Stream Analytics-specific server from there to create a compatible runtime environment.

For more information on how to install Oracle Stream Analytics, see Installing and Configuring Oracle Stream Analytics. Then see Standalone-Server Domains in Oracle Fusion Middleware Administering Oracle Stream Explorer to configure an Oracle Stream Analytics domain.

9.7 Next Steps

Once you have verified your Quick Start installation and compact domain connection, you can take any of the following actions:

Action Resource

Deploy a sample application.

See Running a Sample Application.

Make or test an application of your own.

See Getting Started with Developing Applications with Oracle JDeveloper in Oracle Fusion Middleware Developing Applications with Oracle JDeveloper.

Delete your installation.

If you have tested your installation out and are done, see Deinstalling Oracle Quick Start.