| Oracle® Retail Integration Bus Installation Guide Release 13.1 |
|
 Previous |
 Next |
This manual details the installation of the Retail Integration Bus (RIB). Generally, a RIB installation contains the following components:
An installation of RIB's Java EE applications (rib-<app>.ear) on Java EE 5 compliant application server.
An installation of the Retail Integration RIB Hospital administration (RIHA) tool.
An installation of the RIB Diagnostics and Monitoring tools.
The RIB includes an optional component, the RIB Integration Gateway Services (IGS) that can be installed as a sub-system to the core RIB. The IGS should be installed after the core RIB components have been successfully installed and tested.
|
Note: See RIB Implementation Guide - Integration Gateway Services for details and considerations before attempting installation. |
It is important to also follow all installation steps of the Oracle Retail Applications that are being connected to the RIB. Failure to follow these may result in a faulty RIB installation. See the install guides of the relevant Retail applications for more information.
|
Note: The instructions provided in this guide apply to a full installation of the RIB. The RIB 13.1 application cannot be installed over an existing version, such as 13.0.1. |
This list covers all of the sequential steps required to perform a full install of the RIB, using either the GUI RIB Installer (strongly recommended) or a command line installation.
| Task | Notes |
|---|---|
|
Prepare the Oracle Application Servers for installation of the RIB Components. |
Prerequisite |
|
Prepare the Oracle Database Schemas that the RIB will use. |
Prerequisite |
|
Prepare the JMS. |
Prerequisite |
|
Verify the Applications the RIB will be integrating to are configured appropriately. |
|
|
"Information to Gather for the Install" |
During the prerequisites steps, there is information that should be noted that will be used to configure the RIB during the installation process. |
|
Install the RIB using one of these methods:Installation using the RIB Installer GUIOrInstallation using the RIB App Builder Command Line Tools. |
It is strongly recommended that the RIB Installer GUI method be used. |
|
Verify Application URL settings match RIB install. |
RIB Functional Artifact URLJNDI URL |
|
Complete the setup of RDMT using the same "Information to Gather for the Install" |
During either of the Install methods, one of the manual steps will have extracted the RDMT tools to the appropriate directory. |
|
Verify the RIB installation using the RDMT tools. |
|
|
Install RIHA. |
The RIB Hospital maintenance tool |
|
Note: See Appendix C, "RIB Installation Checklists", while performing the install, in order to minimize the chance of a faulty RIB installation. |
The RIB Integration Gateway Services (IGS) is an optional component and should be installed after the installation and verification of the RIB components.
| Task | Notes |
|---|---|
|
Prepare the WebLogic application servers for installation of the IGS component. |
This is a mandatory prerequisite. |
|
"Information to Gather for the Install" |
During the RIB component prerequisites steps, there is information that should be noted that will be used to configure the IGS during the installation process. |
|
Install the IGS. |
|
|
Verify the IGS installation using the Soap UI tool and test cases. |
See Chapter 4 of the RIB Operations Guide. |
|
Note: See Appendix C, "RIB Installation Checklists" IGS Installation Check Lists while performing the installation to minimize the chance of a faulty installation. |
The RIB and Integration Gateway Services have several dependencies on Oracle Retail Application installations, as well as on the Oracle Application Servers. This section covers these requirements.
| Supported On | Versions Supported |
|---|---|
| Database OS | OS certified with Oracle Database 11gR1 Enterprise Edition. Options are:
|
| Database Server | Oracle Database 11g Release 1 Enterprise Edition (minimum 11.1.0.7 patchset required) with the following patches and components:
Patches:
RAC only
Components:
|
| AQ JMS Server | Oracle Database 11g (11.1.0.7) |
| Application Server OS | OS certified with Oracle Application Server 10g 10.1.3.4. Options are:
|
| Application Server | Oracle Application Server 10g 10.1.3.4 with the following patches:
|
|
Note: See also the Oracle® Database Administrator's Guide 10g Release 2 (10.2) and the Oracle® Application Developer's Guide - Fundamentals 10g Release 2 (10.2). |
| Supported On | Version Supported |
|---|---|
| Oracle WebLogic Server OS | OS certified with OracleWebLogic Server 10 g Release 3 (10.3). Options are AIX 6.1 and OEL 5 update 2. |
| Oracle WebLogic Server | Oracle WebLogic Server 10g Release 3 (10.3) with the following patches:
3QHE MHL8 (5KXF, 9V4T, GFKC, GP7Q, KJQR) |
|
WARNING: For AIX, the IBM JDK located at ORACLE_HOME/jdk is not supported by the RIB. Make sure that IBM Java SDK 1.5.0 build pap32dev-20080315 (SR7) or newer is installed on the RIB system and configured as the JAVA_HOME for the RIB OC4J instances. |
In this release, rib-<app> uses Oracle Streams AQ as the JMS provider. Oracle Streams AQ is built on top of Oracle database system. Since AQ is hosted by Oracle database system the RIB can take advantage of database RAC capability for its JMS provider. By using RAC AQ as the RIB's JMS provider you can scale RIB's JMS server vertically and horizontally to meet any retailer's scalability and high availability need.
At runtime, rib-<app> uses the database for keeping track of its RIB Hospital records. These RIB Hospital tables can be hosted by an Oracle RAC database providing high availability and scalability for these RIB Hospital records.
All rib-<app>s use the Oracle type 4 Java Database Connectivity (JDBC) driver to connect to the RIB Hospital database and the AQ JMS server. When the RIB Hospital database and the AQ JMS servers are hosted by a Oracle RAC database, the only configuration change required in rib-<app> is the RAC JDBC connection URL.
|
Note: The RIB supports only the use of the Oracle Type 4 Thin Java Database Connectivity (JDBC) driver (ojdbc5dms.jar) for all JDBC connections, including RAC. |
The RIB uses JMS server for message transportation between the integrating retail applications. Since the RIB must preserve the message publication and subscription ordering, rib-<app>s deployed in Oracle Application Server cannot be configured in an active-active cluster mode. In active-active cluster mode, multiple subscribers and publishers will process messages simultaneously and there will be no way to preserve message ordering.
The rib-<app> can be deployed to a "single" oc4j instance of an Oracle Application Server that is clustered (active-passive). In this configuration, even though rib-<app> is deployed in an OAS cluster, multiple instance of same rib-<app> is not running at the same time as there is only one oc4j instance where the rib-<app> is deployed and so RIB can still preserve message ordering. The maximum number of JVM (Java Virtual Machine) hosting a rib-<app> oc4j instance must always be configured to be 1 for the same reason of preserving message ordering.
To truly configure rib-<app>s for high availability, the only option is to configure it in active-passive mode.
|
 Copyright © 2009, Oracle and/or its affiliates. All rights reserved. Legal Notices |
|