Include Page | ||||
---|---|---|---|---|
|
Panelnote | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
To use the Grouper installer, see the "Grouper Installer" training video and this wiki page. For a minor upgrade, see the "Grouper Minor Upgrade" training video |
Report Grouper Security Concerns here
| ||
As of Grouper v2.5+ it is required to use the InCommon Trusted Access Platform packaging approach. |
Learn how to 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)Note: The release of Grouper 2.2 is scheduled for July 10, 2014
Current Grouper release is
...
v4.
...
x.x non-enhancement version
Read the Release Notes for Grouper 2.2
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. 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.2.0
There is a new more usable UI which makes Grouper easy to use by end users and administrators. It co-exists with the legacy Admin UI and the Lite UIs. | |
Migrate from legacy attributes to the new attribute framework in a transparent way. The API, WS, and UI work similar as they did before. | |
SCIM events can be sent from Grouper to keep SCIM compatible systems in sync with Grouper. | |
Grouper config files can have hierarchical overlays to make Grouper easier to deploy and upgrade across multiple environments. | |
Grouper objects now have a unique integer ID which can be used in GID management | |
Ability to tag folders in Grouper (via the attribute framework) so that folders, groups, permissions can be grouped into a "service". The API/UI/WS can filter search results based on the service to make it easier for users to perform tasks in Grouper. |
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/
Grouper release is v5.x.x an enhancement version
Read the Release Notes for Grouper v5
Past Grouper release is v2.5.x non-enhancement version
Read the Release Notes for Grouper 2.5
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
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).
See Also
Grouper 2.2 Upgrade Instructions from Grouper 2.1 Grouper Changes v2.2