Install Oracle Machine Learning for R on the Client

To install OML4R on the client computer, first verify that the Microsoft Windows environment meets the requirements.

Next, complete these steps:

  1. Install Oracle R Distribution on the Windows client
  2. Install Oracle Instant Client
  3. Install the OML4R packages
  4. Install the OML4R supporting packages

These steps are described in the following topics:

Install Oracle R Distribution on the Windows Client

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

To install Oracle R Distribution on Windows:

  1. Go to the Oracle R Distribution downloads page.

  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.

Install Oracle Instant Client

Oracle Machine Learning for R 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 OML4R client components. The directory can have any name. For example:

    c:\myoml4rclient
    
  2. Navigate to the Oracle Database Instant Client website.

  3. Click the Download Now button.

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

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

  6. 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:\myoml4rclient\instantclient-basic-windows.x64-12.1.0.2.0.zip
    
  7. 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:

    myoml4rclient
      instantclient_12_1
        vc10
        vc11
        vc12
  8. Return to the Instant Client Downloads for Microsoft Windows (x64) page.

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

    c:\myoml4rclient\instantclient-sdk-windows.x64-12.1.0.2.0.zip
    
  10. Unzip the file.

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

    myoml4rclient
      instantclient_12_1
        help
        sdk
        vc10
        vc11
        vc12
  11. 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:\myoml4rclient\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:\oml4rclient\instantclient_12_1.

    5. Under System variables, edit PATH to include c:\myoml4rclient\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.

Install the Oracle Machine Learning for R Packages

Example of installing the Oracle Machine Learning for R packages.

Follow these steps to download and install the OML4R packages:

To download the OML4R packages:

  1. Go to the Oracle Machine Learning for R Downloads website.

  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:\myoml4rclient\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 OML4R 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:/myoml4rclient/client/ORE_1.5.1.zip", repos=NULL)
    install.packages("c:/myoml4rclient/client/OREbase_1.5.1.zip", repos=NULL)
    install.packages("c:/myoml4rclient/client/OREcommon_1.5.1.zip", repos=NULL)
    install.packages("c:/myoml4rclient/client/OREdm_1.5.1.zip", repos=NULL)
    install.packages("c:/myoml4rclient/client/OREdplyr_1.5.1.zip", repos=NULL)
    install.packages("c:/myoml4rclient/client/OREeda_1.5.1.zip", repos=NULL)
    install.packages("c:/myoml4rclient/client/OREembed_1.5.1.zip", repos=NULL)
    install.packages("c:/myoml4rclient/client/OREgraphics_1.5.1.zip", repos=NULL)
    install.packages("c:/myoml4rclient/client/OREmodels_1.5.1.zip", repos=NULL)
    install.packages("c:/myoml4rclient/client/OREpredict_1.5.1.zip", repos=NULL)
    install.packages("c:/myoml4rclient/client/OREstats_1.5.1.zip", repos=NULL)
    install.packages("c:/myoml4rclient/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

Install the Oracle Machine Learning for R Supporting Packages

Example of installing the OML4R supporting packages.

Follow these steps to download and install the OML4R supporting packages:

To download the OML4R supporting packages:

  1. Go to the Oracle Machine Learning for R Downloads website.
  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:\myoml4rclient\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:/myoml4rclient/supporting/ROracle_1.3-1.zip", repos=NULL)
    install.packages("c:/myoml4rclient/supporting/DBI_0.5.zip", repos=NULL)
    install.packages("c:/myoml4rclient/supporting/png_0.1-7.zip", repos=NULL)
    install.packages("c:/myoml4rclient/supporting/Cairo_1.5-8.zip", repos=NULL)
    install.packages("c:/myoml4rclient/supporting/arules_1.1-9.zip", repos=NULL)
    install.packages("c:/myoml4rclient/supporting/randomForest_4.6-10.zip", repos=NULL)
    install.packages("c:/myoml4rclient/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