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.

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.

On first use, no notebook is present yet. To create one (or to create new ones), got 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'.

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

All normal Jupyter Notebook funktions are available. pip can be used to install modules. Note, however, that for module that need gcc for example, the proper image has to be used (for example SciPy notebook).

To stop using it, go to File → close and halt. It will save the current state and close the tab.