RStudioServerPro Administrator’sGuide - Amazon S3

1 RStudio Server ProAdministrator s GuideRStudio Server Professional 2015 RStudio, Getting Introduction .. Installation .. RedHat / CentOS (5+) .. Debian (8+) / Ubuntu ( +) .. openSUSE / SLES (11+) .. Management Script .. Activation .. Accessing the Server .. Logging In .. Troubleshooting Problems .. 92 Server Core Administrative Tasks .. Configuration Files .. Stopping and Starting .. Managing Active Sessions .. Taking the Server Offline .. Upgrading to a New Version .. Administrative Dashboard .. Enabling the Dashboard .. Administrator Superusers .. 153 Authenticating PAM Authentication .. PAM Basics .. Default PAM Configuration .. Diagnosing PAM Authentication Problems .. Managing PAM Login Lifetimes .. Restricting Access to Specific Users .. Minimum User Id .. Restricting by Group.

2 Google Accounts .. Registering with Google .. Enabling Google Accounts .. Translating to Local Accounts .. Proxied Authentication .. Enabling Proxied Authentication .. Implementing the Proxy .. Security Considerations .. Troubleshooting with Access Logs .. 254 Access and Network Port and Address .. IP Access Rules .. Secure Sockets (SSL) .. SSL Configuration .. SSL Protocols .. SSL Ports .. Server Permissions .. Server Account .. AppArmor .. Running with a Proxy .. Overview .. Nginx Configuration .. Apache Configuration .. RStudio Configuration .. SPDY .. Overview .. Configuration .. 34 CONTENTS35 R R Executable and Libraries .. Locating R .. Locating Shared Libraries .. Customizing Session Launches .. User and Group Profiles .. Creating Profiles .. CPU Affinity and Scheduling Priority.

3 Resource Limits .. Using Multiple Versions of R .. Multiple R Sessions .. Creating New Sessions .. Session Lifetimes .. Disabling Multiple Sessions .. PAM Sessions .. Session PAM Profile .. PAM Session Cleanup .. Disabling PAM Sessions .. Kerberos .. Configuration .. Testing and Troubleshooting .. Workspace Management .. Default Save Action .. Suspend and Resume .. Workspace Storage .. Project Sharing .. Overview .. Prerequisites .. Disabling Project Sharing .. Package Installation .. User Library .. Discouraging User Installations .. CRAN Repositories .. Feature Limits .. Disabling Access to Features .. Maximum File Upload Size .. CPU Time per Computation .. XFS Disk Quotas .. 556 R Overview .. Installing Multiple Versions of R .. Binary and Source Versions.

4 Building Additional Versions from Source .. Recommended Installation Directories .. Configuring the Default Version of R .. Single Default Version of R .. Default Version Per User or Group .. User Configurable Default Version .. Using Multiple Versions of R Concurrently .. Determining Available Versions .. Switching Between Versions .. Disabling Use of Multiple Versions .. Managing Upgrades of R .. User Controlled Migration .. Partial Migration .. Full Migration .. 627 Load Overview .. Configuration .. Requirements .. Defining Nodes .. File Locking .. Managing Nodes .. Troubleshooting .. Access and Availablity .. Single Master .. Multiple Masters .. Using SSL .. Balancing Methods .. Sessions .. System Load .. User Hash .. Custom .. 708 Auditing and Auditing Configuration.

5 R Console Auditing .. Data Format .. Storage Options .. Monitoring Configuration .. System and Per-User Resources .. Using Graphite .. Server Health Checks .. Enabling Health Checks .. Customizing Responses .. Changing the URL .. 759 License Product Activation .. Activation Basics .. Connectivity Requirements .. Proxy Servers .. Offline Activation .. 77 Chapter 1 Getting IntroductionRStudio Server enables you to provide a browser based interface (the RStudio IDE) to a version ofR running on a remote Linux server. Deploying R and RStudio on a server has a number of benefits,including: The ability to access R sessions from any computer in any location; Easy sharing of code, data, and other files with colleagues; Allowing multiple users to share access to the more powerful compute resources (memory,processors, etc.) available on a well equipped server; and Centralized installation and configuration of R, R packages, TeX, and other manual describesRStudio Server Professional Edition, which adds many enhancements to theopen-source version of RStudio Server, including: The ability to run multiple concurrent R sessions per-user.

