A.3 Installing Oracle R Enterprise on the Client

To install Oracle R Enterprise on the client computer, first verify that the Windows environment meets the requirements.

The requirements are specified in About the Oracle R Enterprise Sample Installation Environment. Next, complete these steps:

To install Oracle R Enterprise on the Client:

  1. Install Oracle R Distribution on the Windows Client

  2. Install Oracle Instant Client

  3. Install the Oracle R Enterprise Packages

  4. Install the Oracle R Enterprise Supporting Packages

A.3.1 Install Oracle R Distribution on the Windows Client

Before installing Oracle R Distribution, verify that your version of Microsoft Windows is supported by Oracle R Enterprise and that you have access to the internet.

See Also:

To install Oracle R Distribution on Windows:

  1. Go to the Oracle R Distribution downloadspage.

  2. Under R 3.3.0 Downloads, select R Distribution for Windows 64 bit. Save the file on your computer.

    ORD-3.3.0-win.zip

  3. When you unzip the file, the executable file is extracted.

    ORD-3.3.0-win.exe

  4. Double-click the executable file to start the installation of Oracle R Distribution.

  5. Follow the instructions to complete the installation.

A.3.2 Install Oracle Instant Client

Oracle R Enterprise requires Oracle Database Client.

Instead of installing the full Database Client, which must be installed in an Oracle home directory, you can install Oracle Instant Client.

To download and install Oracle Instant Client:

  1. Create an installation directory for the Oracle R Enterprise client components. The directory can have any name. For example:

    c:\myoreclient

  2. Navigate to the Oracle Database Instant Client page on the Oracle Technology Network.

  3. Select See Instant Client Downloads.

  4. On the Instant Client Downloads page, select Instant Client for Microsoft Windows (x64).

  5. Accept the license agreement.

  6. Under Version 12.1.0.2.0, select Instant Client Package - Basic for Oracle Database 12.1.

  7. Save the file in the installation directory that you created in Step 1. For example, if you choose the basic package, the following file is downloaded:

    c:\myoreclient\instantclient-basic-windows.x64-12.1.0.2.0.zip

  8. Unzip the file.

    When you unzip the file, the instantclient_12_1 subdirectory is created. The contents of the installation directory are shown as follows:

    myoreclient
  instantclient_12_1
    vc10
    vc11
    vc12

  9. Return to the Instant Client download page for your platform.

  10. Accept the license agreement and select Instant Client Package - SDK. Save the file in the directory that you created in Step 1.

    c:\myoreclient\instantclient-sdk-windows.x64-12.1.0.2.0.zip

  11. Unzip the file.

    When you unzip the file, the sdk subdirectory is created. The contents of the installation directory are shown as follows:

    myoreclient
  instantclient_12_1
    help
    sdk
    vc10
    vc11
    vc12

  12. Add the full path of the Instant Client to the environment variables OCI_LIB64 and PATH. The following steps set the variables to the path used in this example, c:\myoreclient\instantclient_12_1:

    1. In Windows Control Panel, choose System.

    2. Click Advanced systems settings.

    3. On the Advanced tab, click Environment Variables.

    4. Under System variables, create OCI_LIB64 if it does not already exist. Set the value of OCI_LIB64 to c:\oreclient\instantclient_12_1.

    5. Under System variables, edit PATH to include c:\oreclient\instantclient_12_1.

      Note:

      The graphical user interface for creating environment variables may vary slightly, depending on your version of Windows.

      To be able to load the ROracle package, you must first add the full path of the Oracle Instant Client to the PATH and the OCI_LIB64 environment variables. For troubleshooting tips, refer to the Troubleshooting section in the ROracle INSTALL file on CRAN at ROracle INSTALL.

A.3.3 Install the Oracle R Enterprise Packages

Follow these steps to download and install the Oracle R Enterprise packages:

