Skip Headers

Oracle® Application Server Integration InterConnect Installation Guide 10g Release 2 (10.1.2) B14070-02 |
| Contents | Index

Previous | Next |

# 2 Installing OracleAS Integration InterConnect

This chapter contains instructions for installing OracleAS Integration InterConnect. It contains the following topics:

- Preparing for Installation

- Installing OracleAS Integration InterConnect

## Preparing for Installation

This section describes the preinstallation steps that need to be carried out before the installation of the OracleAS Integration InterConnect. It contains the following topics:

- Hub Preinstallation Tasks

- Development Kit Preinstallation Tasks

### Hub Preinstallation Tasks

Hub or adapters can be installed only over an existing Oracle Application Server 10.1.2 Middle Tier and not on any other oracle homes, including new oracle homes. When you install Hub, ensure that the corresponding 10.1.2 Middle Tier is already installed.

To install OracleAS Integration InterConnect on an Real Application Cluster database, you need to manually create `OAIUSERS` tablespace. The data file for this tablespace should be created on the shared storage. By default, OracleAS Integration InterConnect creates this data file in an unshared location. To create the `OAIUSERS` tablespace, log on as system administrator and use the following command.

    CREATE TABLESPACE OAIUSERS DATAFILE '<full path of the shared storage>/oaiusers.dbf' SIZE 50m AUTOEXTEND ON MAXSIZE UNLIMITED;

This command also creates the data file for `OAIUSERS` tablespace on the shared storage.

### Development Kit Preinstallation Tasks

Consider the following before starting the installation process:

- If you are installing OracleAS Integration InterConnect on Sun SPARC Solaris, then the development kit installation option also includes the OracleAS Integration InterConnect SDK.

- If you want to use iStudio, then you must install the OracleAS Integration InterConnect Development Kit on Windows.

When you install iStudio, ensure that it is installed in a new Oracle home or an existing 10.1.2 Middle Tier.

OracleAS Integration InterConnect Development Kit enables you to create custom OracleAS Integration InterConnect adapters. It also installs all dependencies. If you have not installed the OracleAS Integration InterConnect Hub, then you need to do so before proceeding with this installation.

## Installing OracleAS Integration InterConnect

This section contains instructions for installing OracleAS Integration InterConnect.

See Also: Oracle Application Server Release Notes

Perform the following steps to install OracleAS Integration InterConnect:

1. Insert the OracleAS Integration CD-ROM in your CD-ROM drive.

2. Start the Oracle Universal Installer (OUI):

   - UNIX: Type `runInstaller`

   - Windows: Double-click `setup.exe`

   The OUI Welcome screen is displayed as shown in Figure 2-1. It provides information about OUI.

   Figure 2-1 Oracle Universal Installer Welcome Screen

   Description of "Figure 2-1 Oracle Universal Installer Welcome Screen"

3. Click Next. The Specify File Locations screen is displayed as shown in Figure 2-2.

   Figure 2-2 Specify File Locations Screen

   Description of "Figure 2-2 Specify File Locations Screen"

4. Enter the following information in the fields provided:

   1. Source Path: The default value displays. Do not change this value.

   2. Destination Name: Enter the desired Oracle home name, which contains the existing Oracle Application Server 10.1.2 Middle Tier.

   3. Destination Path: Browse or enter the path to your Oracle home.

5. Click Next. The Select a Product to Install screen is displayed as shown in Figure 2-3.

   Figure 2-3 Select a Product to Install Screen

   Description of "Figure 2-3 Select a Product to Install Screen"

6. Select the Oracle Application Server Integration InterConnect. The Select Installation Type screen is displayed as shown in Figure 2-4.

   Figure 2-4 Select Installation Type Screen

   Description of "Figure 2-4 Select Installation Type Screen"

7. Select the OracleAS Integration InterConnect installation type from the following list:

   - OracleAS Integration InterConnect Hub

   - OracleAS Integration InterConnect Adapters

   - OracleAS Integration InterConnect Development Kit

