You are viewing documentation for Structure Server and Data Center version 5.4 and patch releases. For other versions, see Version Index or [Structure Cloud].
To upgrade Structure 3.0 or later:
Install the new version of the plugin.
catalina.out
or jira-application.log
for warnings or errors.We strongly recommend that you back up your data before upgrading. The introduction of manual adjustments required changes to our backup file format, which makes previous versions of Structure unable to restore data from backup files created by Structure 5.0 and later. For more information, see Backup Format Version Change.
For more specific instructions, please check the Release Notes for the version to which you wish to upgrade.
Reverting Structure to an older version is not always possible, because newer versions can modify the database, making it incompatible with older versions.
A simple downgrade is possible if the database schema hasn't changed. Check the Release Notes for the version you are downgrading from and look for a downgrade advisory. Proceed only if you have indications that it is safe to downgrade to the specific version you have in mind.
catalina.out
or jira-application.log
for warnings or errors. This is especially important with this kind of downgrade, because some errors may be subtle and not visible to users!Reliable downgrade requires a Structure backup file and manual access to the database.
AO_8BAD1B_
. If after that you have other objects starting with that prefix, drop them too.catalina.out
or jira-application.log
for warnings or errors.Creating a backup and restoring from backup may require considerable time. If you want to speed up the process and you don't need the history of structure changes, turn off the option "Include History" when creating a backup.
If you are using Structure 3.x or 4.x: follow the upgrade instructions above.
If you are using Structure 5.0 or later: in Structure 5.0 we had to change the backup file format version, due to the backwards-incompatible changes required by the introduction of manual adjustments. This means that previous versions of Structure will not be able to restore data from backup files created by Structure 5.0 and later.
To downgrade to an earlier version, use the procedure outlined below to restore Structure data from a 5.0 backup file:
version
attribute in the <structure-backup>
element from "5.0" to "3.3".<manualAdjustments>
elements from the XML.Then you can restore directly from the modified XML file; you do not have to pack it into a ZIP archive.