Oracle
Applications Interconnect Installation Guide Release 3.1.3 Part Number A86040-01 |
|
Release 3.1.3 Installation Guide
Part No. A86040-01
This guide explains the installation of Oracle Applications InterConnect Release 3.1.3. Please check that your system meets all the hardware and software prerequisites before starting the installation of these products.
This guide explains the installation of Oracle Applications InterConnect Release 3.1.3.
There are a total of eight broad steps to install OAI and all its dependent components. The guide lists these steps one by one in the order you should follow them. Each step has a number of substeps. The guide is organized such that you can begin from page 1 and go to the end of the guide without having to jump around sections and have a fully installed working OAI system.
Throughout this documentation, <variable_name> refers to variables suppliedby the user. For example, <ORACLE_HOME> refers to the top-level directory used during Oracle software installation. $VARIABLE_NAME refers to system environment variables. The notation $ORACLE_HOME is reserved for the Oracle home directory on Unix platforms.
OAI is a hub'n'spoke end to end integration solution. The following is a list of components that need to be installed.
Note:All of the following components can be found on the Oracle 8i Release 3 (8.1.7) CD. There is one Oracle 8i Release 3 (8.1.7) CD per platform. Currently OAI is supported on NT and Solaris. Use the NT or Solaris CD to install these components. Most of the installation steps are not platform specific. The ones that are, are clearly marked.
Oracle Applications InterConnect is comprised of three major components:
iStudio is a wizard-based tool used to specify and configure the integration. It enables you to model hierarchical data that represent business objects you are integrating between applications. It is used to specify data transformations, and supports publish/subscribe, request/reply, and point-point messaging paradigms.
The Repository stores iStudio-generated metadata, that encapsulates all the integration information.
Adapters are software modules that plug into applications to make them Applications InterConnect enabled. Each adapter is a runtime component that manages all information flow between a particular application and OAI. Adapters may be specialized for use with applications.
Applications InterConnect includes four specialized adapters:
Two XML adapters are available--one for use with Oracle 8.1.5, and one for use with Oracle 8.1.6/8.1.7. For more detailed information please refer to the users guide.
There is absolutely no restriction on where each of the components listed above reside--it could range from all components on one machine to each component on its own dedicated machine. We, however, recommend the following topology:
A CD-ROM drive to install Applications InterConnect, or the ability to access a CD-ROM drive over the network.
Note:Do not run an install on a Solaris machine using Exceed on a remote machine. This can cause problems during install.
The SAP adapter can only run on an NT machine
OAI works on JRE 1.1.8.
Note:You do not need to install JRE or JDK 1.1.8 prior to OAI install. The OAI install bundles JRE 1.1.8 with it and will install it for you. The following is information on the Solaris patch required for proper functioning of Java programs.
(Reproduced from the README for JDK 1.1.8_10 for Solaris/SPARC)
Solaris 2.5.1, Solaris 2.6 or Solaris 7 with at least the required patches from the table below installed. The patches in the table can be downloaded from http://www.sun.com/solaris/java or obtained from your service provider. The two digit number following the dash in each patch id is the revision of that patch. The table lists minimum revisions that this release was tested with; later revisions are acceptable.
(1) - recommended for locales which use traditional Chinese characters. In addition to the patches listed here, you may also want to install the latest patch cluster for your version of Solaris, which includes additional recommended and security patches. Solaris patch clusters are available for download on the Web; follow the appropriate links starting at http://sunsolve.sun.com.
Use the command 'showrev -p' to list the patches installed on your system. If the required/recommended patches are not already installed, follow the steps below:
Solaris 2.5.1: $ tar xvf 1.1.8_10_patches_sparc_5.5.1.tar
Solaris 2.6: $ tar xvf 1.1.8_10_patches_sparc_5.6.tar
Solaris 7: $ tar xvf 1.1.8_10_patches_sparc_5.7.tar
This will create a number of patch archives with names like <patch-id>.tar.Z.
$ zcat <patch-id>.tar.Z | tar -xvf -A directory with a name like <patch-id> will be created for each patch. General instructions for patch installation are included in the Install.info file in the top-level directory of each patch. In addition, special installation instructions or post-installation requirements (such as a system reboot) appear in the README file included with each patch, along with a list ofbug ids fixed and files changed by that patch.
# shutdown
Most patches can be installed using the commands below; however the Install.info and README files for each patch should be consulted. In the commands below, replace <your_patch_directory> with the path to the directory where the patches were extracted.
Solaris 2.5.1 (repeat these steps for each patch):
# cd <your_patch_directory>/<patch-id>
# ./installpatch .
Solaris 2.6 and Solaris 7:
# patchadd -M <your_patch_directory> <patch-id> <patch-id> ...
# shutdown -i6
To successfully install Oracle Applications Interconnect and its dependent components, it is important to install the products in the order listed here:
Note:Do not multi-select items when installing. Install components in the order listed below ONE by ONE.
This should also install database 8.1.7 automatically.
Refer to Oracle 8i Release 3 (8.1.7) Installation Guide on information on installing this component. OID can be found in the Management and Integration section of Oracle 8i Release 3 (8.1.7).
OID installation will install the database for you. Even though the install allows you to use an already installed database instance, DO NOT install OID on top of a pre-installed database.
All OAI components (repository, adapters, iStudio, console) and OMB communicate to each other using CORBA. To find each other, they need a location service. OID provides that location service. These components use OID for storing and accessing CORBA object references.
In particular, both the repository and OMB store their CORBA object references in OID in a predefined place (configured through OAI and OMB installs). The adapters look up OID in the same predefined place to access both OMB and repository connection information. And, iStudio looks up OID to access repository connection information.
In the Oracle Universal Installer program, in the "Available Products" screen, select Oracle 8i Management and Integration 8.1.7.
Now you will see four choices for Installation Types. Select Custom.
Note:Do not select Oracle Integration Server even though it lists OMB as one of its components. The OMB version that works with OAI can be found under the Custom selection.
You will now see a product hierarchy starting with Oracle 8i Management and Integration as the first element. Deselect all elements immediately under this node except for Oracle integration Server 8.1.7.
Note:You should deselect Oracle Workflow and Oracle Partitioning before you deselect Oracle 8i Server. Otherwise, you will not be able to deselect Oracle 8i Server.
Advanced Security feature is selected automatically when OMB is selected. This is ok.Now, refer to the Oracle Message Broker 2.0.1.0 Installation Guide for instructions.
If you are installing OMB specifically for OAI, specify the values listed below for these specific steps during installation.
On the Suffix screen:
Be sure to write down the values you supply in this step on paper. You will need to supply them later during OAI installation.On the LDAP Information screen:
This is not the DHCP name. The default is the host name determined by the installer. If it is a DHCP name, you MUST change it to the computer name.
Be sure to write down the values you supply in this step on paper. You will need to supply them later during OAI installation.
On the Authentication Methods screen: On the Summary screen:Please make sure that OID and the TNS listener are started. Refer to the OMB Installation Guide (Post Installation Tasks chapter) for more detail.
If you installed OMB specifically for OAI, specify the values listed below for these specific steps during post-installation.During the "Directory Configuration" post installation step:
For the "update the directory schema using the LDAPSchema command" step use the following command line options:
For the "modify the directory for OMB suffix with the InitDir command" step use the following command line options: Perform the Oracle Advanced Queueing Configuration step.For the "Configure database parameters" step provide the following values:
Do not perform any other optional steps--MQSeries, TIBCO, Async Component Invocation, or AQLite.
After the post installation step are done, you need to initialize OMB so that topics and queues can be installed later.
Start ombadmin tool.This tool must be on your path. If you get the "not found" message, please make sure that you've run the "setenv" script supplied by OMB. To find more details on "setenv", please refer to the OMB installation guide.
Do not modify any of the fields on the login screen.
On the main screen: In the wizard...On the welcome screen:
On the Create a new or select an existing OMB instance screen: On the Create a new OMB instance screen:
You will need to provide this information duing OAI installation.
On the Create Message Broker screen: On the Select Servers and Drivers to Add screen: On the Create an Oracle AQ Server screen:
On Solaris:
On NT:
OMB is the store and forward unit for messages and acts as the messaging hub in the OAI hub'n'spoke architecture. OAI adapters use Java Message Service (JMS), provided by Oracle Message Broker, for sending and receiving messages. Please refer to OMB's user guide for more details.
At this point all dependent products have been installed. Now we need to install OAI components.
OAI can be installed from the Oracle 8i Release 3 (8.1.7) NT or Solaris CD. Here are the general steps to navigate the CD to reach OAI components:
On the Welcome screen:
On the File Locations screen:
On the Available Products screen:
On the Installation Types screen:
On the Available Product Components screen:
If you don't click them in the order listed, you may not be able to deselect the Oracle 8i Server.
Now you're ready to install OAI components.
Please follow the steps outlined in "Where do you find the OAI components" before performing the following steps
Note:Before installing the repository, please make sure that the hub database (installed through OID) is up and running. For details on how this database is used by the repository, please see "Repository Architecture Details", .On the Available Product Components screen:
On the Application Interconnect Repository screen:Before proceeding to the next step, please review "Repository Architecture Details", if you are unfamiliar with what the repository is. This is relevant to the install.
On the Repository Configuration screen, provide the following information:
This is not the DHCP name. The default is the host name determined by the installer. If it is a DHCP name, you should change it to the computer name. Be sure to write the repository name and host name on a piece of paper. You will need to supply this information during adapter installation.
On the Database Configuration screen:
This is the database which the repository Java program connects to. Please read "Repository Architecture Details", for more information.
On the Oracle Internet Directory Configuration screen:
You will need the piece of paper where you noted down OID specific information during OMB install (Refer to Step 2.4 and 2.5).
All this information is utilized by the repository to locate the OID instance in the hub so that it can put it's CORBA identification information (IOR) in OID to be used by iStudio and adapters to connect to it.
On the Summary screen:
\[ORACLE_HOME]\OAIRepository31\[your repository name]
The repository consists of two components:
In the install program and this installation document, all references to "repository" should be considered references to the Java API layer (item 1 above). All references to "repository database" should be considered references to item 2 above.
All OAI components talk to the Java layer and not directly to the database.
The database instance used for the repository is typically the same one used by OMB and OID. You don't need a separate physical database or even another instance for the repository. The repository install creates a user and all its schema is contained within that user in the database.
The repository is used to store integration information as metadata. iStudio connects to the repository at design time and pushes the mapping information modeled into the repository. At runtime, the adapters access the repository and use the metadata as runtime instructions for doing transformations and other functionality.
Please follow the steps outlined in "Where do you find the OAI components" before performing the following steps.
On the Available Product Components screen: On the iStudio Installation screen:On the Oracle Internet Directory Configuration screen:
During this step, refer to the information you wrote down regarding OID specific information during OMB install (Refer to Step 2.4 and 2.5).
This information is used by iStudio to locate the OID instance in the hub so it can pull the repository's CORBA identification information (IOR) from OID. With that information, iStudio can connect to the repository.
On the Summary screen:\[ORACLE_HOME]\OAIIstudio31
All integration logic is captured in metadata modeled through iStudio. You have two choices:
Regardless of whether you used method 1 or 2 to model your integration, you need to start up iStudio for the following tasks:
Note:For instructions on starting iStudio, please refer to "How To Start and Stop OAI Components", near the end of this guide. Note down what the application names are on paper.
You will need to supply this information when you install the adapters. The application names can be found on the left hand side main navigator screen under Applications.
In iStudio, multi consumer queue corresponds to topic; single consumer queue corresponds to queue.
You will need to note down all queues and topics that need to be configured under AQ for the next step.
This tool must be on your path. If you receive the "not found" message, please make sure that you've run the "setenv" script supplied by OMB. To find more details on "setenv", please refer to the OMB installation guide.
From the Tool menu:
Note:In iStudio, multi consumer queue corresponds to topic; single consumer queue corresponds to queue.
For each topic or queue, you must go through the wizard and create it.
There are several adapters that come packaged with OAI. They are as follows:
Please follow the steps outlined in "Where do you find the OAI components" before proceeding to install a specific adapter.
On the Repository Configuration screen:
You will need the piece of paper on which you noted this information down during repository install (Step 3.3).
On the Oracle Internet Directory Configuration screen:
You will need the piece of paper where you noted down OID specific information during OMB install (Step 2.4 and 2.5).
All this information is utilized by the adapter to locate the OID instance in the hub so that it can pull the repository's and OMB's CORBA identification information (IOR) from OID. With that information, the adapter can connect to the repository and OMB.
On the AQ Database Configuration screen:
This is the database on the application side from which the adapter will either put or get messages from AQs. This is NOT the information for the hub database.
The application that will write to the AQ will use a consumer name to indicate that OAI should pick this message up. To figure out what consumer name you should use, there are two options.
Option 1
If the piece of code that will write the message to the AQ is already written, you can look at that code or the documentation that comes with it to figure out what the consumer name is. For example, for iProcurement to SAP integration, the consumer name can be found in their documentation.
Option 2
If the piece of code that will write the message to the AQ is not written, you can type in any string as the consumer name. When that piece of code is built, you must ensure that the consumer names match.
\[ORACLE_HOME]\OAICRMAdapter31\[AppType][Partition]
You can install the DB Adapter on Oracle 7.3.x or 8.0.x or 8i databases. All other components of Applications InterConnect require Oracle 8i.On the Available Product Components screen:
On the Welcome to the Adapter Installation screen: On the Application Identification screen:
On the Repository Configuration screen:
You will need the piece of paper on which you noted this information down during repository install (refer to Step 3.3).
On the Oracle Internet Directory Configuration screen:
You will need the piece of paper where you noted down OID specific information during OMB installation (Step 2.4 and 2.5.)
All this information is utilized by the adapter to locate the OID instance in the hub so that it can pull the repository's and OMB's CORBA identification information (IOR) from OID. With that information, the adapter can connect to the repository and OMB.
On the Application Database Connection Configuration screen:
This information is regarding the application database that this adapter will connect to, NOT the hub database.
On the Application Database User Configuration screen:
This information is utilized to figure out where will the stored procedures generated through iStudio be installed for application inbound messages. At runtime, the db adapter will utilize this information to call user specified stored procedures. This can be a existing user.
You may, but are not required to create a separate OAI user.
\[ORACLE_HOME]\OAIDBAdapter31\[AppType][partition]
On the Repository Configuration screen:
You will need the piece of paper on which you noted this information down during repository install (Refer to Step 3.3).
On the Oracle Internet Directory Configuration screen:
You will need the piece of paper where you noted down OID specific information during OMB install (Refer to Step 2.4 and 2.5).
All this information is utilized by the adapter to locate the OID instance in the hub so that it can pull the repository's and OMB's CORBA identification information (IOR) in OID. With that information, the adapter can connect to the repository and OMB.
On the SAP Configuration screen:
Here is a description of each:
Depending upon what you select, you might or might not see some of the screens listed below.
On the IDOC Destination Configuration screen:Type the IDOC Destination. This question will be asked only if the SAP Adapter will be sending or receiving IDocs.The IDoc Destination is the program id of a valid RFC destination in SAP which SAP will use to send IDocs to the SAP Adapter or receive IDocs from the SAP Adapter. See the seciton titled "Common Questions about the SAP Adapter" for details on how to configure a valid RFC destination in SAP.
On the Sender Partner Configuration screen:This screen will show up only if the SAP Adapter will be sending IDocs into SAP.
Configure this information about the partner which is sending the IDocs into SAP.
On the Recipient Partner Configuration screen:This screen will show up only if the SAP Adapter will be sending IDocs into SAP.
Configure this information about the partner in SAP which is receiving the IDocs.
On the Summary screen:\[ORACLE_HOME]\OAISAPAdapter31\[AppType][Partition]
After installing the SAP adapter, make sure the file librfc32.dll is in the system path variable. librfc32.dll is distributed with the SAP system this adapter will connect to. We recommend you install the dll in the\[ORACLE_HOME]\OracleSAPBridge31\bin directory.
OAI does NOT provide this dll.You must export one file from SAP which contains information about the IDoc structure of all the IDocs which the SAP Adapter will be using. This file should have the same information which you used to import the IDoc in iStudio. The file must be named ALL.<segment release version>. <SAP version>
Normally the two values are the same. So for example for SAP version 4.0B, this file would be named ALL.40B.40B.
If you don't perform this step correctly, you may encounter the following error when you run the SAP adapter:
"** Error: The IDoc repository could not be initialized from the from the repository file ([file name]) because of an error: io error: syntax file [file name] cannot be opened ([file name]). Please make sure you have the correct IDoc repository file, save log files and contact the integration team".
Log on to SAP as the same user that you specified during the SAP Adapter install using the SAP Frontend. Call SAP transaction SM59 or go to Tools->Administration->Administration->Network->RFC destinations.
Hit F8 or the Create button. Type in any name for your RFCdestination, specify T for connection, enter some description, check the "Current User" option and push the save button or type Ctrl-s.
On the next screen choose Registration as the Activation type and type in something for program id. SAP recommends entering something like [hostname].[some program or organization identifier]. Remember what you type in for program id because this is what should specify for IDoc Destination during the SAP Adapter install (or what you should specify for IDocDestination in the sap.ini file.)
Is it possible to edit the SAP configuration settings after the initial configuration?:Yes, simply edit $ORACLE_HOME/OAISapAdapter31/[AppType][Partition]/sap.ini.
Listed below are the parameters and their corresponding question in the install:
These parameters are not part of the installation:
The steps are exactly the same as the ones for CRM 11i Adapter installation.
The steps are exactly the same as the ones for CRM 11i Adapter installation.
Adapters are components that are attached to applications to OAI enable them. The adapter has the following defining characteristics:
If you're using pre-packaged metadata, after importing it into the repository (see below), you will need to start up iStudio to find the corresponding application name (under Apps folder in iStudio) to utilize as the Application Type for the adapter you are installing.
Please follow the steps outlined in "Where do you find the OAI components" before proceeding.
On the Available Product Components screen: On the Welcome screen:On the Oracle Internet Directory Configuration screen:
You will need the piece of paper where you noted down OID specific information during OMB install (Refer to Step 2.4 and 2.5).
On the Error DB Configuration screen:
All runtime errors get logged to this database. You need to supply this information so that through the Management Console, you can browse the error database. The error database IS THE SAME as the repository database.
Refer to Steps 3.3 and 3.4.
\[ORACLE_HOME]\OAIManagementConsole31
Oracle Applications InterConnect console is a centralized tool to administer the Applications InterConnect runtime components, specifically the repository and each adapter. Using the Management Console, the administrator can start, stop, monitor and troubleshoot the Applications InterConnect runtime.
If you want to create new adapters instead of using pre-existing ones that come bundled with OAI, you must install the adapter SDK and read the documentation contained therein. To install the SDK, do the following steps:
Please follow the steps outlined in "Where do you find the OAI components" before proceeding.
On the Available Product Components screen: On the Summary screen:\[ORACLE_HOME]\OAIAdapterSDK31
This medthod of stopping the adapter will be improved in the next version.
Stopping the Management Console on NT
|
![]() Copyright © 1996-2000 Oracle Corporation. All Rights Reserved. |
|