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

Installing Microsoft R Open 3.3.1 [Archived Documentation]

Archive Notice

These are not the latest instructions.

The following documentation describes how to install and uninstall Microsoft R Open 3.3.0, 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.3.1, is based on (and 100% compatible with) the statistical language, R-3.3.1, and includes additional capabilities for performance, reproducibility and platform support. Learn more...

System Requirements

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

Supported Platforms. Microsoft R Open 3.3.1 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, 15.04
    • CentOS / Red Hat Enterprise Linux 6.5, 7.1
    • SUSE Linux Enterprise Server 11
  • Mac OS X:
    • Mavericks (10.9), Yosemite (10.10), El Capitan (10.11)

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.3.1, please review the following system requirements.

Side-by-Side Installs

On Windows, Microsoft R Open 3.3.1 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.3.1, 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.3.1, here is how you could work with them side-by-side:

  • Start Microsoft R Open 3.3.1 by executing C:\Program Files\Microsoft\MRO\R-3.3.1\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. Go to the directory where you downloaded the Microsoft R Open installer.

  3. Launch the Microsoft R Open installer as a user with administrator privileges and follow the prompts.

    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.
    • If you choose not to write to the registry keys during the installation of Microsoft R Open, then you may be missing some functionality.
  4. During the installation of Microsoft R Open, you can enable the optional multi-threaded performance by installing the recommended math libraries (MKL).

  5. When the Microsoft R Open installation is complete, launch Rgui.exe to start interacting with R. On some platforms, you can find Rgui.exe under C:\Program Files\Microsoft\MRO\R-3.3.1\bin\x64\Rgui.exe or using Microsoft R Open shortcut in the Start menu.

    Note: After installing Microsoft R Open, the default R path now points to the R installed with Microsoft R Open 3.3.1.

Silent and Unattended Installs of Microsoft R Open

To install and uninstall Microsoft R Open from a script on Windows, use the following command-line flags. These commands will install Microsoft R Open using all defaults, including MKL, and display only the progress bar.

Unattended mode Silent Mode
Install msiexec /i <path_to_MSI> /passive msiexec /i <path_to_MSI> /quiet
Uninstall msiexec /x <path_to_MSI> /passive msiexec /x <path_to_MSI> /quiet

The MKL libraries are installed when you use the commands above unless you specify INSTALLMKL=0. For example, msiexec /i <path_to_MSI> /quiet INSTALLMKL=0.

What's Next After Install

Installing on Linux

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

Side-by-Side Installs

On Linux machines, Microsoft R Open 3.3.1 can work side-by-side with other Major-Minor versions of CRAN R. For example, Microsoft R Open 3.3.1 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.3.1.

After installation, you can start Microsoft R Open 3.3.1 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.3.1. To do so, specify the full path to the R executable you want to use. For example, if you installed RRO 3.2.2 and then upgraded to Microsoft R Open 3.3.1, you could work with both as follows:

  • Start Microsoft R Open 3.3.1 by executing R since it was the last one installed.
  • Start RRO 3.2.2 by executing /usr/lib64/RRO/R-3.2.2/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.3.1 (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.3.1.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.

      Note: After installing, the default R path is updated to point to R installed with Microsoft R Open 3.3.1, which is under /usr/lib64/microsoft-r/3.3/lib64/R/bin/R.

    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.3.1, please review the following system requirements.

    Side-by-Side Installs

    On Mac OS X machines, Microsoft R Open 3.3.1 can work side-by-side with other Major-Minor versions of CRAN R. For example, Microsoft R Open 3.3.1 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.3.1. After installation, you can start Microsoft R Open 3.3.1 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.3.1 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.3.1 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.9 directly from https://www.xquartz.org/ before installing Microsoft R Open. Do not install XQuartz 2.7.9 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, 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.

    What's Next After Install

    Uninstalling

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

    To uninstall Microsoft R Open 3.3.1, 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.3.1 in the list and uninstall.

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

    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:
        yum erase MRO-3.3.1
      • On SLES:
        zypper remove MRO
    3. Remove the installation directory:

        rm –rf /usr/lib64/microsoft-r/3.3/

    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.