Contents

Title and Copyright Information

Send Us Your Comments

Preface

• Audience
• Documentation Accessibility
• Related Documentation
• Customer Support
• Review Patch Documentation
• Improved Process for Oracle Retail Documentation Corrections
• Oracle Retail Documentation on the Oracle Technology Network
• Conventions

1 Introduction

• About This Document
• Hardware and Software Requirements
  • RPAS Server and Components
  • RPAS Classic Client
  • RPAS Fusion Client
  • Hardware and Software Requirement Notes
    • Monitor Disk Space
• Supported Oracle Retail Products
• Requesting Infrastructure Software
• Terms

Part I Full Installation

2 Getting Started

• RPAS Platform Overview
• Installation Process Flow
  • RPAS Environment
  • Downloading and Extracting the RPAS Media Pack
    • RDF Packaging

3 Installing on UNIX and Linux Environments

• Preparation
  • Java Environment
    • Linux
    • AIX
    • Solaris
    • HP-UX Itanium
  • RPAS_JAVA_CLASSPATH
  • Ride Options
    • For Java
    • For HP Itanium and Solaris
    • For RPAS
  • Before You Begin
• Running the RPAS Installer
• Environment Variable Setup Script
• Installing ODBC Server and Client Components
• Installing JDBC Client
• Determine the Path for the Domains
• DomainDaemon

4 Installing on a Windows Environment

• RPAS Server and Tools Installation on Windows
  • Extracting the RPAS Package
  • Java Environment
  • Install Cygwin
    • Cygwin Path Settings
  • Determine the Path for the Domains
  • Installing the RPAS Server
    • Microsoft 2010 Runtime Libraries
  • Installing Configuration Tools
  • Install ODBC or JDBC Client Components (Optional)
  • Install ODBC Server Components (Optional)
• Creating Start Menu Shortcuts to RPAS Applications and Utilities
• Creating the Required Environment Variables
  • Create a Global Domain Configuration Directory (Optional)
  • Configure the RPAS Clients to Use the Domain
  • Using Multiple Versions of RPAS on the Same Windows Machine
• Base Configuration Installation
  • Build a Domain Process Overview
    • Verify the Environment Variable Settings
    • Setting Up Base Configuration Files
    • Building the Domain on your Windows PC
    • Build the Domain
    • Start the RPAS Server (DomainDaemon)

5 Installing the RPAS Fusion Client

• Road Map for Installing the RPAS Fusion Client
  • Road Map Tasks
• Pre-Installation Tasks
  • Planning
    • Planning Your Environment
    • Session Cookie Name
    • Supported Configurations
  • Install and Set Up the RPAS Infrastructure
  • Install Oracle Database for WLS/ADF 12c Setup
  • Setting Up the WebLogic Server
    • Installing the WebLogic Server
    • Applying the Oracle ADF Run Time Patches
    • Running the RCU
    • Creating Schemas
    • Setting Up a WebLogic Domain
    • Setting Up the Maximum Heap Size
    • Setting Up the Garbage Collection Parameter
    • Configuring the Node Manager for Clusters-based Installation
  • Setting Up the Domain Policy Store
  • Accessing the Fusion Client Installation Media
  • Setting Up Your Installation Properties File
    • Installation Use Case 1
    • Installation Use Case 2
    • Installation Use Case 3
    • Installation Use Case 4
    • Installation Use Case 5
    • Installation Use Case 6
    • Installation Use Case 7
    • Installation Properties File Parameter Reference
  • Setting Up Environment Variables
  • Validating WebLogic and Oracle ADF Versions
  • Creating User Credentials in an Oracle Wallet
    • Storing Credentials
    • Creating Credentials
• Installation Tasks
  • Installing the RPAS Fusion Client in Silent Mode
    • install.sh
  • Installing the RPAS Fusion Client in Graphical or Text Mode
• Postinstallation Tasks
  • Multi-Solution Taskflow and Resource Properties Setup
  • Configuring External Authentication
    • Authentication (SSO)
    • Standalone Authentication (Non-SSO)
    • External Authentication Process
  • Setup SSL
    • About SSL and RPAS
    • Two-way SSL Setup
  • OBIEE Report Configuration Tasks
  • Clear the Browser Cache
  • Review the RPAS Configuration Property Files
  • Set Up Single Sign-On (SSO)
    • Setting Up an SSO Environment
  • Oracle Linux on x86 Architecture
  • Upload Application Security Policies to OID-based Domain Policy Store
    • Procedure
  • Enable Gzip Compression
    • Implementing Compression
• Troubleshooting
  • WebLogic Ulimit Error
  • Error Occurs When Users Access the Charting Feature in the RPAS Fusion Client
  • Error Occurs When Users Export to Microsoft Excel in the RPAS Fusion Client
  • StringIndexOutOfBoundsException in Oracle Linux on x86 Architecture

6 Installing and Configuring the RPAS Classic Client

• Make RPAS Classic Client Files Generally Accessible
• Installing the RPAS Classic Client
• Configuration

7 RPAS Classic Client Web Deployment

