Oracle® R Enterprise Installation and Administration Guide Release 1.3 for Linux and Windows Part Number E36763-04 |
|
|
PDF · Mobi · ePub |
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:
R Requirement (includes installation instructions)
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.
Linux x86-64, client and server
Oracle Linux Release 5 Update 6 through Oracle Linux 6
Red Hat Enterprise Linux Release 5 Update 6 through Red Hat Enterprise Linux 6
To download Oracle Linux Release 5 Update 6 Media Pack for x86_64 (64 bit), go to http://www.oracle.com/us/technologies/linux/index.html
).
Microsoft Windows XP, Vista, or Windows 7 64-bit, client only
Oracle R Enterprise is also supported on
Oracle Exadata running Oracle Linux
Linux x86-64 Oracle Linux Release 5 Update 5 or higher or Red Hat Linux 5 Update 5 or higher.
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 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.
Follow these steps to install R 2.15.1 on Windows:
Go to http://www.r-project.org
; click CRAN under the heading Download, Packages.
Select a CRAN Mirror.
Click Download R for Windows.
Click base.
Under the heading Other builds, click Previous releases in the third bullet.
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
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.
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:
Become root; for example use
sudo su -
Install the yum repository as follows:
cd /etc/yum.repos.d
Use this command to get el5.repo
:
wget http://public-yum.oracle.com/public-yum-el5.repo
Open a text editor on the file just downloaded public-yum-el5.repo
.
Set
"enabled=1" for [el5_addons]
"enabled=1" for [el5_latest]
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.
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.
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:
Become root; for example use
sudo su -
Install the yum repository as follows:
cd /etc/yum.repos.d
Use this command to get ol6
.repo:
wget http://public-yum.oracle.com/public-yum-ol6.repo
Open a text editor on the file just downloaded, public-yum-ol6.repo
.
Set
"enabled=1" for [ol6_addons]
"enabled=1" for [ol6_latest]
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.
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.
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:
Create an RPM build directory structure:
mkdir -p ~/rpmbuild/{BUILD,RPMS,SOURCES,SPECS,SRPMS}
Set up RPM tools to use your own build tree (to avoid root
login):
echo '%_topdir %(echo $HOME)/rpmbuild' > ~/.rpmmacros
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.
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
.
The binary RPMs will be built and saved under ~/rpmbuild/RPMS.
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)
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:
Add libmkl_rt.so
, $R_HOME/lib
, and $ORACLE_HOME/lib
to the LD_LIBRARY_PATH system environment variable.
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.
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
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 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:
For Oracle 11.2.0.1.0: on Linux: Patch number 12598677 fixes bug number 11678127
For Oracle 11.2.0.2.0 on Linux: Patch number 12976544 fixes bug number 11678127
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.