4 Install Server

This chapter describes how to install the Oracle R Enterprise server on Linux. You can also install the server on Oracle Exadata, as described in Install Server on Oracle Exadata.

Install the same release of Oracle R Enterprise for both client and server.

Install the server as follows:

Make sure that the Prerequisites for Linux are satisfied.

You can install the server on Linux only.
Make sure that Oracle Database Requirement is installed on the system where you plan to install the server. Make sure that any required patches are installed properly.
Install R, as described in R Requirement.

Install R before you install the server.

Before you start the server installation, check that you can run R. This usually means that the R executable is in your PATH environment variable.
Make sure that the Required Privileges are satisfied. If you do not run the install script from an appropriate account, the script will fail.
Set the Environment Variables ORACLE_HOME, ORACLE_SID, LD_LIBRARY_PATH, and PATH.
Read Server Installation Overview or go to Install Server on Linux to begin the install.
Follow the directions in Install Server on Linux or Install Server on Oracle Exadata to install the server.
Install the Oracle R Enterprise Client Supporting Packages.

Before you can run Oracle R Enterprise, you must create at least one user, as described in Oracle R Enterprise Users. Then you can Validate Oracle R Enterprise Installation.

Before You Install the Server

The install scripts for the Oracle R Enterprise server require:

You must run the script from an account that has Required Privileges.
You must properly set certain Environment Variables.

This section also contains the Server Installation Overview that explains how the installation script works.

Required Privileges

Important: Before you start installation, make sure that:

You have DBA privileges, that is, you can run as oracle:
- On Linux, you must be a member of the DBA group; the user oracle satisfies this requirement. Note that root is not usually a member of the DBA group.
  
  If necessary, users can be added to the DBA group with
```
useradd -G dba <username>
```
In any case, make sure that you are logged in to an account in which you can run sqlplus / as sysdba before you run the install script.
You have write privileges at the operating system level to the directory $ORACLE_HOME/lib; the user oracle satisfies this requirement

In summary, for all platforms, you can use the account that you used to install the database to install the server. Check that you can run R from this account.

Environment Variables

Make sure that these environment variables exist and are defined properly:

Add $ORACLE_HOME/lib to LD_LIBRARY_PATH
Add $ORACLE_HOME/bin to PATH
Define the variable $ORACLE_SID; it contains the SID for the database where you install Oracle R Enterprise.

Server Installation Overview

The installation scripts for the server works as follows:

Before the Oracle R Enterprise server install starts, it checks for the presence of an R installation.
Once the script verifies that R is known to be installed and its location known via PATH, the install checks for the presence of these libraries in $R_HOME/lib/. In particular, the script checks for
- $R_HOME/lib/libR.so
- $R_HOME/lib/libRblas.so
- $R_HOME/lib/libRlapack.so
Next the script checks the location of the database installation by checking for the presence of environment variable ORACLE_HOME and ORACLE_SID.

If ORACLE_HOME is set, the install expects that the $ORACLE_HOME/lib directory is present.

Before you start the script check that ORACLE_HOME and ORACLE_SID are present and properly set.
Next the script checks the Oracle database instance information. The check includes looking for environment variable ORACLE_SID and then connecting to the instance by starting
```
sqlplus  /as sysdba
```
Logging into the database as sysdba is critical for the install script to proceed.

If sqlplus fails to connect to the database instance, the install process aborts.

Before you start the installation script, check that you can connect to the database using this sqlplus command.
If Oracle R Enterprise has been installed on the database, that is, if you installed release 1.0, 1.1, or 1.2, then the installer expects to find a user name RQSYS in dba_users table and the Oracle R Enterprise version number details in SYS.RQ_CONFIG. The installer uses this information subsequently to install the correct SQL packages.
The script prompts you to optionally enter the names of permanent and temporary table spaces for the RQSYS schema; the default schemas are SYSAUX and TEMP.

At this point, the install script has determined it has found the prerequisites satisfactory and proceeds to do the actual installation.
The install script now attempts to copy libraries to $ORACLE_HOME/lib.

