JupyterHub spawns, manages multiple instances of the single-user Jupyter notebook server. The Jupyter notebook server is run on the interactive psana nodes to allow direct access to LCLS data.
The Jupyter notebooks are running python kernels from the new Conda Release System. It is possible to run both Python 2 and Python 3 kernel, but only Python 2 provides the LCLS psana analysis package.
Users can login with their unix account to start a new jupyter notebook server.
NOTE: The jupyterhub web interface by default will only allow you to navigate to subdirectories of your home directory (see https://github.com/jupyter/notebook/issues/2032 for the reasoning behind this decision). If you want to navigate to another directory that is not underneath your home directory, run a script like this in your home directory to make a softlink that you can click on in the jupyterhub web interface:
Code Block
import os
os.symlink("/reg/d/psdm/xpp/xpptut15","xpptut15")
511 Error
If you try to start a server and see a "511 error" it is often an indication that your ssh keys are too old (or non-existent). When that happens you need to generate new keys by running this script:
JupyterHub spawns, manages multiple instances of the single-user Jupyter notebook server. The Jupyter notebook server is run on the interactive psana nodes to allow direct access to LCLS data.
The Jupyter notebooks are running python kernels from the new Conda Release System. It is possible to run both Python 2 and Python 3 kernel, but only Python 2 provides the LCLS psana analysis package.
JupyterHub is a web service and is available at:
https://pswww.slac.stanford.edu/jupyterhub/hub/home
Users can login with their unix account to start a new jupyter notebook server.
NOTE: The jupyterhub web interface by default will only allow you to navigate to subdirectories of your home directory (see https://github.com/jupyter/notebook/issues/2032 for the reasoning behind this decision). If you want to navigate to another directory that is not underneath your home directory, run a script like this in your home directory to make a softlink that you can click on in the jupyterhub web interface:
import os os.symlink("/reg/d/psdm/xpp/xpptut15","xpptut15")511 Error
If you try to start a server and see a "511 error" it is often an indication that your ssh keys are too old (or non-existent). When that happens you need to generate new keys by running this script:
Managing Jupyterhub Service
JupyterHub is running on machine: psanasvc01
log file is here:
/reg/g/psdm/sw/jupyterhub/psjh/jupyterhub-slac/run.log
To start / stop / restart JupyterHub with supervisord on psanasvc01:
supervisorctl -c /reg/g/psdm/psdatmgr/bin/supervisord_psanasvc01_jupyter.conf
and then type: stop jupyerhub or start jupyterhub
The code for running JupyterHub at SLAC is developed at:
https://github.com/slac-lcls/jhub