...
Although Argon is unsuitable for providing a full JupyterHub installation, you can run a Jupyter notebook on an Argon compute node and connect a web browser to it. This connection requires creating a network path, consisting of at least one SSH tunnel, between the compute node system running your notebook and the computer system running the web browser. If you want Thus to use a browser running on your local computer, then one end of the tunnel needs to be on your computer.
The required SSH software and configuration are typically present on Linux and Mac workstations/notebooks by default, so the instructions on this page describing tunnel configuration should function there without additional configuration. A variation commonly used on Windows systems is also shown. The instructions on this page for selecting a Python environment , using the scheduler to request a compute node, and running jupyter are tailored specifically for specific to the Argon HPC system.
For most Argon use, it's typical to connect to "argon.hpc.uiowa.edu", resulting in a login session on whichever of Argon's login nodes least recently served a new connection. However, to configure the tunnel for your jupyter notebook connection, you must ensure you consistently connect to the same login node in multiple steps. Therefore, for each connection you should use the "true" name one of Argon's login nodes instead of "argon.hpc.uiowa.edu":
- argon-login-1.hpc.uiowa.edu
- argon-login-2.hpc.uiowa.edu
- argon-login-3.hpc.uiowa.edu
- argon-login-4.hpc.uiowa.edu
The example here assumes shows how to connect using the browser on your local computer, and uses argon-login-1.hpc.uiowa.edu only as a specific example.
| Note |
|---|
For simplicity in illustrating tunnel setup, this particular example runs an instance of jupyter notebook on a login node. This arrangement is only suitable for visualizing data sets of modest size without additional processing. More generally, you should run jupyter notebook in a qlogin session on a compute node, in which case the simplest arrangement is to log into an Argon login node using FastX and use Firefox there. More elaborate arrangements are possible using more complex tunnel setup than illustrated here. |
First, connect to your chosen login node:
...
| Info |
|---|
You can start the jupyter notebook in a screen or tmux session so that you can detach the terminal. See Screen and Tmux for more information. |
The port number is essentially a public address which anyone can use, even unintentionally (by typo, for example). The token is like a password; it only applies to the specific notebook running there (the one you launched just now), and it prints only in your specific terminal.
...