Page History

Design

Slack bookmarks

(include links)

Welcome to Grouper School! Here's some information to keep on hand so that you can access the class resources quickly:

1. Zoom - same Zoom for the course introduction, office hours, and live instruction
2. Canvas: (check link!!!)
3. Pre-Course Survey - tell us what you hope to learn!
4. Training wiki
5. VM credentials
6. VM jump page
7. Text to copy/paste
8. 101 corrections
9. Kahoot
10. Post-course survey

Monday meeting

• intro
• dont email me
• slack bookmarks at top
• multiple screens
• needle of too fast vs too slow
• some sessions might not be applicable (e.g. sysadmin stuff)
• anything not on the agenda you want to cover let us know
• experts can help the people new to grouper
• speed of playback
• camera on
• get the most out of training by
  • doing the prework
  • being available during training
  • doing hands on

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
   
   

   Code Block
   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

Image Added

Schedule

12:00-1:30 - sessions
1:30-1:45 - break
1:45-3:15 - sessions
3:15-3:30 - break
3:30-5:00 - sessions

Example of overriding a file

GET FILE (one time task)
wget https://raw.githubusercontent.com/Internet2/grouper/GROUPER_2_6_BRANCH/grouper-ui/webapp/WEB-INF/grouperUi2/grouperObjectTypes/grouperObjectTypesGroupMoreActionsButtonContents.jsp

EXISTING CONTAINER (retains data, note you only need to restart if you have received the error already)
docker cp grouperObjectTypesGroupMoreActionsButtonContents.jsp 101.1.1:/opt/grouper/grouperWebapp/WEB-INF/grouperUi2/grouperObjectTypes/grouperObjectTypesGroupMoreActionsButtonContents.jsp
docker restart 101.1.1

NEW CONTAINER (deletes data)
./gte --mount="type=bind,source=/home/student/grouperObjectTypesGroupMoreActionsButtonContents.jsp,target=/opt/grouper/grouperWebapp/WEB-INF/grouperUi2/grouperObjectTypes/grouperObjectTypesGroupMoreActionsButtonContents.jsp" 101.1.1

Upgrade environment

docker pull tier/gte:base-202403
docker pull tier/gte:401.end-202403
docker pull tier/gte:201.end-202403
docker pull tier/gte:101.1.1-202403

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://docs.google.com/document/d/1o8siMrRxZm1M_DgDQ5qu6jZEE4mb4MODxfQVvIxG508/edit

The current working branch for June 2019 training is "201906". https://github.internet2.edu/docker/grouper_training/tree/201906201911.

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.

...

1. create a feature branch off of 201906 201911 (eg. 201906201911-201-updates).
2. update ./gte line 12 with your branch name (eg. replace "201906201911" with "201906201911-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 namerun ./start-rabbitmq.sh (this starts rabbitmq, and can be left running. it is required for the ./gte command to work)
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 in to 201906 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: 201906201911
   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.

...

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

Links

Admin notes for 2021: https://docs.google.com/document/d/1ao9isNiUij4L_5oPudukUchYClu1lH6SnaAKsOJpIlM/edit#heading=h.vpz3cm3s553o

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

Command Line Jumpstart for the 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/201906202006/README.md

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

...

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

Training notes: (feb 2021) https://docs.google.com/document/d/1pftf1qkkviWuU9O1eTghIehXjeTdeFfpBzAaBbAsThk/edit
(jun 2021) https://docs.google.com/document/d/12WoWcOCG5uXB52CwM_2xWfK9djsuxrF0bN17J8rTGkU/edit
(sept 2021) https://docs.google.com/document/d/1ClKB-SAkoFQvZb4naEK9IwDHXeD68_w21rRYRnVlsnI/edit
(feb 2022) https://docs.google.com/document/d/10lA1MxSgQjZAoYXpRN79tODaaGKbOdCQFAe-znT7WIg/edit
(may 2022) https://docs.google.com/document/d/1ctUAgEm41SmmORRv3lJfzeUIJZZFYWx1lNOShVO0dKs/edit

TODO for spring 2022

• installer, remove?
• postman client
• smtp external system

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)