Installing Microsoft R Open 3.4.0 [Archived Documentation] · MRAN Skip to main content

Installing Microsoft R Open 3.4.0 [Archived Documentation]

Archive Notice

These are not the latest instructions.

The following documentation describes how to install and uninstall Microsoft R Open 3.3.3, which has been archived.

Take advantage of the latest version by downloading and installing Microsoft R Open 3.4.1.

Visit our Previous Releases page to learn about other past versions.


Due to the fact that these instructions have been archived, certain links on this page may no longer work over time.

Introduction

Microsoft R Open is the enhanced distribution of R from Microsoft Corporation. Microsoft R Open is a complete open source platform for statistical analysis and data science, which is free to download and use.

The current version, Microsoft R Open 3.4.0, is based on (and 100% compatible with) the statistical language, R-3.4.0, and includes additional capabilities for performance, reproducibility and platform support. Learn more...

System Requirements

Before you begin installing Microsoft R Open 3.4.0, make sure the machine on which you will install meets the minimum hardware and software requirements defined below.

Supported Platforms. Microsoft R Open 3.4.0 is built and tested on the following 64-bit platforms:

  • Windows®:
    • Windows® 7.0 (SP1), 8.1, 10, Windows Server® 2008 R2 (SP1) and 2012
  • Linux:
    • Ubuntu 14.04, 16.04
    • CentOS / Red Hat Enterprise Linux 6.5, 7.1
    • SUSE Linux Enterprise Server 11
  • Mac OS X:
    • El Capitan (10.11), Sierra (10.12)

Processor. Processor 64-bit processor with x86-compatible architecture (such as AMD64, Intel 64, x86-64, IA-32e, EM64T, or x64 chips). ARM chips, Itanium-architecture chips (also known as IA-64), and non-Intel Macs are not supported. Multiple-core chips are recommended.

Free disk space. 250 MB

RAM. 1 GB required, 2 GB recommended.

Installing on Windows

Before installing Microsoft R Open 3.4.0, please review the following system requirements.

Side-by-Side Installs

On Windows, Microsoft R Open 3.4.0 can work side-by-side with any other version of CRAN R, including past versions of Microsoft R Open. In order to continue working with a different version of R from a terminal window, you must specify the full path to the R executable you want to use.

After installing Microsoft R Open 3.4.0, launch Rgui.exe to start interacting with R. If you already had installed RRO 3.2.2, for example, and then upgraded to Microsoft R Open 3.4.0, here is how you could work with them side-by-side:

  • Start Microsoft R Open 3.4.0 by executing C:\Program Files\Microsoft\R Open\R-3.4.0\bin\x64\Rgui.exe if that is where you installed that version.
  • Start RRO 3.2.2 by executing C:\Program Files\RRO\R-3.2.2\bin\x64\Rgui.exe (assuming default install directory).

Install Microsoft R Open & MKL

  1. Make sure R is not running. Stop every R process prior to installing Microsoft R Open. You may need to close your IDE.

  2. Ensure that .NET 4.5 is already installed on your machine. If not, install it now. https://www.microsoft.com/en-us/download/details.aspx?id=30653

  3. Go to the directory where you downloaded the Microsoft R Open installer.

  4. Launch the Microsoft R Open installer as a user with administrator privileges and follow the prompts. All package dependencies are installed during the installation of Microsoft R Open as long as your machine has access to the internet.

  5. Launch the Microsoft R Open setup and follow the prompts.

  6. Accept the default installation path for Microsoft R Open or choose another location.

  7. Review the components that will be installed as part of Microsoft R Open.

    While most components are required, you can choose to add the optional multi-threaded performance that come with the math libraries (MKL).

  8. Accept the Microsoft R Open license terms.

  9. Accept the Math Kernel Libaries license term.

  10. Click Finish when installation is finished. A welcome screen opens to introduce you to the product and documentation.

  11. When the Microsoft R Open installation is complete, configure your R integrated development environment (R IDE). You can also launch Rgui.exe to start interacting with R. On some platforms, you can find Rgui.exe under C:\Program Files\Microsoft\R Open\R-3.4.0\bin\x64\Rgui.exe or using Microsoft R Open shortcut in the Start menu.

Notes:
  • After installing Microsoft R Open, the default R path now points to the R installed with Microsoft R Open .
  • The CRAN repository points to a snapshot from May 1, 2017. This means that every user of Microsoft R Open has access to the same set of CRAN package versions. To get packages from another date, use the checkpoint package, installed with Microsoft R Open.

Silent and Passive Installs of Microsoft R Open

