This chapter provides instructions for running the RIB Application Installer.
Note: If there is an existing WebLogic installation on the server, you must upgrade to WebLogic 10.3.6. All middleware components associated with WebLogic server should be upgraded to 11.1.1.7.Back up the weblogic.policy file ($WLS_HOME/wlserver_10.3/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 RIB application installer can be used to perform any of the tasks below. For a new installation, all tasks are recommended.
Run the Preparation Phase to unpack files, prepare the workspace, and perform preinstallation verifications.
Generate the rib-deployment-env-info.xml file, which configures the RIB installation.
Run the Assembly Phase to build the EAR and WAR files for the rib-<app> applications.
Configure the Advanced Queuing JMS topics for RIB.
Run the Deployment Phase to deploy the EAR and WAR files to the application servers.
For more information about the Preparation, Assembly and Deployment Phases, see the Oracle Retail Integration Bus Operations Guide.
The Oracle Retail OCM Installer packaged with this release installs the latest version of OCM.
The document, "Oracle Configuration Manager Installer Guide" (ID 1071030.1), is available through My Oracle Support:
https://support.oracle.com
This document describes the procedures and interfaces of the Oracle Retail Oracle Configuration Manager Installer that a retailer runs at the beginning of the installation process.
To run the RIB application installer, do the following.
Undeploy all old rib-apps and completely remove them from the AdminServer upload directory as follows.
Shut down all the rib-* servers.
Delete all rib-* apps from the deployments menu in WebLogic.
Note: Be sure to remove ONLY the rib-* apps and no others. If other applications are removed, their deployments will break. |
Remove them from the upload directory if they exist:
cd [RIB_DOMAIN]/servers/AdminServer/uploadrm -rf rib-*
Start the rib-servers up again before starting the installer.
Expand the RIB Kernel distribution as described in Expand the RIB Kernel Distribution.
Note: For RIB installation in AIX platform, castor libraries may encounter an issue during the check_version_and_unpack step. Please execute the following instructions as a work around to resolve the issue.
|
Download the RIB Functional Artifacts distribution (RibFuncArtifact14.1.2ForAll14.1.2Apps_eng_ga.tar), and copy it into the <RIB_HOME>/download-home/rib-func-artifacts directory. Do not untar the file.
Download the tar file distributions for each rib-<app> application (RibPak14.1.2For<app>14.1.2_eng_ga.tar) that you will install. Copy the files into the <RIB_HOME>/download-home/all-rib-apps directory. Do not untar the files.
Download the RIB Diagnostic and Monitoring Tools (RDMT) package (Rdmt14.1.2ForAll14.x.xApps_eng_ga.tar) and untar it into the <RIB_HOME>/tools-home directory. Several files will be placed under the rdmt directory when you untar the package. This allows the installer to run the <RIB_HOME>/tools-home/rdmt/configbuilder.sh script as part of the RIB installation.
For multiple JMS servers only: If your RIB installation includes more than one JMS server, you must complete the additional preinstallation steps in the section, Preinstallation Steps for Multiple JMS Server Setup.
Set the JAVA_HOME environment variable. The JAVA_HOME must be set to a JDK 1.7.0+ 64 bit or Jrockit 1.6 R28 build or later, within the 1.7 code line. 64 bit. For Linux and Solaris OS only.
Be sure there are no pre-existing instances of ANT in your path:
$ unset ANT_HOME
$ unset ANT_CONTRIB
$ unset CLASSPATH
The following command should not find the ant executable:$ which ant
If you are using an X server, such as Exceed, set the DISPLAY environment variable so that you can run the installer in GUI mode (recommended). If you are not using an X server, or the GUI is too slow over your network, unset DISPLAY for text mode.
Make sure that all WebLogic instances that you intend to deploy to are currently running.
Give execute permissions to rib-home:
For example, chmod -R 700 rib-home.
Change directories to the <RIB_HOME> directory.
Run the rib-installer.sh script. The RIB installer appears.
Note: See Appendix A, "Appendix: RIB Application Installer Screens" for details about every screen and input field in the installer. |
Restart the rib-<app>-server. During the installation process a shared library is created that contains the JDBC Driver update. For PL/SQL applications, it is necessary to bounce the WebLogic managed server instance.
If the installer finds the configbuilder.sh script, it will attempt to run it. However, if the installer is unable to run the RDMT script or if the RDMT setup failed for some reason, manually run the RDMT at this time to verify the installation.
To check log files, do the following.
Check the log files in <RIB_HOME>/deployment-home/log to ensure that all RIB applications deployed successfully.
If errors are encountered, verify that the installer inputs were correct.
If all installer inputs were correct, it may be necessary to rerun the installer with the existing <RIB_HOME>/deployment-home/conf/rib-deployment-env-info.xml file. Running the installer multiple times usually resolves any extraneous errors.
Note: Using multiple JMS servers allows for the isolation of flows for performance and operational QoS. For more information, see "JMS Provider Management" section in the Oracle Retail Integration Bus Operations Guide. |
If your RIB installation will include multiple JMS servers, additional steps are required before you can run the installer.
Note: Do not follow these steps if you are using only one JMS server. |
Determine the family that must be configured for multiple JMS.
Locate the rib-integration-flows.xml inside the rib-func-artifacts.war.
Examine the rib-integration-flows.xml to identify all the RIB applications participating in the integration flows that must be configured with multiple JMS.
Ensure that a new AQ JMS database server (not a schema) is set up. For information see "Prepare Oracle AQ JMS Provider" in this guide.
Ensure that any additional AQ JMS are not in the same database server. Each new AQ JMS requires a new database server.
Note: If this is a first-time installation (or if you are using the installer to rewrite the rib-deployment-env-info.xml) you do not need to complete Step 6. |
Add JMS servers by updating rib-deployment-env-info.xml.
In the rib-home, modify the appropriate files for each of the rib-<apps> that participate in the integration flow. Point the adapters to the right JMS server. The following applies to this step:
rib-<app>-adapters.xml
rib-<app>-adapter-resources.properties
Note: For more information on this step, see the Oracle Retail Integration Bus Operations Guide. |
Once Step 6 is finished, the installer tool does the following to complete preinstallation activities:
Note: This step is not required if this is a first time installation or when the installer is used for installation. |
Compiles all rib apps
($RIB_HOME/application-assembly-home/bin/rib-app-compiler.sh).
Runs prepare-jms for the newly-created JMS server
($RIB_HOME/deployment-home/bin/rib-app-deployer.sh -prepare-jms<jms2>). This step configures additional JMS servers.
Deploys ($RIB_HOME/deployment-home/bin/rib-app-deployer.sh rib-<app>).
The RIB Diagnostic and Monitoring Tools (RDMT) should be used at this time to verify the RIB installation. See "Diagnostic and Monitoring Tools" in the Oracle Retail Integration Bus Operations Guide for how to configure and use the RDMT tools.
The RIB application installer creates the following backup and log files:
Each time the installer is used to generate a new rib-deployment-env-info.xml, a backup of the existing file will be created in: <RIB_HOME>/deployment-home/conf/archive/rib-deployment-env-info.xml.
<timestamp>
Each time the installer is run, the output of the installer script will be written to a log file. The installer's log file will be located in:
<RIB_HOME/.retail-installer/rib/log/rib-install-app.<timestamp>.log.
Each time the installer is run, the user inputs will be recorded in: <RIB_HOME/.retail-installer/rib/log/ant.install.properties.<timestamp>. This file should only be used during troubleshooting to verify the exact inputs that were given to the installer. Modifying the file is not recommended, as it is a record of the inputs at the time the installer was run.
If an error is encountered while running the installer, the cause of the error must be corrected before making another attempt to run the installer. The installer's log file may contain helpful information for determining the cause of the error. After you have examined the log files, see "Appendix: RIB Installer Common Errors" for a list of commonly encountered errors.
When you are ready to attempt another installation, keep in mind that you may be able to avoid re-entering all your inputs if the previous installation process was far enough along to configure the rib-deployment-env-info.xml. If the installer has already generated the rib-deployment-env-info.xml file, or if you have manually edited the rib-deployment-env-info.xml file, then it is not necessary to re-enter all the inputs in the installer. Verify that the rib-deployment-env-info.xml contains the correct settings, and run the installer with the Use existing rib-deployment-env-info.xml option.