Overview

Note

If you are new to DKRZ and want to access our JupyterHub, please consult the Quick Start page.

Note

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).

What’s new?

On September 1st, 2020, we deployed a new version of our Jupyterhub server. Check the Changelog for all notable changes. Furthermore, the new release has been also presented during the DKRZ Tech Talks.

Video

PDF

Interface

You can switch from classical to lab notebook simply by adding /lab before /tree in the URL. Undo this operation to go back to switch again to jupyter notebook.

_images/lab-tree.gif

Support?

If you encounter any issue or you have request for new features, please send us an e-mail to support@dkrz.de.

Misc

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 how you started the session (preset, advanced)
    • JupyterLab: File -> Hub Control Panel -> (preset/advanced) and then stop

    • classical Jupyter: Control Panel -> (preset/advanced) and then stop

_images/stop_server.gif
  • SLURM might cancel your server session if a timeout occurs after 8 hours

  • By default, stdout and stderr of the SLURM batch job that is spawned by Jupyterhub is written to your HOME directory on the HPC system. In order to make it simple to locate the log file:

    • if you use the preset options form: the log file is named jupyterhub_slurmspawner_preset_<id>.log.

    • if you use the advanced options 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 Name also allows you to change the Path of the output log file to a diffrent directory where you have write permissions. Example: /path/to/your/scratch/name_of_your_logfile.