6 Flexible use of multiple versions of R on the same server. Project sharing for easy collaboration within workgroups. Load balancing for increased capacity and higher availability. An administrative dashboard that provides insight into active sessions, server health, andmonitoring of system-wide and per-user performance and resource metrics; Authentication using system accounts, ActiveDirectory, LDAP, or Google Accounts; Full support for PAM (including PAM sessions for dynamically provisioning user resources); Ability to establish per-user or per-group CPU priorities and memory limits; HTTP enhancements including support for SSL and keep-alive for improved performance; Ability to restrict access to the server by IP; Customizable server health checks; and Suspend, terminate, or assume control of user sessions; Impersonate users for assistance 1. GETTING RedHat / CentOS (5+)Installing RYou can install R for RedHat and CentOS using the instructions on CRAN: CommandsAfter downloading the appropriate RedHat/CentOS package for RStudio Server Professional youshould execute the following command to complete the installation:sudoyum install --nogpgcheck< >NOTE: If you are running on RedHat 5 you will need to enable the EPEL repository to satisfyRStudio s dependencies on thelibffiandrrdtoolpackages (these packages are part of the baserepository in RedHat 6 and 7 so EPEL is not required on those systems).

7 Debian (8+) / Ubuntu ( +)Installing RRStudio requires a previous installation of R version or higher. To install the latest versionof R you should first add the CRAN repository to your system as described here: Debian: Ubuntu: can then install R using the following command:$sudoapt-get install r-baseNOTE: If you do not add the CRAN Debian or Ubuntu repository as described above this commandwill install the version of R corresponding to your current system version. Since this version of Rmay be a year or two old it is strongly recommended that you add the CRAN repositories so youcan run the most up to date version of CommandsAfter downloading the appropriate Debian/Ubuntu package for RStudio Server Professional youshould execute the following commands to complete the installation:$sudoapt-get install gdebi-core$sudogdebi< >CHAPTER 1. GETTING openSUSE / SLES (11+)Installing RYou can install R for openSUSE or SLES using the instructions on CRAN: that the binaries linked to from this page have one additional requirement that isn t satisfiedusing the default repositories.

8 Before installing R you should install package is available from the SUSE Linux Enterprise SDK. If the SDK repository is availablein your environment you can installlibgfortran43as follows:$sudozypper install libgfortran43 Installation CommandsAfter downloading the appropriate RPM package for RStudio Server Professional you should executethe following command to complete the installation:$sudozypper install< > Management ScriptRStudio Server management tasks are performed using therstudio-serverutility (installed under/usr/sbin). This utility enables the stopping, starting, and restarting of the server, enumerationand suspension of user sessions, taking the server offline, as well as the ability to hot upgrade arunning version of the example, to restart the server you can use the following command:$sudorstudio-server restartNote that on some systems (including RedHat/CentOS 5 and SLES 11) thesudoutility doesn thave the/usr/sbindirectory in it s path by default.

9 For these systems you can use a full path tothe management script. For example:$sudo/usr/sbin/rstudio-server ActivationAfter completing the installation steps described in the previous section you may need to activatethe product before using it. Alternatively, if you haven t previously installed RStudio Server ona system then it will run in evaluation mode for a period of time before requiring activation. Todetermine the current license status of your system you can use the following command:CHAPTER 1. GETTING STARTED9$sudorstudio-server license-manager statusTo activate the product you obtain a product key and then use the following commands:$sudorstudio-server license-manager activate<product-key>$sudorstudio-server restartNote that you need to restart the server in order for licensing changes to take details on license management (including discussions of offline activation and activatingthrough a proxy server) can be found in the License Management Accessing the Logging InBy default RStudio Server runs on port 8787 and accepts connections from all remote clients.

10 Afterinstallation you should therefore be able to navigate a web browser to the following address toaccess the server:http://<server-ip>:8787 RStudio will prompt for a username and password and will authenticate access using the PAMauthentication scheme configured for the server. Some notes related to user authentication: RStudio Server will not permit logins by system users (those with ids < 100). By default on Debian/Ubuntu the system default PAM profile (/ ) will beused (this can be customized by creating an RStudio PAM profile at/ ). By default on RedHat/CentOS and SLES an RStudio PAM profile (/ )that authenticates using the system username/password database will be used (this can becustomized by editing the profile as appropriate). User credentials are encrypted using RSA as they travel over the details on customizing RStudio Server authentication are provided in AuthenticatingUsers. Details on customizing the port and enabling SSL are covered in Access and Troubleshooting ProblemsIf you are unable to access the server after installation, you should run theverify-installationcommand to output additional diagnostics:$sudorstudio-server verify-installationCHAPTER 1.