BinAC/Software/Jupyterlab: Difference between revisions

From bwHPC Wiki
Jump to navigation Jump to search
No edit summary
No edit summary
Line 72: Line 72:
After a successfull authentication the SSH tunnel is ready to use.
After a successfull authentication the SSH tunnel is ready to use.
The ssh command does not return a result.
The ssh command does not return a result.
If there is no error message everything should be fine (see image below).
If there is no error message everything should be fine:


[[File:Binac_jupyterlab_ssh_tunnel_linux.png | 800px | center | Creation of SSH tunnel on Linux]]


=== Windows Users ===
=== Windows Users ===


TODO
...


== Access JupyterLab ==


JupyterLab is now running on a BinAC compute node and you created an SSH tunnel from your workstation to that compute node.
Open a browser and copy the URL with the access token into the address field:


[[File:Binac_jupyterlab_browser_url.png | 800px | center ]]


== Access JupyterLab ==
Your browser should now display the JupyterLab user interface:


[[File:Binac_jupyterlab_browser_lab.png | 800px | center ]]
The Jupyterlab output file also contains a direct link to your Jupyterlab:

<pre>
cat JupyterLab.o11604591
[...]
Or copy and paste one of these URLs:
[...]
http://127.0.0.1:18617/lab?token=<your token>
</pre>


== Stop Jupyterlab ==
== Stop Jupyterlab ==

TODO


== Add new Kernels ==
== Add new Kernels ==

TODO


== Set
== Set

Revision as of 17:14, 25 July 2024

The main documentation is available via module help devel/jupyterlab on the cluster. Most software modules for applications provide working example batch scripts.


Description Content
module load devel/jupyterlab
License JupyterLab License
Links Homepage
Graphical Interface Yes

Description

JupyterLab is a web-based interactive development environment for notebooks, code, and data.

Usage

Start Jupyterlab

The module provides a job script for starting a JupyterLab instance on the BinAC inter queue. Load the module and copy the job script into your workspace:

module load devel/jupyterlab/7.2.1
cp $JUPYTERLAB_EXA_DIR/jupyterlab.pbs.template jupyterlab.pbs

You can adjust the following settings in the job script according to your needs.

#PBS -l nodes=1:ppn=1          # adjust the number of cpu cores (ppn)
#PBS -l mem=2gb
#PBS -l walltime=6:00:00

Please note the restrictions of the inter queue:

  • max. walltime: 12 hours
  • max. cores: 28
  • max jobs per user: 1

Then submit the job.

jobid=$(qsub jupyterlab.pbs)

Create SSH tunnel

The compute node on which JupyterLab is running is not reachable from your workstation. Hence you have to create an SSH tunnel from your workstation to the compute node through a BinAC login node.

The job's standard output file (Jupyterlab.<jobid>) contains the SSH command for this tunnel. Please note that details like IP, port number, and access URL will vary.

cat JupyterLab.o${jobid}
Jupyterlab connection info

Linux Users

Copy the ssh -N -L ... command and execute it in a shell on your workstation. After a successfull authentication the SSH tunnel is ready to use. The ssh command does not return a result. If there is no error message everything should be fine:

Creation of SSH tunnel on Linux

Windows Users

TODO

Access JupyterLab

JupyterLab is now running on a BinAC compute node and you created an SSH tunnel from your workstation to that compute node. Open a browser and copy the URL with the access token into the address field:

Binac jupyterlab browser url.png

Your browser should now display the JupyterLab user interface:

Binac jupyterlab browser lab.png

Stop Jupyterlab

TODO

Add new Kernels

TODO

== Set