Skip to content
Go to file
Latest commit a98f774 Jun 9, 2019 History
2 contributors

Users who have contributed to this file

@wgthom @dima767
72 lines (51 sloc) 2.84 KB

Grouper Training Environment

The Grouper Training Environment (gte) is a set of docker images that contain all the software components, configuration, and setup necessary to complete the InCommon Grouper Training course. Each docker image tag coincides with a particular course, exercise, step, and the overall gte version. For example, the gte image tag for Grouper Basics 101 is 101.1.1-201906. The docker command to run the image for the 101 course is:

docker run -d -p 80:80 -p 389:389 -p 8443:443 -p 3306:3306 \
  --name 101.1.1 tier/gte:101.1.1-201906

This will start Grouper, a Shibboleth IdP, OpenLDAP, mySQL, and other components. It will take a little while for the container to be ready. You can watch the logs as the various components are coming up with this command:

docker logs -f 101.1.1

Once the container is ready, browse to https://localhost:8443/grouper to access the Grouper UI and log in with one of the following:

  • Grouper Administrator
    • username: banderson, password: password
  • Normal User
    • username: jsmith, password: password

The container has a few other applications running. phpMyAdmin provides an admin interface to the Grouper mySQL database. phpLDAPadmin provides an admin interface to OpenLDAP. Finally, there is a sample application that displays subject attributes for the user that is logged in.

All of the gte image tags are published to To use a particular image tag, run:

docker run -d -p 80:80 -p 389:389 -p 8443:443 -p 3306:3306 \
  --name {coures}.{exercise}.{step} tier/gte:{VERSION_TAG}

Where {VERSION_TAG} takes the form of {course}.{exercise}.{step}-{version}. For example:

docker run -d -p 80:80 -p 389:389 -p 8443:443 -p 3306:3306 \
  --name 101.1.1 tier/gte:101.1.1-201906

More information about Grouper Training can be found on the Internet2 wiki:

RabbitMQ for 401 exercises

The 401 exercises require RabbitMQ. Before starting the 401 docker images, start RabbitMQ and a queue named grouper.

docker run -d -p 15672:15672 --env RABBITMQ_NODENAME=docker-rabbit \
  --hostname rabbitmq --name=rabbitmq rabbitmq:management

Then browse to http://localhost:15672/ and login with guest/guest, and create a new queue named grouper.

Finally, start the 401 series gte with this slightly modified command:

docker run -d -p 389:389 -p 8443:443 -p 3306:3306 \
  --link rabbitmq:rabbitmq --name {coures}.{exercise}.{step} tier/gte:{VERSION_TAG}
You can’t perform that action at this time.