To download the Oracle R Enterprise packages:

  1. Navigate to the Oracle R Enterprise Downloads page on the Oracle Technology Network:

    Oracle R Enterprise Downloads

  2. Accept the License Agreement.

  3. Select the Client packages for Windows. Save the file in the installation directory that you created in Install Oracle Instant Client.

    c:\myoreclient\ore-client-win-x86_64-1.5.1.zip

  4. Unzip the file.

    When you unzip the file, the client subdirectory is created. The contents of the installation directory are shown as follows:

    ORE_1.5.1.zip
OREbase_1.5.1.zip
OREcommon_1.5.1.zip
OREdm_1.5.1.zip
OREdplyr_1.5.1.zip
OREeda_1.5.1.zip
OREembed_1.5.1.zip
OREgraphics_1.5.1.zip
OREmodels_1.5.1.zip
OREpredict_1.5.1.zip
OREstats_1.5.1.zip
ORExml_1.5.1.zip

To install the Oracle R Enterprise packages from the R Console:

  1. Start R from the Windows Start menu. If you have installed both 32 and 64-bit R, be sure to choose 64-bit R.

  2. In the R Console window, install the packages as follows:

    install.packages("c:/myoreclient/client/ORE_1.5.1.zip", repos=NULL)
install.packages("c:/myoreclient/client/OREbase_1.5.1.zip", repos=NULL)
install.packages("c:/myoreclient/client/OREcommon_1.5.1.zip", repos=NULL)
install.packages("c:/myoreclient/client/OREdm_1.5.1.zip", repos=NULL)
install.packages("c:/myoreclient/client/OREdplyr_1.5.1.zip", repos=NULL)
install.packages("c:/myoreclient/client/OREeda_1.5.1.zip", repos=NULL)
install.packages("c:/myoreclient/client/OREembed_1.5.1.zip", repos=NULL)
install.packages("c:/myoreclient/client/OREgraphics_1.5.1.zip", repos=NULL)
install.packages("c:/myoreclient/client/OREmodels_1.5.1.zip", repos=NULL)
install.packages("c:/myoreclient/client/OREpredict_1.5.1.zip", repos=NULL)
install.packages("c:/myoreclient/client/OREstats_1.5.1.zip", repos=NULL)
install.packages("c:/myoreclient/client/ORExml_1.5.1.zip", repos=NULL)

    Each successful package installation produces this message in the R console:

    package 'package_name' successfully unpacked and MD5 sums checked

A.3.4 Install the Oracle R Enterprise Supporting Packages

Follow these steps to download and install the Oracle R Enterprise supporting packages:

To download the Oracle R Enterprise supporting packages:

  1. Navigate to the Oracle R Enterprise Downloads page on the Oracle Technology Network:

    Oracle R Enterprise Downloads

  2. Accept the License Agreement and select the Supporting packages for Windows. Save the file in the installation directory that you created in Install Oracle Instant Client.

    c:\myoreclient\ore-supporting-win-x86_64-1.5.1.zip

  3. Unzip the file.

    When you unzip the file, the supporting subdirectory is created. The contents of the installation directory are shown as follows:

    arules_1.1-9.zip
Cairo_1.5-8.zip
DBI_0.5.zip
png_0.1-7.zip
randomForest_4.6-10.zip
ROracle_1.3-1.zip
statmod_1.4.21.zip

To install the supporting packages from the R Console:

  1. Start R from the Windows Start menu. If you have installed both 32 and 64-bit R, be sure to choose 64-bit R.

    The R Console window is displayed.

  2. Install the packages as follows:

    install.packages("c:/myoreclient/supporting/ROracle_1.3-1.zip", repos=NULL)
install.packages("c:/myoreclient/supporting/DBI_0.5.zip", repos=NULL)
install.packages("c:/myoreclient/supporting/png_0.1-7.zip", repos=NULL)
install.packages("c:/myoreclient/supporting/Cairo_1.5-8.zip", repos=NULL)
install.packages("c:/myoreclient/supporting/arules_1.1-9.zip", repos=NULL)
install.packages("c:/myoreclient/supporting/randomForest_4.6-10.zip", repos=NULL)
install.packages("c:/myoreclient/supporting/statmod_1.4.21.zip", repos=NULL)

    Each successful package installation produces this message in the R console:

    package 'package_name' successfully unpacked and MD5 sums checked