Rancher ApplicationsRStudio Server

RStudio

Running RStudio

We offer two ways of running RStudio:

  1. Run RStudio in web JupyterHub - this option ❗️requires a valid MetaCentrum account❗️. JupyterHub provides easy way of creating RStudio and straightforward integration with MetaCentrum home. Only R 4.2.1 is supported.

  2. Run RStudio as a Rancher application - this option is ❗️for anyone, who does not have MetaCentrum account❗️. It offers multiple R versions but is slighly more complicated to set up.

JupyterHub RStudio

JupyterHub is a web application that has a simple input form where you choose various settings of your deployment. To learn more, see JupyterHub introduction where you can find other necessary information.

Rancher RStudio

If not already logged, log to rancher.cloud.e-infra.cz, see Rancher section.

Following the steps below, you can install RStudio web application. This application has persistent home directory, it means, that if you delete the application and later install the application again with the same name, content of home directory will be preserved.

Notes

  • Default project has quota limit for 12 guaranteed CPUs and quota for 16 CPUs limit. Do not select more than 10 guaranteed CPUs and more than 14 CPUs limit. If needed more just ask. This may be increased in future so request for more CPUs can be made.

Select Application to Run

Navigate through Only User Namespaces (1), App & Marketplace (2), Charts (3), cerit-sc (4), and select RStudio (5). See screenshot below.

selectapp

Install the Application

When you click on the chart, hit Install to continue.

selectapp

Now you can install the RStudio application. In most cases, keep both Namespace (1) and Name (2) intact, however, you can select namespace as desired except default. The default namespace is available but it is not meant to be used. The Name will be in URL to access the application. The Name must be unique in the Namespace, i.e., you cannot run two or more instances with the same Name in the same Namespace. If you delete the application and later install the application again preserving its Name, content of home directory will be preserved.

appinst

In the first part of the form, you choose R image, using it you select R version. Image with Full tag contains most of system libraries and also allows to install additional system packages using fakeroot command like fakeroot apt-get install libssl-dev. However, if application is restarted or reinstalled, all installs using fakeroot are lost and has to be installed again.

appinst

In the second part of the form, you select access password, please avoid chars like {, }, non trivial password is strongly recommended, however, it is also strongly recommended not to use a password you already use somewhere else. Username will be just rstudio.

appform1

In the third part of the form, you can select e-infra storage (3) to connect to the application. If you check External Storage, only storage-brno12-cerit.metacentrum.cz is supported. If you want to connect this storage, follow the tutorial on creating the storage. On the storage secrets site you will click the first option Create Samba password for storage-brno12-cerit.metacentrum.cz This storage is mounted to /home/rstudio/data directory.

You can also select persistent /opt volume (2) that is used for installed packages via conda installer, see below. Persistent /opt preservers installed packages across rstudio restart.

Persistent home (1) enables preserving content of the home directory across rstudio restart.

appinst

In the fourth part of the form, you can select requested resources. This step is optional. Minimum CPU or RAM is guaranteed amount of CPU and RAM, system reserves these resources for the application. However, the application can exceed guaranteed resources up to Maximum. However, in this case, resources are not exclusive and can be shared among other applications. If the application exceeds Maximum CPU, it gets limited, if it exceeds Maximum RAM, it gets terminated (you will see OOMKill report) and restarted. See note above about maximum values.

appform2

Wait for Application to Start

When you hit Install, you will see installation log. Once you see SUCCESS (see screenshot below), the application is running.

apphelm

Login to the Running Instance

Once the application is running, navigate through Service Discovery (1) and Ingresses (2). You will see Ingresses. If you see cm-acme-http-solver... (3), wait until it disappears. Once you see rstudio or whatever Name you used in the previous steps, you can click on Target (4) to log in to the application.

appacme

You will see log in window, use rstudio as login name and the selected password from the from.

applogin

Delete Running Instance

If you feel you do not need the application anymore, you can delete it. Just navigate to App & Marketplace (1), Installed Apps (2), select the application (3) and hit Delete (4). The data in home directory is not deleted. Running the application again with the same Name restores access to the home directory folder.

appdel

Install Additional Packages

As of chart version 1.4, it is possible to use conda or mamba tool to install additional packages. They are instaled into /opt/conda directory. E.g., in rstudio terminal (1), type: mamba install mc (3) to install the mc package. If you see (base) (2) in the beginning of prompt, all paths are set correctly to use conda installed packages. If you do not see the (base), type: /opt/conda/bin/conda init, close the terminal and run a new one. This action is required once only.

terminal