Oracle® Real-Time Decisions Installation and Administration Guide Version 3.0.0.1 Part Number E13856-02 |
|
|
View PDF |
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:
Oracle RTD is a real-time decision engine software platform that consists of the following components:
Real-Time Decision Server
Decision Studio
Decision Center
Load Generator
Administration (JMX)
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:
Install the database server, Java Development Kit, and application server.
Install files for the Real-Time Decision Server and Oracle RTD clients, and create and initialize the database.
Configure the data source for the Oracle RTD Database.
Deploy and configure Real-Time Decision Server using the administration console for your application server, and other tools.
Configure authentication settings.
Set up access to enterprise data sources.
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:
If you are using SQL Server, you may install your database server either as the default (unnamed) instance or as a named instance.
If you are using Oracle Database, you must install the user_lock package. Refer to the Oracle Database documentation for information about installing optional Oracle packages.
You can install your database server on the same computer where you plan to install Oracle RTD, or on a different computer.
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;
'
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
.
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
.
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
.
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 thebin
directory of the appropriate JDK to the beginning of the PATH
operating system environment variable, as follows:
PATH=JAVA_HOME/bin:$PATH
export PATH
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
.
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.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.
Follow these steps to install standalone OC4J for Oracle RTD:
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 asOC4J_HOME
. For example, if you unzip the standalone OC4J files into C:\Program Files
, your OC4J_HOME
will be C:\Program Files\OC4J
.Make a backup copy of the file OC4J_HOME
\bin\oc4j.cmd
(or OC4J_HOME
/bin/oc4j
on UNIX).
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.
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
.
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.
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
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 asORACLE_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
.Follow these steps to install WebSphere for Oracle RTD:
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 asWEBSPHERE_HOME
. For example, on Windows, the default WEBSPHERE_HOME
is C:\Program Files\IBM\WebSphere
.Follow these steps to install WebLogic for Oracle RTD:
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.
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 asMW_HOME
. For example, if you install WebLogic into C:\
, your MW_HOME
will be similar to C:\Oracle\Middleware
.Follow these steps to install JBoss 4.3 EAP for Oracle RTD:
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 asJBOSS_HOME
.
For example, C:\Program Files\EnterprisePlatform-4.3.0.GA_CP03, C:\jboss-eap-4.3, d:\genesis\jboss-eap-4.3
.
Enable the JBoss default user, as follows:
Open the file JBOSS_HOME
/jboss-as/server/default/conf/props/jmx-console-users.properties
Uncomment the sample user/password (if needed): #admin=admin
Example: admin=admin
Save the file.
Set the JBoss HTTP and HTTPS ports, as follows:
Open the file JBOSS_HOME
/jboss-as/server/default/deploy/jboss-web.deployer/server.xml
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" />
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" />
Save the file.
Set the JBoss Web Container to use Java compiler compliance level 1.5, as follows:
Open the file JBOSS_HOME
/jboss-as/server/default/deploy/jboss-web.deployer/conf/web.xml
Locate:
<servlet> <servlet-name>jsp</servlet-name>
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>
Save the file.
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.