Skip Headers
Oracle® R Enterprise Installation and Administration Guide
Release 1.3 for Linux and Windows

Part Number E36763-04
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Index
Index
Go to Master Index
Master Index
Go to Feedback page
Contact Us

Go to previous page
Previous
Go to next page
Next
PDF · Mobi · ePub

2 Prerequisites

First decide which platforms the Oracle R Enterprise server and clients will run on. For example, you might install the server on Linux and the client on Microsoft Windows.

Then install the required software before you install Oracle R Enterprise:

Operating System Requirement

Verify that one of these supported operating systems is installed on both client and server. Client and server can be installed on different operating systems.

Oracle R Enterprise is also supported on

R Requirement

You must install R on the server and all clients.

Note:

Oracle R Enterprise 1.3 is certified with R 2.15.1.

Oracle R Enterprise 1.0, 1.1, and 1.2 are certified with R 2.13.2.

Oracle R Distribution (for Linux and similar platforms) was created to work with Oracle R Enterprise.

For Windows, the version of R that you download from CRAN at http://www.r-project.org works with Oracle R Enterprise.

For Linux, the free Oracle R Distribution was created to work with Oracle R Enterprise.

Installation of R depends on the platform:

Oracle R Distribution

Oracle R Distribution is Oracle's free distribution of the open source R environment for Linux.

It is recommended that you use Oracle R Distribution with Oracle R Enterprise for these reasons:

  • Oracle R Distribution has been enhanced for faster performance by taking advantage of hardware specific math library implementations, such as Intel's MKL libraries for high performance mathematical computations on x86 hardware.

  • Oracle R Distribution has been compiled with the flags that are required by Oracle R Enterprise.

    Note:

    If you install R from CRAN, you must ensure that R is compiled with the correct flags for Oracle R Enterprise.
  • Oracle offers support for users of Oracle R Distribution on Oracle Linux 5 Update 6 and higher, Oracle Linux 6, and Red Hat Enterprise Linux 5 Update 6 and higher.

For installation information, see Install R on Linux.

Install R on Windows

Follow these steps to install R 2.15.1 on Windows:

  1. Go to http://www.r-project.org; click CRAN under the heading Download, Packages.

  2. Select a CRAN Mirror.

  3. Click Download R for Windows.

  4. Click base.

  5. Under the heading Other builds, click Previous releases in the third bullet.

  6. Click R 2.15.1 (June, 2012) to start the download.

    Note:

    If you are installing a version of Oracle R Enterprise earlier than 1.3, download R 2.13.2 (September, 2011).

When the download completes, double click the executable that you downloaded, R-2.15.1-win.exe, to launch the Windows installer for R. Follow the instructions to complete the installation.

Note:

It is strongly recommended that you perform a full R installation on 64-bit Windows platforms, so that 64-bit R is installed. (The full R install for 64-bit Windows installs both 32-bit R and 64-bit R.) The Oracle R Enterprise 64-bit Windows Server requires 64-bit R.

You can quickly check that R was installed by starting R from the command line. You will see this startup message for 32-bit R:

R version 2.15.1 (2012-06-22) -- "Roasted Marshmallows"
Copyright (C) 2012 The R Foundation for Statistical Computing
ISBN 3-900051-07-0
Platform: i386-pc-mingw32/i386 (32-bit)
 
R is free software and comes with ABSOLUTELY NO WARRANTY.
You are welcome to redistribute it under certain conditions.
Type 'license()' or 'licence()' for distribution details.
 
  Natural language support but running in an English locale
 
R is a collaborative project with many contributors.
Type 'contributors()' for more information and
'citation()' on how to cite R or R packages in publications.
 
Type 'demo()' for some demos, 'help()' for on-line help, or
'help.start()' for an HTML browser interface to help.
Type 'q()' to quit R.
Install R on Red Hat Enterprise Linux 6

Install R on Linux

It is recommended that you install Oracle R Distribution. Installation on Red Hat Enterprise Linux 6. requires a rebuild.

