external/iiab
1
0
Fork 0
mirror of https://github.com/iiab/iiab.git synced 2025-02-13 11:42:08 +00:00
Code Issues Releases Wiki Activity
iiab/roles/jupyterhub/README.md
root d26a8a8901 JupyterHub: lint, refine, document
2021-09-01 01:13:55 -04:00

4.1 KiB
Raw Blame History

JupyterHub programming environment with student Notebooks

Secondary schools may want to consider JupyterHub to integrate coding with dynamic interactive graphing — A New Way to Think About Programming — allowing students to integrate science experiment results and program output within their own blog-like "Jupyter Notebooks."

  • Jupyter Notebooks are widely used in the scientific community:
  • Students create their own accounts on first use — e.g. at http://box.lan/jupyterhub — just as if they're logging in regularly (unfortunately the login screen doesn't make that clear, but the teacher does not need to be involved!)
    • A student can then sign in with their username and password, to gain access to their files (Jupyter Notebooks).
    • The teacher should set and protect JupyterHub's overall Admin password, just in case. As with student accounts, the login screen doesn't make that clear — so just log in with username Admin using any password that you want to become permanent.
  • Individual student folders are created in /var/lib/private/ on the Internet-in-a-Box (IIAB) server:
    • A student will only be able to see their own work — they do not have privileges outside of their own folder.
    • Students may upload Jupyter Notebooks to the IIAB server, and download the current state of their work via a normal browser.

Settings

Linux administrators please see /opt/iiab/jupyterhub/etc/jupyterhub/jupyterhub_config.py which originates from:

https://github.com/iiab/iiab/blob/master/roles/jupyterhub/templates/jupyterhub_config.py

Note that /opt/iiab/jupyterhub is a Python 3 virtual environment, that can be activated with the usual formula:

source /opt/iiab/jupyterhub/bin/activate

Users changing their own password

Users can change their password by first logging into their account and then visiting URL: http://box.lan/jupyterhub/auth/change-password

This is the only way to change the Admin user's password, because the Control Panel > Admin (below) does not permit deletion of the Admin account. It will be necessary to restart JupyterHub before the changed password becomes effective:

sudo systemctl restart jupyterhub

Control Panel > Admin page, to change user passwords

Admin users can reset user passwords by deleting the user from the JupyterHub Admin page. This logs the user out, but does not remove any of their data or home directories. The user can then set a new password by logging in again with a new password.

  1. As an Admin user, click Control Panel in the top right of your JupyterHub.

    Control panel button in notebook, top right

  2. In the Control Panel, open the Admin link in the top left.

    Admin button in control panel, top left

    This opens up the JupyterHub Admin page, where you can add / delete users, start / stop peoples’ servers and see who is online.

  3. Delete the user whose password needs resetting. Remember this does not delete their data or home directory.

    Delete user button for each user

    If there is a confirmation dialog, confirm the deletion. This will also log the user out if they were currently running.

  4. Re-create the user whose password needs resetting within that same dialog.

  5. Ask the user to log in, but with a new password of their choosing. This will be their password going forward.

PAWS/Jupyter Notebooks for Python Beginners

While PAWS is a little bit off topic, if you have an interest in Wikipedia, please do see this 23m 42s video "Intro to PAWS/Jupyter notebooks for Python beginners" by Chico Venancio, from 2021-06-01.

He explains PAWS as a "powerful Python execution environment http://paws.wmcloud.org [allowing] ordinary folks to write interactive scripts to work with Wikimedia content."