Grouper Training Environment developer notes

Design

Zoom standards

1. Make a recurring meeting starting 5am on start day for 24 hours, recurring for the number of days the training is
2. Meeting should have a 6 digit numeric password
3. Do not post links for the zoom coordinates except in private locations like meeting requests and slack pins

4. For alternative hosts list
   
   

   mchyzer@isc.upenn.edu,emurtha@internet2.edu,chubing@internet2.edu,emily@internet2.edu

5. Video on for hosts and participants
6. Enable join before host
7. Mute participants on entry
8. Disable waiting room
9. Do not require authenticated participants
10. Record meeting automatically in the cloud
11. Slack the link with password, meeting id, and password to Erin (or whoever is managing the pins)
12. For the June training, ChrisHy is Main meeting, Bill is breakout #1, ChrisHu is breakout #2, Emily is breakout #3

Example pin of zoom (not actual links, those are in pin in slack)

Kahoot standards

1. Use the Grouper Training folder
2. For courses, use a section folder (e.g. 101)
3. For quizzes, name with this convention: GTE 101.1: Grouper Basics
4. Do not list answers in slides
5. Do keep the questions in slides (in case Kahoot goes away)
6. Its not clear how to mute Kahoot.  Right click on tab in browser and "mute site" e.g. in chrome
7. During the training, trainers should not take the quiz, as it will skew the results

Hands on copy/paste standards

1. For a course, make a hands on wiki under this page
2. Each thing to copy paste should be in a code block
3. For each slide that has something to copy/paste, link the first word to that course's copy/paste wiki

Schedule

GTE development

Google doc with to do's: https://docs.google.com/document/d/1JLCuGm9pHWOirfdZmkrVsY8OlQSdaju8ldGzlUY4bnc/edit

The current working branch for November 2019 training is "201911". https://github.internet2.edu/docker/grouper_training/tree/201911.

This branch is automatically built on every commit and pushed to dockerhub, with the branch name appended to the image tags.  https://hub.docker.com/r/tier/gte/tags.

To work on updates:

1. create a feature branch off of 201911 (eg. 201911-201-updates).
2. update ./gte line 12 with your branch name (eg. replace "201911" with "201911-201-updates").
3. make local chances to exercises and content
4. run ./manualBuild.sh in whatever ex### directory you are working in. this will create docker images based on your branch name
5. run ./gte 201.1.1 (this will start the correct local version based on your branch name and link to rabbitmq)
6. test/review changes at https://localhost:8443/grouper
7. push local commits/branch to github
8. Merge changes into needed branch when completed.
   1. Log into github and go to "Branches"
   2. Choose "New pull request" on your feature branch
   3. Make sure to update base: master to base: 201911
   4. Add comment and choose "Create pull request" underneath comment section
   5. Choose "Merge pull request"
   6. Choose "Confirm Merge"
   7. Choose "Delete Branch" if done with feature branch.

Developer flow looks like this:

1. make local changes
2. ./manualBuild.sh - build local docker images with tags based on branch name
3. docker ps - check to see what's running.
4. docker stop 201.1.1 - stop an image
5. ./gte 201.1.1 - start an image
6. test/review changes at https://localhost:8443/grouper
7. repeat.

docker restart rabbitmq
./gte 101.1.1

$ docker logs 101.1.1 to bide the time.
$ ./gte-shell 101.1.1

stop

list of sections:

https://docs.google.com/spreadsheets/d/1Emf79h–2lmfSxaNgjVu5lRcboJ1IWkwSmh_6E5T2lo/edit#gid=0

Final date to get new patches from Grouper: June 3rd.  (maybe 7th).  Babb clone VMs on 10th.

Run locally or from docker hub.

docker exec -it {container name} /bin/bash; cd bin; gsh;

https://github.internet2.edu/docker/grouper_training/tree/202006

GTE commands

Grouper email list: grouper-2019-06 at internet2 dot edu

gte $ git clone https://github.internet2.edu/docker/grouper_training.git
grouper_training $ git checkout 201906
grouper_training $ ./manualBuild.sh 

https://github.internet2.edu/docker/grouper_training/blob/202006/README.md

Google drive for slides: https://drive.google.com/drive/u/0/folders/1irHccRqkfrwkeXpA2ayQPEt2PlI67Cx5

Course outline: https://docs.google.com/document/d/1o8siMrRxZm1M_DgDQ5qu6jZEE4mb4MODxfQVvIxG508/edit

Tracking sheet: https://docs.google.com/spreadsheets/d/1A5Eok-GWBJS4zMwsAvS7k0YEkR4OnZz-74B_yRLeRPg/edit#gid=0

Folder for pres: https://drive.google.com/drive/u/0/folders/1irHccRqkfrwkeXpA2ayQPEt2PlI67Cx5

Dec 2019 Temple training notes: https://docs.google.com/document/d/1nfkt8tgv05F_fQwdQc5Ru_A4tv79FFl7JdeAq3tO3rI/edit#heading=h.2zrn2o90s27q

Canvas: https://internet2.instructure.com/

Module Guide: https://docs.google.com/spreadsheets/d/1kfM1QkqQZ9oNFsFm6X5FEye6dMXHPl0Has5HAszj1A0/edit#gid=0

Drive Folder: https://drive.google.com/drive/u/0/folders/1lsXmAfE5bVgfbRXowRFHELkHzl553LHw

LMS Needs for Grouper: https://docs.google.com/document/d/1c_hqXvKIfuUFmiUoGVMyAaKyuJSPZF1nbOmddkgvbtA/edit#heading=h.xq1bphtw3tjm

Notes for later

SSH command easier to access

Wil Cooley  1:37 AM
FYI, for those on Linux/Mac (or otherwise using a command-line OpenSSH) if you want to not have to remember the IP address of your VM or type the extra options for remote username and port forward, you can throw something like the following into ~/.ssh/config:
Host grouper-training
  Hostname 18.218.158.77
  User student
  LocalForward 8443 localhost:8443
  PermitLocalCommand true
  LocalCommand python -m webbrowser -t https://localhost:8443
1:42
You need to have session multiplexing (ControlMaster et al) setup elsewhere though, or you’ll get errors trying to make more than one connection (not to mention spawn a bunch of open tabs).
And if you have SSH keys, ssh-copy-id grouper-training so you can forget the password too… (edited)