Installing Microsoft R Open 3.3.2 · MRAN Skip to main content

Installing Microsoft R Open 3.3.2

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.2, is based on (and 100% compatible with) the statistical language, R-3.3.2, and includes additional capabilities for performance, reproducibility and platform support. Learn more...

System Requirements

Before you begin installing Microsoft R Open 3.3.2, 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.2 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:
    • Mavericks (10.9), Yosemite (10.10), 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.3.2, please review the following system requirements.

Side-by-Side Installs

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

  • Start Microsoft R Open 3.3.2 by executing C:\Program Files\Microsoft\MRO\R-3.3.2\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. All package dependencies are installed 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.2\bin\x64\Rgui.exe or using Microsoft R Open shortcut in the Start menu.

Important!
  • 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 November 1, 2016. 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 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.2, please review the following system requirements.

Side-by-Side Installs

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

After installation, you can start Microsoft R Open 3.3.2 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.2. 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.2, you could work with both as follows:

  • Start Microsoft R Open 3.3.2 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.2 (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.2.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.

    Important!
    • After installing, the default R path is updated to point to R installed with Microsoft R Open 3.3.2, which is under lib64/R/bin/R.
    • The CRAN repository points to a snapshot from November 1, 2016. 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.3.2, please review the following system requirements.

    Side-by-Side Installs

    On Mac OS X machines, Microsoft R Open 3.3.2 can work side-by-side with other Major-Minor versions of CRAN R. For example, Microsoft R Open 3.3.2 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.2. After installation, you can start Microsoft R Open 3.3.2 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.2 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.2 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, 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.

    Important! After installing, the CRAN repository points to a snapshot from November 1, 2016. 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

    Uninstalling

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

    To uninstall Microsoft R Open 3.3.2, 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.2 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.2
      • 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.