Skip to content

Installation (Linux)

This guide shows how to install RPGM Server on a Linux operating system.

Distributions

RPGM Server has been tested on several Debian (stretch and later version) and Ubuntu (18.04 and later) versions.

Automatic installation

Depending on your Linux distribution and version, we may provide you an all-in-one, one-command script to execute that will install all dependencies and RPGM Server. You will have nothing to do after the execution of the script.

Manual Installation

Installing R

R should be installed. Please refer to R installation guide corresponding to your distribution. Also some R packages need special dependencies from the operating system, like the curl library.

# apt-get install r-base r-base-dev libcurl4-openssl-dev libssl-dev build-essential

$ sudo apt-get install r-base r-base-dev libcurl4-openssl-dev libssl-dev build-essential

Installating RPGM Server

The recommended location to install RPGM Server is in /opt.

# mkdir /opt/rpgmserver
# cd /opt/rpgmserver
# wget LINK_TO_RPGM_SERVER_GIVEN_TO_YOU
# unzip rpgm-server.zip
# rm rpgm-server.zip
# ./rpgm-server admin-create
# ./rpgm-server config-wizard

$ sudo mkdir /opt/rpgmserver
$ cd /opt/rpgmserver
$ sudo wget LINK_TO_RPGM_SERVER_GIVEN_TO_YOU
$ sudo unzip rpgm-server.zip
$ sudo rm rpgm-server.zip
# sudo ./rpgm-server admin-create
# sudo ./rpgm-server config-wizard

The admin-create tool will ask for a name, an email and a password for creating the first admin user of RPGM Server. The config-wizard will ask for the server port and the server URL.

Note

You can also modify the configuration manually by editing the config.yml file with a command like nano config.yml. Change the settings in this file according to the config.yml file.

Starting the Server

RPGM can be run in screen:

# screen -dmS rpgmserver ./rpgm-server server

$ sudo screen -dmS rpgmserver ./rpgm-server server

You can detach from screen with Ctrl+A then D, RPGM Server will keep running in background.

Stopping the Server

The server is executed in a linux screen environment.

You can connect to the RPGM Server console with screen -r rpgmserver. Ctrl+C will stop the server and will detach you from the console, or you can detach from screen with Ctrl+A then D and RPGM Server will keep running in background.

Installing Packages

On Linux, the CRAN does not provide already compiled packages when using install.packages(). Thus, all packages need to be recompiled, which can be a long task. Some R packages depends on tens of others packages that also need to be compiled. Because of this, we recommended that you manually install from an SSH session in R the most common R packages you will use.

Warning

Some R packages also need some system dependencies, and their compilations can failed without them.