Child pages
  • v2.4 Release Notes
Skip to end of metadata
Go to start of metadata

Release Notes for Grouper 2.4

Grouper v2.4.0 includes XXX fixes and improvements over v2.3.0. See the full list.

New Features in Grouper 2.3.0


Provisioning Service Provider Next Generation (PSPNG) implementation addresses performance problems and configuration complexity of the Provisioning Service Provider (PSP)

Loader improvements

Grouper loader improvements: scheduling configuration stored in database facilitates high-availability changes to loader config files do not require restarting the loader, handling unresolvable subjects

Web Service operationsNew Web Service operations for attribute definitions, actions, and messaging
Grouper messaging

Grouper messaging system and WS with integration to the change log and ESB

UI screensUI screens for attribute definitions and inherited privileges
Export to GSH

Export Grouper objects to a Grouper Shell (GSH) script

Folder privilegesRefactor folder privileges to be “admin” and “create” instead of “stem” and “create”.  See the glossary for updated privileges and definitions.


v2.4.0 patches

Grouper patching instructions (how to install patches with the Grouper installer)

note: if a java file is included in a patch, then all associated classfiles are there too



Files affected

For more information about upcoming plans, see the Grouper Product Roadmap .

Many other fixes and improvements were also made to all components of the Grouper Toolkit: Grouper API, Administrative & Lite UIs, Grouper Web Services, Grouper Client, Grouper Shell, Grouper Loader, PSP, and the Subject API.

Upgrading to Grouper 2.4 from Grouper 2.3

Using the Grouper Upgrader can simplify your upgrade process. Here is a movie demonstrating the Grouper upgrader.  The upgrader can upgrade an installed env of the API, UI, WS, client, PSP, etc.  If you dont have a build script to manage multiple envs, you might want to use the upgrader.

Upgrade Steps

  1. Download the grouper installer
  2. Run the upgrader for each env (test, prod, ui, ws, etc)

Important Changes in Grouper 2.4 that impact the upgrade

GSH next generation: GSH now uses Groovy shell.  If your scripts dont work, set this in  (Though also inform the Grouper developers via Jira or email in case a fix is needed since the legacy GSH will be removed in the future.)

gsh.useLegacy = true

vt-ldap was converted to Ldaptive

  1. Test your LDAP loader and subject sources to make sure they work correctly.  Note that if you use LDAP for your subject source, your configuration must change.  For more details, visit the vt-ldap to ldaptive migration for LDAP access page.  Also, try the subject source diagnostics to confirm your configuration.

Convert the ehcache xml file to properties

  1. If you have not customized Grouper caching (generally the case), just delete the ehcache xml and use the properties file shipped with Grouper.
  2. If you have customized Grouper caching
    1. Run the grouperInstaller to convert this file
    2. Copy the to all envs (prod, test, ui, ws, etc)

Convert the sources.xml to

  1. Run the grouperInstaller to convert this file
  2. Copy the to all envs (prod, test, ui, ws, etc)

Note that the admin and lite UIs are removed

  1. If you know of applications which deep link to the admin or lite UIs, update those links.
  2. If you have a reason to continue using these old UIs, there is an option to manually redeploy them.  (Though let us know if there is a missing feature or issue in the New UI.)

Custom member fields have been deprecated

  1. This was a very uncommon feature so most people should not be impacted.  Previously, each individual group could have multiple membership lists.  There would be the default list of members, but then you could also specify separate membership lists as well.  Going forward, the best practice is to use separate groups for those custom lists instead.  Custom lists are not supported in the New UI, but if you still use them, they will be available in the Admin UI if you choose to manually redeploy it.

Schema updates

  1. In previous Grouper upgrades, it was very common for large schema updates that required downtime to make the adjustments.  For the 2.3 to 2.4 upgrade, the only updates are 3 new indexes.  The upgrader will automatically add these without requiring a downtime.

See Also

Release Notes for Grouper 2.4

See Also

Grouper Downloads

  • No labels