Skip Headers
Oracle® Real-Time Decisions Installation and Administration Guide
Version 3.0.0.1

Part Number E13856-02
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Feedback page
Contact Us

Go to previous page
Previous
Go to next page
Next
View PDF

1 Preparing for Installation

Oracle RTD is supported on both Windows and UNIX platforms, and runs on Oracle Containers for J2EE (OC4J), Oracle WebLogic, IBM WebSphere, and JBoss 4.3 EAP application servers. For detailed information about supported platforms, refer to Oracle Real-Time Decisions System Requirements and Supported Platforms for Versions 3.0 and 3.0.0.1.

Note:

If you plan to install Oracle RTD on OC4J, you can choose either a standalone version of OC4J, or the version of OC4J that comes with Oracle Application Server.

This chapter contains the following topics:

1.1 About Oracle Real-Time Decisions Installation

Oracle RTD is a real-time decision engine software platform that consists of the following components:

Real-Time Decision Server can be installed on either Windows or UNIX platforms. Decision Studio and Load Generator are client components that can only run on Windows.

Real-Time Decision Server requires its own database, called the Oracle RTD Database, to store objects and metadata for inline services created in Decision Studio.

To install Oracle RTD, you need to:

  1. Install the database server, Java Development Kit, and application server.

  2. Install files for the Real-Time Decision Server and Oracle RTD clients, and create and initialize the database.

  3. Configure the data source for the Oracle RTD Database.

  4. Deploy and configure Real-Time Decision Server using the administration console for your application server, and other tools.

  5. Configure authentication settings.

  6. Set up access to enterprise data sources.

1.2 Installing the Database Server

Install the database server you want to use as the Oracle RTD Database. This database must be one of the following: Oracle Database, Microsoft SQL Server, or IBM DB2. For information about database installation, refer to your database documentation. For detailed information about supported database versions, refer to Oracle Real-Time Decisions System Requirements and Supported Platforms for Versions 3.0 and 3.0.0.1, available from the Oracle RTD Documentation Web site at:

http://www.oracle.com/technetwork/middleware/real-time-decisions/documentation/index.html

Note the following:

1.3 Installing Java Development Kit (JDK)

For some configurations, you need to download and install a Java Development Kit (JDK) before proceeding with Oracle RTD installation. The following sections provide more information about whether you need to install a JDK, and, if so, which JDK to install.After installing the JDK, create a system environment variable called JAVA_HOME and set its value to the full path name of the install location of the JDK.

Modify the system environment variable PATH by adding %JAVA_HOME%\bin; to the beginning of the existing value.

For example, if the existing PATH value is 'abc;', then the new value should be:

'%JAVA_HOME%\bin;abc;'

1.3.1 Standalone OC4J Installations

If you plan to install Real-Time Decision Server on standalone OC4J on Windows, you must install Sun JDK version 1.5.0.8+ or 1.6 before proceeding with the installation of Oracle RTD.

If you plan to install Real-Time Decision Server on standalone OC4J on Solaris or Linux, you must install Sun JDK version 1.5.0.8+ or 1.6 before proceeding with the installation of Oracle RTD.

If you plan to install Real-Time Decision Server on standalone OC4J on HP-UX, you must install HP-UX JDK 5.0.05 before proceeding with the installation of Oracle RTD.

If you plan to install Real-Time Decision Server on standalone OC4J on AIX-based systems, you must install IBM Java 5 SR2 before proceeding with the installation of Oracle RTD.

You must install Sun JDK version 1.5.0.8+ or 1.6 on the Windows computer where you plan to install the Oracle RTD client tools (such as Decision Studio, Load Generator, and SDDBTool). You can also use the JDK shipped within the Oracle RTD archive file, in the jdk folder under the Oracle RTD home directory, for example, C:\OracleBI\RTD\jdk.

1.3.2 Oracle Application Server Installations

If you plan to install Real-Time Decision Server on the version of OC4J that ships with Oracle Application Server on Windows, you do not need to download a separate JDK. Oracle Application Server comes with its own JDK. However, you do need to set the JAVA_HOME system environment variable and set its value to the full path name of the install location of the JDK being used by Oracle Application Server.

If you plan to install Real-Time Decision Server on the version of OC4J that ships with Oracle Application Server on Solaris, Linux, HP-UX, or AIX-based systems, you do not need to download a separate JDK. Oracle Application Server comes with its own JDK.

You must install Sun JDK version 1.5.0.8+ or 1.6 on the Windows computer where you plan to install the Oracle RTD client tools (such as Decision Studio, Load Generator, and SDDBTool). You can also use the JDK shipped within the Oracle RTD archive file, in the jdk folder under the Oracle RTD home directory, for example, C:\OracleBI\RTD\jdk.

1.3.3 WebSphere Installations

If you plan to install Real-Time Decision Server on WebSphere on Windows, you do not need to download a separate JDK. WebSphere comes with its own JDK. However, you do need to set the JAVA_HOME system environment variable and set its value to the full path name of the install location of the JDK being used by WebSphere.