If $ORACLE_HOME/lib is not writable then the installer errors out.
The install script now installs the RQSYS schema. Installing the schema requires logging into the database as SYSDBA.
Finally, the ORE packages are installed under $ORACLE_HOME/R/library.

Install Server on Linux

These directions describe how to install Oracle R Enterprise on Oracle Linux or Red Hat Linux on the Linux x86-64 platform. To install the server on Oracle Exadata, see Install Server on Oracle Exadata.

Review Before You Install the Server before you run the installation script. Make sure that all environment variables are properly set and that all required directories are present.

Follow these steps to install the server:

Install a Database that satisfies Oracle Database Requirement. Make sure that any required patches are installed properly. If the Database is already installed, make sure that it satisfies the requirements.
Install R, as described in R Requirement.
Make sure that these environment variables exist and are defined properly:
- Add $ORACLE_HOME/lib to LD_LIBRARY_PATH
- Add $ORACLE_HOME/bin to PATH
- Define the variable $ORACLE_SID; it contains the SID for the database where you install ORE.
You must have DBA privileges that is, you can run as oracle. The install scripts run SQL*Plus / as sysdba and write to ORACLE_HOME.
Download ore-server-linux-x86-64-1.3.zip as described in Download Oracle R Enterprise Software. If you install the server on Oracle Database 11g Release 2 (11.2), you must download the archive.
Unzip ore-server-linux-x86-64-1.3.zip into an empty directory on your local system. This creates a directory containing library files, SQL scripts, and the install shell script install.sh.
Run install.sh. to create objects in the SYS and RQSYS schemas.

This script copies ORE packages to $ORACLE_HOME/R/library and R_LIBS_USER.

The script executes rqinst.sqlwith SYSAUX and TEMP as the default and temporary tablespaces.

The script creates all SQL objects required by Oracle R Enterprise in the RQSYS user schema. The RQSYS schema is created as a locked account with expired password and no connect privileges.
Install the Oracle R Enterprise Client Supporting Packages ore-supporting-linux-x86-64-1.3.zip as follows:

Unzip the download. Go to the directory where you unzipped the archive and run these commands:
```
ORE CMD INSTALL DBI_0.2-5_R_x86_64-unknown-linux-gnu.tar.gz
ORE CMD INSTALL ROracle_1.1-7_R_x86_64-unknown-linux-gnu.tar.gz
ORE CMD INSTALL png_0.1-4_R_x86_64-unknown-linux-gnu.tar.gz
```
After installation completes, create at least one user, as described in Oracle R Enterprise Users. It may be necessary to make certain GRANTs to users who perform certain tasks; see Required GRANTs.
You may wish to use Oracle Wallet, especially if you plan to run scripts in light-out mode. For information, see Configure Oracle Wallet (Optional)
Validate Oracle R Enterprise Installation.

Install Server on Oracle Exadata

The Oracle Exadata Database Machine is a complete preoptimized and preconfigured package of software, servers, and storage that provides an optimal solution for all database workloads. It combines Oracle Exadata Storage Server Software, Oracle Database software, and Sun hardware components to deliver extreme performance in a highly available and highly secure environment. Along with Oracle's unique clustering and workload management capabilities, the Database Machine is also well-suited for consolidating multiple databases onto a single grid.

These directions describe how to install Oracle R Enterprise on Oracle Exadata.

Oracle Exadata Install Steps

An Oracle Database Machine consists of several compute nodes, along with storage and other facilities. Oracle R Enterprise server must be installed on every compute node), that is on every server where the database is installed.

Follow these steps to install Oracle R Enterprise server on Oracle Exadata:

Install the following software on each compute node:
- Oracle R Distribution, as described in Install R on Linux
- Oracle R Enterprise Server, as described in Install Server on Linux; make sure that you follow all steps, including installation of the Oracle R Enterprise Client Supporting packages
Each compute node has it's own ORACLE_HOME, ORACLE_SID, and PATH environment variable.
You must install the following software on each Oracle R Enterprise client, as described in Install Client:
- Oracle R Distribution
- Oracle R Enterprise Client packages
- Oracle R Enterprise Client supporting packages
The client systems must be able to communicate with the server The clients can run on Microsoft Windows or on Linux.