To install Microsoft R Open from a script on Windows, use the following commandline switches. Doing so will install Microsoft R Open using all defaults, including MKL, and display only the progress bar.

Mode Install Command
Passive microsoft-r-open-<version>.exe /passive
Silent microsoft-r-open-<version>.exe /quiet

What's Next After Install

Installing on Linux

Before installing Microsoft R Open 3.4.0, please review the following system requirements.

Side-by-Side Installs

On Linux machines, Microsoft R Open 3.4.0 can work side-by-side with other Major-Minor versions of CRAN R. For example, Microsoft R Open 3.4.0 can exist side-by-side with a 3.2.x version. During the installation of Microsoft R Open, a symbolic link is created under /usr/bin/ that points to the last version of R that was installed, which in this case would be Microsoft R Open 3.4.0.

After installation, you can start Microsoft R Open 3.4.0 from a terminal window by typing R since it is the last one installed and is therefore under /usr/bin/.

You can also continue to work from a terminal window with other versions of R that were installed prior to Microsoft R Open 3.4.0. To do so, specify the full path to the R executable you want to use. For example, if you installed Microsoft R Open 3.2.3 and then upgraded to Microsoft R Open 3.4.0, you could work with both as follows:

  • Start Microsoft R Open 3.4.0 by executing R since it was the last one installed.
  • Start Microsoft R Open 3.2.3 by executing /usr/lib64/MRO-3.2.3/bin/R.
Tip: You can also manage multiple side-by-side installations of any application using the alternatives command (or update-alternatives on Ubuntu). This command allows you create and manage symbolic links to the different installations, and thus easily refer to the installation of your choice.

Install Microsoft R Open & MKL

Important! Any package dependencies will be installed automatically during the installation of Microsoft R Open provided your machine has access to the internet.

To install Microsoft R Open 3.4.0 (and MKL) on Linux:

