Changes between Version 11 and Version 12 of cypress/JupyterNode

Timestamp:

06/10/2026 02:03:06 PM (42 hours ago)

Author:

fuji

Comment:

--

cypress/JupyterNode

@@ -1 @@
-== Jupyter Notebook ==
+= Jupyter Notebook =
 The ​[https://jupyter.org/ Jupyter Notebook] is a web application that allows you to create and share documents that contain live code, equations, visualizations, and explanatory text.
+== Option 1 ==
+=== 1. Getting started ===
+On Cypress, download the script.
+{{{
+git clone https://gitlab.tulane.edu/fuji/launchjupyter.git
+}}}
+Copy LaunchJupyter.sh to the directory where you want to run the Jupyter Notebook, and edit it to customize the resource request to your needs. The default settings are shown below:
+{{{
+#SBATCH --qos=normal             # Quality of Service
+#SBATCH --partition=centos7      # partition
+#SBATCH --job-name=jupyter       # Job Name
+#SBATCH --time=8:00:00           # WallTime
+#SBATCH --nodes=1                # Number of Nodes
+#SBATCH --ntasks-per-node=1      # Number of tasks (MPI processes)
+#SBATCH --cpus-per-task=20       # Number of threads per task (OMP threads)
+#SBATCH --mem=128000             # Request 128GB RAM
+}}}
 
+=== 2. Submit a job ===
+{{{
+sbatch LaunchJupyter.sh
+}}}
+You can log out after submitting the job. You will receive an email once the job becomes active.
+
+3. Read Jupyter Notebook Access Information Email
+
+Once the job becomes active, you will receive an email like below:
+{{{
+Jupyter is running at cypress01-058
+token: 38e3c6cdf28b9d691677882cfcf62fbd217d35e1de7cc909
+
+Open a terminal and run the following command to create an SSH tunnel:
+ssh -L 8888:127.0.0.1:8888 -J [email protected] cypress01-058
+
+Copy and paste below to your web browser to access Jupyter Notebook:
+http://127.0.0.1:8888/?token=38e3c6cdf28b9d691677882cfcf62fbd217d35e1de7cc909
+}}}
+
+=== 4. Create an SSH Tunnel ===
+
+Open a terminal and run the command in the email, for example,
+{{{
+ssh -L 8888:127.0.0.1:8888 -J [email protected] cypress01-058
+}}}
+This will create an SSH tunnel from your local computer to the Cypress computing node.
+You may need to type a password to login Cypress.
+
+=== 5. Access Jupyter Notebook ===
+
+After logging in, keep the terminal open. Copy and paste the URL from the email into your web browser, or click the link to access the Jupyter Notebook.
+
+==== When SSH connection lost ====
+
+When your SSH tunnel session is disconnected, you can still access your Jupyter Notebook session as long as the job is still running. If this happens, recreate the SSH tunnel and reload your web browser or reconnect using the original URL.
+
+==== Quit Jupyter Notebook Session ====
+
+Click the “Quit” button located at the upper-right corner of the Jupyter Notebook interface.
+
+
+
+== Option 2 ==
 1. Login to Cypress with port-forwarding
 {{{