TODO: this README is out of date, needs to be cleaned up

Server Setup

Instructions

SSH into Hypervisor
use Git to clone this repository and move into the terraform directory
Run the following 3 commands:
- terraform init
- terraform plan
- terraform apply
Navigate to the ansible directory
run setup target from Makefile
Use ansible to setup hub using the commands that would be equivalend to
- make ansible/setup > gets external roles
- make hub/init > updates kernel
- make hub/apply > builds JupyterHub (this is the step we are iterating over
ansible hub - iterate here until ltiauth is working

eventually terraform state file needs to live in an S3 bucket

ssh stty2u@<hypervisor address>
virsh list
virsh domifaddr <name>

ls ../keys/id_syzygy_stat
ssh -i <ip addr of hub>

To Check

Is the pre-spawn hook defined in the correct place?

ansible/roles/internal/jupyterhub/templates/jupyterhub_config_base.py.j2

Do we need to use this for the hub_ip?

from jupyter_client.localinterfaces import public_ips
c.JupyterHub.hub_ip = public_ips()[0]

Is pycurl isntalling correctly?

If not:

sudo yum install python36u-devel openssl-devel
PYCURL_SSL_LIBRARY=openssl sudo -E pip3.6 install pycurl

Did I set the Apache proxy header correctly?

  <Location /jupyter>
    ProxyPass http://127.0.0.1:8000/jupyter
    ProxyPassReverse http://127.0.0.1:8000/jupyter
    ProxyPreserveHost on
    RequestHeader set X-Forwarded-Proto "https"
  </Location>

Should we update and upgrade git? Yes!
To specify at runtime:
- Canvas API Token
- LTI Consumer Key
- LTI Consumer Secret
- put it in a file that is in the same place as the ssh keys
Can we specify the course name?
- incorporate course name into zfs role
- store as host or group variable (list of courses we will have)
- example: see local_vars.yml (we could encrypt this...)
Is ltiauthenticator installing?

Is this yaml file being sourced, and if not, how would it be?
```
ansible/roles/internal/ltiauthenticator/main.yml
```

Grading Server:

pip install rudaux
pip install nbgrader

sudo jupyter nbextension install --sys-prefix --py nbgrader --overwrite
sudo jupyter nbextension enable --sys-prefix --py nbgrader
sudo jupyter serverextension enable --sys-prefix --py nbgrader

Rebuilding the environment

Here are temporary instructions for rebuilding the hub and marker environments from scratch

  $ cd dsc100-infra-ian/terraform/prod
  $ terraform init
  $ terraform plan
  $ terraform apply
  $ cd ../../ansible/
  $ make env=prod hub/init
  $ make env=prod hub/apply

lheagy / dsci-100-infra