MUQ-hIPPYlib Educational Environment

Umberto Villa

This will launch a multi-user MUQ-hIPPYlib environment for classrooms, courses and general fun using Jupyterhub and Jupyter Notebook. Each user has his own home directory.

This scripts are an adaptation of Jake Hale's project available from fenics-jupyter.

Here a list of instructions:

1. (One time only) Install docker. On Ubuntu one can simply enter the command

   apt-get install docker.io
   

2. Build the docker image (This step needs to be repeated each time hippylib or muq is updated)

   sudo docker build -t muq-hippylib/g2s3hub .
   

3. Check that the image was created correctly with the command

   sudo docker images
   

4. Start the server

   sudo docker run -td -p 80:8000 --name=g2s3hub muq-hippylib/g2s3hub
   

5. Check that the server is up

   sudo docker ps
   

6. Check messages from the server

   sudo docker logs g2s3hub
   

7. Update the Lab materials

   docker exec --user root g2s3hub ./update_lab.sh <LabName>
   

8. Stop ad delete the server (always stop the server before rebuilding the docker image)

   sudo docker stop g2s3hub & sudo docker rm g2s3hub