2
Installing OracleAS InterConnect

This chapter contains instructions for installing OracleAS InterConnect.

Topics discussed are:

• Installing OracleAS InterConnect

• Installing OracleAS InterConnect Hub

• Installing OracleAS InterConnect Adapters

• Installing OracleAS InterConnect Development Kit

Installing OracleAS InterConnect

This section contains instructions for installing OracleAS InterConnect.

See Also: Oracle Application Server 10g Release Notes for latest information about OracleAS InterConnect.

Perform the following steps to install OracleAS InterConnect:

1. Insert the Oracle Application Server InterConnect CD-ROM in your CD-ROM drive.

2. Start the Oracle Universal Installer by doing the following:
   • UNIX: Type runInstaller

   • Windows: Double-click setup.exe

     See Also: Oracle Application Server 10g Installation Guide for additional information on invoking runInstaller

3. The Oracle Universal Installer Welcome screen appears. It provides information about Oracle Universal Installer.
   1. Review the Oracle Universal Installer Welcome screen. The following buttons appear on the screen:
      • Deinstall Products: Deinstalls individual components, or the entire product. This button appears only on the Welcome screen.

      • About Oracle Universal Installer: Provides the version number of the installer in use.

      • Help: Provides detailed information about the functionality of each screen.

      • Installed Products: Enables you to view currently installed products, or to deinstall the entire product or components.

      • Next: Enables you to proceed to the next screen.

      • Cancel: Cancels the installation process and exit the installer.

   2. Click Next.

4. The Specify File Locations screen appears.
   1. Enter the following information in the fields provided:
      • Source: The default value displays. Do not change this value.

      • Destination Name: Enter desired Oracle home name.

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

   2. Click Next.

5. The Select Installation Type screen appears.
   1. Select the OracleAS InterConnect installation type from the following list:
      • OracleAS InterConnect Hub

      • OracleAS InterConnect Adapters

      • OracleAS InterConnect Development Kit

        See Also: "OracleAS InterConnect Installation Types" for descriptions of the OracleAS InterConnect installation types

   2. Click Next.

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

• OracleAS InterConnect Hub: Installing OracleAS InterConnect Hub

• OracleAS InterConnect Adapters: Installing OracleAS InterConnect Adapters

• OracleAS InterConnect Development Kit: Installing OracleAS InterConnect Development Kit

Installing OracleAS InterConnect Hub

This section contains instructions for installing OracleAS InterConnect hub.

OracleAS InterConnect Hub installation type installs Oracle Workflow Server and the OracleAS InterConnect repository. This section contains the following topics:

• Hub Preinstallation Tasks

• Hub Installation Process

• Hub Postinstallation Tasks

Hub Preinstallation Tasks

Before installing OracleAS InterConnect hub, verify the values of the following parameters in the init.ora file of the metadata repository database:

• AQ_TM_PROCESSES: Oracle Workflow requires the time manager process in Oracle Advanced Queuing (AQ) to monitor delay events in queues, as in the case of the Oracle Workflow standard Wait activity. The minimum recommended number of time manager processes for Oracle Workflow is one or more. Verify that the AQ_TM_PROCESSES parameter is set in the init.ora file. For example:

  AQ_TM_PROCESSES = 2
  
  

• JOB_QUEUE_PROCESSES: Oracle Workflow leverages Oracle Advanced Queuing, which requires job queue processes to handle message propagation. You must start at least one job queue process to enable message propagation. The minimum recommended number of processes for Oracle Workflow is 10, and may need to be increased if sufficient processes are not available for propagation. Verify that the JOB_QUEUE_PROCESSES parameter is set in the init.ora file to specify the number of SNP job queue processes for your instance. For example:

  JOB_QUEUE_PROCESSES = 10
  
  

  You can either modify the preceding parameters in the init.ora file and restart your database to make the changes effective, or you can use the ALTER SYSTEM statement to dynamically modify the parameter values for the duration of the instance.

  See Also: Oracle9i Reference and Oracle9i Application Developer's Guide - Advanced Queuing

If your integration scenario involves leveraging Oracle Workflow functionality, make sure that you have installed Oracle Workflow in Oracle Application Server middle-tier.

See Also: Chapter 3, "Integrating Oracle Workflow with OracleAS InterConnect" to determine different options for installing Oracle Workflow. Make note of the Oracle Workflow schema password as it is required during the OracleAS InterConnect installation process.

Hub Installation Process

When installing the OracleAS InterConnect hub on a machine that does not contain Oracle Application Server, 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 InterConnect schema.

These dialogs appear after you select OracleAS InterConnect Hub on the Select Installation Type screen.

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

See Also: Oracle Application Server 10g Upgrading to 10g (9.0.4) for your platform for more information on Oracle Workflow migration.

Perform the following steps to install OracleAS InterConnect hub:

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

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

2. The OracleAS InterConnect Hub Database screen appears. Specify database connection information on this 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: SID for the database. The default is iasdb.

   2. Click Next.

3. The OracleAS InterConnect Metadata Repository screen appears. Set the password for the oaihub904 schema on this screen.
   1. Verify the following information:
      • Database: Database indicated on the previous screen. The value is entered as host:port:sid.

      • Schema Name: oaihub904.

   2. Enter the appropriate information in the following fields:
      • Password: New password for the schema.

      • Confirm Password: Re-enter the new password.

   3. Click Next.

4. Another OracleAS InterConnect Metadata Repository screen appears. Set the the password for the owf_mgr schema on this screen.
   1. Verify the following information:
      • Database: Database indicated on the previous screen. The value is entered as host:port:sid.

      • Schema Name: owf_mgr.

   2. Enter the appropriate information in the following fields:
      • Password: New password for the schema.

      • Confirm Password: Re-enter the new password.

   3. Click Next.