This section describes how to install Oracle R Distribution on Oracle Linux or Red Hat Linux. To install Oracle R Distribution on Oracle Exadata Machine, see Install R on Oracle Exadata.

The exact steps depend on the version of Linux where you install Oracle R Distribution:

If the Intel Math Kernel Library is available on your system and you wish to use them, see Using MKL.

Install Oracle R Distribution on Linux 5

Oracle R Distribution for Linux 5 allows you to install a version of R 1.13.2 or a version of R 2.15.1 that is designed to work with Oracle R Enterprise. Oracle R Distribution supports Oracle Enterprise Linux 5 and Red Hat Enterprise Linux 5.

Go to http://public-yum.oracle.com/ and follow these steps to install R:

  1. Become root; for example use

    sudo su -
    
  2. Install the yum repository as follows:

    cd /etc/yum.repos.d
    
  3. Use this command to get el5.repo:

    wget http://public-yum.oracle.com/public-yum-el5.repo
    
  4. Open a text editor on the file just downloaded public-yum-el5.repo.

    Set

    • "enabled=1" for [el5_addons]

    • "enabled=1" for [el5_latest]

  5. This step is optional.

    Type the following commands in a shell to check that your yum repository is configured correctly:

    sudo yum repolist
    

    The output should look like this:

    sudo yum repolist
    $ sudo yum repolist
    Loaded plugins: aliases, changelog, downloadonly, kabi, presto, refresh-packagekit, security, tmprepo, verify, versionlock
    Loading support for kernel ABI
    el5_latest                                              | 1.4 kB     00:00    
    el5_latest/pri                                          |  12 MB     00:07    
    el5_latest                                                           9713/9713
    ol6_UEK_latest                                          | 1.2 kB     00:00    
    ol6_UEK_latest/primary                                  | 4.3 MB     00:02    
    ol6_UEK_latest                                                      106/106
    ol6_addons                                               | 1.2 kB     00:00    
    ol6_addons/primary                                       |  11 kB     00:00    
    ol6_addons                                                            52/52
    ol6_latest                                               | 1.4 kB     00:00    
    ol6_latest/primary                                       |  23 MB     00:14    
    ol6_latest                                                       18112/18112
    repo id            repo name                                 status
    el5_latest         Oracle Linux 6Server Latest (x86_64)           9,713
    ol6_UEK_latest     Latest Unbreakable Enterprise Kernel for Oracle Linux 6Server (x86_64) 106 
    ol6_addons         Oracle Linux 6Server Add ons (x86_64)              52
    ol6_latest          Oracle Linux 6Server Latest (x86_64)             18,112
    repolist: 27,983
    
    

    Make sure that both the el5_addons and ol5_u6_base repository are listed. The list of repository can be different depending on the Linux version and current user's configuration of yum.

  6. To install R, use the following command:

    yum install R.x86_64
    

You can quickly check that R was installed by starting R from the command line. You will see this startup message:

Oracle Distribution of R version 2.15.1  (--) -- "Roasted Marshmallows"
Copyright (C)  The R Foundation for Statistical Computing
ISBN 3-900051-07-0
Platform: x86_64-unknown-linux-gnu (64-bit)
 
R is free software and comes with ABSOLUTELY NO WARRANTY.
You are welcome to redistribute it under certain conditions.
Type 'license()' or 'licence()' for distribution details.
 
  Natural language support but running in an English locale
 
R is a collaborative project with many contributors.
Type 'contributors()' for more information and
'citation()' on how to cite R or R packages in publications.
 
Type 'demo()' for some demos, 'help()' for on-line help, or
'help.start()' for an HTML browser interface to help.
Type 'q()' to quit R.
R version 2.15.1 (2012-06-22) -- "Roasted Marshmallows"
Copyright (C) 2012 The R Foundation for Statistical Computing
ISBN 3-900051-07-0
Platform: i386-pc-mingw32/i386 (32-bit)
 
R is free software and comes with ABSOLUTELY NO WARRANTY.
You are welcome to redistribute it under certain conditions.
Type 'license()' or 'licence()' for distribution details.
 
  Natural language support but running in an English locale
 