The following links direct you to installation information for each installation type.

- Installing OracleAS Integration InterConnect Hub

- Installing OracleAS Integration InterConnect Adapters

- Installing OracleAS Integration InterConnect Development Kit

### Installing OracleAS Integration InterConnect Hub

This section contains instructions for installing OracleAS Integration InterConnect Hub. OracleAS Integration InterConnect Hub installation type installs Oracle Workflow Server and the OracleAS Integration InterConnect repository.

Hub Installation Process

During the Hub installation process, you see two dialogs, one enables you to specify the database to use as the Hub database, and the other enables you to set the password for the OracleAS Integration InterConnect schema (IC Hub schema).

If you have an existing Oracle Workflow Server setup, then you need to migrate it to Oracle Application Server Workflow Server after Hub installation.

See Also: Oracle Application Server Upgrade and Compatibility Guide

Perform the following steps to install OracleAS Integration InterConnect Hub:

1. Select OracleAS Integration InterConnect Hub from the Select Installation Type screen, then click Next.

2. The Set Oracle Wallet Password screen is displayed as shown in Figure 2-5. Enter and confirm the password on the screen, which will be used to administer OracleAS Integration InterConnect installation passwords.

   Figure 2-5 Set Oracle Wallet Password Screen

   Description of "Figure 2-5 Set Oracle Wallet Password Screen"

   Note: If the InterConnect Wallet does not exist in this Oracle home, then the installation will prompt you to set an InterConnect Wallet password. However, if the InterConnect Wallet already exists, then the installation prompts you to specify its password.

3. The Specify Hub Database screen is displayed in Figure 2-6. Specify database connection information on this screen.

   Figure 2-6 Specify Hub Database Screen

   Description of "Figure 2-6 Specify Hub Database Screen"

   1. Enter database connection information in the following fields:

      - Host Name: Host name for the database. The default is `localhost`.

      - Port Number: Port number for the database. The default is `1521`.

      - Database SID: The database System Identifier (SID). The default is `iasdb`.

      - System Password: The system users password.

   2. Click Next.

4. The Set Schema Password screen is displayed as shown in Figure 2-7. Enter and confirm the password for the `ichub` schema on this screen. The password should be more than 8 characters.

   Figure 2-7 Set Schema Password Screen

   Description of "Figure 2-7 Set Schema Password Screen"

5. Click Next. The Specify Workflow Schema Password screen is displayed as shown in Figure 2-8. Enter the password for the `owf_mgr` schema on this screen. The password should be more than 8 characters.

   Figure 2-8 Specify Workflow Schema Password Screen

   Description of "Figure 2-8 Specify Workflow Schema Password Screen"

6. Click Next. The Summary screen is displayed as shown in Figure 2-9. Review the selections made on previous screens and click Install.

   Figure 2-9 Summary Screen

   Description of "Figure 2-9 Summary Screen"

7. The End of Installation screen is displayed as shown in Figure 2-10, indicating that the installation has completed. Click Exit to exit the installer.

   Figure 2-10 End of Installation Screen

   Description of "Figure 2-10 End of Installation Screen"

   See Also: If you have an existing workflow installation in the hub database, then upgrade the workflow schema to the 2.6.3.5 version by performing the steps documented in Oracle Workflow Installation Notes for Oracle Content Management SDK.

   Note: To configure Oracle Workflow to use a schema in a database different from the InterConnect Hub database, edit the following parameters in the `$ORACLE_HOME/integration/interconnect/workflow/adapter.ini` file to point to the Workflow database.
       aq_bridge_host=mpjoshi-lap
       aq_bridge_port=1521
       aq_bridge_instance=ora10g

### Installing OracleAS Integration InterConnect Adapters

This section contains instructions for installing OracleAS Integration InterConnect adapters. OracleAS Integration InterConnect adapters must be installed on a Oracle Application Server Middle Tier installation. To install one or more OracleAS Integration InterConnect adapters, start the Oracle Universal Installer and complete the following steps.

