Page History

Image Removed  To use the Grouper installer, see the "Grouper Installer" training video and this wiki page.

Image Removed

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

...

v4.

...

x.x non-enhancement version

Read the Release Notes

Release components

If you are new to Grouper and need to get started, download the installer and watch this video

• Grouper Installer v2.1.5 (.tar.gz) (jar only) - Designed to get a working demo up and running quickly. Contains the Grouper API, UI, WS, loader (daemons), a demo database, a database engine, tomcat, and ant. All you need is Java 6+ JDK. Note: this is new and experimental.
• Grouper API Binary v2.1.5 (.tar.gz) - Binary release of the Grouper Application Program Interface and associated utilities. Cf. Getting started with the Grouper API Binary Distribution
• Grouper API Source v2.1.5 (.tar.gz) - Contains the full source for the Grouper Application Program Interface, Grouper Shell, and other associated utilities.
• Provisioning Service Provider v2.1.5 (.tar.gz) - Binary provisioning plugin for Grouper. More provisioning software for Grouper is available in Maven
• Grouper UI v2.1.5 (.tar.gz) - Contains the full source for the Grouper Administrative and Lite User Interfaces.
• Grouper WS v2.1.5 (.tar.gz) - Contains the full source for the Grouper Web Services Interface.
• Grouper Client v2.1.5 (.tar.gz) - Client for Grouper LDAP and Web Services, in binary form. Grouper Client v2.1.5 source is also available.
• Contributed Software
  - Provided by the Grouper community, in addition to the above core Grouper products.
• Grouper Voot Connector - NOTE: This has NOT been fully tested. Please confirm to your satisfaction that it meets your needs before deploying in a production environment.

New Features in Grouper 2.1.x

• PSP - Changes to user access can now happen in real time courtesy of real time and incremental provisioning based on Grouper's changelog. Group and folder moves and renames can be provisioned as well. This is accomplished with the new Provisioning Service Provider (PSP), which replaces LDAPPCNG.
• Provision from LDAP - Grouper can now be updated from LDAP via PSP or Grouper Loader.
• More Web Services Improved web services support for applications that outsource their internal access management to Grouper: The new web services are: Assign Attribute Def Name Inheritance, Attribute Def Name Save, Attribute Def Name Delete, and Find Attribute Def Names.
• Local Entities - Improved management of access by service principals to info stored in Grouper using a new "local entity" object type.
• Grouper Installer - It's quick and easy to get started using Grouper with the new installer. Really!
• Subject Filter and Attribute Decorator - Manage who can see which subject attributes with new subject attribute security support. You can also decorate subjects after retrieval from their source.
• Grouper Failover Client - Higher availability of web services using a new failover client library and discovery service library.

Grouper source code (or via viewvc) is in Internet2's SVN repository. For command line users:
svn co http://anonsvn.internet2.edu/svn/i2mi/tags/GROUPER_2_1_5/

for Grouper v4

Past Grouper release is v2.5.x non-enhancement version

Read the Release Notes for Grouper 2.5

Which version should be used

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

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

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 list names:

• 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, send an e-mail to pubsympa at internet2 dot edu with the following message in the subject:
"subscribe ListName FirstName LastName"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.

...