1 Preinstallation Tasks

This chapter explains the tasks required prior to installation.

Note:

Oracle Retail assumes that the retailer has applied all required fixes for supported compatible technologies.

Requesting Infrastructure Software

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.

Check Supported Database Server Requirements

General requirements for a database server running Oracle Retail Financial Integration Pack include:

Table 1-1 Database Server Requirements

Supported on:	Versions Supported:
Database Server OS	OS certified with Oracle Database 12c Release 1 Enterprise Edition or 19c (19.3.0+) Enterprise Edition. Options are: Oracle Linux 6 or 7 for x86-64 (Actual hardware or Oracle virtual machine). Red Hat Enterprise Linux 6 or 7 for x86-64 (Actual hardware or Oracle virtual machine). AIX 7.1 (Actual hardware or LPARs) Solaris 11.x SPARC (Actual hardware or logical domains) HP-UX 11.31 Integrity (Actual hardware, HPVM, or vPars)
Database Server 12c	Oracle Database Enterprise Edition 12c Release 1 (12.1.0.2) with the following specifications: Components: Enterprise Edition Examples CD Oneoff Patches: 20846438: ORA-600 [KKPAPXFORMFKK2KEY_1] WITH LIST PARTITION LIST PARTITION 19623450: MISSING JAVA CLASSES AFTER UPGRADE TO JDK 7 20406840: PROC 12.1.0.2 THROWS ORA-600 [17998] WHEN PRECOMPILING BY 'OTHER' USER 20925154: ORA-39126: WORKER UNEXPECTED FATAL ERROR IN KUPW$WORKER GATHER_PARSE_ITEMS JAVA 19672263: Patch 19672263: GTT SESSION LEVEL STATISTICS RETURNS ORA-20006 RAC Only: 21260431: APPSST 12C: GETTING ORA-4031 AFTER 12C UPGRADE 21373473: INSTANCE TERMINATED AS LMD0 AND LMD2 HUNG FOR MORE THAN 70 SECS Other Components: Perl interpreter 5.0 or later X-Windows interface JDK 1.8 with latest security updates
Database Server 12c	Oracle Database Enterprise Edition 19c (19.3.0+) with the following specifications: Components: Enterprise Edition Examples CD Other Components: Perl interpreter 5.0 or later X-Windows interface JDK 1.8

Note:

By default, JDK is at 1.7, upgrade JDK to 1.8.

Note:

Bash Shell is supported and usage of any other shell may have adverse impact on the app functions.

Check Supported Application Server Requirements

General requirements for an application server capable of running the Oracle Retail Financial Integration application include the following:

Table 1-2 Application Server Requirements

Supported on	Versions Supported
Application Server OS	OS supported with Oracle Fusion Middleware 12.2.1.4.0. Options are: Oracle Linux 6 or 7 for x86-64 (Actual hardware or Oracle virtual machine). Red Hat Enterprise Linux 6 or 7 for x86-64 (Actual hardware or Oracle virtual machine). AIX 7.1 (Actual hardware or LPARs) Solaris 11.x SPARC (Actual hardware or logical domains) HP-UX 11.31 Integrity (Actual hardware, HPVM, or vPars)
Application Server	Oracle Fusion Middleware 12.2.1.4.0 Components: Oracle WebLogic Server 12c (12.2.1.4.0) Java: JDK 8 with latest security updates+ 64 bit Oneoff Patches: 22648025: Java.lang.IllegalStateException. Note: If there is an existing WebLogic installation on the server, you must upgrade to WebLogic 12.2.1.4.0. All middleware components associated with WebLogic server 10.3.3 or 10.3.4 should be upgraded to 12.2.1.4.0. Back up the weblogic.policy file ($WL_HOME/ 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 installer can fail because of missing .jar in $ORACLE_HOME/utils/ccr/lib. This issue occurs only when the application is being installed on the same WebLogic server on which forms based applications are installed. It is valid only for Linux 64-bit. WebLogic 12c domain for ORFI 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. Weblogic 12.2.1.4.0 needs OWSM for Policy A and C to work. The owsm template choice while creating the wls domian, will give an option to deploy wsm-pm application to admin server. This app is required for policies to work.

Check Supported Client PC and Web Browser Requirements

Table 1-3 Supported Client PC and Web Browser Requirements

Requirement	Version
Operating system	Windows 7 Note: Oracle Retail assumes that the retailer has ensured its Operating System has been patched with all applicable Windows updates.
Display resolution	1024x768 or higher
Processor	2.6GHz or higher
Memory	1GByte or higher
Networking	intranet with at least 10Mbps data rate
Oracle (Sun) Java Runtime Environment	1.8.0+
Browser	Mozilla Firefox 45+

Supported Oracle Retail Products

Table 1-4 Supported Oracle Retail Products

Requirement	Version
Oracle Retail Merchandising Cloud Services	23.0.000
Oracle Retail Invoice Matching (ReIM)	23.0.000
Oracle Retail Integration Bus (RIB)	23.0.000
Oracle Retail Bulk Data Integration (BDI)	23.0.000

UNIX User Account Privileges to Install the Software

A UNIX user account is needed to install the software. The UNIX user that is used to install the software should have write access to the WebLogic server installation files.

For example, oretail.

Note:

Installation steps will fail when trying to modify files under the WebLogic installation, unless the user has write access.

Supported Oracle Applications

Table 1-5 Supported Oracle Applications

Requirement	Version
Oracle Financials Cloud(General Ledger and Accounts Payable)	Oracle Financials Cloud Release 13 Update 19B integration is supported using the Oracle Financial Operations Control Integration Pack for Oracle Retail Merchandising Suite and Oracle Financials Cloud.

Note:

The release cycle of Cloud Fusion Financials (CFIN) does not align with Oracle Retail's Enterprise release cycle. Because of this discrepancy, the certification of newer versions of Cloud Financials with the Oracle Retail suite of applications can be delayed. Because the Oracle Retail Financial Integration (RFI) product aligns its release with the Oracle Retail Enterprise release cycle, Oracle Retail Development will attempt to certify RFI, and other Oracle Retail applications, with newer versions of CFIN in every major (.0), not minor (.x), release of Oracle Retail applications.

Though they are not officially certified with Oracle Retail applications, the minor version patches of Cloud Financials (that are higher than that which is certified with Oracle Retail applications) may be compatible and function properly.

Oracle Support will attempt to help customers to resolve issues that arise in these implementations that do not include documented, certified versions. Oracle Retail will try to duplicate the issues on certified versions of the integration, and if the issues can be duplicated in the certified versions, Oracle Retail will strive to fix and resolve the issues. If there arises an issue that cannot be resolved in an uncertified implementation, Oracle Retail maintains final discretion on its actions. In such situations, Oracle Support will try to help customers resolve their issues. Note, however, that in an uncertified version combination, SEV-1 escalations would not be allowed.