• Installation and Configuration Process Overview
• Installing the RPAS Web Application
  • Preparing Your Environment
  • Installing on WebLogic Server with SSO Support
    • Step 1: Set Up SSO
    • Step 2: Configure the Oracle Access Manager
    • Step 3: Set Up the WAR File
    • Step 4: Deploy the WAR File
    • Step 5: Set RPAS Role for Oracle SSO Logins
  • Installing on WebLogic Server without SSO Support
    • Step 1: Configuring RPAS Web Launch
    • Step 2: Deploying the WAR File
  • Installing on Apache Tomcat
    • Step 1: Deploying the RPAS WAR File
    • Step 2: Configuring RPAS Web Launch on Apache Tomcat
  • Migrating from Previous Versions
• Configuring the RPAS Servlet
• Configuring and Administering the Web Application
  • Start the RPAS Web Configuration Utility – Administration Console
  • Other Web Client Administration Activities
    • Adding, Modifying and Deleting Domain Configuration in an SSO Environment
    • Adding, Modifying and Deleting Domain Configuration in a Non-OSSO Environment
• Install and Launch the RPAS Classic Client Application
  • Troubleshooting
• RPAS Web Launch and Web-based Applications

8 Installing and Building the RPAS HSA Environment

• RPAS HSA Prerequisites
• RPAS HSA Build Process
  • Preinstallation
  • Installation
  • Postinstallation
• RDM Repository
  • RDM Repository Directory Structure
  • RDM Properties in a Domain
• RDM Schema Information
  • Schema Info Format
• Integration Configuration
  • Shared Hierarchies
  • Shared Facts
  • Integration Map
  • Domain and Configuration Map
  • Integration Configuration Format
• Partition Information
• RDM SSL Configuration
  • Setting Up SSL on the Oracle Server
    • Creating the Oracle Server Wallet
    • Updating the Oracle Server Network Configuration
    • Updating the Oracle Listener Configuration
  • Setting Up SSL on the Oracle Client
    • Updating Schema Information Configuration
    • Importing the Sever CA Certificate
    • Updating Oracle Client Network Configuration
    • Updating Oracle Net Service Names
  • Test and Confirm the SSL Connection
• RPAS Installation Utilities
  • RDM Preparation Script
  • RPAS Installer
    • Command Line Syntax
  • RDM Manager
    • Registering a Domain with RDM
    • Unregistering a Domain from RDM
    • Configuration Files and Output Files
    • Command Line Syntax
    • Creating the RDM Repository
    • Building RDM Schema
    • Testing the ODB Connection
    • Registering a Domain with RDM
    • Unregistering a Domain from RDM
    • Listing Properties or Domains

Part II Patch Installation

9 RPAS Package Extraction

• Example Package Extraction

10 RPAS Server Patch Installation

• RPAS Upgrade Prerequisites
  • Upgrade to Key RPAS Versions
    • Upgrade and Patch to RPAS Release 13.2.3
    • Convert for Integer Indexing
    • Upgrade and Patch to RPAS Release 13.3 or Later
  • For Windows: Install Cygwin
    • Cygwin Setup Guide for RPAS (Note 1333398.1)
  • Java Environment
  • Ride Options
    • For Java
    • For HP Itanium and Solaris
    • For RPAS
• RPAS Upgrade Process
• Domain Upgrade Process
• ODBC/JDBC Upgrade Process
  • ODBC Server
    • Upgrading from 13.0.x
    • Upgrading from 13.1.1.x
  • ODBC Client
    • UNIX Platform
    • Windows Platform
  • JDBC Client
    • Upgrading from 13.0.x
    • Upgrading from 13.1.1.x

11 RPAS Fusion Client Patch Installation

12 RPAS Classic Client Patch Installation

• Windows Installer Method
  • Make RPAS Classic Client Files Generally Accessible
  • Installing the RPAS Classic Client
  • Configuration
  • The EConfigure Utility
    • Menu Bar
    • Main View
• Classic Client Web Deployment

13 HSA Patch Installation

• Upgrading RDM
• Patching RDM

A Appendix: Bandwidth Requirements

• Understanding Bandwidth Requirements

B Appendix: RPAS Sizing and Partitioning Considerations

• RPAS Sizing
• Partitioning Considerations
• Workbook Sizing Considerations

C Appendix: rsp_manager Usage

• Prerequisites
• Applying a Service Pack
• Applying Service Packs on Multiple Domains
• Optional Arguments or Commands for rsp_manager
• Optional Environment Variables

D Appendix: Oracle Single Sign-On (SSO)

• What is Single Sign-On?
• What Do I Need for Oracle Single Sign-On?
• Oracle SSO Terms and Definitions
• What SSO is Not
• Single Sign-On Topology
• Installation Overview
• User Management
  • OID DAS
  • LDIF Scripts
  • User Data Synchronization

E Appendix: Installing Solution Plug-ins

• Installing Solution Plug-in
• Installing POView
  • About the POView Installer
• Road Map Tasks
  • Pre-Installation Tasks
    • Installing the Fusion Client
    • Setting Up Your Installation Properties File
    • Setting up Environment Variables
    • Creating User Credentials in an Oracle Wallet
  • Installation Tasks
    • Running the POView Installer—Silent Mode
    • Running the POView Installer—Graphical or Text Mode
  • Post-Installation Tasks
    • Fusion Client Install
    • Configuring In-Context Module
    • Configuring the Manifest File

F Appendix: Installation Order

• Enterprise Installation Order