Attention
The ShARC HPC cluster was decommissioned on the 30th of November 2023 at 17:00. It is no longer possible for users to access that cluster.
7. JupyterHub: errors and troubleshooting
7.1. Common issues
7.1.1. After submitting Spawner options I get returned to the Spawner options page after a minute or two
The cluster is not able to start your JupyterHub session at this time because:
the cluster is currently doesn’t have the capacity to start your JupyterHub job on demand at this time or
you have requested an incompatible set of resources from the Spawner options form or
the job scheduler allocates you resources on cluster nodes but the Jupyter server software cannot start for some reason.
To determine if the third of these possibilities is the case
look at the most recent messages written to the .jupyterhub.sge.out log file in your home directory.
7.1.2. I encounter errors when trying to create/modify environments via the Conda tab in Jupyter
This is a known issue that will hopefully be resolved in future. For now create and modify conda environments from the command-line.
7.3. Less common issues
7.3.1. I get a ‘503’ error after logging in to JupyterHub
If you modify the PYTHON_PATH variable in your .bashrc file your Jupyter server may not start correctly.
The solution to this is to remove these lines from your .bashrc file.
Also, if you have previously tried installing and running Jupyter yourself
(i.e. not using this JupyterHub interface) then you may get 503 errors when
connecting to JupyterHub due to the old .jupyter profile in your home
directory; if you then
find a Jupyter log file in your home directory containing SSL
WRONG_VERSION_NUMBER then try deleting (or renaming) the .jupyter
directory in your home directory.