R is a collaborative project with many contributors.
Type 'contributors()' for more information and
'citation()' on how to cite R or R packages in publications.
 
Type 'demo()' for some demos, 'help()' for on-line help, or
'help.start()' for an HTML browser interface to help.
Type 'q()' to quit R.

Install Oracle R Distribution on Linux 6

Oracle R Distribution for Linux 6 allows you to install a version of R 2.15.1 that is designed to work with Oracle R Enterprise.

Note:

Oracle R Distribution is available for Oracle Enterprise Linux 5 and 6 and Red Hat Enterprise Linux 5.

To install R on Red Hat Enterprise Linux 6, see Install R on Red Hat Enterprise Linux 6.

Go to http://public-yum.oracle.com/ and follow these steps to install R:

  1. Become root; for example use

    sudo su -
    
  2. Install the yum repository as follows:

    cd /etc/yum.repos.d
    
  3. Use this command to get ol6.repo:

    wget http://public-yum.oracle.com/public-yum-ol6.repo
    
  4. Open a text editor on the file just downloaded, public-yum-ol6.repo.

    Set

    • "enabled=1" for [ol6_addons]

    • "enabled=1" for [ol6_latest]

  5. This step is optional.

    Type the following commands in a shell to check that your yum repository is configured correctly:

    sudo yum repolist
    $ sudo yum repolist
    Loaded plugins: aliases, changelog, downloadonly, kabi, presto, refresh-packagekit, security, tmprepo, verify, versionlock
    Loading support for kernel ABI
    el5_latest                                              | 1.4 kB     00:00    
    el5_latest/pri                                          |  12 MB     00:07    
    el5_latest                                                           9713/9713
    ol6_UEK_latest                                          | 1.2 kB     00:00    
    ol6_UEK_latest/primary                                  | 4.3 MB     00:02    
    ol6_UEK_latest                                                      106/106
    ol6_addons                                               | 1.2 kB     00:00    
    ol6_addons/primary                                       |  11 kB     00:00    
    ol6_addons                                                            52/52
    ol6_latest                                               | 1.4 kB     00:00    
    ol6_latest/primary                                       |  23 MB     00:14    
    ol6_latest                                                       18112/18112
    repo id            repo name                                 status
    el5_latest         Oracle Linux 6Server Latest (x86_64)           9,713
    ol6_UEK_latest     Latest Unbreakable Enterprise Kernel for Oracle Linux 6Server (x86_64) 106 
    ol6_addons         Oracle Linux 6Server Add ons (x86_64)              52
    ol6_latest          Oracle Linux 6Server Latest (x86_64)             18,112
    repolist: 27,983
    
    

    The list of repository can be different depending on the Linux version and current user's configuration of yum.

  6. To install R, use the following command:

    yum install R.x86_64
    

You can quickly check that R was installed by starting R from the command line.

Oracle Distribution of R version 2.15.1  (--) -- "Roasted Marshmallows"
Copyright (C)  The R Foundation for Statistical Computing
ISBN 3-900051-07-0
Platform: x86_64-unknown-linux-gnu (64-bit)
 
R is free software and comes with ABSOLUTELY NO WARRANTY.
You are welcome to redistribute it under certain conditions.
Type 'license()' or 'licence()' for distribution details.
 
  Natural language support but running in an English locale
 
R is a collaborative project with many contributors.
Type 'contributors()' for more information and
'citation()' on how to cite R or R packages in publications.
 
Type 'demo()' for some demos, 'help()' for on-line help, or
'help.start()' for an HTML browser interface to help.
Type 'q()' to quit R.

Install R on Red Hat Enterprise Linux 6

You must rebuild Linux 6 Oracle R Distribution RPMs from the source RPMs on Red Hat 6 before you install R.

