4 Installing Oracle AIA

This chapter describes how to install Oracle Communications Application Integration Architecture (Oracle AIA) pre-built integrations.

About Installing Oracle AIA

You can install Oracle AIA in two ways:

Installation Assumptions

The instructions in this chapter assume the following:

Installing Oracle AIA by Using Interactive Install

To install Oracle AIA:

  1. Download the Oracle AIA software media pack from the Oracle software delivery Web site, located at:

    http://edelivery.oracle.com

  2. Unzip the software media pack to a temporary directory and navigate to that directory.

  3. Ensure that your JAVA_HOME environment variable is set to the location where you installed the Java Development Kit and added to the PATH variable.

  4. Enter one of the following commands:

    • To run the Installer and save a response file for future silent installations:

      java -jar comms_home_installer_generic.jar -record -destinationFile response_file

      where response_file is the name of the response file, including the complete path to the directory where you want to store the response file.

      Note:

      The response file is saved only after you click Install or Cancel on the Installation Summary screen. If you cancel the installation earlier, none of the information entered is saved.

    • To run the Installer without saving a response file:

      java -jar comms_home_installer_generic.jar

    The Welcome screen of the Oracle AIA Installer appears.

  5. Review the components that will be installed and click Next.

    The Installation Inventory screen appears.

  6. In the Inventory Directory field, do one of the following:

    • On UNIX, enter or browse to the directory for your Oracle Central Inventory.

    • On Windows, verify the automatically populated directory.

  7. From the Operating System Group menu, select the system group and click Next.

    The Choose Installation Directory screen appears.

  8. In the Choose Installation Directory field, enter or browse to the directory in which you want to install Oracle AIA and click Next.

    The Languages Selection screen appears.

  9. Select languages from the Available list and move them to the Selected list by clicking the right arrow.

  10. Click Next.

    The Java Home Location screen appears.

  11. In the Java Home field, enter or browse to the directory where the Oracle Java Development Kit (JDK) is installed and click Next.

    The Installation Summary screen appears.

  12. Review the installation summary.

  13. (Optional) To change any of the information shown on the summary screen:

    1. Select any screen from the navigation panel.

    2. Edit the information.

    3. Select the Installation Summary screen from the navigation panel.

  14. Do one of the following:

    • To cancel the active installation, click Cancel.

      The Installer closes.

    • To complete the active installation:

      1. Click Install.

        The Installation Progress screen appears.

      2. Wait for the progress bar to reach 100% and click Next.

        The Installation Complete screen appears.

      3. Review the information.

      4. Click Finish.

        The Installer closes and the installation is complete.

      5. Review the installation log file and resolve any errors that appear. The log is located in the Install_home/comms_home/logs directory.

      6. Verify that the following directories were created in the installation home directory:

        comms_home

        custom

        inventory

        OPatch

        oracle_common

        oraInst.loc

        oui

      7. Prepare the SOA domain as described in "Preparing the SOA Domain".

      8. Configure and deploy the pre-built integrations that you will use as described in "Configuring and Deploying Pre-Built Integrations".

    If you used the -record option when running the Installer, the values you entered are saved in the response file whether you click Cancel or Install on the Installation Summary screen. See "Installing Oracle AIA by Using Silent Install" for information about using this response file for silent installation.

Installing Oracle AIA by Using Silent Install

You can perform a silent installation using a response file with values recorded by the Oracle AIA Installer.

To perform a silent installation:

  1. Generate the response file by performing an interactive installation and using the -record option as described in "Installing Oracle AIA by Using Interactive Install".

  2. In the command line, navigate to the directory where you unzipped the software media pack.

  3. Enter the following command:

    java -jar comms_home_installer_generic.jar -silent -responseFile response_file

    A message showing installation progress appears. A success message is displayed when installation is complete.

  4. Review the installation log file and resolve any errors that appear. The log is located in the Install_home/comms_home/logs directory.

  5. Verify that the following directories were created in the installation home directory:

    • comms_home

    • custom

    • inventory

    • OPatch

    • oracle_common

    • oraInst.loc

    • oui

  6. Prepare the SOA domain as described in "Preparing the SOA Domain".

  7. Configure and deploy the pre-built integrations that you will use as described in "Configuring and Deploying Pre-Built Integrations".

Preparing the SOA Domain

After installing Oracle AIA, you must prepare the SOA domain by copying domain configuration files and by updating the domain.

Copying Domain Configuration Files

To copy the domain configuration files:

  1. On the system where you installed Oracle AIA, navigate to the following directory:

    Comms_home/comms_home/src/SCEApp

  2. Do one of the following:

    • On UNIX, in the command line, run the following command:

      SCEApp.sh

      When prompted, enter the path to the SOA home directory.

      The script copies the domain configuration files to the appropriate directories.

    • On Windows:

      1. Copy the files in Table 4-1 from Comms_home/comms_home/src/SCEApp to the directories specified in the table.

        Table 4-1 Domain Configuration Files and Their Destination Directories

        File Destination Directory

        aiafp.zip

        Oracle_home/soa

        classes.zip

        Oracle_home/soa/soa/modules/oracle.soa.ext_11.1.1

        oracle.soa.fp_template.jar

        Oracle_home/soa/common/templates/wls

        In a clustered environment, copy the files from their directories on the administration server to the corresponding directories on each managed server.

      2. Unzip aiafp.zip and classes.zip.

        In a clustered environment, unzip the files on the administration server and each managed server.

Updating the Domain

To update the domain:

  1. Update the domain as described in Oracle Fusion Middleware Creating WebLogic Domains Using the Configuration Wizard. On the Templates screen:

    1. Select the Update Domain Using Custom Template option.

    2. Browse to the following directory:

      Oracle_home/soa/common/templates/wls

    3. Select the oracle.soa.fp_template.jar custom template.

    4. Click Next.

    5. Complete the domain update as described in the Fusion Middleware documentation.

  2. Verify that the domain was updated successfully:

    1. Start all servers in the SOA domain.

    2. Log in to Oracle Enterprise Manager Fusion Middleware Control.

    3. From the Target Navigation tree, expand SOA, then the SOA infrastructure element, then the SOA partition element.

      A list of composites deployed on the SOA partition appears.

    4. Verify that the following composites appear:

      • AIAAsyncErrorHandlingBPELProcess

      • Reload Process