v2.4 Upgrade Instructions from v2.3

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.

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 grouper.properties 

gsh.useLegacy = true

vt-ldap was converted to Ldaptive

1. Test your LDAP loader and subject sources to make sure they work correctly.  Try the subject source diagnostics

Upgrade Steps

1. Download the grouper installer
2. Run the upgrader

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 grouper.cache.properties to all envs (prod, test, ui, ws, etc)

Convert the sources.xml to subject.properties

1. Run the grouperInstaller to convert this file
2. Copy the subject.properties 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

See Also

Release Notes for Grouper 2.4