Follow these steps to rebuild the RPMs on Red Hat Enterprise Linux 6:

  1. Create an RPM build directory structure:

    mkdir -p ~/rpmbuild/{BUILD,RPMS,SOURCES,SPECS,SRPMS}
    
  2. Set up RPM tools to use your own build tree (to avoid root login):

    echo '%_topdir %(echo $HOME)/rpmbuild' > ~/.rpmmacros
    
  3. Download the R 2.15.1 SRPM (*.src.rpm) from Oracle's public yum at http://public-yum.oracle.com/repo/OracleLinux/OL6/addons/x86_64/R-2.15.1-1.el6.src.rpm.

    Save them to the rpmbuld/SRPMS directory.

  4. Rebuild for Red Hat Enterprise Linux 6 using rpmbuild. For example,

    rpmbuild --rebuild~/SRPMS/R-2.15.1-1.el6.src.rpm
    

    Note that if any dependencies are missing you will need to yum install them as root.

  5. The binary RPMs will be built and saved under ~/rpmbuild/RPMS.

  6. Login as root: and run the commands to install. You use commands of the form

    rpm -i <path to rpmbuild/RPMS/<R-core RPM >
    

    For example,

    rpm -i /refresh/home/rpmbuild/RPMS/x86_64/R-core-2.15.1-1.el6.x86_64.rpm
    

You can quickly check that R was installed by starting R from the command line. R starts up with:

[oracle@celvpint1001 ~]$ R
 
Oracle Distribution of R version 2.15.1  (--) -- "Roasted Marshmallows"
Copyright (C)  The R Foundation for Statistical Computing
ISBN 3-900051-07-0
Platform: x86_64-unknown-linux-gnu (64-bit)

Using MKL

The Intel Math Kernel Library (MKL) includes highly vectorized and threaded Linear Algebra, Fast Fourier Transforms (FFT), Vector Math and Statistics functions. Oracle R Distribution includes support that dynamically picks up the Intel Math Kernel Library (MKL) if MKL is installed on your system.

Follow these steps to use MKL with Oracle R Distribution:

  1. Add libmkl_rt.so, $R_HOME/lib, and $ORACLE_HOME/lib to the LD_LIBRARY_PATH system environment variable.

  2. Start R and execute this Oracle R Distribution function Sys.BlasLapack():

    R> Sys.BlasLapack()
         $vendor
         [1] "Intel Math Kernel Library (Intel MKL)"
         $nthreads
         [1] -1
    

    The vendor value returned indicates the presence of MKL instead of R's internal BLAS.

  3. In order to get the speedup provided by MKL, you must set the MKL_THREADING_LAYER environment variable to GNU before you invoke Oracle R Distribution on your system. In the Bash shell, set the variable as follows:

    export MKL_THREADING_LAYER=GNU
    

Install R on Oracle Exadata

Oracle R Distribution is recommend for Oracle Exadata. You must install R on every Exadata Compute Server, as described in Install R on Linux.

Using http://public-yum.oracle.com/ is the recommended way to install R on Oracle Exadata.

Oracle Database Requirement

Oracle R Enterprise requires Oracle 11.2 Enterprise Edition; the Oracle Database can be installed on Oracle Linux or Red Hat Linux.

The 64-bit version of the database must be installed for Linux or Red Hat Linux. You can check that the proper database is installed by examining $ORACLE_HOME/bin/oracle.

In order for certain Oracle R Enterprise functionality to work properly, the Oracle Database must include the patch that fixes bug number 11678127; Oracle 11.2.0.3 or later includes this fix.

If you cannot upgrade to Oracle 11.2.0.3, you can use Oracle 11.2.0.1 or 11.2.0.2 if you install the patch that fixes bug number 11678127. For basic information about patching an Oracle Database, see Patching Oracle Databases.

Use one of these solutions to install the required patch on the system where you install the Oracle R Enterprise server:

Patching Oracle Databases

Patches for Oracle products are downloaded from My Oracle Support (http://support.oracle.com). Access to My Oracle Support requires a CSI (Customer Support ID).

Note:

A given patch may not be available on all supported platforms at any given time. Check My Oracle Support to see if a patch is available for your platform.

After you download patches, install them using OPatch, described in Oracle Universal Installer and OPatch User's Guide 11g Release 2 (11.2) for Windows and UNIX.

Before you apply a patch, review README.txt. The patch may require other patches. Also make sure that the latest version of OPatch is installed.