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.

https://github.internet2.edu/docker/grouper/blob

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

...

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

Jankins log

Latest instructions

• Download the latest VM: . Get the link from https://s3-us-west-1.amazonaws.com/internet2-tier-appliance-us-west-1/TIER-grouper-appliance-centos7-ova-17070.tarspaces.at.internet2.edu/x/DQfSBQ
• Setup networking if you need to, I dont don't have DHCP so I needed to do a NETnetwork and do some port forwarding...
• SSH with putty or something to port 22, grouper/grouper
• Run: /home/grouper/work/setup.sh
  • I used localhost as domain name
• Run: /home/grouper/build/grouper/bin/build.sh 
• Run: /home/grouper/run/bin/run.sh

• (shouldnt have to do this) Start tomcat:
  
  

  Code Block
  [grouper@localhost run]$ sudo docker exec -i -t grouper /bin/bash bash-4.2# /opt/grouper/2.3.0/apache-tomcat-8.5.12/bin/startup.sh

  
  
  

• s

...

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

• Get the current VM: . Get the link from https://s3-us-west-1.amazonaws.com/internet2-tier-appliance-us-west-1/TIER-grouper-appliance-centos7-ova-17070.tarspaces.at.internet2.edu/x/DQfSBQ

• Close background applications on your workstation for memory reasons
  

• Load the VM in virtualbox (Import the OVA, do not start the VM at this point)

• Setup networking in VM in virtualbox
   ( A NAT network is suggested, but not specifically required.) 

  
  
  

• Add some settings to the VM configuration

  

• Port forward 22,8080,3306 in the virtual box Network settings (Assuming you are using a NAT network. Other Network configs may not require/allow ports to be forwarded.)

• Now you should be ready to start the VM. So start it up.
• You may want to login through an external SSH client. ( like putty or securecrt etc)
  • NOTE: The virtualbox ssh client cant copy/paste because the Virtual Box Guest Additions (vm client tools) have not been loaded into the OS by default.
  • Note, you might need to disable authn in your ssh client for anything not user/pass
• Login, grouper/grouper, type ifconfig, get the ip address of enp0s3

• Follow instructions in the README.md ( located at /home/grouper/README.md  See the file for details for the following sections.)

  • Optional: Config HTTPS/SSL
    • If you want to you can provided a proper SSL cert for the VM by following this part of the instructions. 

  • Agree to the Oracle JDK ToS ( by editing the file install_oracle_jdk.sh  NOTE: This file is executed as part of the next step, so just edit it here.)

    Code Block
    [grouper@localhost ~]$ emacs /home/grouper/build/grouper/additional_container_files/bin/install_oracle_jdk.sh

    
    

  • Build the Grouper container

    Code Block
    [grouper@localhost ~]$ /home/grouper/build/grouper/bin/build.sh

    
    

  • Change Service Passwords

    Code Block
    [grouper@localhost ~]$ emacs /home/grouper/run/conf/common.env [grouper@localhost ~]$ emacs /home/grouper/run/conf/grouper.env [grouper@localhost ~]$ emacs /home/grouper/run/conf/db.env

    
    

  • Run the Grouper Service

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

    
    

• NOTE: Now you have the service on 8080 ( and optionally 8443 if SSL is up)  and running!

...