2 Prerequisites

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.

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 ~/rpmbuild/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 Oracle R Distribution on Solaris

Follow these steps to install Oracle R Distribution for Solaris:

1. The installation script install.sh for Oracle R Distribution must be run as root or as a user with sudo access.

2. Go to Oracle R Distribution at https://oss.oracle.com/ORD/.

   Download the correct set of files for your installation:

   • For x86 64-bit systems:

     ord-2.15.1-sol10-x86-64-sunstudio12u3.tar.gz
     ord-2.15.1-supporting-sol10-x86-64-sunstudio12u3.tar.gz
     

   • For SPARC 64-bit systems:

     ord-2.15.1-sol10-sparc-64-sunstudio12u3.tar.gz
     ord-2.15.1-supporting-sol10-sparc-64-sunstudio12u3.tar.gz
     

3. Uncompress either ord-2.15.1-sol10-x86-64-sunstudio12u3.tar.gz or ord-2.15.1-sol10-sparc-64-sunstudio12u3.tar.gz.

   Run install.sh as root or as a user with sudo to install the Solaris PKG file for Oracle R Distribution.

   uninstall.sh uninstalls Oracle R Distribution on Solaris.

4. Uncompress either ord-2.15.1-supporting-sol10-x86-64-sunstudio12u3.tar.gz or ord-2.15.1-supporting-sol10-sparc-64-sunstudio12u3.tar.gz

   Uncompress the libraries to a local file such as $ORACLE_HOME/lib and add that directory to LD_LIBRARY_PATH.

   These tar files contain the following shared libraries that R shared library libR.so depends on:

   • libiconv.so.2

   • libncurses.so.5

   • libreadline.so.6

   • libsunperf.so (This library and its dependent shared libraries usually ship with Solaris sunstudio).

5. Run ldd -r /usr/lib/64/R/lib/libR.so to verify that libR.so is picking up its shared library dependencies correctly from the local directory.

6. To verify that R is installed correctly, type R.

Install Oracle R Distribution on AIX

Follow these steps to install Oracle R Distribution for AIX:

1. The installation script install.sh for Oracle R Distribution must be run by a user with the super user privilege. You can also use smitty (GUI) to instal Oracle R Distribution. You must also be super user to uninstall Oracle R Distribution.

2. Go to Oracle R Distribution at https://oss.oracle.com/ORD/.

   Download these files:

   • ORD.2.15.1.0.bff.gz

   • ord-supporting-aix.tar.gz

3. First install the prerequisite for Oracle R Distribution for AIX.

   1. Uncompress and untar ord-supporting-aix.tar.gz. This results in a collection of rpms:

      $ gunzip ord-supporting-aix.tar.gz  # get ord-supporting-aix.tar
      $ tar -xvf ord-supporting-aix.tar   # extract contents of .tar file
      $ ls ord-supporting-aix             # list of rpms
      bash-4.2-5.aix5.1.ppc.rpm
      expat-2.0.1-3.aix5.1.ppc.rpm
      gettext-0.17-1.aix5.1.ppc.rpm
      glib2-2.28.6-1.aix5.1.ppc.rpm
      info-4.13a-2.aix5.1.ppc.rpm
      libiconv-1.14-1.aix5.1.ppc.rpm
      libpng-1.5.9-1.aix5.1.ppc.rpm
      libpng-devel-1.5.9-1.aix5.1.ppc.rpm
      pkg-config-0.25-2.aix5.1.ppc.rpm
      readline-6.2-3.aix5.1.ppc.rpm
      readline-devel-6.2-3.aix5.1.ppc.rpm
      texinfo-4.13a-2.aix5.1.ppc.rpm
      zlib-1.2.6-1.aix5.1.ppc.rpm
      zlib-devel-1.2.6-1.aix5.1.ppc.rpm
      $ 
      

      You can also download these rpms from http://www.perzl.org/aix/.

   2. Install these rpms using an rpm command from the directory where you extracted the contents of ord-supporting-aix.tar.gz.

      $ cd ord-supporting-aix
      $ su
      # rpm -i *.rpm
      

      To upgrade existing dependencies, use

      # rpm -UF *.rpm
      

      If you experience conflicts with dependencies, use

      # rpm -UF --nodeps *.rpm
      

   3. Add /opt/freeware/lib to the LIBPATH (or LD_LIBRARY_PATH) environment variable:

      • For ksh

        $ export LIBPATH=/opt/freeware/lib:$LIBPATH
        

      • For csh

        $ setenv LIBPATH /opt/freeware/lib:$LIBPATH
        

      Make sure that /opt/freeware/lib is before /usr/lib.

4. Now install Oracle R Distribution:

   1. Uncompress ORD-2.15.1-aix.bff.gz to get ORD-2.15.1-aix.bff:

      $ gunzip ORD.2.15.1.0.bff.gz
      

   2. To install all of the filesets in Oracle R Distribution, use the installp command (with the apply option) from the directory where the file has been downloaded:

      $ su
      # installp -a -d . ORD   # install all the filesets in ORD
      

      You can also independent filesets:

      # installp -a -d . ORD.core   # installs only ORE.core 
      # installp -a -d . ORD.devel  # installs only ORE.devel
      

   3. Run ldd to ensure that shared library dependencies were picked up correctly:

      $ ldd /usr/lib/R/bin/exec/R
      $ ldd /usr/lib/R/lib/libR.so (libiconv, libreadline)
      $ ldd /usr/lib/R/lib/libRlapack.so
      $ ldd /usr/lib/R/lib/libRblas.so
      

   4. Add /usr/lib/R/lib to the LIBPATH (or LD_LIBRARY_PATH) environment variable:

      • For ksh

        $ export LIBPATH=/usr/lib/R/lib:$LIBPATH
        

      • For csh

        $ setenv LIBPATH //usr/lib/R/lib:$LIBPATH
        

5. To verify that R is installed correctly, type R.

Uninstall Oracle R Distribution for AIX

To unistall filesets, use the installp command (uninstall option).

$ su
# installp -u ORD                # uninstall all filesets

Uninstall independent filesets as follows:

# installp -u ORD.devel   # uninstall only ORD.devel
# installp -u ORD.core    # uninstall only ORD.core

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).

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.