Skip to content

Customization

You may customize your virtual machine at launch:

Conda

Conda is an open-source package management system and environment management system that runs on Windows, macOS, and Linux. Conda quickly installs, runs, and updates packages and their dependencies. Conda easily creates, saves, loads, and switches between environments on your local computer. It was created for Python programs but it can package and distribute software for any language.

Responsibility for conda tools

Third parties create and support all conda tools. The de.NBI cloud isn't responsible for the capability of the packages provided. If problems occur during installation or use, please contact the developers of the respective packages.

Choose tools and packages

Choose from a list of Bioconda, Anaconda, and Condaforge tools to install automatically at vm launch. Filter by name to find the tools you need.
Click on the green plus sign to add the tool or click the red minus sign to remove the tool from your selection of tools.

conda_table_with_selections

After choosing your tools and packages, you need to read and confirm the proceeding installation process.

conda_confirmation_needed

Installation process

Minoconda3

Miniconda3 will install, which is a lightweight package manager. We decided against the full Anaconda set of tools due to its size with over 1500 packages.
If you wish to install Anaconda, you will have to choose it from the list of packages.

We create a temporary private and public key pair to access your virtual machine at launch, and to install your selection with Ansible. At the end of the installation process we remove the temporary key from your vm and copy your public key onto it, regardless of whether the installation of your selection succeeds or fails.
You may download the installation logs as a PDF or TXT file. See Instance Detail for more information.

Environment

You get a Conda environment named 'denbi'. You may find your selection of tools in this environment. For your convenience, the installation process initializes the .bashrc for conda and creates an alias, so that you may load the 'denbi' environment by running the command in your vm:

denbi

Research environments

You may find a selection of research environments here you may use over your web browser, e.g., JupyterLab, RStudio, Apache Guacamole or Theia IDE. In the future, you may find more research environments added.

Use with Anti-Virus Software

In some situations, anti-virus sofware may cause you to experience connection problems with browser-based research environments. If you experience difficulties connecting, it is advisable to check whether your anti-virus software may be blocking the connection.

Select a research environment

resenv_pre_build_images

resenv_selection_filled

To start a research environment on your virtual machine, either select a pre-build image provided by de.NBI from the “Research Environment” tab or select a base image and a research environment template. By using a template, the research environment installs at vm launch.
Either way, name your research environment or click to generate a random name. This name appears in the unique URL used to access your research environment.

Pre-build images versus base image with a template

Virtual machines with pre-build images start faster than base images with a selected template.

Installation process

Like the installation process of Conda, we create a temporary rsa-keypair, which we use to install your research environment with Ansible. Afterward, we remove the temporary key and copy your public key onto your virtual machine, whether the process succeeds or fails. When the process finishes, you may download and look into the installation logs.

Find your research environment URL

To access your research environment, follow the Link you find on the instance overview or on the detail page of your virtual machine.

resenv_link

A LifeScience login prompt appears if you haven't already logged in with your LifeScience account.
If you don't grant access to other members of your project on the detail page, only the person who started the vm may access the research environment.

JupyterLab

JupyterLab is the latest web-based interactive development environment for notebooks, code, and data. Its flexible interface allows users to configure and arrange workflows in data science, scientific computing, computational journalism, and machine learning. A modular design invites extensions to expand and enrich functionality.

To access your JupyterLab research environment, follow the link you find, after starting your virtual machine, in the instance overview or on the detail page of your virtual machine. A LifeScience login prompt appears if you haven't already logged in with your LifeScience account.
Afterward a prompt to log in to JupyterLab with a Token shows.

jupyterlab_login

Login Token

Use the following Token:

simplevm

Now you can work with JupyterLab by web browser.

rstudio_resenv

RStudio

RStudio is an integrated development environment (IDE) for R. It includes a console, syntax-highlighting editor that supports direct code execution, as well as tools for plotting, history, debugging and workspace management.

To access your RStudio research environment, follow the link you find, after starting your virtual machine, in the instance overview or on the detail page of your virtual machine. A LifeScience login prompt appears if you haven't already logged in with your LifeScience account.
Afterward a prompt to log in to RStudio shows.

rstudio_login

Login credentials

Use the following credentials:

Username: ubuntu
Password: simplevm
If these credentials don't work, use the deprecated credentials (since 16.03.2020):
Username: ubuntu
Password: ogvkyf
Now you can work with RStudio by web browser.

rstudio_resenv

Multiple users and concurrent sessions

To grant other users access to your research environment, add them to the allowed list of users. You may find the list on the detailed page.

Concurrent sessions

This doesn't automatically allow for concurrent sessions, i.e., your session terminates once another user logs in with the same credentials.
For concurrent sessions, see this guide.

Apache Guacamole

Apache Guacamole is a clientless remote desktop gateway. It supports standard protocols like VNC, RDP, and SSH. We call it clientless because no plugins or client software are required. Thanks to HTML5, once Guacamole is installed on a server, all you need to access your desktops is a web browser.

Rebooting a guacamole vm

After rebooting your vm or turning your vm from shutoff to active, it takes about 15 minutes until you may access your Apache Guacamole research environment.

To access your Apache Guacamole research environment, follow the link you find, after starting your virtual machine, in the instance overview or on the detail page of your virtual machine. A LifeScience login prompt appears if you haven't already logged in with your LifeScience account.
Afterward a prompt to log in to Apache Guacamole shows.

guacamole_login

After logging in, choose a keyboard layout.

guacamole_keyboard_layout

Login credentials

Use the following credentials:

Username: denbi
Password: denbi

Password prompt on inactivity

It may happen that, because of inactivity, a prompt for the password of the ubuntu user shows:

ogvkyf

Now you can work with Apache Guacamole by web browser.

guacamole_resenv

Multiple users and concurrent sessions

To grant other users access to your research environment, add them to the allowed list of users. You may find the list on the detailed page.

Concurrent sessions

This doesn't automatically allow for concurrent sessions, i.e., your session terminates once another user logs in with the same credentials.
For concurrent sessions, see this guide.

TheiaIDE

Eclipse Theia is an extensible platform to develop full-fledged multi-language Cloud & Desktop IDE-like products with state-of-the-art web technologies.

Find more information on TheiaIDE on the tutorial page.

To access your TheiaIDE research environment, follow the link you may find, after starting your virtual machine, in the instance overview or on the detail page of your virtual machine. A LifeScience login prompt appears if you haven't already logged in with your LifeScience account.
Now you can work with Theia IDE by web browser.

theiaide_resenv


Last update: August 9, 2023