Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Section
titleUpgrade Instructions

Here is a short guide to update to this new version of the projectdoc Toolbox. For detailed information on dependencies, please consult the documentation of the add-ons.

Caution Box
titleBackup first, install add-on second!

This upgrade requires an upgrade of the projectdoc tables. This upgrade will be started automatically!

Expect this to be huge. Do not install this version of the projectdoc Toobox without a backup plan!


Section
titleUpgrade Order


Caution Box
titlePlease check again!

Make sure you have a recent backup and checked the upgrade in a test environment before you continue with the following steps.

In case you are only using the projectdoc Toolbox without any extensions, you may install the projectdoc Toolbox and the automatic upgrade process of the projectdoc tables in your database will start automatically.

In case you have extensions to install, you should consider to set the Java System system property de.smartics.projectdoc.upgrade.skip-auto to true. This will prevent the upgrade process to start. Install the projectdoc Toolbox then the extensions, unset the system property and restart the serverPlease install the projectdoc Toolbox first, then the extensions and finally update the doctype add-ons.

So this is the basic order:

Only the projectdoc Toolbox

  1. projectdoc Toolbox

projectdoc Toolbox with extension and doctype add-ons:

  1. set the system property -Dde.smartics.projectdoc.upgrade.skip-auto=true
  2. projectdoc Toolbox
  3. extension add-ons (start with Web API Extension)
  4. doctype add-ons (start with Core Doctypes)

Please install only those add-ons that are actually used! In case you do not use any of the Web APIprojectdoc extensions, there is no need to install it.   (smile)


Section
titleRebuild

Due to the following issues a rebuild is required to update properties.

This is detected by an automatic upgrade process. So there is no need to start the rebuild

Expect this to be huge. Do not upgrade without a backup plan!

Jira
serversmartics JIRA
columnIdsissuekey,summary,issuetype,priority,description
columnskey,summary,type,priority,description
maximumIssues1000
jqlQueryproject = 'projectdoc Toolbox' && (fixVersion IN ('5.0.0', '5.0.1', '5.0.2')) && "Break" ='runtime (fix with reindex)' ORDER BY priority DESC, type DESC
serverId79ad43bc-d289-364e-bfc7-46c09847bebd

Please refer to 

Static Document Link
documentRebuild and Reindex
for details on how to rebuild the projectdoc tables.


...