.. include:: /includes.rst.txt

.. comments - headings

   # with overline, for parts
   * with overline, for chapters
   = for sections
   - for subsections
   ^ for subsubsections
   " for paragraphs
   * for H5
   + for H6

.. index:: pair: TopBraid EDG ; Upgrading

.. _upgrading:

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 :ref:`edg_backup_and_restore`) taken before upgrade.


.. _migration_notes:

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.

.. toctree::
   :maxdepth: 1

   migration_7.6
   migration_7.7
   migration_7.8
   migration_8.0
   migration_8.0.1
   migration_8.1
   migration_8.2
   migration_8.3
   migration_8.4
   migration_8.5
   migration_9.0
   migration_9.1
   migration_9.2


Upgrade steps from 8.x and earlier 9.x releases to latest 9.x release
---------------------------------------------------------------------

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

#. Backup the workspace directory

#. Backup and remove the ``/edg`` directory and ``edg.war`` file located in Tomcat's ``webapps`` directory

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

#. Clear Tomcat's ``work`` and ``temp`` directories

#. Start Tomcat

#. Perform any steps from the :ref:`migration_notes` applicable to your installation

#. Test for refressions


Upgrade steps from 6.x/7.x
--------------------------

This requires a fresh installation from scratch, using the old installation's setup file and workspace.
Follow the steps in the :ref:`migration notes for upgrading to 8.0 <migration_8_0>`.