Installing Microsoft R Open 3.4.1 · MRAN Skip to main content

Installing Microsoft R Open 3.4.1

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

System Requirements

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

Side-by-Side Installs

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

  • Start Microsoft R Open 3.4.1 by executing C:\Program Files\Microsoft\R Open\R-3.4.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. 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.1\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 Sept 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.1, please review the following system requirements.

Side-by-Side Installs

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

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

  • Start Microsoft R Open 3.4.1 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.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.4.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. 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.1, which is under lib64/R/bin/R.
    • The CRAN repository points to a snapshot from Sept 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.1, please review the following system requirements.

    Side-by-Side Installs

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

    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

    If you have not installed clang4 or gfortran on your system, run one or both of the following commands to remove additional symbolic links:

    sudo rm -rf /usr/local/clang4
    sudo rm -rf /usr/local/gfortran

    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.