Grouper is packaged in TIER as what the installer delivers on a MySQL (MariaDB) database.  It is a virtualbox image, which creates and runs a docker container.

The instructions handed over the packaging team to setup the applications are here

See the TIER packaging site for more information and download links

Future work includes using Shibboleth for UI authentication, configuring provisioning, user management with COManage, having an upgrade/patch process, TIER API tomee, etc.

Running the current VM

Note, if things freeze Oracle VirtualBox might have run out of resources and paused.  Just go to the main VirtualBox window and click pause to run it again

• https://docs.google.com/document/d/1B8iL8Vm50BbJ4-HaoqjzXrlxa-oiDZpEhvtiQfa7y44/edit# 

• Get the current VM: https://s3-us-west-1.amazonaws.com/internet2-tier-appliance-us-west-1/grouper-appliance-centos7-ova-1479910549.tar 

• Close background applications on your workstation for memory reasons
  

• Setup networking in VM in virtualbox
  
  General settings
   

  
  
  

• Load the VM in virtualbox

• Settings for that VM
  
  
   

• Login, grouper/grouper, type ifconfig, get the ip address of enp0s3

• Follow instructions in the README.md

• Port forward 22,8080,3306 in the virtual box main settings

• Logout and login through putty or securecrt etc (not the virtualbox ssh client that cant copy/paste)
  • Note, you might need to disable authn in your ssh client for anything not user/pass

• Install packages? as root: sudo su -
  
  

  yum -y install telnet yum -y install mlocate updatedb yum -y install emacs

• Start things on boot of image (after building)
  
  

  [grouper@localhost ~]$ cd build/grouper [grouper@localhost grouper]$ ./bin/build.sh [grouper@localhost ~]$ ~/run/bin/run.sh

• Connect to mysql (port forward to 3319), db grouper, user: grouper_user, pass: 3cf0ccc7d6b240390188367933c9cd90

• Interact with docker
  
  

  [grouper@localhost ~]$ docker ps [grouper@localhost ~]$ sudo docker exec -i -t grouper /bin/bash [grouper@localhost ~]$ docker compose up [grouper@localhost ~]$ docker stop grouper [grouper@localhost ~]$ docker start grouper

• sdf
  
  
  

Discussion with Levvel August 1st, 2016

• We will have 3 containers
  • Loader
  • WS
  • UI
• Grouper will continue externalizing configuration so that the subject api and ehcache use configuration properties overlays
• Properties files can be mounted outside the container and specified via env variables
• UI/WS will come with tomcat and apache and ready for shib SP
• Containers will be built with latest patches
  • The container maker can look at release notes page for latest release to see list of patches available

Testing a Grouper container

• At a minimum hit the status servlet on the UI and WS, get a 200 back.  /status?diagnosticType=all
• Note the grouper daemon needs to have been running for a minute or two
• Look at the UI, login, see the Grouper UI, click around a little
• Make a grouper client call to the WS, make sure you get a positive result