Spawner options#

After you log in into Jupyterhub you will need to start a session. We provide two different option forms (for all DKRZ systems) to customize your session:

  • preset: the most important Slurm and notebook settings already set (memory, cpus, runtime)

  • advanced: this is for advanced users with a minimal knowledge of Levante configuration and Slurm

../../../_images/new-spawner-home.png

Note

We also provide a Jupyterhub service to check information about your accounts/projects/jobs. Just click on services –> accounts.

Advanced#

The advanced options form is for advanced users with a minimal understanding of Slurm parameters. Furthermore, it provides an additional level of dynamicity for:

  • setting accounts, partitions, reservations and features (drop menu)

  • choosing between different notebook interfaces (notebook, lab or terminal)

../../../_images/advanced.png

Parameter

Mandatory

Description

Account

Yes

Project that should be charged

Partition

Yes

Partition to run the job

Reservation

No

Resources reserved for certain time/accounts

Time

No (Default: 1 Hour)

The maximum amount of time your job can take before Slurm forcefully kills it.

Number of cores

No (Default: 1 core)

Number of threads (logical cores) per task.

Memory

No (Default: 1024 MB)

The total amount of RAM to allocate.

QoS

No

Quality of Service often puts the job in high priority queue (e.g. training).

GPU Configuration

No (Default: gpu:0)

Type and count of GPU devices

Log File Name

No (Default: jupyterhub_slurmspawner_advanced)

Notebook log

Request Features

No

Node-features requested for the job.

User interfaces

No (Default: jupyterlab)

Notebook/Lab/Terminal/VNC Desktop

Note

Most of the issues when using the advanced options form are due to non valid Slurm options. Please check this Levante configuration first, so you can pick up the correct settings for your session.

Form options / browser’s storage#

For both preset and advanced, the form options are stored every 10s and are not lost when you close/stop your notebook. This is a nice feature especially for the advanced options where there are many inputs. You can also reset the form to the initial state.

../../../_images/options_saved1.gif

Note

This feature is based on the browser’s storage. If you delete the cache, the options are also deleted.