Grouper Downloads

Wiki Home	Grouper Release Announcements	Grouper Guides	Grouper Deployment Guide	Community Contributions	Internal Developer Resources

As of Grouper v2.5+ it is required to use the InCommon Trusted Access Platform packaging approach.

Report Grouper Security Concerns here

Which version should be used

Use version	In these conditions
v5..	You want new Grouper features as they are released
	You have non trivial testing process on upgrades
	Upgrade to latest stable v5.. at least every quarter
	Upgrade to latest stable v5.. when security advisories are released
	Use ABAC
v4.. (was 2.6)	You want as little change/risk as possible when upgrading containers (for OS / security / critical bug fixes)
	You do not want to test thoroughly when upgrading
	Upgrade to latest stable v2.6.* at least every quarter
	Upgrade to latest stable v2.6.* when security advisories are released
	Using the Grouper Provisioning Framework
v2.5.*	You want as little change/risk as possible when upgrading containers (for OS / security / critical bug fixes)
	You do not want to test thoroughly when upgrading
	Upgrade to latest stable v4.. by May 2023
v2.4.*	Do not use
v2.3.*	Do not use
v2.2.*	Do not use
v2.1 or earlier	Seriously?

Release components

Grouper in v4 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:

v4 release notes to see which version to use
Install instructions
Container maturity level -1 (quick start)
Container maturity level 0 instructions manual install
v4 upgrade instructions
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://raw.githubusercontent.com/Internet2/grouper/GROUPER_RELEASE_2.5.XX/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.5

Grouper 2.5 includes many helpful new features, as listed below, as well as the enhancements provided in Grouper 2.4 patches, such as visualization and reporting.

The upgrade from 2.4.0 to 2.5 is not generally a major upgrade. The database did not change much.

You are required to use a container when running Grouper. This will ensure you have consistent directory structure, the correct version of libraries, and low risk and low effort upgrades. There are instructions to make using the container as easy as possible.

Expirable groups	Groups can have enabled / disabled dates and can be disabled (RBAC feature)
Container required	Grouper requires a container to run. No tarballs will be distributed. No more patches, no more confusing upgrades, no more inconsistent environments, no more lengthy installs
Container redesign	One servlet container, easier mounts, one directory structure, fewer processes, maven build, patchless
Grouper installer installs container	REMOVED
Improve pagination in WS	Cursor based paging allows fewer memory problems and paging which does not skip records
Gantt chart for jobs	See when jobs have executed, job overlap, how long jobs take, success or error
Add new web services	Get audit log Web Service Add point in time options for WS get members, get groups, group save, get memberships
Attributes on memberships in UI	Allow direct and indirect attributes on memberships in UI (see JIRA). See wiki documentation here
WS and UI authentication	Basic authn stored in database. Passwordless WS authn in future. This is more friendly for containers
Simple custom UI	Analyze access for a policy. Allow easy join/leave. One-pager application
Automatic DDL upgrades	Grouper can automatically adjust the database structure in a controlled way when a new container is run

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

Grouper Email Subscriptions

Please see this page for info on the Grouper email lists and InCommon-Grouper slack.

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).

Page tree