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

Installing Microsoft R Open 3.3.3 [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.0.

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

System Requirements

Before you begin installing Microsoft R Open 3.3.3, 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.3 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.3, please review the following system requirements.

Side-by-Side Installs

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

  • Start Microsoft R Open 3.3.3 by executing C:\Program Files\Microsoft\R Open\R-3.3.3\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.

    If you choose not to write to the registry keys during the installation of Microsoft R Open, then you may be missing some functionality.

  5. During the installation of Microsoft R Open, you can enable the optional multi-threaded performance by installing the recommended math libraries (MKL).

  6. 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\R Open\R-3.3.3\bin\x64\Rgui.exe or using Microsoft R Open shortcut in the Start menu.

Important! If your Windows OS has not been updated in a while, you may get an error message similar to the following when you launch your R console IDE: "The program can't start because api-ms-win-crt-heap-l1-1-0.dll is missing from your computer." If you get this message, you must do the following in order to use Microsoft R Open:
  1. Install all Windows updates. After updating, restart your computer and check for more updates.
  2. Once all updates have been installed, download Visual C++ Redistributable for Visual Studio 2015 (64-bit) (vcredist_x64.exe).
  3. Run vcredist_x64.exe and select "Uninstall".
  4. Run vcredist_x64.exe again and select "Install".
  5. Restart the computer and then try your IDE again.
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 March 15, 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.3.3, please review the following system requirements.

Side-by-Side Installs

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

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

  • Start Microsoft R Open 3.3.3 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.3 (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.3.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.3, which is under lib64/R/bin/R.
    • The CRAN repository points to a snapshot from March 15, 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.3.3, please review the following system requirements.

    Side-by-Side Installs

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

    Uninstalling

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

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

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

    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:
        yum erase MRO-3.3.3
      • 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.