Access the JupyterHub Slurm Server - Revision history

Weiler: /* The Live Notebook */

2026-05-23T01:11:04Z

The Live Notebook

← Older revision		Revision as of 18:11, 22 May 2026
Line 40:		Line 40:

	[[File:Live_notebook.png\|1200px\|frame\|left\|Login Page]]		[[File:Live_notebook.png\|1200px\|frame\|left\|Login Page]]

			If the slurm queue is full, you may be waiting a while.

	This is a notebook actually running on one of the cluster nodes, but the connection is proxied through the head node, and you are seeing it in your web browser. You can actually see your job running in slurm by looking at the output of the '''squeue''' command, if you are curious.		This is a notebook actually running on one of the cluster nodes, but the connection is proxied through the head node, and you are seeing it in your web browser. You can actually see your job running in slurm by looking at the output of the '''squeue''' command, if you are curious.

Weiler: /* Terminate Your Notebook When Finished */

2026-05-23T01:10:18Z

Terminate Your Notebook When Finished

← Older revision		Revision as of 18:10, 22 May 2026
Line 48:		Line 48:

	If you simply click "Logout", or "File -> Logout", it will log you out, but your notebook is still running! So next time you log in, it will take you right back to that notebook. If you are truly done, then kill your notebook via '''Stop My Server''' as described above.		If you simply click "Logout", or "File -> Logout", it will log you out, but your notebook is still running! So next time you log in, it will take you right back to that notebook. If you are truly done, then kill your notebook via '''Stop My Server''' as described above.

			If slurm sees the job is still running when the job's wall time is exceeded, slurm will kill your notebook automatically.

Weiler: /* Terminate Your Notebook When Finished */

2026-05-23T01:09:06Z

Terminate Your Notebook When Finished

