Upgrading from Previous Versions

You can upgrade from any previous release straight to the current release.

Warning

Upgrade a test/development environment successfully before upgrading any production environment. This is especially important when the EDG workspace includes UI or model customizations.

Warning

Workspaces cannot be downgraded once upgraded. To revert to a previous version of EDG, you must restore the workspace from a backup (see EDG Backup and Restore) taken before upgrade.

Migration Notes

Warning

Before upgrading, review all Migration Notes starting at the version you are currently on and following along to the current release. The migration notes contain additional steps that must be done before, during or after the upgrade to keep EDG functioning and to prevent data loss.

Upgrade steps from earlier 8.x releases to latest 8.x release

  1. Stop Tomcat, make sure the process is fully stopped

  2. Backup the workspace directory

  3. Backup and remove the /edg directory and edg.war file located in Tomcat’s webapps directory

  4. Place the current release’s edg.war file found in the download package into Tomcat’s webapps directory

  5. Clear Tomcat’s work and temp directories

  6. Start Tomcat

  7. Perform any steps from the Migration Notes applicable to your installation

  8. Test for refressions

Upgrade steps from 6.x/7.x to latest 8.x release

Note

This requires an upgrade from Tomcat 8/9 to Tomcat 10. The steps given here assume that EDG will be installed on a fresh Tomcat 10 installation in a different location from the old Tomcat.

Warning

This is a major upgrade. Carefully read all the instructions prior to beginning!

  1. Read the migration notes for upgrading to 8.0 and take note of any additional steps that apply to your installation

  2. Recommended: Take screenshots of the EDG settings on the Rights Management page. Have the credentials and connections strings/URLs handy for Explorer and S3 connections.

  3. Stop the old Tomcat instance, make sure the process is fully stopped

  4. Back up everything (workspace, vault, Tomcat installation, etc.)

  5. Follow the steps for installing a new EDG server, but using the existing edg-setup.properties setup file and existing workspace location