Recommendation
As of Grouper v2.5+ it is required to use the InCommon Trusted Access Platform packaging approach with Docker.
To use the Grouper installer, see the "Grouper Installer" training video.
Here is a movie demonstrating the Grouper upgrader, for Grouper 2.2.1 and above
Report Grouper Security Concerns here
View the Grouper Demo
View the Grouper demo (if you have issues registering for the demo, click here for info)
Current Grouper release is v2.5.x
Read the Release Notes for Grouper 2.5
Release components
Grouper in v2.5 is a container. If your institution does not run containers regularly, it's ok, you can run Grouper without making investments in container orchestration.
For the Grouper container, which runs the Grouper UI, WS, daemon, scim, GSH, see:
- v2.5 release notes to see which version to use
- v2.5 install instructions
- v2.5 maturity level 0 instructions
- v2.5 upgrade instructions
- The Grouper installer helps you install this container for the first time (and in non production)
- Download the version you want from maven. (download the grouper-installer-*.jar)
- Get a grouper.installer.example.properties e.g. for 2.5.X:
https://github.com/Internet2/grouper/blob/GROUPER_RELEASE_2.5.X/grouper-misc/grouper-installer/conf/grouper.installer.example.properties - Create a blank grouper.installer.properties and use any settings from the example
- Run: java -jar grouper-installer-2.5.X.jar
- The Grouper client is a java library for Grouper web services which can be used command line and can show example web service calls
- Download the version you want from maven. (download the grouperClient-*.jar)
- Get a grouper.client.base.properties e.g. for 2.5.X:
https://github.com/Internet2/grouper/blob/GROUPER_RELEASE_2.5.X/grouper-misc/grouperClient/conf/grouper.client.base.properties - Create a blank grouper.client.properties and use any settings from the base properties
- Run: java -jar grouperClient-2.5.X.jar
New Features in Grouper 2.4.0
Most features in Grouper 2.4.0 are also in 2.3.0 patches. The upgrade from 2.3.0 to 2.4.0 is a minor upgrade.
Migrate all screens in Admin and Lite UI to the "New UI" and remove the admin and lite UI. Note, you can add the legacy UI if needed | |
Deprovisioning | Deprovision access from someone to loses an affiliation or changes jobs |
Attestation | Groups and folders can be marked to require periodic membership review. Reminders will be emailed to group owners |
Grouper deployment guide | Version 1 of the Grouper deployment guide is an introduction to Grouper and best practices for using it |
Add new messaging strategies for ActiveMQ, AMQP (e.g. RabbitMQ), AWS | |
Grouper loader in UI | User interface to show loader configuration, diagnostics, logs, wizard editor |
Subject API diagnostics | User interface to analyze, diagnose, and recommend improvements for subject source configuration |
Real time SQL loader | Allow a change log table (SQL triggers) or messages to trigger loader updates for a partial population or single user |
Instrumentation | Improve and standardize Grouper logging to provide centralized metrics at an institution and the ability to upload stats to a central Internet2 server |
Packaging | Docker containers that hold Grouper components for each deployment |
GSH next generation | Improve gsh by adding readline like capabilities (line editing, tab completions, history, etc) |
Inbound messages | Allow Grouper to read a message queue and act on messages (e.g. membership changes etc) |
vt-ldap to Ldaptive | Upgrade from vt-ldap to Ldaptive |
properties config | Convert sources.xml and ehcache.xml to be cascaded properties files |
Update 3rd party libraries | Update 3rd party libraries to the latest version that is feasible |
Grouper source code is on GitHub.
Previous Grouper Versions
For previous Grouper versions, click the link for the desired version:
2.4.0: 2.4.0
2.3.0: 2.3.0
2.2.2: 2.2.2
2.2.1: 2.2.1
2.2.0: 2.2.0
2.1: 2.1.5, 2.1.4, 2.1.3, 2.1.2, 2.1.1, 2.1.0
2.0: 2.0.3, 2.0.2, 2.0.1, 2.0.0
1.7: 1.7.0
1.6: 1.6.3, 1.6.2, 1.6.1, 1.6.0
Email Subscriptions
As an open source project, support is provided by means of the Grouper documentation wiki and open mailing lists. Grouper implementers are urged and welcome to subscribe to the following email lists:
- Grouper-Announce mailing list, for important annoucements around security and releases.
- Grouper-Users mailing list, which is an open support forum for deployment issues.
- Grouper-Developers mailing list, for those interested in discussion of development issues.
To subscribe , see instructions here
License
Grouper is licensed under the Apache 2.0 license. See http://www.apache.org/licenses/LICENSE-2.0.html for a copy of this license.
Development of this software was supported with funding from Internet2, the University of Chicago, University of Pennsylvania, Duke University, University of Washington, University of Memphis, University of Bristol (UK), the NSF Middleware Initiative (NSF 02-028, Grant No. OCI-0330626, Grant No. OCI-0330626, OCI-0721896, and OCI-1032468), and JISC. Any opinions, findings and conclusions or recommendations expressed in this material are those of the author(s) and do not necessarily reflect the views of the National Science Foundation (NSF).