← Older revision		Revision as of 18:09, 22 May 2026
Line 46:		Line 46:

	When you are done, don't forget to terminate your notebook to free up the Slurm resources it was using! To close your notebook, click on '''File -> Hub Control Panel'''. Then from there click the red '''Stop My Server''' button. Your notebook will terminate and the associated Slurm job will also exit.		When you are done, don't forget to terminate your notebook to free up the Slurm resources it was using! To close your notebook, click on '''File -> Hub Control Panel'''. Then from there click the red '''Stop My Server''' button. Your notebook will terminate and the associated Slurm job will also exit.

			If you simply click "Logout", or "File -> Logout", it will log you out, but your notebook is still running! So next time you log in, it will take you right back to that notebook. If you are truly done, then kill your notebook via '''Stop My Server''' as described above.

Weiler at 00:57, 23 May 2026

2026-05-23T00:57:42Z

← Older revision		Revision as of 17:57, 22 May 2026
Line 39:		Line 39:
	Once you start your notebook (give it some time, it can take 10-20 seconds to start based on your environment and resource requests), you should see your notebook appear as something like this in your web browser:		Once you start your notebook (give it some time, it can take 10-20 seconds to start based on your environment and resource requests), you should see your notebook appear as something like this in your web browser:

	[[File:~~Notebook~~.png\|1200px\|frame\|left\|Login Page]]		[[File:Live_notebook.png\|1200px\|frame\|left\|Login Page]]

	This is a notebook actually running on one of the cluster nodes, but the connection is proxied through the head node, and you are seeing it in your web browser. You can actually see your job running in slurm by looking at the output of the '''squeue''' command, if you are curious.		This is a notebook actually running on one of the cluster nodes, but the connection is proxied through the head node, and you are seeing it in your web browser. You can actually see your job running in slurm by looking at the output of the '''squeue''' command, if you are curious.

Weiler at 00:55, 23 May 2026

2026-05-23T00:55:35Z

← Older revision		Revision as of 17:55, 22 May 2026
Line 31:		Line 31:
	If you need a more specific environment, click on the '''Advanced''' tab, which should yield this screen:		If you need a more specific environment, click on the '''Advanced''' tab, which should yield this screen:

	[[File:~~Advanced_server~~.png\|600px\|frame\|left\|Advanced Server]]		[[File:Advanced_options.png\|600px\|frame\|left\|Advanced Server]]

	This allows for a more fine grained resource definition when requesting resources for your notebook. It also allows for a custom Jupyter environment to be defined, if you need one. The Default environment is fairly basic, so it may make sense to create your own custom environment. If you would like to do that, refer to [[Create a Jupyter Virtual Environment]].		This allows for a more fine grained resource definition when requesting resources for your notebook. It also allows for a custom Jupyter environment to be defined, if you need one. The Default environment is fairly basic, so it may make sense to create your own custom environment. If you would like to do that, refer to [[Create a Jupyter Virtual Environment]].

Weiler at 00:54, 23 May 2026

2026-05-23T00:54:04Z

← Older revision		Revision as of 17:54, 22 May 2026
Line 23:		Line 23:
	You will see this page after logging in, which is the "Simple" setup page:		You will see this page after logging in, which is the "Simple" setup page:

	[[File:~~Simple_server~~.png\|600px\|frame\|left\|Simple Server]]		[[File:Simple_options.png\|600px\|frame\|left\|Simple Server]]

	Here you can define more specific job parameters.		Here you can define more specific job parameters.

Weiler at 00:52, 23 May 2026

2026-05-23T00:52:09Z

← Older revision		Revision as of 17:52, 22 May 2026
Line 13:		Line 13:
	There you will see a login page:		There you will see a login page:

	[[File:~~Jupyter_login~~.png\|1200px\|frame\|left\|Login Page]]		[[File:Signin.png\|1200px\|frame\|left\|Login Page]]

	Login using your regular UNIX username and password.		Login using your regular UNIX username and password.

Weiler at 00:24, 23 May 2026

2026-05-23T00:24:49Z

← Older revision		Revision as of 17:24, 22 May 2026
Line 7:		Line 7:
	You can login to the JupyterHub interface here:		You can login to the JupyterHub interface here:

	https://~~jupyter~~.~~mckenna.edu~~		https://jupyterhub.prism

	Your web browser may complain about a name mismatch on the SSL certificate but you can click past it, the connection is still secure.		Your web browser may complain about a name mismatch on the SSL certificate but you can click past it, the connection is still secure.

Weiler: Created page with "TOC We have a JupyterHub server running on top of Slurm that is very useful for spawning Jupyter Notebooks. == Login to the Hub == You can login to the JupyterHub interface here: https://jupyter.mckenna.edu Your web browser may complain about a name mismatch on the SSL certificate but you can click past it, the connection is still secure. There you will see a login page: Login Page Login using your regular UNIX us..."

2026-05-23T00:23:52Z

Created page with "__TOC__ We have a JupyterHub server running on top of Slurm that is very useful for spawning Jupyter Notebooks. == Login to the Hub == You can login to the JupyterHub interface here: https://jupyter.mckenna.edu Your web browser may complain about a name mismatch on the SSL certificate but you can click past it, the connection is still secure. There you will see a login page: 1200px|frame|left|Login Page Login using your regular UNIX us..."

New page

__TOC__

We have a JupyterHub server running on top of Slurm that is very useful for spawning Jupyter Notebooks.

== Login to the Hub ==

You can login to the JupyterHub interface here:

https://jupyter.mckenna.edu

Your web browser may complain about a name mismatch on the SSL certificate but you can click past it, the connection is still secure.

There you will see a login page:

[[File:Jupyter_login.png|1200px|frame|left|Login Page]]

Login using your regular UNIX username and password.

== Configure Your Notebook ==

Once you login, you can configure your notebook for its required resources in Slurm, and then launch your notebook, which will appear on a node Slurm chooses. If a node is free right then, your notebook will launch immediately. If the Slurm queue is full, you may have to wait for resources to become available.

You will see this page after logging in, which is the "Simple" setup page:

[[File:Simple_server.png|600px|frame|left|Simple Server]]

Here you can define more specific job parameters.

You will want to mostly accept the defaults if running a simple notebook. But if your notebook requires more resources, then kick up the max time or CPU/GPU count as appropriate. Remember Slurm will kill the notebook if it persists past the '''Job Duration''' parameter. Simply click the '''Start''' button on the bottom to launch the notebook.

If you need a more specific environment, click on the '''Advanced''' tab, which should yield this screen:

[[File:Advanced_server.png|600px|frame|left|Advanced Server]]

This allows for a more fine grained resource definition when requesting resources for your notebook. It also allows for a custom Jupyter environment to be defined, if you need one. The Default environment is fairly basic, so it may make sense to create your own custom environment. If you would like to do that, refer to [[Create a Jupyter Virtual Environment]].

== The Live Notebook ==

Once you start your notebook (give it some time, it can take 10-20 seconds to start based on your environment and resource requests), you should see your notebook appear as something like this in your web browser:

[[File:Notebook.png|1200px|frame|left|Login Page]]

This is a notebook actually running on one of the cluster nodes, but the connection is proxied through the head node, and you are seeing it in your web browser. You can actually see your job running in slurm by looking at the output of the '''squeue''' command, if you are curious.

== Terminate Your Notebook When Finished ==

When you are done, don't forget to terminate your notebook to free up the Slurm resources it was using! To close your notebook, click on '''File -> Hub Control Panel'''. Then from there click the red '''Stop My Server''' button. Your notebook will terminate and the associated Slurm job will also exit.