5 Server Management
This section describes common administrative tasks for RStudio Connect.
5.1 Stopping and Starting
Occasionally it is necessary to start and stop the RStudio Connect service. Stopping and starting is handled by
systemd or Upstart. On stop/start or restart the following occurs:
- The RStudio Connect process is stopped.
- R processes serving Shiny applications are stopped.
- R processes rendering R Markdown documents run through completion.
- In-progress deployments will fail. R processes running as part of the deployment may run to completion.
- RStudio Connect process is resumed.
- Shiny applications with a minimum number of R processes are started.
- Scheduled R Markdown updates missed during system downtime are run at most once.
The specific stop/start commands depend on the service dameon. Commands for
systemd and Upstart are listed below.
5.1.1 systemd (Red Hat/CentOS 7, Ubuntu 15.04+)
systemd is a management and configuration platform for Linux. The newest versions of most major Linux distributions have adopted
systemd as their default init system.
The RStudio Connect installer installs a
systemd service called
rstudio-connect, which causes the
connect program to be started and stopped automatically when the machine boots up and shuts down. The
rstudio-connect service is also automatically launched during installation.
Use the following commands to manually start and stop the server:
$ sudo systemctl start rstudio-connect
$ sudo systemctl stop rstudio-connect
You can restart the server with:
$ sudo systemctl restart rstudio-connect
If you wish to keep the server running without interruption, but reload the configuration, you can use the systemctl command to send a
$ sudo systemctl kill -s HUP --kill-who=main rstudio-connect
This causes the server to re-initialize but does not interrupt the current processes or any of the open connections to the server.
We do not recommend using
HUPsignal to reconfigure RStudio Connect, as many property changes will not fully propagate through the system. This may adversely affect the behavior of RStudio Connect. A full restart of the service is preferred.
You can check the status of the
rstudio-connect service using:
$ sudo systemctl status rstudio-connect
And finally, you can use the
disable commands to control whether Connect should be run automatically at boot time:
$ sudo systemctl enable rstudio-connect
$ sudo systemctl disable rstudio-connect
5.1.2 Upstart (Ubuntu 12.04 through 14.10, Red Hat 6)
Upstart is a system used to automatically start, stop and manage services. The installer writes an Upstart configuration file to
/etc/init/rstudio-connect.conf. This instructs the Upstart to initialize RStudio Connect as soon as the network is activated on the machine and stop when the machine is being shut down.
The Upstart configuration also ensures that the
connect process is respawned if the process unexpectedly terminates. However, in the event that there is an issue which consistently prevents RStudio Connect from being able to start (such as a bad configuration file), Upstart will give up on restarting the service after approximately 5 failed attempts within a few seconds. For this reason, you may see multiple repetitions of a bad RStudio Connect startup attempt before it transitions to the “stopped” state.
To start or stop the server, run the following commands, respectively.
$ sudo start rstudio-connect
$ sudo stop rstudio-connect
To restart the server you can run:
$ sudo stop rstudio-connect $ sudo start rstudio-connect
restart command re-initializes the server.
restartbecause some configuration changes are not incorporated into a restart. In particular,
re-read the Upstart definition at/etc/init/rstudio-connect.conf
. Changes to this file need astop
andstart` to take effect.
If you wish to reload the configuration and keep the server and all R processes running without interruption, you can use the
$ sudo reload rstudio-connect
This command causes the server to re-initialize but does not interrupt the current processes or any of the open connections to the server.
Known Bug: Due to a bug in the version of Upstart which comes with Ubuntu 13.04,
reloaddoes not behave as expected on that platform and should not be used.
We do not recommend using reload or a HUP signal to reconfigure RStudio Connect, as many property changes will not fully propagate through the system. This may adversely affect the behavior of RStudio Connect. A full restart of the service is preferred.
To check the status or retrieve the process ID associated with
rstudio-connect, run the following:
$ sudo status rstudio-connect
5.2 System Messages
Administrators can add a message to the RStudio Connect welcome page and content page.
Messages are set in the
Server.PublicWarning defines the message for the welcome page.
Server.LoggedInWarning defines the message for the content page. The messages are supplied as HTML snippets. For example:
[Server] PublicWarning = "<strong>Warning:</strong> Scheduled downtime this weekend." LoggedInWarning = "Data Science Team Meeting Tomorrow"
Messages can be added or modified without restarting the connect service. After adding the message property to the config file, use the reload commands for either systemd (Red Hat/CentOS 7, Ubuntu 15.04+):
sudo systemctl kill -s HUP --kill-who=main rstudio-connect
or Upstart (Ubuntu 12.04 through 14.10, Red Hat 6):
sudo reload rstudio-connect
Upgrading RStudio Connect requires limited downtime. Scheduled R Markdown documents are not interrupted. Connections to running Shiny applications are closed. We recommend upgrading during a period of downtime. Users can be warned ahead of an upgrade with system messages.
The RStudio Connect version number is visible on the lefthand navigation pane. The latest version is available on the download page along with release notes.
- Download the latest
Run the install command:
sudo gdebi <rstudio-connect-version.deb>
sudo yum install --nogpgcheck <rstudio-connect-version.rpm>
The new version of RStudio Connect will install on top of an earlier installation. Existing configuration settings are respected. During installation the RStudio Connect service is restarted. Total downtime is less than 10 minutes.
5.4 Purging RStudio Connect
You can fully remove RStudio Connect and all its data from your server using the following steps:
- Stop the RStudio Connect service. (See 5.1 for details)
Uninstall the RStudio Connect package from your system.
sudo apt-get purge rstudio-connect
sudo yum remove rstudio-connect
/opt/rstudio-connectif it still exists.
- Remove logs from
- Remove the
Database.Dirdirectory. This has a default location of
- Remove the
Server.DataDirdirectory. By default, this is
Remove configuration files from
/etc/rstudio-connectif they still exist.