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 between classical and lab notebook simply by replacing the /lab in the URL with /tree. Do the opposite to switch again to jupyterlab.

_images/lab-tree.gif

If you have ? at the end of the url, it needs to be removed before adding /lab.

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

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