Alert!
  • Microsoft R Open installations from a live CD are not supported on Ubuntu.
  • Before installing Microsoft R Open on RedHat/CentOS, disable SELinux.
    1. Log in as root or a user with sudo privileges. If the latter, precede commands requiring root privileges with sudo.

    2. Make sure R is not running. Stop every R process prior to installing Microsoft R Open. You may need to close your IDE.

    3. Download the Microsoft R Open installer.

    4. Change to the directory where you downloaded the Microsoft R Open installer bundle.

    5. Untar the installer bundle as follows:

      tar -xf microsoft-r-open-3.4.0.tar.gz
    6. Go to the microsoft-r-open directory as follows:

      cd microsoft-r-open/
    7. Install Microsoft R Open as follows:

      sudo ./install.sh
    8. Follow the installer's onscreen prompts.

    9. To enable the optional multi-threaded performance for Microsoft R Open, select the MKL installation option and accept the end-user license agreement.

    10. When the Microsoft R Open installation is complete, run R in a terminal to begin interacting with R. Or, configure your R integrated development environment (R IDE).

    Important!
    • After installing, the default R path is updated to point to R installed with Microsoft R Open 3.4.0, which is under lib64/R/bin/R.
    • The CRAN repository points to a snapshot from May 1, 2017. This means that every user of Microsoft R Open has access to the same set of CRAN package versions. To get packages from another date, use the checkpoint package, installed with Microsoft R Open.

    Silent and Unattended Installs of Microsoft R Open

    To install and uninstall Microsoft R Open from a script on Linux, use the following command-line options for install.sh.

    Option Description
    -a Accept the license for the Intel MKL components
    -s Perform a silent, unattended install
    -u Perform an unattended install

    What's Next After Install

    Installing on Mac OS X

    Before installing Microsoft R Open 3.4.0, please review the following system requirements.

    Side-by-Side Installs

    On Mac OS X machines, Microsoft R Open 3.4.0 can work side-by-side with other Major-Minor versions of CRAN R. For example, Microsoft R Open 3.4.0 can exist side-by-side with a 3.2.x version.

    During the installation of Microsoft R Open, a symbolic link is created under Library/Frameworks/R.Framework/Versions that points to the last version of R that was installed, which in this case would be Microsoft R Open 3.4.0. After installation, you can start Microsoft R Open 3.4.0 from a terminal window by typing R since it is the last one installed and is therefore under Library/Frameworks/R.Framework/Versions.

    To switch to another version of R installed prior to Microsoft R Open 3.4.0 from within a terminal window, run these two commands:

    rm /Library/Frameworks/R.framework/Versions/Current
    
    ln –s /Library/Frameworks/R.framework/Versions/{R_VERSION} /Library/Frameworks/R.framework/Versions/Current

    Install Microsoft R Open

    Important! Any package dependencies will be installed automatically during the installation of Microsoft R Open as long as your machine has access to the internet.

    Microsoft R Open can be installed on Mac OS X using the standard Apple installer package.

    1. Make sure R is not running. Stop every R process prior to installing Microsoft R Open. You may need to close your IDE.

      Note: At this time, side-by-side installations of Microsoft R Open 3.4.0 and other versions of R are not supported on Mac OS X.
    2. To benefit from all features in the product, you must install XQuartz 2.7.11 directly from https://www.xquartz.org/ before installing Microsoft R Open. Do not install the XQuartz package using HomeBrew or any other package manager.

    3. Go to the directory where you downloaded the Microsoft R Open installer.

    4. Launch the Microsoft R Open installer by double-clicking the filename.

    5. In the dialog box, review the license terms and click Continue.

    6. Follow the steps in the Microsoft R Open installer.

    7. Click Install to begin the installation process.

    8. When the Microsoft R Open installation is complete, start interacting with R in the R console. Launch the R console by clicking on the Microsoft R Open program icon in the Applications folder or launch your preferred R IDE such as R Tools for Visual Studio or RStudio.

    Important! After installing, the CRAN repository points to a snapshot from May 1, 2017. This means that every user of Microsoft R Open has access to the same set of CRAN package versions. To get packages from another date, use the checkpoint package, installed with Microsoft R Open.

    What's Next After Install

    Configure your R IDE

    After you download and install Microsoft R Open or open R, the next step is to get an integrated development environment, or IDE, for R. One such R IDE is R Tools for Visual Studio and another is RStudio. Your R IDE is where you'll write your code.

    After you've installed Microsoft R Open, the next step is to configure your favorite R integrated development environment (R IDE) to point to the R executable for Microsoft R Open. This way, whenever you execute your R code, you'll do so using Microsoft R Open and benefit from MKL performance and bundled packages such as checkpoint. R IDE options include R Tools for Visual Studio on Windows (Recommended), RStudio, or any other R development environment.

    Set up RTVS for Microsoft R Open on Windows

    R Tools for Visual Studio (RTVS) is an integrated development environment available as a free add-in for any edition of Visual Studio.

    1. After installing Microsoft R Open, launch RTVS.
    2. From the R Tools, choose Change R to Microsoft R Open.
    3. When you launch RTVS, Microsoft R Open is now the default R engine.


    Set up RStudio for Microsoft R Open on Windows or Linux

    1. After installing Microsoft R Open, launch RStudio.
    2. Update the path to R. For example, point to C:\Program Files\Microsoft\R Open\bin\x64 on Windows.
    3. When you launch RStudio, Microsoft R Open is now the default R engine.

    Uninstalling

    To uninstall Microsoft R Open 3.3.3, read these instructions here.

    To uninstall Microsoft R Open 3.4.0, select the tab below to get your operating system-specific instructions.
     

    To uninstall Microsoft R Open and the associated math libraries (if installed):

    1. Using the Windows instructions for uninstalling a program specific to your version of Windows, uninstall Microsoft R Open.
      For example, on Windows 10, go to Start > Settings > System > Apps & features.

    2. Find MRO for Windows 3.4.0 in the list and uninstall.

    3. Remove the directory in which you installed Microsoft R Open, by default C:\Program Files\Microsoft\R Open\R-3.4.0.

    For silent and passive uninstalls:

    To uninstall Microsoft R Open from a script on Windows, use the following commandline switches.

    Mode Uninstall Command
    Passive microsoft-r-open-<version>.exe /uninstall /passive
    Silent microsoft-r-open-<version>.exe /uninstall /quiet

    To uninstall Microsoft R Open and the associated math libraries (if installed):

    1. Log in as root or a user with sudo privileges. If the latter, precede commands requiring root privileges with sudo.

    2. Uninstall Microsoft R Open :

      • On Ubuntu:
        %sudo apt-get remove microsoft-r-open-*
      • On CentOS or Red Hat:
        %sudo yum erase microsoft-r-open-*
      • On SLES:
        %sudo zypper remove microsoft-r-open-*
    3. Remove the installation directory:

        rm -rf /usr/lib64/microsoft-r/3.4

    Run the following commands to uninstall Microsoft R Open:

    cd /Applications
    sudo rm -rf "Microsoft R Open".app
    cd /Library/Frameworks
    sudo rm -rf R.framework
    sudo rm -rf /usr/local/bin/R 
    sudo rm -rf /usr/local/bin/Rscript

    Warning: Depending on how R packages were installed, you may need to manually remove any R packages that remain in your personal R library and/or the global R library after uninstalling Microsoft R Open.