Message-ID: <1248033225.15996.1711712543759.JavaMail.appbox@confluence> Subject: Exported From Confluence MIME-Version: 1.0 Content-Type: multipart/related; boundary="----=_Part_15995_912262000.1711712543759" ------=_Part_15995_912262000.1711712543759 Content-Type: text/html; charset=UTF-8 Content-Transfer-Encoding: quoted-printable Content-Location: file:///C:/exported.html Upgrading and Downgrading

Upgrading and Downgrading

Upgrading

A standard upgrade procedure is simple:

  1. Create a backup of Structure data. Use Administration | St= ructure | Backup Structure. See Backing Up Structure&nb= sp;for details.
  2. Install the new version of the plugin.

  3. Check Structure extensions. If you are using Structure.Testy, Structure= .Pages, or other extensions, they will most likely become disabled. You nee= d to either upgrade them too (it might be a compatibility requirement) or e= nabled them manually in the Add-on Manager. If they fail to enabled, reinst= all them (uninstall and install again).
  4. Check plugins that integrate with Structure, such as Colors or Gantt Ch= art. Like with extensions, see if they are enabled and maybe upgrade or rei= nstall them.
  5. Monitor catalina.out or jira-applicat= ion.log for warnings or errors.

For more specific instructions, please check the Release Notes for the version to whi= ch you wish to upgrade. 

Downgrading

Reverting the plugin to an older version is not always possible because = newer versions can modify the database so it becomes incompatible with olde= r versions.

Simplified Downgrade=

A simple downgrade is possible if the database schema hasn't changed. Ch= eck the Release Notes for the version you are downgrading from and look for= downgrade advisory. Proceed only if you have indications that it is safe t= o downgrade to the specific version you have in mind.

  1. Uninstall Structure plugin. This step is required because Add-on Manage= r will not install an earlier version over a later version.
  2. Install the version that you need.
  3. Check Structure extensions and integrating add-ons. See the steps in th= e Upgrading section above.
  4. Monitor catalina.out or jira-applicat= ion.log for warnings or errors. This is especially= important with this kind of downgrade, because some errors may be subtle a= nd not visible to the users!

Reliable Downgrade

Reliable downgrade requires Structure backup file and manual access to t= he database.

  1. Create Structure backup using Administration | Structure |= Backup Structure
    1. Backup files are backward / forward compatible along Structure 3.x seri= es. You cannot use Structure 3.x backup to downgrade to Structure 2. <= /li>
    2. You can use a previously created backup file. Note that all dat= a will be rolled back to the state when the backup file was created.
  2. Uninstall Structure add-on.
  3. Double-check you have the backup! You are about to delete all S= tructure data.
  4. Manually access your database using database tools. Drop all tables tha= t start with AO_8BAD1B_. If after that you have other obj= ects starting with that prefix, drop them too.
  5. Install the previous version of Structure add-on.
  6. Use Administration | Structure | Restore Structure to = populate the data from the backup file.
  7. Check Structure extensions and integrating add-ons. See the steps in th= e Upgrading section above.
  8. Monitor catalina.out or jira-applicat= ion.log for warnings or errors.

 

Creating a backup and restoring from backup may require considerable tim= e. If you want to speed up the process and you don't need the history of st= ructure changes, turn off the option "Include History" when creating a back= up.

------=_Part_15995_912262000.1711712543759--