1. On the Select Installation Type screen:

   1. Select OracleAS Integration InterConnect Adapters.

   2. Click Next.

      See Also: "Installing OracleAS Integration InterConnect" for instructions on how to display the Specify Installation Types screen

2. The Available Product Components screen is displayed.

   1. Select the adapter you want to install. The following adapters are available:

      - OracleAS Integration InterConnect Adapter for AQ 10.1.2.0.2

      - OracleAS Integration InterConnect Adapter for DB 10.1.2.0.2

      - OracleAS Integration InterConnect Adapter for Oracle Applications 10.1.2.0.2

      - OracleAS Integration InterConnect Adapter for FTP 10.1.2.0.2

      - OracleAS Integration InterConnect Adapter for HTTP 10.1.2.0.2

      - OracleAS Integration InterConnect Adapter for IBM WebSphere MQ 10.1.2.0.2

      - OracleAS Integration InterConnect Adapter for SMTP 10.1.2.0.2

      - OracleAS Integration InterConnect EIS Adapter Plugin 10.1.2.0.2

      - OracleAS Integration InterConnect Adapter For JCA 10.1.2.0.2

   2. Click Next.

3. Refer to the adapter guides mentioned in Table 2-1 for adapter-specific installation instructions.

Table 2-1 Adapter-specific Installation Information

Adapter | Installation Instructions
--- | ---
AQ | OracleAS Integration InterConnect Adapter for AQ Installation and User's Guide
DB | OracleAS Integration InterConnect Adapter for DB Installation and User's Guide
FTP | OracleAS Integration InterConnect Adapter for FTP Installation and User's Guide
HTTP | OracleAS Integration InterConnect Adapter for HTTP Installation and User's Guide
WebSphere MQ | OracleAS Integration InterConnect Adapter for WebSphere MQ Installation and User's Guide
OA | OracleAS Integration InterConnect Adapter for OA Installation and User's Guide
SMTP | OracleAS Integration InterConnect Adapter for SMTP Installation and User's Guide
EIS Plugin | Oracle Application Server Adapters Installation Guide
JCA | OracleAS Integration InterConnect Adapter for J2CA Installation and User's Guide

### Installing OracleAS Integration InterConnect Development Kit

This section describes how to install the OracleAS Integration InterConnect Development Kit. It contains the following topics:

- Development Kit Installation Process

- Development Kit Postinstallation Tasks

#### Development Kit Installation Process

Perform the following steps to install the OracleAS Integration InterConnect Development Kit:

1. On the Select a Product to Install screen, select Oracle Application Server Integration InterConnect.

2. Click Product Languages. The Language Selection dialog box is displayed.

3. Select all the languages in the Available Languages list.

   Note: To view data in languages such as Japanese, Korean, Traditional Chinese, and Simplified Chinese, the correct fonts have to be installed. The installation of the font is based on the language selected. For example, if you select Korean among the languages, then the Korean font is installed. Hence, to view data in Japanese, Korean, Traditional Chinese, and Simplified Chinese, select the relevant languages.

4. Click the right arrow. All the languages are displayed in the Selected Languages list. Click Ok.

5. Click Next. The Select Installation Type screen is displayed.

6. Select OracleAS Integration InterConnect Development Kit, and then click Next.

7. The Set Oracle Wallet Password screen is displayed, as shown in Figure 2-5. Enter and confirm the password on the screen, which will be used to manage OracleAS Integration InterConnect installation.

   - Go to step 8, if installing in an OracleAS Middle Tier Oracle home that does not have an InterConnect component already installed. Ensure that the OracleAS Integration InterConnect hub has been installed.

   - Go to step 9, if installing in an OracleAS Middle Tier Oracle home that has an existing InterConnect component. Ensure that it is a home directory to an OracleAS Integration InterConnect component.

   Note: If the InterConnect Wallet does not exist in this Oracle home, then the installation will prompt you to set an InterConnect Wallet password. However, if the InterConnect Wallet already exists, then the installation prompts you to specify its password.