If you plan to install Real-Time Decision Server on WebSphere on Solaris, Linux, HP-UX, or AIX-based systems, you do not need to download a separate JDK. WebSphere comes with its own JDK.

You must install Sun JDK version 1.5.0.8+ or 1.6 on the Windows computer where you plan to install the Oracle RTD client tools (such as Decision Studio, Load Generator, and SDDBTool). You can also use the JDK shipped within the Oracle RTD archive file, in the jdk folder under the Oracle RTD home directory, for example, C:\OracleBI\RTD\jdk.

1.3.4 WebLogic Installations

If you plan to install Real-Time Decision Server on WebLogic on Windows, Solaris, or Linux, you do not need to download a separate JDK. WebLogic comes with its own JDK.

You must install Sun JDK version 1.5.0.8+ or 1.6 on the Windows computer where you plan to install the Oracle RTD client tools (such as Decision Studio, Load Generator, and SDDBTool). You can also use the JDK shipped within the Oracle RTD archive file, in the jdk folder under the Oracle RTD home directory, for example, C:\OracleBI\RTD\jdk.

Note:

If you are installing WebLogic on a UNIX system, you must add the bin directory of the appropriate JDK to the beginning of the PATH operating system environment variable, as follows:
PATH=JAVA_HOME/bin:$PATH
export PATH

1.3.5 JBoss Installations

If you plan to install Real-Time Decision Server on JBoss, download and install JDK version 1.6, then set the JAVA_HOME system environment variable to the folder where JDK was installed.

