This manual details the installation of the Retail Integration Bus (RIB). Generally, a RIB installation contains the following components:
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 subsystem to the core RIB. The IGS should be installed after the core RIB components have been successfully installed and tested.
Note: See the ”Integration Gateway Services” section in Chapter 3, ”Core Concepts,” in the Oracle Retail Integration Bus Implementation Guide 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 installation guides for the relevant Oracle Retail applications for more information.
Note: The instructions provided in this guide apply to a full installation of the RIB. The RIB 16.0.3 application cannot be installed over an existing version, such as 15.x.x. |
This list covers all of the sequential steps required to perform a full installation of the RIB, using either the GUI RIB Installer (strongly recommended) or a command line installation.
Task | Notes |
---|---|
Prepare the Oracle WebLogic 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 to which RIB will be integrating are configured appropriately. | |
Information to gather for the Installation | 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 installation. | RIB Functional Artifact URLJNDI URL |
Complete the setup of RDMT using the same Information to Gather for the Installation. | During either of the installation 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 installation to minimize the chance of errors. |
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 Installation | 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 Oracle Retail Integration Bus Operations Guide. |
Note: See Appendix C, ”RIB Installation Check Lists,” while performing the installation to minimize the chance of errors. |
The RIB and Integration Gateway Services have several dependencies on Oracle Retail Application installations, as well as on the Oracle WebLogic Servers. This section covers these requirements.
If you are unable to find the necessary version of the required Oracle infrastructure software (database server, application server, WebLogic, etc.) on the Oracle Software Delivery Cloud, you should file a non-technical 'Contact Us' Service Request (SR) and request access to the media. For instructions on filing a non-technical SR, see My Oracle Support Note 1071023.1 - Requesting Physical Shipment or Download URL for Software Media.
Note: Oracle Retail assumes that the retailer has applied all required fixes for supported compatible technologies. |
Supported On | Versions Supported |
---|---|
Database Server OS | OS certified with Oracle Database 12c (12.x) Enterprise Edition or 19c (19.3.0.0.0) Enterprise Edition. Options are:
|
Database Server 12cR1 | Oracle Database Enterprise Edition 12cR1 (12.1.0.2) with the following specifications:
Components:
Oneoffs:
RAC only:
Other Components:
|
Database Server 19c |
Oracle Database Enterprise Edition 19c (19.3.0.0.0) with the following specifications: Components:
Other Components:
|
AQ JMS Server | Oracle Database 12cR1 or 19c |
Application Server OS | OS certified with Oracle Fusion Middleware 12.2.1.4. Options are:
|
Application Server | Oracle Fusion Middleware 12.2.1.4
Components:
Note: WebLogic 12c domain for RIB needs JRF to be installed. Choose the JRF option at the domain creation. JRF needs an RCU schema for its runtime. This schema must be created prior to domain creation using the RCU tool. Java:
|
Minimum required JAVA version for all operating systems | Java:
JDK 1.8.0+ 64 bit with latest security updates |
Note on 12C JDK: By default, JDK is at 1.6. After installing the 12.1.0.2 binary, apply patch 19623450. Follow the instructions on Oracle Database Java Developer's Guide 12c Release 1 to upgrade JDK to 1.7. The Guide is available at:http://docs.oracle.com/database/121/JJDEV/chone.htm#JJDEV01000 |
Note: Use GNU Tar when installing on AIX as other utilities fail when extracting the RIB tarballs. |
Note: Bash shell is supported. Using other shells could have adverse effects. |
Important: If there is an existing WebLogic installation on the server, you must upgrade to WebLogic 12.2.1.4. All middleware components associated with WebLogic server should be upgraded to 12.2.1.4.Back up the weblogic.policy file ($WLS_HOME/wlserver/server/lib) before upgrading your WebLogic server, because this file could be overwritten. Copy over the weblogic.policy backup file after the WebLogic upgrade is finished and the post patching installation steps are completed. |
The RIHA model and view components require ADF runtime to run properly. Verify that ADF runtime 12.2.1.4 or higher is available in the WebLogic Application Server (12.2.1.4) and applied to the domain where RIHA will be installed.
For information about WebLogic Application Server 12.2.1.4, see the Oracle WebLogic Server Documentation Library:
http://docs.oracle.com/middleware/12212/wls/index.html
Note: See also the Oracle Database Administrator's Guide 12c (12.x) and the Oracle WebLogic Application Server 12.2.1.4 documentation. |
Supported On | Version Supported |
---|---|
Oracle WebLogic Server OS | OS certified with Oracle Fusion Middleware 12.2.1.4. Options are:
|
Oracle WebLogic Server | Oracle WebLogic Server 12.2.1.4 |
Supported On | Version Supported |
---|---|
RWMS 16.0.3 | RIB 16.0.3 |
RMS 16.0.3 | RIB 16.0.3 |
RPM 16.0.3 | RIB 16.0.3 |
SIM 16.0.3 | RIB 16.0.3 |
AIP 16.0.3 | RIB 16.0.3 |
RSB 16.0.3 | RIB 16.0.3 |
RXM 16.0.3 | RIB 16.0.3 |
OMS 16.0.3 | RIB 16.0.3 |
Supported On | Version Supported |
---|---|
Oracle E-Business Suite Financials | Oracle E-Business Suite 12.2.4 integration is supported using the Oracle Retail Financial Integration for Oracle Retail Merchandising Suite and Oracle E-Business Suite Financials.
See the Oracle® Retail Financial E-Business Suite Integration Solution Implementation/Operations Guide for specific version information. |
In this release, rib-<app> uses Oracle Streams AQ as the JMS provider. Oracle Streams AQ is built on top of Oracle database system. Because AQ is hosted by the Oracle database system, RIB can take advantage of database RAC capability for its JMS provider. By using RAC AQ as 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 an Oracle RAC database, the only configuration change required in rib-<app> is the RAC JDBC connection URL.
Note: RIB supports only the use of the Oracle Type 4 Thin Java Database Connectivity (JDBC) driver (ojdbc7.jar) for all JDBC connections, including RAC. |
RIB uses JMS server for message transportation between the integrating retail applications. Because RIB must preserve the message publication and subscription ordering, rib-<app>s deployed in Oracle WebLogic 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 instance of an Oracle WebLogic server that is setup as active-passive topology. In this configuration, as rib-<app> is deployed in a single active WebLogic instance, multiple instances of the same rib-<app> are not running at the same time, as there is only one WebLogic instance where the rib-<app> is deployed. Therefore, RIB can still preserve message ordering.
To truly configure rib-<app>s for high availability, the only option is to configure it in active-passive mode.