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

Note

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

Preset (recommended)¶

If you choose the preset form, you only need to select the profile that best fits your requirements. Slurm parameters are already set, e.g. memory, number of cores and the partition.

Parameter	Mandatory
Account	Yes
Reservation	No
QoS	No

Levante¶

This table shows the preset profiles we provide for Levante:

Partition	Memory (GB)
interactive	5, 10, 20, 50, 100
shared	10, 20, 50
compute	256 (exclusive node)

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)

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).
Log File Name	No (Default: `jupyterhub_slurmspawner_advanced`)	Notebook log
Request Features	No	Node-features requested for the job.
User interfaces	No (Default: notebook)	Notebook/Lab/Terminal

Note

Most of the issues when using the advanced options form are due to non valid Slurm options. Please check this Levante or Mistral 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.

Note

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