Skip Headers
Oracle® Real-Time Decisions Installation and Administration Guide
Version 3.0.0.1
Part Number E13856-02
Home
Book List
Contact Us
Next
View PDF
Contents
Title and Copyright Information
Preface
Audience
Documentation Accessibility
Related Documents
Conventions
1
Preparing for Installation
1.1
About Oracle Real-Time Decisions Installation
1.2
Installing the Database Server
1.3
Installing Java Development Kit (JDK)
1.3.1
Standalone OC4J Installations
1.3.2
Oracle Application Server Installations
1.3.3
WebSphere Installations
1.3.4
WebLogic Installations
1.3.5
JBoss Installations
1.4
Installing the Application Server
1.4.1
Installing OC4J for Oracle RTD
1.4.1.1
Installing Standalone OC4J
1.4.1.2
Installing Oracle Application Server
1.4.2
Installing WebSphere for Oracle RTD
1.4.3
Installing WebLogic for Oracle RTD
1.4.4
Installing JBoss for Oracle RTD
1.5
Additional Preinstallation Tasks
2
Installing the Real-Time Decision Server
2.1
Installing Oracle Real-Time Decisions Files
2.1.1
Installing Oracle RTD on a Single Windows Computer
2.1.2
Installing Real-Time Decision Server on UNIX
2.1.3
About the Oracle RTD Run-Time Environment
2.2
Creating and Initializing the Oracle RTD Database
2.2.1
Creating a Database: Microsoft SQL Server
2.2.2
Creating a Database: Oracle Database
2.2.3
Creating a Database: IBM DB2
2.2.4
Initializing the Oracle RTD Database Using SDDBTool
2.2.5
Initializing the Oracle RTD Database Using Command Line Scripts
2.3
Populating the CrossSell Example Data (Optional)
2.4
Populating the DC_Demo Example Data (Optional)
2.5
Quick Zip Installation
2.6
Using SSL with Oracle Real-Time Decisions
2.6.1
Additional Information for SSL-Only Configurations
3
Configuring OC4J for Oracle Real-Time Decisions
3.1
Configuring Server Properties
3.1.1
Configuring Server Properties for Standalone OC4J
3.1.2
Configuring Server Properties for Oracle Application Server
3.2
Providing JDBC Access to the Oracle RTD Database
3.2.1
Creating the Shared Library oracle.rtd.jdbc
3.2.2
Creating a JDBC Provider for the Oracle RTD Database in SQLServer and DB2
3.2.3
Creating a JDBC Provider for the Oracle RTD Database in Oracle
3.3
Creating Oracle RTD Roles and Users
3.3.1
Creating Oracle RTD Roles
3.3.2
Creating Oracle RTD Administrators and Other Users
3.3.3
Updating Oracle RTD's Deployment Descriptors
3.4
Installing the Oracle Real-Time Decisions Application on OC4J
3.5
Assigning Permissions to Custom Roles
3.6
Starting Oracle Real-Time Decisions
3.7
Uninstalling the Oracle Real-Time Decisions Application from OC4J
3.8
Configuring SSL for Real-Time Decision Server (Recommended)
3.8.1
Setting Up SSL
3.8.2
Testing the SSL Configuration
3.9
Setting Up JConsole Security for OC4J
3.10
Changing the Oracle Real-Time Decisions Port Number in OC4J
4
Configuring WebSphere for Oracle Real-Time Decisions
4.1
Creating and Administrative User and Enabling Security
4.2
Configuring Server Properties
4.3
Creating Oracle RTD Roles and Users
4.3.1
Creating Users for Oracle RTD
4.3.2
Creating Groups
4.3.3
Standard Oracle RTD Roles
4.4
Creating a JDBC Provider for the Oracle RTD Database
4.5
Installing the Oracle Real-Time Decisions Application on WebSphere
4.6
Starting Oracle Real-Time Decisions
4.7
Setting Classloader Priority
4.8
Viewing and Changing User-Role Associations
4.9
Creating Custom Roles and Assigning Permissions to Custom Roles (Optional)
4.9.1
Creating Custom Roles
4.9.1.1
Specifying Roles in application.xml
4.9.1.2
Mapping Roles to Groups
4.9.2
Assigning Permissions to Custom Roles
4.10
Uninstalling the Oracle Real-Time Decisions Application from WebSphere
4.11
Configuring SSL for Real-Time Decision Server (Recommended)
4.11.1
Testing the SSL Configuration
4.12
Setting Up JConsole for WebSphere
4.12.1
Determining the WebSphere Bootstrap Port Number
4.12.2
Setting Up a Batch File for JConsole
4.12.2.1
Setting Up a JConsole Batch File for Windows
4.12.2.2
Setting Up a JConsole Batch File for Linux or AIX-Based Systems
4.12.2.3
Setting Up a JConsole Batch File for Solaris
4.12.3
Creating a JConsole User
4.13
Changing the Oracle Real-Time Decisions Port Number in WebSphere
5
Configuring WebLogic for Oracle Real-Time Decisions
5.1
Creating and Starting an Oracle RTD Domain
5.2
Starting the Node Manager and the WebLogic Server
5.3
Creating a Managed Server
5.4
Configuring Managed Server Properties
5.5
Creating and Adding a Machine to the Managed Server
5.6
Starting the Managed Server
5.6.1
Starting Oracle RTD When Deployed to Admin Server or Through Startup Scripts
5.7
Creating a JDBC Provider for the Oracle RTD Database
5.7.1
Creating an Oracle JDBC Provider for the Oracle RTD Database on WebLogic 11g 10.3.3+
5.8
Creating Oracle RTD Roles and Users
5.8.1
Creating User Groups for Standard Roles
5.8.2
Creating User Groups for Custom Roles
5.8.3
Specifying Subgroups
5.8.4
Creating Roles
5.8.5
Creating the Oracle RTD Administrator and Other Users
5.8.6
No Deployment Descriptor Update Required
5.9
Deploying Oracle RTD to the Managed Server
5.10
Assigning Permissions to Custom Roles
5.11
Starting Oracle Real-Time Decisions
5.12
Uninstalling the Oracle Real-Time Decisions Application from WebLogic
5.13
Configuring SSL for Real-Time Decision Server (Recommended)
5.13.1
Testing the SSL Configuration
5.14
Setting Up JConsole Security for WebLogic
5.15
Changing the Oracle Real-Time Decisions Port Number in WebLogic
6
Configuring JBoss for Oracle Real-Time Decisions
6.1
Configuring Server Properties
6.1.1
Adding Oracle RTD Logging to the JBoss Server
6.1.2
Copying Oracle RTD Log 4J Jar File to JBoss
6.1.3
Copying New Version of Eclipse JDT Compiler to the JBoss Web Container Directory
6.1.4
Modifying the JBoss Start Script
6.1.4.1
Modifying the Windows JBoss Start Script
6.1.4.2
Modifying the Unix JBoss Start Script
6.2
Creating a JDBC Provider for the Oracle RTD Database
6.3
Creating Oracle RTD Roles and Users
6.3.1
Creating Oracle RTD Administrators and Other Users
6.3.2
Creating Standard Roles
6.3.3
Creating Custom Roles
6.3.4
Updating Oracle RTD's Deployment Descriptors
6.4
Installing and Starting the Oracle Real-Time Decisions Application on JBoss
6.5
Assigning Permissions to Custom Roles
6.6
Uninstalling the Oracle Real-Time Decisions Application from JBoss
6.7
Configuring SSL for Real-Time Decision Server (Recommended)
6.8
Setting Up JConsole for JBoss
6.8.1
Setting Up JConsole for JBoss on Windows
6.8.2
Setting Up JConsole for JBoss on Unix
7
Configuring Security for Oracle Real-Time Decisions
7.1
Permissions
7.1.1
Cluster Permissions
7.1.2
Inline Service Permissions
7.1.3
Decision Center Perspective Permissions
7.2
Standard Oracle RTD Roles
7.2.1
Default Cluster Permission Assignments
7.2.2
Default Inline Service Permissions
7.2.3
Default Decision Center Perspective Permissions
7.3
Custom Roles
7.4
Assigning Permissions
7.4.1
Granting Cluster Permissions
7.4.1.1
Operation listPermissionCodes
7.4.1.2
Operation assignPermission
7.4.1.3
Operation listDirectPermissions
7.4.2
Granting Inline Service Permissions
7.4.3
Granting Decision Center Perspective Permissions
7.5
Debugging Role Assignments
7.6
Migration Strategy
7.6.1
Migrating Oracle RTD Users and Groups to Enterprise Identity Store
7.6.2
Defining Standard Security Roles in JEE Server
7.6.3
Defining Custom Security Roles in JEE Server
7.6.4
Declaring Custom Role References
7.6.5
Assigning Inline Service Permissions to Roles
7.6.6
Assigning Decision Center Perspective Permissions to Roles
8
Configuring Data Access for Oracle Real-Time Decisions
8.1
Creating Additional JDBC Data Sources in OC4J
8.1.1
Providing Access to JDBC Jar Files for Your Data Source
8.1.2
Creating a Connection Pool and Data Source in OC4J
8.1.3
Adding the New Data Source to Oracle RTD
8.2
Creating Additional JDBC Data Sources in WebSphere
8.2.1
Creating a Data Provider and Data Source in WebSphere
8.2.2
Adding the New Data Source to Oracle RTD
8.2.3
Updating Resource References in WebSphere
8.2.4
Adding Additional Data Sources
8.3
Creating Additional JDBC Data Sources in WebLogic
8.3.1
Setting the Path to JDBC Jar Files for Your Data Source
8.3.2
Creating a Data Source in WebLogic
8.3.2.1
Creating an Oracle JDBC Provider for the Oracle RTD Database on WebLogic 11g 10.3.3+
8.3.3
Adding the New Data Source to Oracle RTD
8.4
Creating Additional JDBC Data Sources in JBoss
8.4.1
Creating a Connection Pool and Data Source in JBoss
8.4.2
Adding the New Data Source to Oracle RTD
8.4.3
Updating RTD.ear in JBoss
8.5
Testing a New Enterprise Data Source
9
Additional Configuration Settings and Starting Client Tools
9.1
Decision Center Browser Configuration
9.2
Real-Time Decision Server Logging Configuration
9.3
Accessing Oracle Real-Time Decisions Client Tools
9.3.1
Accessing Decision Studio
9.3.2
Accessing Decision Center
9.3.3
Accessing Load Generator
10
Production Deployment of Oracle Real-Time Decisions
10.1
All-In-One Configuration
10.2
Full Deployment Configuration
11
Command Line Deployment of Inline Services
11.1
Deploying the Inline Service
12
Setting Up and Using Model Snapshots
12.1
Overview of Setting Up and Using Model Snapshots
12.2
Model Snapshot Tables Schema
12.3
Configuring the Model Snapshot Tables
12.4
Populating and Clearing the Model Snapshot Tables
12.5
Creating Reports from the Model Snapshot Data
12.5.1
Counts by Choice Query
12.5.2
Top Six Predictive Attributes Query
12.5.3
Difference Between Expected and Actual Counts Query
12.6
Handling Partitions
12.7
Tuning the Model Snapshot Process
13
Deploying Oracle RTD into an Oracle RTD Cluster
13.1
Overview of Oracle RTD Clustering
13.2
Terminology
13.2.1
Distinguishing Oracle RTD Clusters from J2EE Clusters
13.3
Cluster-Specific Configuration Properties
13.4
Creating Server Instances for Oracle RTD Type 3 Clusters
13.4.1
Creating J2EE Clusters
13.4.2
Setting JVM Options
13.4.2.1
Oracle RTD Clustering System Properties
13.4.2.2
Generic JVM Options
13.4.2.3
Application Server Specific JVM Options
13.4.3
Setting Up JConsole Access
13.4.3.1
JConsole on Oracle AS and WebLogic
13.4.3.2
JConsole on WebSphere
13.4.4
Setting Up JDBC Resources
13.5
Deploying Oracle RTD into an Oracle RTD Type 3 Cluster
13.5.1
Deploying RTD.ear Into rtdGroup1 as OracleRTD
13.5.2
Deploying RTD.ear Into rtdGroup2 as OracleRTD2
13.5.2.1
Configuring Classpath for OracleRTD2 in Oracle AS
13.5.3
Disabling Certain Oracle RTD Services
13.5.4
Setting Decision Service Address
13.5.5
Adding Restricted Cluster Members
13.5.6
Adding Trusted Decision Service Clients
13.6
Optional Session Affinity Cookie
13.7
Setting up a WebLogic Cluster
13.7.1
Cluster Machine Setup
13.7.2
Installing Oracle RTD Software
13.7.3
Initializing Oracle RTD Database
13.7.4
Installing WebLogic \Apache Server
13.7.4.1
Installing WebLogic Application Server
13.7.4.2
Installing Apache HTTP Server
13.7.5
Setting Up WebLogic Domain and Node Managers
13.7.5.1
Creating WebLogic Domain
13.7.5.2
Copying OracleRTD JDBC Jar to Domain
13.7.5.3
Starting All Machine Node Managers
13.7.6
Creating Oracle RTD Roles and Users
13.7.7
Creating Machines, Clusters, and Servers
13.7.7.1
Creating WebLogic Machines
13.7.7.2
Creating WebLogic Cluster
13.7.7.3
Creating Servers
13.7.7.4
Setting Server JVM Properties
13.7.8
Creating JDBC Data Sources
13.7.8.1
Creating an Oracle JDBC Provider for the Oracle RTD Database on WebLogic 11g 10.3.3+
13.7.9
Setting Up the Web Server
13.7.9.1
Enabling WebLogic Proxy Plug-In in Servers
13.7.9.2
Setting Up Apache HTTP Server
13.7.10
Deploying RTD.ear Onto Cluster
13.7.11
Copying WebLogic Domain to All Clustered Machines
13.7.12
Starting the Cluster
13.7.12.1
Restarting Admin Server and Node Managers
13.7.12.2
Starting Clustered Servers
13.7.13
Starting the OracleRTD Application
13.7.14
Setting JConsole Server Properties
13.7.15
Disabling HTTP Session Affinity and Enable Request Forwarding on Each Server
13.7.16
Deploying CrossSell Inline Service (Through Web Server Port 8080)
13.7.17
Creating CrossSell Database Tables
13.7.18
Running Load Generator Against CrossSell Inline Service (Through Web Server Port 8080)
13.8
Setting up a WebSphere Cluster
13.8.1
Cluster Machine Setup
13.8.2
Setting Up Host Machine Files
13.8.3
Installing WebSphere Software
13.8.4
Installing Oracle RTD Software
13.8.5
Initializing the Oracle RTD Database
13.8.6
Adding Nodes to Deployment Manager
13.8.7
Creating an Administrative User and Enabling Security
13.8.8
Adding Virtual Host Port 8080
13.8.9
Creating Cluster and Servers and Setting Server Properties
13.8.9.1
Creating Cluster and Servers
13.8.9.2
Setting Server JVM Properties
13.8.9.3
Setting Server Administration Properties
13.8.10
Creating Oracle RTD Roles and Users
13.8.10.1
Creating Users for Oracle RTD
13.8.10.2
Creating Groups
13.8.10.3
Standard Oracle RTD Roles
13.8.11
Adding Virtual Host HTTP Address for Servers
13.8.11.1
Getting HTTP Addresses For Each Server
13.8.11.2
Creating an HTTP Virtual Port For Each Unique Server Port
13.8.12
Creating JDBC Providers and Data Sources
13.8.12.1
Creating JDBC Providers
13.8.12.2
Creating J2C Authentication Aliases
13.8.12.3
Creating Data Sources
13.8.12.4
Setting Data Source Properties
13.8.12.5
Setting Data Source Statement Cache
13.8.12.6
Restarting Nodes and Deployment Manager
13.8.12.7
Testing Data Source Connection
13.8.13
Creating the Web Server
13.8.13.1
Modifying IBM HTTP Server Configuration File
13.8.13.2
Creating Web Server
13.8.13.3
Generating and Propagating Web Server Plug-In
13.8.13.4
Starting the Web Server
13.8.14
Starting the Cluster and Servers
13.8.15
Deploying RTD.ear onto Cluster
13.8.15.1
Deploying RTD.ear to Cluster
13.8.15.2
Generating and Propagating Web Server Plug-In
13.8.15.3
Starting the OracleRTD Application
13.8.16
Setting Classloader Priority
13.8.17
Viewing and Changing User-Role Associations
13.8.18
Creating Custom Roles and Assigning Permissions to Custom Roles (Optional)
13.8.18.1
Creating Custom Roles
13.8.18.2
Assigning Permissions to Custom Roles
13.8.19
Creating startJConsole Batch Files
13.8.19.1
Getting Bootstrap Addresses For Each Server
13.8.19.2
Creating JConsole Startup Script For Each Server
13.8.20
Deploying CrossSell Inline Service
13.8.21
Creating CrossSell Database Tables
13.8.22
Running Load Generator Against CrossSell Inline Service
13.8.23
Creating WebSphere Thread Dump
13.9
Setting up an Oracle AS Cluster
13.9.1
Cluster Machine Setup
13.9.2
Operations to Perform on Host1 and Host2
13.9.3
Installing Oracle AS 10.1.3.3
13.9.4
Optionally Changing Port
13.9.5
Creating OC4J Groups and Instances
13.9.6
Creating JDBC Resources
13.9.7
Setting Server Properties
13.9.7.1
Adjusting Start Parameters
13.9.7.2
Changing Web-Site
13.9.7.3
Checking Process Group
13.9.8
Creating Oracle AS RTD Data Source
13.9.9
Editing OC4J Instance Configurations
13.9.9.1
Editing server.xml
13.9.9.2
Creating rtd-web-site.xml
13.9.10
Deploying RTD.ear into rtdGroup as OracleRTD
13.9.11
Deploying RTD.ear into rtdGroup2 as OracleRTD2
13.9.12
Verifying the Configuration
13.9.13
Disabling Certain Oracle RTD Services
13.9.14
Joining the Clusters on Host1 and Host2
13.9.14.1
Combining Two Separate Oracle Application Server Installations Into a Cluster
13.10
Setting up a JBoss Cluster
13.10.1
Installing the Oracle RTD Software
13.10.2
Initializing the Oracle RTD Database
13.10.3
Setting Up and Installing the Apache Software
13.10.3.1
Installing the Apache Server and Downloading mod_jk
13.10.3.2
Configuring the Apache Server
13.10.3.3
Creating the File mod_jk.conf
13.10.3.4
Creating the File uriworkermap.properties
13.10.3.5
Creating the File workers.properties
13.10.3.6
Starting the Apache HTTP Server
13.10.4
Installing the JBoss Software
13.10.5
Configuring the JBoss Software
13.10.5.1
Enabling the JBoss Default User
13.10.5.2
Setting JBoss HTTP and HTTPS Ports
13.10.5.3
Setting JBoss Web Server to User Java 1.5 JVM
13.10.5.4
Adding Oracle RTD Logging to JBoss Server
13.10.5.5
Copying Oracle RTD log4j Jar to JBoss
13.10.5.6
Copying New Version of the Eclipse JDT Compiler to JBoss Web Server Directory
13.10.5.7
Copying Oracle RTD jgroups Jar to JBoss
13.10.5.8
Configuring JBoss to Add Identifiers to HTTP Session IDs
13.10.5.9
Giving Identities to JBoss Servers to Match workers.properties Entries
13.10.5.10
Setting Up Oracle RTD SDDS Data Source and Copying to JBoss Deploy Directory
13.10.5.11
Modifying JBoss Start Script
13.10.5.12
Changing Message Server Server Id on Machine #2
13.10.6
Creating Oracle RTD Roles and Users
13.10.7
Starting the JBoss Application Server
13.10.8
Deploying RTD.ear to the JBoss Cluster
13.10.9
Undeploying RTD.ear from the JBoss Cluster
13.10.10
Stopping the JBoss Application Server
13.10.11
JBoss and Oracle RTD Logs
14
Performance Monitoring
14.1
Setting Performance Monitoring Parameters
14.2
Viewing Common Performance Monitoring Snapshot Values
14.3
CSV File Contents
14.4
XLS File Contents
15
Managing Oracle Real-Time Decisions
15.1
Accessing JConsole
15.1.1
Accessing JConsole for OC4J, Oracle Application Server, or WebLogic
15.1.2
Accessing JConsole for WebSphere
15.2
About JMX MBean Operations and Attributes
15.3
Oracle Real-Time Decisions Cluster-Level Management
15.3.1
About OracleRTD > SDManagement > SDClusterPropertyManager
15.3.2
About OracleRTD > SDClusterPropertyManager > Misc
15.3.3
About OracleRTD > SDClusterPropertyManager > Cluster
15.3.4
About OracleRTD > SDClusterPropertyManager > Deployment
15.3.5
About OracleRTD > SDCluster > SDManagement
15.4
Oracle Real-Time Decisions Member-Level Management
15.4.1
About OracleRTD > SDManagement > SDLogging
15.4.2
About OracleRTD > SDManagement > SDPropertyManager
15.4.3
About OracleRTD > SDPropertyManager > Performance Monitoring
15.4.4
About OracleRTD > SDPropertyManager > Misc
15.4.5
About OracleRTD > Server > DecisionService
15.4.6
About OracleRTD > Server > SDManagement
15.4.7
About OracleRTD > Server > BatchAgent
15.4.8
About OracleRTD > Server > BatchManager
15.5
Oracle Real-Time Decisions Security Management
15.5.1
About OracleRTD > SDManagement > SecurityManager
15.6
Managing Inline Services
15.6.1
About OracleRTD > SDManagement > InlineServiceManager
15.6.2
About OracleRTD > InlineServiceManager > [Inline Service] > [Deployment State] > [Flag]
15.6.3
Invoking Maintenance Operations
15.7
Deployment States
15.7.1
About OracleRTD > SDManagement > DeploymentStates
15.7.2
About OracleRTD > Deployment States > [State]
15.8
Managing the Learning Service
15.8.1
About OracleRTD > Server > LearningService
15.8.2
About OracleRTD > Learning Server > [Study]
15.8.3
About OracleRTD > Study > [Study Name] > [Model]
15.9
System Properties
A
System Log and Configuration Files
A.1
Log Files
A.1.1
Main Oracle RTD Log Files
A.1.2
Log Files for Oracle RTD Client Tools
A.1.3
Server-Side Application Server Specific Log Files
A.1.3.1
Server-Side Log Files for Standalone OC4J
A.1.3.2
Server-Side Log Files for Oracle Application Server
A.1.3.3
Server-Side Log Files for WebSphere
A.1.3.4
Server-Side Log Files for WebLogic
A.1.3.5
Server-Side Log Files for JBoss
A.1.4
Eclipse Log File
A.2
Configuration Files
B
Exceptions