Support

Upgrading RStudio Server

Follow

If you perform an upgrade of RStudio Server and an existing version of the server is currently running, then the upgrade process will also ensure that active sessions are immediately migrated to the new version. This includes the following behavior:

  • Running R sessions are suspended so that future interactions with the server automatically launch the updated R session binary
  • Currently connected browser clients are notified that a new version is available and automatically refresh themselves.
  • The core server binary is restarted.

Upgrading from Open-source to Pro

If you currently have RStudio Server Open-source installed and want to upgrade to the Pro version, the process is very simple. You can do so with no worries about your current settings, configuration or files for RStudio Server.

First, stop the current version of RStudio Server:

sudo /usr/sbin/rstudio-server stop

Next, remove the current version of RStudio Server using your package manager:

sudo apt-get remove rstudio-server 
or
sudo yum remove rstudio-server

Finally, download the appropriate package for RStudio Server Pro and install it using your package manager:

sudo gdebi <rstudio-server-package.deb>
or
sudo yum install --nogpgcheck <rstudio-server-package.rpm>

Note that your configuration and settings will be unchanged from the open-source version, so you may want to modify it to take into account the increased features and settings of RStudio Server Pro.

Upgrading to a later version of RStudio Server

If you are upgrading to a later version of RStudio Server open-source or Pro, we recommend taking the service offline completely while you do the upgrade. Generally, you will want to:

  1. Notify users ahead of time of the upgrade (using the admin notifications feature, if you are using the Pro version, or manually if you are using the open-source version)
  2. Suspend all active user sessions (suspend-all)
  3. Put the old version of the server in offline mode (offline)
  4. Install the new version of the server (see below)
  5. Restart the server. The new version of the server will start in offline mode.
  6. Put the new version online (online)

In that way, the service will never be truly down (in the sense that users see a failure to connect). The offline mode keeps users from trying to start new sessions while you’re doing the upgrade.

To perform the installation in step 4, you would download the newer package and installing it using your package manager:

sudo gdebi <rstudio-server-package.deb>
or
sudo yum install --nogpgcheck <rstudio-server-package.rpm>

Your configuration and settings will be unchanged from the previous version, and if you are running RStudio Server Pro, your license status will remain untouched as well.

Comments