Opening sessions

Jupyter notebooks based sessions

Open from command line

You can open Jupyter notebook sessions from the REANA-Client as follows:

$ reana-client open jupyter -w helloworld
==> SUCCESS: Interactive session opened successfully
https://reana.cern.ch/f8be55e4-5d18-43f9-b977-f773fdcab163?token=<your-reana-token>
It could take several minutes to start the interactive session.
Please note that it will be automatically closed after 7 days of inactivity.

Warning

REANA administrators can configure REANA to automatically close inactive interactive sessions after a given period of inactivity. As shown in the previous example, when you start an interactive session, you will be informed about how long your inactive sessions will be kept open before they are automatically closed. You can read more about this in the closing sessions section.

By default, newly opened sessions will use the jupyter/scipy-notebook:notebook-6.4.5 Docker image to spawn your notebook. You can supply your desired image by passing it to the previous command with the -i/--image option:

$ reana-client open -w jupyter --image jupyter/scipy-notebook:notebook-6.4.7
==> SUCCESS: Interactive session opened successfully
https://reana.cern.ch/f8be55e4-5d18-43f9-b977-f773fdcab163?token=<your-reana-token>
It could take several minutes to start the interactive session.

By clicking on the link you will have access to a Jupyter notebook interface:

jupyter-notebook

Note

Keep in mind that this operation might take a minute, if you see "Service unavailable", just wait and retry.

Open from web interface

Alternatively, you can also open Jupyter notebook sessions from the REANA web interface by going through a list of your workflows and clicking on the vertical ellipsis menu on the right-hand-side and selecting "Open Jupyter Notebook":

ui-open-session

When a workflow has an associated Jupyter notebook session opened, a Jupyter icon will appear next to the workflow name; you can then click on it to access the notebook.