Skip to end of metadata
Go to start of metadata

For Grouper 2.5+ see the new approach for Grouper 2.5+ packaging and versioning strategy
There are some upgrade steps but also, running a container of a new version will do a lot of the steps for you.

If you want to upgrade the ehache config file see this page.

 This topic is discussed in the "Grouper Upgrader" training video.

In Grouper 2.2.1 the Grouper Installer can upgrade Grouper as well.  When you run the Grouper installer it will ask you if you want to install or upgrade.  If you choose "upgrade", then you will be running the Grouper Upgrader.

  1. Download the grouperInstaller.jar
  2. Run: java -jar grouperInstaller.jar
  3. When it asks you if you want to install or upgrade, type "upgrade"
  4. Follow the rest of the instructions

Here is a movie demonstrating the Grouper Upgrader

Note, this is sort of a bootstrap, or quick upgrade.  If you are managing dev/test/prod envs you might use the Grouper Upgrader to build Grouper, but then have other scripts and config files managed in those envs.  See this page as an example

You can use the Grouper Upgrader output to see what commands you need to do to upgrade.

The Grouper Upgrader will also install all the latest patches for a release (if applicable)


  1. Note: if you get an error or a problem and the upgrader stops, you can start it again.  If you had previous successfully done things, you dont have do them again.  e.g. if you built the UI, and it says it has been built, do you want to build it again, you can say no.
  2. I saw a JRE crash, and restarted the upgrader, and it worked fine the second time.
# A fatal error has been detected by the Java Runtime Environment:
#  SIGBUS (0x7) at pc=0x00002ab18085af31, pid=23518, tid=46941848123712
# JRE version: 6.0_20-b02
# Java VM: Java HotSpot(TM) 64-Bit Server VM (16.3-b01 mixed mode linux-amd64 )
# Problematic frame:
# C  []
# If you would like to submit a bug report, please visit:
# The crash happened outside the Java Virtual Machine in native code.
# See problematic frame for where to report the bug.

---------------  T H R E A D  ---------------

Current thread (0x000000004d05c800):  JavaThread "main" [_thread_in_native, id=23519, stack(0x00002ab1801eb000,0x00002ab1802ec000)]


Java frames: (J=compiled Java code, j=interpreted, Vv=VM code)
j  java.util.jar.JarFile.getEntry(Ljava/lang/String;)Ljava/util/zip/ZipEntry;+2
j  edu.internet2.middleware.grouperInstaller.util.GrouperInstallerUtils.jarVersion2(Ljava/io/File;)Ljava/lang/String;+40
j  edu.internet2.middleware.grouperInstaller.util.GrouperInstallerUtils.jarVersion(Ljava/io/File;Z)Ljava/lang/String;+105
j  edu.internet2.middleware.grouperInstaller.util.GrouperInstallerUtils.jarVersion(Ljava/io/File;)Ljava/lang/String;+2
j  edu.internet2.middleware.grouperInstaller.GrouperInstaller.compareAndReplaceJar(Ljava/io/File;Ljava/io/File;ZLjava/io/File;)Z+210
j  edu.internet2.middleware.grouperInstaller.GrouperInstaller.upgradeJars(Ljava/io/File;Ljava/io/File;)V+455
j  edu.internet2.middleware.grouperInstaller.GrouperInstaller.upgradeJars(Ljava/io/File;)V+13
j  edu.internet2.middleware.grouperInstaller.GrouperInstaller.upgradeUi()V+114

See Also

 Grouper Installer

Grouper Patcher

  • No labels