Contents

List of Figures

List of Tables

Title and Copyright Information

Preface

• Audience
• Documentation Accessibility
• Related Documents
• Conventions

1 Getting Started

• What is RUEI?
  • Data Collection
  • Product Architecture
• Security
• Connection Options
  • Copy Ports
  • TAPs
• Installation Options
• Local and Remote Database Installations
• Scaling Scenarios
• Server Requirements
  • Single-Server Requirements
  • Reporter Requirements
  • Collector Requirements
  • Processing Engine Requirements
  • Deployment Best Practices
  • Data Retention Policies
  • Full Session Replay Storage Requirements
  • Memory Requirements
• Software Requirements
• Network Requirements
• Client Requirements

2 Installing the RUEI Software

• Prerequisites
  • Planning the Software Installation Location
  • Configuring the Network Interface
  • Operating System Security Configuration
  • Verify NTP Daemon Operation
  • Installing the RUEI Prerequisites
  • Oracle Database Installation
• Obtaining the RUEI Software
• Unpacking the RUEI Software
• Generic Installation Tasks
  • The RUEI Configuration File
  • Installing Java
  • Installing libxml2
• Remote Collector Installation
• Reporter Installation
  • Installing the Apache Web Server and PHP
    • PHP Configuration
    • Avoiding RSVG Warnings
    • Securing Apache Web Server
  • Installing the Oracle Database Instant Client
  • Installing the php-oci8 Module
  • Installing the Zend Optimizer
  • Creating the Reporter Database Instance
  • Installation of the Reporter Software
• Configuring the Network Interface
• Enabling International Fonts (Optional, but Recommended)
• Mail (MTA) Configuration (Optional, Reporter Only)
• SNMP (Reporter Only)
• Configuring Automatic Browser Redirection (Optional)
• Configuring Reporter Communication (Split-Server Setup Only)
• Verifying Successful Installation of RUEI

3 Upgrading to RUEI 12.1.0.3

• KPI Values
• XPath Support
• Increased Database Space Requirements
• Default Tablspace Modes
• Upgrading From RUEI 11.1 to 12.1.0.3
  • Upgrading the Reporter System
  • Upgrading the Remote Collector System(s)
• Rolling Back to Version 11.1
  • Rolling Back Remote Collector Systems
• Upgrading From RUEI 12.1.0.x to 12.1.0.3
  • Upgrading the Reporter System
  • Upgrading the Remote Collector System(s)
  • Upgrading the Processing Engine System(s)
• Rolling Back to Version 12.1.0.x
  • Rolling Back Remote Collector Systems
  • Rolling Back Processing Engine Systems

4 Configuring RUEI

• Introduction
• Performing Initial RUEI Configuration
• Configuring Collector Systems
  • Resetting Collector Systems
• Performing Post-Installation Configuration
  • Specifying the Cookie Technology
  • Adding/Uploading HTTPS SSL Keys
  • Specifying How Users are Identified
  • Defining Applications and Page Identification
  • Specifying the Scope of Monitoring
  • Authorizing Initial Users
• Verifying and Evaluating Your Configuration
  • Viewing a Traffic Summary
  • Confirming Data Collection

5 Installing and Configuring SSO Authentication Integration

• Turning off the Default Web Server
• Reporter System Without Local Database
  • Creating the Oracle User
  • Setting up the Oracle HTTP Server Environment
  • Creating the Installation Directory
• Reporter System With Local Database
• Installing Oracle HTTP Server
• Registering RUEI with the Oracle SSO Server
  • Registering with Oracle SSO Version 10.1.4
  • Registering with Oracle SSO Version 11.1
• Verifying the Oracle HTTP Server Configuration

6 Configuring the Oracle Access Manager (OAM)

• Creating an OAM Access Gate for RUEI
• Downloading and Installing the Access Gate Software
• Configuring the Access Gate Software on the RUEI Server
• Configuring the Required Session Traffic Definitions

7 Installing Processing Engines

• Prerequisites
  • Planning the Software Installation Location
  • Operating System Security Configuration
  • Verify NTP Daemon Operation
  • Installing the RUEI Prerequisites
  • Oracle Database Software Installation
• The RUEI Configuration File
• Processing Engine Installation
  • Creating Groups and Users
  • Installing the Oracle Database Instant Client
  • Creating the Processing Engine Database Instance
  • Installation of the Processing Engine Software
• Configuring Processing Engine Communication
  • Configuring the SSH Connections
  • Configuring the Database Link Connections
• Registering Processing Engines
• Configuring Multiple Processing Engines

8 Configuring a Failover Reporter System

• Introduction
• Preparing the Primary Reporter
• Installing the Secondary Reporter
• Configuring Reporter Failover
• Initiating Reporter Failback

9 Configuring a Failover Collector System

• Introduction
• Installing the Secondary Collector
• Configuring the Secondary Collector
• Initiating Collector Failback

10 Configuring a Failover Processing Engine System

• Introduction
• Preparing the Primary Processing Engine
• Installing the Secondary Processing Engine
• Configuring Processing Engine Failover
• Instigating Processing Engine Failback

A Installing the Oracle Database Software

• Download the Oracle Database Software
• Operating System Prerequisites
• Creating the Database User Accounts and Groups
• Configuring the Kernel Parameter Settings
• Setting Shell Limits for the Oracle User
• Creating the Database Directory
• Configuring the Oracle User's Environment
• Creating an Oracle init Script File

B Generic Database Instance Setup

• Overview
• Creating the Database Instance
• Creating Tablespaces
• DRCP Connection Pooling
• Rescheduling Oracle Database Maintenance
• Installing SQL Packages
• Creating the RUEI Database User
• Setting up the Connection Data
• Setting up the Oracle Wallet

C Setting up an Alternative Enriched Data Export Database Instance

• Introduction
• Setting up the Alternative Database Instance
  • Creating the Database Instance
  • Using Compressed Tablespaces
  • Rescheduling Oracle Database Maintenance
  • Creating the RUEI Database User
  • Setting up DRCP Connection Pooling
• Connecting the RUEI Systems to the Alternative Database Server
  • Setting up the Connection Data
  • Setting up the Oracle Wallet
  • Editing the RUEI Configuration File

D Setting up a Connection to the Enterprise Manager Repository

• Introduction
• Setting up the Connection Data
• Setting up the Oracle Wallet

E The ruei-check.sh Script

F Verifying Monitored Network Traffic

• Introduction
• Creating Traffic Snapshots
• Analyzing Traffic Information

G Troubleshooting

• Running the ruei-check.sh Script
• The ruei-prepare-db.sh Script Fails
• Starting Problems
• Data Collection Problems
• Data Processing Problems
• E-Mail Problems
• SSL Decryption Problems
• Missing Packages and Fonts Error Messages
• ORA-xxxxx Errors
• Oracle DataBase Not Running
• General (Non-Specific) Problems
• Network Interface Not Up
• OAM-Related Problems
• ruei-check.sh Script Reports PHP Timezone Error
• ORA-00020: maximum number of processes (%s) exceeded
• rsync Fails When user@ Argument not Specified

H Installation Checklist

I Removing RUEI From Systems

J Third-Party Licenses

Index