8. Click Next. The Specify Hub Database Connection screen is displayed, as shown in Figure 2-6. Enter the host name, port, system identifier, and InterConnect users password for the database.

   Note: This screen appears only when all of the following conditions are met: You are installing the OracleAS Integration InterConnect Development Kit on a UNIX platform. The Oracle home in which you are installing the OracleAS Integration InterConnect Development Kit does not have any OracleAS Integration InterConnect components.

9. Click Next. The Summary screen is displayed. Review the selections made on previous screens and click Install. The development kit is installed on your computer in the following directory:

   - UNIX: `ORACLE_HOME``/integration/interconnect/sdk`

   - Windows: `ORACLE_HOME``\integration\interconnect\sdk`

10. The End of Installation screen is displayed, indicating that the installation has completed. Click Exit to exit the installer.

#### Development Kit Postinstallation Tasks

On Windows, configure Oracle Net using the Oracle Net Configuration Assistant. Select the typical configuration option and follow the directions in the configuration assistant help to complete the configuration. If you are using Oracle Workflow, after installing the Oracle Workflow Client, perform the following steps:

Step 1 Set up Oracle Workflow HTML Help

If you install Oracle Workflow Builder while installing Oracle Workflow Client, then OUI copies a `.zip` file containing the HTML help, `wfdoc.zip`, to the Workflow directory in your Oracle home. For example, `ORACLE_HOME``\wf\wfdoc.zip`. To view the HTML help, extract the doc directory list from the `.zip` file to your file system:

1. Use an `unzip` utility to extract the doc directory list from the `.zip` file within the Workflow directory. You need at least 7 MB of free disk space to extract the `.zip` file. Extract the files to `ORACLE_HOME``/wf/`. You should get the following subdirectories:

   - `ORACLE_HOME\wf\doc`\lang\`wf`: Contains Oracle Workflow Guide.

   - `ORACLE_HOME\wf\doc`\lang\`wfcust`: Contains custom help. You can add your own customized Workflow help in this directory.

2. After extracting the doc directory list, you can remove the `.zip` file. This step is optional.

3. You can now view the HTML help using a Web browser.

   The path for the contents page of the Oracle Workflow Online Help is:

       ORACLE_HOME\wf\doc\lang\wf\toc.htm

   The path for the contents page of your custom Oracle Workflow Online Help is:

       ORACLE_HOME\wf\doc\lang\wfcust\wfcust.htm

4. To add custom help, replace the placeholder file in the `wfcust` directory, `wfcust.htm`, with your own help material. The HTM file that is the main entry point for your custom help must be named `wfcust.htm` and must contain an anchor named `contents`. Your custom help is accessible through the Custom Help link on the contents page of the Oracle Workflow Online Help. This step is optional.

Step 2 Modify Fonts in Oracle Workflow Builder

If you are installing Oracle Workflow Builder in another language, such as Japanese, then you can modify the font used by the windows in Oracle Workflow Builder to a font that is suitable for your language. Any change you make applies to all windows within the program. This step is optional.

1. Choose Font from the View menu in Oracle Workflow Builder to display the Fonts properties page.

2. Select the font you want to use in the labels for your icons and in the navigator list. The Sample region shows the appearance of the font you select. For example, when using Oracle Workflow Builder in Japanese, you might choose the font MS PGothic.

3. Select the font style, for example, regular, bold, italic, or bold italic. Some fonts have a limited selection of font styles.

4. Select the font size. Some fonts have a limited selection of font sizes.

5. Select the Underline or Strikeout check boxes to apply those effects.

6. Click OK when you are finished.

7. Close and restart Oracle Workflow Builder. The new font settings should have taken into effect.

Step 3 Review Documentation for Custom Adapters

If you need to create custom adapters and browsers, then refer to the documentation in `ORACLE_HOME``/integration/interconnect/sdk/cookbook.zip.`This step is optional.

Note: You can use assistive technologies, such as JAWS screen reader, with InterConnect by installing Java Access Bridge. For more information about installing Java Access Bridge, see Oracle Application Server Installation Guide.