This site is moving soon to become part of an integrated Appfire documentation and information site for our apps. This site will remain available during the transition to our new and improved site. Once this site is moved over, this banner will be updated with the new site link for easy access.

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

Data upgrade for document activity in data center



Comala Document Control 2 introduces an improved capability - Document Activity. This requires you to upgrade your data in spaces with pages and/or blog posts with an applied Comala workflow.

New spaces created in your data center instance will automatically use document activity data and do not need to undergo any data upgrade

Spaces in your data center instance that have not previously had a Comala workflow applied to any page or blog post will also automatically use document activity when applying a workflow for the first time and will not need to have the data upgraded.

Document Activity Upgrade Console

The Document Activity Upgrade console in global administration enables you to manage the upgrade of your data (and run pre-upgrade checks).

The data upgrade option is only available in Comala Document Control v2.0 and later. This will require Read Only mode in your data center to be enabled during the data upgrade.

Pre-upgrade checks can be completed from Comala Document Control v1.13+ on both Confluence server and data center. We recommend that you update to the latest version of the Comala Document Control app before running the checks to ensure you have the latest set of use cases.

Running the upgrade

Once you have completed the pre-upgrade checks you can plan your upgrade activity to take place in

  • a single upgrade window

  • across multiple upgrade windows

You do not need to have all your spaces upgraded at the same time.

The pre-upgrade checks and the upgrade can be run together in sequence for a space using the Document Activity Upgrade console. You do not have to run these separately but if running the upgrade you must enable Read Only Mode for the spaces being upgraded.


After a data upgrade to use Document Activity, the previous Page Activity data will continue to be stored in the previous format for the life of Comala Document Control 2.0+ and a recovery path will be available. This recovery path will NOT include any data changes that occurred after the data upgrade.

What to do if any pre-upgrade checks or an upgrade fails?

A pre-upgrade check that includes any errors on pages in a space will display the number of pages with an error in the space and a downloadable Support Package file. This can be attached to a Comala support ticket.

The Support Package files linked in the Document Activity Upgrade Console are temporary files. If the Support Package is not found for a space, it may have been removed by the Confluence Clean Temporary Directory job and you will need to re-run the upgrade checks for this space.