5. The Summary screen appears. Review the selections made on previous screens and click Install.

6. The End of Installation screen appears, indicating that the installation has completed. Click Exit to exit the installer.

Hub Postinstallation Tasks

After installing OracleAS InterConnect hub, perform the following postinstallation tasks:

1. Create the OracleAS InterConnect schema in the hub database.

   See Also: ORACLE_HOME/oai/9.0.4/repository/post_installation.txt for instructions on creating OracleAS InterConnect schema

   Make sure you use the same password that you entered during installation.

2. For Oracle Workflow users, perform the tasks listed in Chapter 3, "Integrating Oracle Workflow with OracleAS InterConnect".

Installing OracleAS InterConnect Adapters

This section contains instructions for installing OracleAS InterConnect adapters.

To install one of more OracleAS InterConnect adapters, start the Oracle Universal Installer and complete the following steps.

1. On the Select Installation Type screen:
   1. Select OracleAS InterConnect Adapters.

   2. Click Next.

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

2. The Available Product Components screen appears.
   1. Select the adapter you want to install. The following adapters are available:
      • OracleAS InterConnect Adapter for AQ

      • OracleAS InterConnect Adapter for DB

      • OracleAS InterConnect Adapter for MQ Series

      • OracleAS InterConnect Adapter for FTP

      • OracleAS InterConnect Adapter for HTTP

      • OracleAS InterConnect Adapter for SMTP

      • OracleAS InterConnect Adapter for CICS

      • OracleAS InterConnect Adapter for J.D. Edwards OneWorld XE

      • OracleAS InterConnect Adapter for PeopleSoft 7.5x

      • OracleAS InterConnect Adapter for PeopleSoft 8

      • OracleAS InterConnect Adapter for SAP R/3

      • OracleAS InterConnect Adapter for Siebel 2000

      • OracleAS InterConnect Adapter for Siebel 7

   2. Click Next.

3. For adapter-specific installation information, refer to Table 2-1.

   Table 2-1 Adapter-specific Installation Information

   Adapter	Installation Instructions
   AQ	OracleAS InterConnect Adapter for AQ Installation and User's Guide
   CICS	OracleAS InterConnect Adapter for CICS Installation and User's Guide
   DB	OracleAS InterConnect Adapter for DB Installation and User's Guide
   FTP	OracleAS InterConnect Adapter for FTP Installation and User's Guide
   HTTP	OracleAS InterConnect Adapter for HTTP Installation and User's Guide
   J.D. Edwards OneWorld XE	OracleAS InterConnect Adapter for J.D. Edwards OneWorld XE Installation and User's Guide
   MQ Series	OracleAS InterConnect Adapter for MQ Series Installation and User's Guide
   PeopleSoft 7.5x	OracleAS InterConnect Adapter for PeopleSoft 7.5x Installation and User's Guide
   PeopleSoft 8	OracleAS InterConnect Adapter for PeopleSoft 8 Installation and User's Guide
   SAP R/3	OracleAS InterConnect Adapter for SAP R/3 Installation and User's Guide
   Siebel 7	OracleAS InterConnect Adapter for Siebel 7 Installation and User's Guide
   Siebel 2000	OracleAS InterConnect Adapter for Siebel 2000 Installation and User's Guide
   SMTP	OracleAS InterConnect Adapter for SMTP Installation and User's Guide

Installing OracleAS InterConnect Development Kit

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

• Development Kit Preinstallation Considerations

• Development Kit Installation Process

• Development Kit Postinstallation Tasks

Development Kit Preinstallation Considerations

Consider the following before starting the installation process:

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

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

Development Kit Installation Process

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

See Also: "Installing OracleAS InterConnect Hub"

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

1. On the Select Installation Type screen:
   1. Select OracleAS InterConnect Development Kit.

   2. Click Next.

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

2. The OracleAS InterConnect Hub Database screen appears. Specify database connection information here by entering the following information about the OracleAS InterConnect hub:
   • Host Name: Host name of the OracleAS InterConnect hub. The default is the current host.

   • Port Number: Port number of the OracleAS InterConnect hub. The default is 1521.

   • Database SID: Database SID. The default is iasdb1.

   • Password: Password for the OracleAS InterConnect hub. This password was set up during the OracleAS InterConnect hub installation. If you have not installed OracleAS InterConnect hub, you will need to do so before proceeding with this installation.

     See Also: "Hub Installation Process"

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

3. The Summary screen appears. Review the selections made on previous screens and click Install.The development kit is installed on your machine in the following directory:
   • UNIX: ORACLE_HOME/oai/9.0.4/sdk

   • Windows: ORACLE_HOME\oai\9.0.4\sdk

4. 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.

Development Kit Postinstallation Tasks

(Windows only) If you are using Oracle Workflow, after installing the Oracle Workflow Client, perform the following steps:

Step 1 Set up Oracle Workflow HTML Help

When you install Oracle Workflow Builder while installing Oracle Workflow Client, Oracle Universal Installer copies a .zip file containing the HTML help, wfdoc.zip, in the Workflow directory in your Oracle home, for example, ORACLE_HOME\wf\wfdoc.zip. To view the HTML help, extract the documentation directory tree from the .zip file to your file system:

1. Use an unzip utility to extract the documentation directory tree 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 documentation directory tree, 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, you can modify the font used by the windows in Oracle Workflow Builder to a font that is appropriate 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 tree. 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 (UNIX only) Review Documentation for Custom Adapters

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