Install R Server 9.1 for Windows

Looking for the latest release? See Machine Learning Server for Windows installation

This article explains how to install Microsoft R Server 9.1 on a standalone Windows server that has an internet connection. If your server has restrictions on internet access, see offline installation.

If you previously installed version 9.0.1, it is replaced with the 9.1 version. An 8.x version can run side-by-side 9.x, unaffected by the new installation.

System requirements

  • Operating system must be a supported version of Windows on a 64-bit with x86-compatible architecture (variously known as AMD64, Intel64, x86-64, IA-32e, EM64T, or x64 chips). Itanium chips (also known as IA-64) are not supported. Multiple-core chips are recommended.

  • Memory must be a minimum of 2 GB of RAM is required; 8 GB or more are recommended.

  • Disk space must be a minimum of 500 MB.

  • .NET Framework 4.5.2 or later. The installer checks for this version of the .NET Framework and provides a download link if it's missing. A computer restart is required after a .NET Framework installation.

The following additional components are included in Setup and required for an R Server on Windows.

  • Microsoft .NET Core 1.1
  • Microsoft MPI 7.1
  • AS OLE DB (SQL Server 2016) provider
  • Microsoft R Open 3.3.3
  • Microsoft Visual C++ 2013 Redistributable
  • Microsoft Visual C++ 2015 Redistributable

How to install

This section walks you through an R Server 9.1 deployment using the standalone Windows installer. Under these instructions, your installation will be serviced under the Modern Lifecycle policy and includes the ability to operationalize your analytics.

Download R Server installer

You can get the zipped installation file from one of the following download sites.

Site Edition Details
Visual Studio Dev Essentials Developer (free) This option provides a zipped file, free when you sign up for Visual Studio Dev Essentials. Developer edition has the same features as Enterprise, except it is licensed for development scenarios.
Volume Licensing Service Center (VLSC) Enterprise Sign in, search for "SQL Server 2016 Enterprise edition", and then choose a per-core or CAL licensing option. A selection for R Server for Windows 9.0.1 is provided on this site.

From Visual Studio Dev Essentials:

  1. Click Join or access now to sign up for download benefits.
  2. Check the URL to verify it changed to https://my.visualstudio.com/.
  3. Click Downloads to search for R Server.
  4. Click Downloads for a specific version to select the platform.

Download page on Visual Studio benefits page

Run Setup

Unzip the installation file en_microsoft_r_server_910_for_windows_x64_10324119.zip, navigate to the folder containing RServerSetup.exe, and then run setup.

  1. Double-click RServerSetup.exe to start the wizard.
  2. In Configure installation, choose optional components. Required components are listed, but not configurable. Optional components include:
  3. Accept the SQL Server license agreement for R Server 1, as well as the license agreement for Microsoft R Open.
  4. Optionally, change the home directory for R Server.
  5. At the end of the wizard, click Install to run setup.

1 R Server for Windows is licensed as a SQL Server enterprise feature, even though it's installed independently of SQL Server on a Windows operating system.

Log files

Post-installation, you can check the log files (RServerSetup_.log) located in the system temp directory. An easy way to get there is typing %temp% as a Run command or search operation in Windows.

Connect and validate

R Server runs on demand as a background process, as Microsoft R Engine in Task Manager. Server startup occurs when a client application like R Tools for Visual Studio or Rgui.exe connects to the server.

As a verification step, connect to the server and execute a few ScaleR functions to validate the installation.

  1. Go to C:\Program Files\Microsoft\R Server\R_SERVER\bin\x64.
  2. Double-click Rgui.exe to start the R Console application.
  3. At the command line, type search() to show preloaded objects, including the RevoScaleR package.
  4. Type print(Revo.version) to show the software version.
  5. Type rxSummary(~., iris) to return summary statistics on the built-in iris sample dataset. The rxSummary function is from RevoScaleR.

Additionally, run the Administrator Utility to configure your R Server for remote access and execution, web service deployment, or multi-server installation.

Enable Remote Connections and Analytic Deployment

The server can be used as-is if you install and use an R IDE on the same box, but to benefit from the deployment and consumption of web services with Microsoft R Server, then you must configure R Server after installation to act as a deployment server and host analytic web services. Possible configurations are a one-box setup or an enterprise setup. Doing so also enables remote execution, allowing you to connect to R Server from an R Client workstation and execute code on the server.

What's Installed with R Server

An installation of Microsoft R Server includes the following components.

Component Description
Microsoft R Open (MRO) An open-source distribution of the base R language, plus the Intel Math Kernel library (int-mkl). The distribution includes standard libraries, documentation, and tools like R.exe and RGui.exe.

