This site has moved to the integrated Appfire documentation and information site for our apps.

From February 2024 this site is no longer updated.

Take a look here! If you have any questions please email

Document Activity Upgrade


The Document Activity Upgrade console is available from Comala Document Control 1.13 to allow Confluence Admins to:

  • complete upgrade checks to validate the existing activity in their instance, and

  • start planning the upgrades prior to installation of Comala Document Control 2 (Data Center only).

From Comala Document Control 2.0 the console allows Confluence Administrators to manage the upgrade of Document Activity to enable the new capabilities in your data center instance.

Read Only Mode must be enabled to undertake the data upgrade process for one or more spaces in an instance.

Document Activity Upgrade console

In Confluence Admin

  • choose Comala Document Control > Upgrade Activity

The console will identify the spaces that have pages with activity and that will need upgrading.

For spaces that need upgrading the console will display

  • the number of spaces

  • a list of the spaces

  • the total number of pages in each space

  • the total number of pages with workflow activity in each space

  • the current update check status

Upgrade check

To run the upgrade checks

  • select one or more spaces listed in the console

  • choose Run checks

A progress bar will display the progress of the upgrade checks for each selected space.

Each space upgrade check runs in parallel, you may notice some performance impacts when starting a large number of checks at the same time.

A global administrator can cancel an in-progress upgrade check by clicking on the upgrade check progress bar for each individual space.

This can be done for example, to mitigate any performance impact.

Successful validation of the upgrade checks for each space will be displayed in the Upgrade status column including the date and time of the check. A duration time for the upgrade of the space is also displayed.

Upgrade check errors

The console will display the following warning message if errors are detected in one or more spaces.

Pre-upgrade validation errors for a space will be displayed in the Upgrade status column. This includes

  • date and time of the validation check

  • estimated time duration for any upgrade

  • number of pages in space where errors where validation errors were found

A button to download a Support Package is also shown for spaces with one or pages with an upgrade check validation error.

If a validation check error occurs

  • download the Support Package for each space with a validation error

  • review the pages with validation errors and update the pages

    • pages with restrictions for the user running the upgrade will need to be removed for that user

  • re-run the upgrade

If you need help, contact Comala Support and include the Support Package as an attachment to the request.