User Tools

Site Tools


doku:jupyterhub

Jupyterhub

The VSC offers a jupyterhub available for all VSC users at https://vsc.ac.at/jupyterhub/hub/login

Login works with any cluster user (both VSC3 and VSC4) and uses the OTP like on the cluster. A VPN connection is not needed.

start a server

choose a profile:

  • VSC4 Singularity Image - a singularity image running on VSC4 (this is the default)
  • VSC3 Singularity Image - a singularity image running on VSC3+
  • VSC3 GPU nodes - a singularity image with CUDA support running on GPU nodes of VSC3+ (currently only GTX1080)
  • VSC4 direct - a python virtual environment running directly on VSC4

Note: You need a VSC4 user for the VSC4 profiles and a VSC3 user for the VSC3+ profiles

In all profiles, you can choose the IDE, either Jupyter Notebook or the more modern Jupyter Lab (which is the default)

For all the singularity profiles, you can choose between a predefined image (default) or a custom image:

  • Predefined image gives a dropdown list of different singularity images. Each image shows a short description, a version, an author and a link to the image. The GPU option only has one predefined image.
  • Custom image shows a line where the complete path to the image has to be entered. Note that the image has to reside on the cluster already. Web-upload is not possible.

Independent of the profile you can choose the number of CPUs, size of the RAM, the maximum running time.

After everything is selected, press start - your server will start and show you the JupyterLab interface or the simpler Notebook interface. In both cases, there is a list of all files in your home directory, which includes previously created notebooks.

JupyterLab

Simply click on the desired notebook in your list - it will open in the main panel.

On first use, no notebook is present yet. To create one (or to create new ones), go to File → New → Notebook. You will be asked what kernel to use (the default is Python3): choose select and the notebook is started. It will show up as untitled in the file list, and can be renamed via right-click.

It is possible to log out of the system and leave the server running with File → Log Out. Keep in mind that this also keeps the selected resources blocked for other users.

To stop the server, user File → Hub Control Panel and choose 'Stop My Server'.

Jupyter Notebook

Simply click on the desired notebook in your list - it will be opened in a new tab.

On first use, no notebook is present yet. To create one (or to create new ones), click on 'new' in the upper right area above the file list and choose the appropriate type. The new notebook will start in a new browser tab. It will show up as untitled in the file list, and can be renamed by selecting the checkbox to the left of the name and choose 'rename' at the top.

It is possible to log out of the system and leave the server running with the 'Logout' button at the top right. Keep in mind that this also keeps the selected resources blocked for other users.

To stop the server, click on 'Control Panel' at the top right and choose 'Stop My Server'.

doku/jupyterhub.txt · Last modified: 2021/09/10 17:44 by goldenberg