If you plan to install the Oracle RTD client tools (such as Decision Studio, Load Generator, and SDDBTool on a separate machine from the Real-Time Decision Server, Oracle recommends that you install JDK version 1.5 on that separate machine. After installing the JDK, set the JAVA_HOME system environment variable to the folder where JDK was installed. You can also use the JDK shipped within the Oracle RTD archive file, in the jdk folder under the Oracle RTD home directory, for example, C:\OracleBI\RTD\jdk.

1.4 Installing the Application Server

Real-Time Decision Server runs on one of the following application servers: OC4J (a component of Oracle Application Server), WebSphere, WebLogic, or JBoss 4.3 EAP. For detailed information about supported application server versions, refer to Oracle Real-Time Decisions System Requirements and Supported Platforms for Versions 3.0 and 3.0.0.1, available from the Oracle RTD Documentation Web site at:

http://www.oracle.com/technetwork/middleware/real-time-decisions/documentation/index.html

Note:

For up to date information on specific versions of your spplication server, read all references to that application server in Oracle Real-Time Decisions Release Notes.

1.4.1 Installing OC4J for Oracle RTD

You can choose to install a standalone version of OC4J, or the version of OC4J that comes with Oracle Application Server. The standalone version of OC4J includes a single server in a small package without an installer. The version of OC4J included with Oracle Application Server provides a full-suite installer and supports J2EE clustering.

1.4.1.1 Installing Standalone OC4J

Follow these steps to install standalone OC4J for Oracle RTD:

  1. On the computer where you want to run Real-Time Decision Server, install standalone OC4J. Refer to Oracle Containers for J2EE Configuration and Administration Guide for information about installing standalone OC4J.

    Note:

    In this document, the directory where the standalone OC4J instance is installed is referred to as OC4J_HOME. For example, if you unzip the standalone OC4J files into C:\Program Files, your OC4J_HOME will be C:\Program Files\OC4J.
  2. Make a backup copy of the file OC4J_HOME\bin\oc4j.cmd (or OC4J_HOME/bin/oc4j on UNIX).

  3. Open OC4J_HOME\bin\oc4j.cmd (or OC4J_HOME/bin/oc4j on UNIX) for editing. At the top of the file, add the following line:

    set ORACLE_HOME=your_OC4J_HOME
    

    For example:

    set ORACLE_HOME=C:\OracleBI\OC4J
    

    Then, save and close the file.

  4. Start OC4J using the oc4j script. To do this, open a command prompt and go to OC4J_HOME\bin (or OC4J_HOME/bin on UNIX), then type oc4j -start.

  5. When prompted, enter a new password and confirm it. This password is the password for the oc4jadmin account, which is the administrative account for the OC4J instance. You only need to provide this password the first time you start OC4J; you do not need to enter it for subsequent OC4J startups.

  6. Shut down the OC4J server using the oc4j script. To do this, open a command prompt and go to OC4J_HOME\bin (or OC4J_HOME/bin on UNIX), then issue the following command. You must supply the ORMI port used by OC4J, which is 23791 by default, as well as the password for the oc4jadmin account.

    oc4j -shutdown -port oc4jOrmiPort -password oc4jadmin_password
    

    For example:

    oc4j -shutdown -port 23791 -password mypwd
    

1.4.1.2 Installing Oracle Application Server

On the computer where you want to run Real-Time Decision Server, install Oracle Application Server. Refer to Oracle Application Server Installation Guide for information about installing Oracle Application Server.

Note:

In this document, the directory where Oracle Application Server is installed is referred to as ORACLE_AS_HOME. For example, if you install Oracle Application Server into C:\Oracle, your ORACLE_AS_HOME will be similar to C:\Oracle\10.1.3.1\OracleAS_1.

1.4.2 Installing WebSphere for Oracle RTD

Follow these steps to install WebSphere for Oracle RTD:

  1. Install WebSphere on the computer where you want to run Real-Time Decision Server. Refer to the WebSphere documentation for information about installing WebSphere. When installing, you must be logged into the local computer as an administrative user.

    Note:

    In this document, the directory where WebSphere is installed is referred to as WEBSPHERE_HOME. For example, on Windows, the default WEBSPHERE_HOME is C:\Program Files\IBM\WebSphere.

1.4.3 Installing WebLogic for Oracle RTD

Follow these steps to install WebLogic for Oracle RTD:

  1. If you are installing WebLogic on UNIX, make sure that the JAVA_HOME/bin directory for the appropriate JDK has been added to the beginning of the PATH operating system environment variable. See Section 1.3.4, "WebLogic Installations" for more information about JDK requirements for WebLogic.

  2. Install WebLogic on the computer where you want to run Real-Time Decision Server. Refer to the WebLogic documentation for information about installing WebLogic.

    When the Installation Complete window appears, you can select Run Quickstart, and click Done to start the WebLogic Server.

    Note:

    In this document, the directory where WebLogic is installed is referred to as MW_HOME. For example, if you install WebLogic into C:\, your MW_HOME will be similar to C:\Oracle\Middleware.

1.4.4 Installing JBoss for Oracle RTD

Follow these steps to install JBoss 4.3 EAP for Oracle RTD:

  1. Install JBoss 4.3 EAP on the computer where you want to run Real-Time Decision Server.

    Note:

    The directory into which you installed JBoss 4.3 EAP is referred to as JBOSS_HOME.

    For example, C:\Program Files\EnterprisePlatform-4.3.0.GA_CP03, C:\jboss-eap-4.3, d:\genesis\jboss-eap-4.3.

  2. Enable the JBoss default user, as follows:

    1. Open the file JBOSS_HOME /jboss-as/server/default/conf/props/jmx-console-users.properties

    2. Uncomment the sample user/password (if needed): #admin=admin

      Example: admin=admin

    3. Save the file.

  3. Set the JBoss HTTP and HTTPS ports, as follows:

    1. Open the file JBOSS_HOME /jboss-as/server/default/deploy/jboss-web.deployer/server.xml

    2. For HTTP, near the top of the file at ''<Connector port="8080" ...'

      add the following line after the line "enableLookups":

      URIEncoding="UTF-8"

      For example:

      <Connector port="8080" address="${jboss.bind.address}"    
                maxThreads="250" maxHttpHeaderSize="8192"
                emptySessionPath="true" protocol="HTTP/1.1"
                enableLookups="false" redirectPort="8443" acceptCount="100"
                URIEncoding="UTF-8"
                connectionTimeout="20000" disableUploadTimeout="true" />
      
    3. For HTTPS, near the top of the file, replace:

      <!--
      <Connector port="8443" protocol="HTTP/1.1" SSLEnabled="true"
                        maxThreads="150" scheme="https" secure="true" 
                        clientAuth="false" sslProtocol="TLS" /> 
      -->
      

      with:

      <Connector port="8443" protocol="HTTP/1.1" SSLEnabled="true"
                        maxThreads="150" scheme="https" secure="true"
                        clientAuth="false" sslProtocol="TLS"
                        minSpareThreads="5" maxSpareThreads="15"
                        address="${jboss.bind.address}"           keystoreFile="${rtd.install.dir}/etc/ssl/sdserver.keystore"
                       URIEncoding="UTF-8"
                        keystorePass="tc-ssl" />
      
    4. Save the file.

  4. Set the JBoss Web Container to use Java compiler compliance level 1.5, as follows:

    1. Open the file JBOSS_HOME /jboss-as/server/default/deploy/jboss-web.deployer/conf/web.xml

    2. Locate:

      <servlet>          <servlet-name>jsp</servlet-name>
      
    3. Add the following servlet init parameters:

      <init-param>
         <param-name>compilerSourceVM</param-name>
         <param-value>1.5</param-value>
      </init-param>
      <init-param>
         <param-name>compilerTargetVM</param-name>
         <param-value>1.5</param-value>
       </init-param>
      
    4. Save the file.

1.5 Additional Preinstallation Tasks

Close all open applications before you install Oracle RTD. In particular, shut down any applications or processes that use port 8080, the default Oracle RTD port. In addition, shut down any real-time indexing software, such as Google Desktop, before installing Oracle RTD. Running real-time indexing software on the computer where Real-Time Decision Server is running can adversely impact Oracle RTD performance.