Apereo uPortal Upgrade and Compatibility Notes

uPortal can be directly upgraded from any previous version to any later version.  Please check the update notes found below for any intermediate versions to find steps you may need to perform after the upgrade.   Also refer to the Upgrading page.

After Every Upgrade

Please run: ant db-update

This will ensure that if there were any hibernate changes that your database is updated accordingly.

Latest 4.0, or uPortal 4.1 with Universality theme to 4.2:

• To upgrade to uPortal 4.2.0 you must do an ant initdb.  Export your current layouts, portlet definitions, and other entities and integrate the changes into the uPortal 4.2's uportal-war/src/main/data folder.  uPortal 4.2 does not support the Universality theme so you will need to re-do your layout files using the Respondr theme.
• To use the database-backed PAGS configuration, you must integrate your custom changes to PAGSGroupStoreConfig.xml into default.person-attribute-group-store.xml.

uPortal 4.1 to 4.2

• Do not need to do an initdb (unless you are using the Universality theme, see above)
• If using XML-based PAGS suggest switching to database-backed PAGS.  This will be strongly suggested with uPortal 4.3 to take advantage of Ad-hoc groups (
  Error rendering macro 'jira' : Unable to locate Jira server for this macro. It may be due to Application Link configuration.
  )