There are a few points you should be aware of when working with Jupyter Notebooks on the jupyterhub server:
Sessions are persistent. If you close the browser tab without stopping the server before, you can revisit the jupyterhub site and carry on working
Closing browser’s tab or log-in out will not stop your session, your session will continue consuming resources (see next point)
- It is preferable to close the session when you finish. This depends on the jupyter interface:
Hub Control Panelthen
Control Paneland then
If you are new to DKRZ and want to access our JupyterHub, please consult the Quick Start page.
If the batch queue is filled with waiting jobs, it might take some time to start the notebook server. There is an internal timelimit specified until which the resources should be ready. If not the spawner will reject and ask you to start again (maybe with reduced resources specified).
On September 1st, 2020, we deployed a new version of our Jupyterhub server. Check the Changelog for all notable changes.
Furthermore, this release was presented in the DKRZ Tech Talks.
You can view the talk on Youtube or
download the slides.
Jupyterlab is the default interface.
However, you can switch from
classical notebook simply by removing the
/tree in the URL.
Undo this operation to go back to switch again to
Debugging and support?#
If you have issues or you have request for new features to jupyterhub, we suggest that you try one of the following steps:
stderrof the SLURM batch job that is spawned by Jupyterhub is written to your
HOMEdirectory on the HPC system. In order to make it simple to locate the log file:
if you use the
presetoptions form: the log file is named
if you use the
advancedoptions form: the log file is named
jupyterhub_slurmspawner_advanced_<id>.log. You can even change the name of the output log file (
Log File Name).
Log File Namealso allows you to change the
Pathof the output log file to a diffrent directory where you have write permissions. Example:
Use the search field in documentation, or look into the blog posts here, we have written some tutorials on well-known issues
Check your job information (services –> accounts), this is useful when the server does not start due to Priority or AssocMaxJobsLimit
If the above steps do not help, send an e-mail to email@example.com.