R Services Installation Guide for Linux Systems The correct bibliographic citation for this manual is as follows: Microsoft Corporation. 2016. Microsoft R Services Installation Guide for Linux Systems. Microsoft Corporation, Redmond, WA. Microsoft R Services Installation Guide for Linux Systems Copyright © 2016 Microsoft Corporation. All rights reserved. No part of this publication may be reproduced, stored in a retrieval system, or transmitted, in any form or by any means, electronic, mechanical, photocopying, recording, or otherwise, without the prior written permission of Microsoft Corporation. U.S. Government Restricted Rights Notice: Use, duplication, or disclosure of this software and related documentation by the Government is subject to restrictions as set forth in subdivision (c) (1) (ii) of The Rights in Technical Data and Computer Software clause at 52.227-7013. Revolution R, Revolution R Enterprise, RPE, RevoScaleR, DeployR, RevoPemaR, RevoTreeView, and Revolution Analytics are trademarks of Microsoft Corporation. Other product names mentioned herein are used for identification purposes only and may be trademarks of their respective owners. Microsoft Corporation One Microsoft Way Redmond, WA 98052 U.S.A. Revised on December 18, 2015 We want our documentation to be useful, and we want it to address your needs. If you have comments on this or any Microsoft R Services document, write to [email protected]. Table of Contents 1 Quick Overview .............................................................................................................. 5 2 Prerequisites and Dependencies..................................................................................... 6 2.1 System Requirements ...................................................................................................... 7 2.2 Package Dependencies ..................................................................................................... 7 3 Managing Your Microsoft R Services Installation ............................................................ 9 3.1 File Ownership .................................................................................................................. 9 3.2 Non-Root Installs .............................................................................................................. 9 3.3 Unattended Installs ........................................................................................................ 11 3.4 File Permissions .............................................................................................................. 11 3.5 Installing to a Read-Only File System ............................................................................. 12 4 Setting Up a Package Repository .................................................................................. 12 4.1 Installing miniCRAN ........................................................................................................ 12 4.2 Creating a Repository from an MRAN Snapshot ............................................................ 13 4.3 Creating a Custom Repository ........................................................................................ 13 4.4 Configuring R to Use Your Local Repository................................................................... 14 5 Removing Microsoft R Services..................................................................................... 15 6 Managing Multiple R Installations ................................................................................ 15 6.1 Using Microsoft R Services with Other R Installations ................................................... 15 7 Using Microsoft R Services with a Third-Party IDE ......................................................... 15 7.1 Running Microsoft R Services with RStudio ................................................................... 16 7.2 Running Microsoft R Services with StatET ..................................................................... 17 1 Quick Overview This chapter describes a quick install process that assumes the following: Your system has Internet access Your system is configured to use your platform’s package manager (yum for RHEL systems, zypper for SLES systems) You are installing as root. If any of these conditions does not hold, you should first verify that your system meets the system requirements and satisfies the package prerequisites described in Chapter 2, then follow the more detailed installation instructions described in Chapter 3. Installation of Microsoft R Services consists of two distinct steps: 1. Install Microsoft R Open for Microsoft R Server 2016. 2. Install Microsoft R Server 2016. To download and install Microsoft R Services: 1. Log in as root or a user with sudo privileges. If the latter, precede commands requiring root privileges with sudo. (If you do not have root access or sudo privileges, you can install as a non-root user. See Section 3.2 for details.) 2. Download Microsoft R Open for Microsoft R Server 2016. 3. Install Microsoft R Open according to the online instructions for your platform. 4. Download and unpack the Microsoft R Server 2016 distribution, which will either be a DVD img file (if you obtained Microsoft R Server via Microsoft Volume Licensing) or a gzipped tar file (if you obtained Microsoft R Server via MSDN). The distribution file includes one or more Microsoft R Server installers, along with installers for DeployR, an optional additional component. 5. If you have an img file, you must first mount the file. The following commands create a mount point and mount the file to that mount point: mkdir /mnt/mrsimage mount –o loop <filename> /mnt/mrsimage If you have a gzipped tar file, you should unpack the file as follows (be sure you have downloaded the file to a writable directory, such as /tmp): [for RHEL/CENTOS systems] tar zxvf MRS80RHEL.tar.gz [for SLES systems] tar zxvf MRS80SLES.tar.gz 6. In either case, you will then want to copy the installer gzipped tar file to a writable directory, such as /tmp: 6 Prerequisites and Dependencies [From the mounted img file] cp /mnt/mrsimage/Microsoft-R-Server-*.tar.gz /tmp [From the unpacked tar file] cp /tmp/MRS80*/Microsoft-R-Server-*.tar.gz /tmp 7. Unpack the tar file and run the installer script, as follows: cd /tmp tar xvzf Microsoft-R-Server-8.0.0-<OS>.tar.gz pushd rrent ./install.sh The installer prompts you for the following: a. the location of your R installation—if you installed Microsoft R Open for Microsoft R Server to the default location, you can simply press Enter and continue. b. where you would like to install additional Microsoft R Services files; these are files that are not part of specific R packages, such as documentation, licenses, and scripts. c. if you would like to load the rpart and lattice packages by default; these packages are recommended as they enhance some RevoScaleR operations. d. to agree to the Microsoft R Services software license. 8. Once you have agreed to the license, the installation completes. Type the following to return to your original directory: popd On Linux systems with Hadoop installed, the install.sh script also tries to configure Microsoft R Services for use with Hadoop. On such systems, the install.sh script runs a Python script that queries the Hadoop environment for certain environment variables and searches the Hadoop installation for certain files, writing a set of Hadoop environment variables required by Microsoft R Services to a file in the RRE installation directories. For complete details on Hadoop configuration, including troubleshooting when the automated configuration is incomplete or inaccurate, see the Microsoft R Services Hadoop Configuration Guide. If you receive messages about uninstalled dependencies, see Chapter 2 on Prerequisites and Dependencies. 2 Prerequisites and Dependencies This chapter describes the minimum and recommended system requirements for Microsoft R Services, and also lists all known package dependencies. Prerequisites and Dependencies 7 2.1 System Requirements Microsoft R Services for Linux has the following system requirements: Processor: 64-bit processor with x86-compatible architecture (variously known as AMD64, Intel64, x86-64, IA-32e, EM64T, or x64 chips). Itanium-architecture chips (also known as IA-64) are not supported. Multiple-core chips are recommended. Operating System: Red Hat Enterprise Linux 5.4, 5.5, 5.6, 5.7, 5.8, 5.9, 5.10, 5.11, 6.0, 6.1, 6.2, 6.3, 6.4, 6.5, or 6.6, or SUSE Linux Enterprise Server 11 SP1, SP2, or SP3. (SUSE Linux Enterprise Server installs require the libgfortran43 package; to our knowledge this is distributed only with SP1, but can be installed into later Service Packs. The required ISO images can be found at https://download.suse.com/.) Only 64-bit operating systems are supported. Memory: A minimum of 2GB of RAM is required; 8GB or more are recommended. Disk Space: A minimum of 500MB of disk space is required. 2.2 Package Dependencies Microsoft R Services, like most Linux applications, depends upon a number of Linux packages. If your system is not Internet-connected or not configured to use a package manager, you must ensure that these dependencies are installed by hand. Most of these, listed in Table 1 for RHEL systems and Table 2 for SLES 11 systems, are explicitly required by Microsoft R Services, either to build R itself or as a prerequisite for an additional Microsoft package. The remainder are in turn required by these dependencies. These are automatically installed