4.4 Install Oracle Machine Learning for R Server for Oracle Database 12c and Earlier

Instructions for installing OML4R Server for Oracle Database 12c or earlier.

Note:

To install OML4R Server without needing to respond to visual prompts, use a batch mode installation such as that described in A Default Batch Installation.

To install OML4R Server:

  1. Ensure that your system satisfies the requirements specified in Oracle Machine Learning for R Server Requirements.

  2. Create an installation directory for the OML4R Server components. The directory can have any name. For example:

    /oml4r_server_install_dir
    
  3. Download the OML4R Server installation files and supporting packages from the Oracle Machine Learning for R Downloads page on the Oracle Technology Network.

    1. Accept the license agreement and download the OML4R Server files for your platform to your installation directory.

    2. Accept the license agreement and download the OML4R Supporting packages for your platform to your installation directory.

    The installation directory now contains two zip files.

    ore-server-platform-arch-version.zip
    ore-supporting-platform-arch-version.zip
    
  4. Unzip the files.

    unzip ore-server-platform-arch-version.zip
    unzip ore-supporting-platform-arch-version.zip
    

    The installation directory looks like this after you unzip both files:

    For Linux or UNIX:

    /oml4r_server_install_dir
         ore-server-platform-arch-version.zip
         ore-supporting-platform-arch-version.zip
         server.sh
         /server
         /supporting
    

    For Windows:

    \oml4r_server_install_dir
         ore-server-platform-arch-version.zip
         ore-supporting-platform-arch-version.zip
         server.bat
         \server
         \supporting
    
  5. For Linux or UNIX, run server.sh. For Windows, run server.bat. The script performs a default, first-time installation of OML4R Server, as described in A Default Interactive Installation. For details about the server script, see About the Server Script.

    For Linux or UNIX:

    ./server.sh

    For Windows:

    server.bat

Note:

Beginning in R-3.3.0, on an Oracle Linux 6 system, it is necessary to set LD_LIBRARY_PATH in $ORACLE_HOME/hs/admin/extproc.ora to the location of the R-core-extra RPM so that these libraries are found by the Oracle process running extproc. On Linux systems, the default location of the R-core-extra RPM is /usr/lib64/R/port/Linux-X64/lib. In extproc.ora, enter:

SET LD_LIBRARY_PATH=/usr/lib64/R/port/Linux-X64/lib

For changes in extproc.ora to take effect, you must stop and restart the database.

This procedure is not necessary on a Linux 7 system, as the required versions of the libraries provided by the R-core-extra RPM are available natively..

See Also:

Example A-1 for an example with output

About the R-core-extra RPM

R has always depended on several third party libraries, specifically, zlib, bzip2, xz, pcre, and curl. Prior to R-3.3.0, R depended on older versions of these libraries, but, if they were not found on the system, bundled copies were included that were built on the fly.

R-3.3.0 depends on newer versions of these libraries and no longer contains the bundled copies. This means that R-3.3.0 won't build against Linux 6 as is, because the native versions of these libraries are older than those that R-3.3.0 requires.

The R-core-extra RPM contains the required versions of these libraries and is provided as a convenience for users of Oracle Linux 6. Adding the location of the libraries in R-core-extra to LD_LIBRARY_PATH removes the need to built these libraries separately. Oracle Linux 7 and later contain the required versions of these libraries, so the R-core-extra RPM is not required.

The following topic describes the OML4R Server script for Oracle Database 12c and earlier.