Oracle Machine Learning for R Installation Steps

These steps and this roadmap illustrate a typical OML4R installation.

For Oracle Database 18c or later, use the rqcfg.sql script to install OML4R Server, as described in Install Oracle Machine Learning for R Server for Oracle Database 18c and Later.

For Oracle Database 12c or earlier, use the OML4R Server script to install OML4R Server, as described in Install Oracle Machine Learning for R Server for Oracle Database 12c and Earlier. That installation script can install the supporting packages and create a database user along with the installation of OML4R Server.

Note:

If you intend to use both client and server components of OML4R on the computer that is hosting Oracle Database, then you do not need to perform a separate client installation. A local installation of Oracle Database Client is automatically included in the installation of Oracle Database.

Illustration of the Installation Steps

Figure 1-2 OML4R Client and Server Installation Steps

This figure illustrates the OML4R client and server installation steps.

Description of Figure 1-2 follows
Description of "Figure 1-2 OML4R Client and Server Installation Steps"

OML4R Installation Roadmap

This roadmap provides the steps required to install and configure a typical OML4R environment. To install OML4R, do the following:

  1. Verify that your system meets the basic requirements

  2. Obtain the correct installation software

  3. Perform and validate the installations

Table 1-1 Tasks for Installing OML4R

Task Description Documentation

1. Review the OML4R sample installation.

Review the steps for a typical installation of OML4R on a Linux server and a Windows client.

Note: All the supported configurations are listed in Oracle Machine Learning for R System Requirements.

A Sample Installation of Oracle Machine Learning for R

2. Verify supported platforms and system requirements.

Use the Platform Requirements table and Server Support Matrix to verify your environment meets the requirements for installation.

Oracle Machine Learning for R System Requirements

3. Identify installation users for Oracle R Distribution and OML4R.

The user executing the installation and configuration on your system requires sufficient permissions and privileges.

For Oracle R Distribution, the installation user is root (Unix/Linux) or Administrator (Windows).

User Requirements for OML4R Server

4. Download the product installers.

Oracle R Distribution is available from Oracle’s public yum or Oracle’s Open Source Software portal (OSS). Oracle Database and OML4R are available on Oracle’s Technology Network (OTN).

For Oracle Database 18c and later, the OML4R installers are shipped with Oracle Database.

Oracle Database Software Downloads

Oracle R Distribution Downloads

Oracle Machine Learning for R Downloads

5. Install and configure Oracle Database.

OML4R requires the 64-bit version of Oracle Database Enterprise Edition.

Install and Configure the Database for Oracle Machine Learning for R

6. Install and configure R.

OML4R requires an installation of R on each node of the server and on each client computer that interacts with the server. Oracle R Distribution is recommended.

The OML4R Server components must be installed on the database server.

Install R for Oracle Machine Learning for R

7. Install and configure OML4R Server.

OML4R includes several components on the server. Together these components enable an OML4R client to interact with an OML4R server.

Install Oracle Machine Learning for R Server

Install Oracle Machine Learning for R on Exadata

8. Install Open Source R packages on the OML4R server.

Embedded R execution with OML4R allows the use of CRAN or other third-party R packages in user-defined R functions executed on the Oracle Database server.

About R Package Installation for Oracle Machine Learning for R

9. Install and configure the OML4R client.

If a physical client is configured, then you must install the following OML4R components separately on each client computer:

  • R

  • Oracle Instant Client

  • OML4R Client packages

  • OML4R Client Supporting packages

If you wish to run the OML4R client through a web browser, then install RStudio Server on the database server (Linux only).

Install Oracle Machine Learning for R Client

Installing RStudio

10. Install Open Source R packages on the OML4R client.

R packages installed on the OML4R server must also be installed on the OML4R client.

R Package Installation Basics

11. Verify the OML4R Installation.

Test the OML4R installation by connecting to the OML4R client to the server and executing some OML4R functions.

Verify the OML4R Server Installation