Tools for the standard base R (RTerm, Rgui.exe, and RScript) are under <install-directory>\bin. Documentation is under <install-directory>\doc and in <install-directory>\doc\manual. One easy way to open these files is to open RGui, click Help, and select one of the options.
Microsoft R Server proprietary libraries and script engine MRS packages provide libraries of functions. MRS libraries are co-located with R libraries in the <install-directory>\library folder. Libraries include RevoScaleR, MicrosoftML, mrsdeploy, olapR, RevoPemaR, and others listed in Package Reference.

On Windows, the default R Server installation directory is C:\Program Files\Microsoft\R Server\R_SERVER.

R Server is engineered for distributed and parallel processing for all multi-threaded functions, utilizing available cores and disk storage of the local machine. R Server also supports the ability to transfer computations to other R Server instances on other platforms through compute context instructions.
Admin tool Used for enabling remote execution and web service deployment, operationalizing analytics, and configuring web and compute nodes.
pre-trained models Used for sentiment analysis and image featurization.

Consider adding a development tool on the server to build script or solutions using R Server features:

Note

By default, telemetry data is collected during your usage of R Server. To turn this feature off, use the RevoScaleR package function rxPrivacyControl(FALSE). To turn it back on, change the setting to TRUE.

Licensing and support

How you install R Server determines the support policy, location of R binaries, and the availability of certain features.

Licensing

R Server for Windows is licensed as a SQL Server enterprise feature. Licensing is the same regardless of how you install the server (standalone, standalone as part of SQL Server, or embedded in a relational database instance as SQL Server Machine Learning Services).

In a development context, developers and data scientists can install the free developer edition, which delivers the same features as enterprise, but is licensed for smaller developer workloads. Each edition is available through different download channels.

Support Policy

Two support plans 1 are available for R Server for Windows. The installation method determines which one is in effect.

Service Plan Details How to get this plan
Modern Lifecycle policy Requires running the latest version of R Server. Install R Server for Windows using a standalone Windows installer
SQL Server support policy Service updates are on the SQL Server release schedule. Install SQL Server Machine Learning Services (In-database) as part of a SQL Server Database engine instance
- or -
Install R Server (Standalone) using the SQL Server installer 2, 3

1 For details, go to Microsoft Lifecycle Policy. Use the index to navigate to R Server or SQl Server 2016.

2 You can unbind an existing R Services instance from the SQL Server support plan and rebind it to Modern Lifecycle. The terms and duration of your license are the same. The only difference is that under Modern Lifecycle, you would adopt newer versions of R Server at a faster cadence than what might be typical for SQL Server deployments.

3 You can provision an Azure virtual machine running Windows that has SQL Server R Server (Standalone) already installed. This VM is provisioned under the SQL Server service plan, but you could rebind to the Modern Lifecycle support policy. For more information, see Provision an R Server Virtual Machine.

Location of R binaries

The Windows installer and SQL Server installer create different library folder paths for the R packages. This is something to be aware of when using tools like R Tools for Visual Studio (RTVS) or RStudio, both of which retain library folder location references.

File location Installer
C:\Program Files\Microsoft\R Server\R_SERVER Windows installer
C:\Program Files\Microsoft SQL Server\130\R_SERVER SQL Server Setup, R Server (Standalone)
C:\Program Files\Microsoft SQL Server<instance_name>\R_SERVICES SQL Server Setup, R Services (In-Database)

Deploy at scale

As a standalone server, R Server for Windows is not multi-instance. If you require multiple copies of R Server at the same functional level on a single server, you can install SQL Server R Services as part of a multi-instance relational database engine service and then use each one independently.

Another scalable topology is to install multiple R Servers, each configured as either a dedicated web node or compute node. Nodes can be clustered using NLB or Windows failover clustering. For more information, see Operationalize your analytics.

Install earlier versions

Earlier versions are supported, but with limited availability on Microsoft download sites. If you already have one of the older supported versions, you can use the links in this section to access installation instructions.

Version Details
Version 8.0.5 This version of R Server for Windows, released as Microsoft R Server 2016, is integrated with the enterprise edition of SQL Server 2016. Licensing, installation, and support of this version of R Server for Windows is through SQL Server. Using SQL Server setup, you can install R Server as a standalone server, or as multi-instance service within SQL Server. For more information, see R Server for Windows and SQL Server R Services - R Server install page in SQL Server 2016 technical documentation.

See Also

Introduction to R Server What's New in R Server Supported platforms
Known Issues
Command line installation
Microsoft R Getting Started Guide
Configure R Server to operationalize your analytics