8. JupyterHub on Yen Servers
Web-based computing is available on the interactive Yen servers with JupyterHub without the need to
ssh from the terminal. JupyterHub is a platform designed to allow multiple users to launch their own JupyterLab instances on a shared system with minimal user effort.
It also gives you a terminal, file browser and a way to run Jupyter notebooks with several language kernels including Python 3, R, Julia, MATLAB, SAS, and Stata.
To get started, open a web browser and visit one of the following links for each server:
- Yen1 https://yen1.stanford.edu/jupyter
- Yen2 https://yen2.stanford.edu/jupyter
- Yen3 https://yen3.stanford.edu/jupyter
- Yen4 https://yen4.stanford.edu/jupyter
- Yen5 https://yen5.stanford.edu/jupyter
You will need to login with your SUNet credentials, and then click on
Start My Server. From there, you will have access to the web-based computing services available.
yen server are independent of each other! If you launch a server on
yen3, it will only use resources available on
Features of JupyterHub
We recommend taking a look at the official documentation for JupyterHub if you have any questions on the features below!
The JupyterLab interface looks like:
The front panel has a Launcher interface from which you can start notebooks with different language kernels and custom environment kernels.
Notebooks allow you to write code and execute it on the yens in your web browser.
Code is written into cells, which can be run in any order, on demand.
You can also include text, images, and plots to make your code read like a lab notebook.
Contact the DARC team if you have a language you would like installed.
Note: If you do not see Julia as an option under Notebooks, see this page on how to add it.
RStudio GUI is also available! Clicking this link will bring up a new tab with a web-based RStudio on the Yens.
If you opened up a notebook and want to get back to the Launcher interface to launch other software as well, click the “+” button in the upper left corner:
You can launch interactive consoles from JupyterHub. These will behave very similar to the versions on the Yen servers.
You can launch a terminal from JupyterHub. This provides access to commands you would normally run on the command line on the Yens, but through the web browser. However, we have seen issues with JupyterHub terminal (as well as VSCode) that modifies or overwrites python paths and environment variables so for package installations, we recommend using a terminal outside of JupyterHub.
Let’s open up a Terminal and make a new directory where the scripts for this class will live.
$ mkdir intro_yens_sep_2023
$ mv investment-npv-parallel.R intro_yens_sep_2023
We moved the script
investment-npv-parallel.R into the newly created directory,
The JupyterHub instances will automatically launch from your home directory on the Yens. Your home directory is a file icon shown by the red arrow:
The current directory is also displayed:
Clicking on the home icon (folder icon), returns the file browser back to your home where you can access any directories that are accessible from your home on the Yens.
Double click on the
zfs directory in your home directory to navigate to your ZFS project files.
File Upload and Download
One very useful feature of JupyterHub is the ability to upload and download files from ZFS. First, make sure you are in the proper directory. Then, to upload, click the up arrow on the top left of your screen to select a file from your local machine ot upload to the Yens.
To download, right click the file you would like to download to your local machine, and click “Download”.
JupyterHub loads packages found in your
If you wish to install Python packages to be available in a JupyterHub notebook, we recommend using Python
The following limits will be imposed on JupyterHub servers:
JupyterHub instance will shut down after 3 hours idle (no notebooks actively running code).
If your processes require more than these limits, reach out to the DARC team for support.
Text File Editor
Finally, you can also edit text files like R scripts directly on JupyterHub. Clicking on Text File icon will open a new file that you can edit. Similarly, clicking on Python File will create an empty
.py file and clicking on R File will create an empty
You can also navigate to a directory that has the scripts you want to edit and double click on the script name to open it up in the Text Editor.
For example, navigate to
intro_yens_sep_2023 folder in file brower first then double click on
investment-npv-parallel.R file to open it in the text editor: