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

• https://docs.google.com/document/d/1GUUyZIH5TWW2SkzDbFtApJrGrJlRlJKRpSDw_1qoDr0/edit?usp=sharing

• Get the current VM: https://s3-us-west-1.amazonaws.com/internet2-tier-appliance-us-west-1/grouper-appliance-centos7-ova-1473894412.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
  
  
   

• Follow instructions in the README.md

• Port forward 8080 in the virtual box main settings

• Install packages?
  
  

  # yum -y install mlocate
  # yum -y install emacs
  # ln -s /opt/grouper/2.3.0/apache-tomcat-6.0.35/bin/startup.sh ~/bin/tomcat_startup.sh
  # ln -s /opt/grouper/2.3.0/apache-tomcat-6.0.35/bin/shutdown.sh ~/bin/tomcat_shutdown.sh
  
  

• Start things on boot of image (after building)
  
  

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

• Interact with docker
  
  

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

• 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