DATA CENTER
Overview
The Document Activity Upgrade console is available from Comala Document Management 6.17+ release to allow Confluence Administrators to
complete pre-upgrade data checks to validate the existing page activity in their instance, and
start planning the data upgrades prior to the release of Comala Document Management 7.0 (Data Center only)
Comala Document Management 7 release Q2 2023 uses Document Activity to record workflow activity. Confluence administrators can use this console in Comala Document Management 7 to upgrade the data to use Document Activity capabilities.
Document Activity Upgrade console
In Confluence Admin, choose Comala Document Management > Upgrade Activity.
The Document Activity Upgrade console allows you identify the current spaces that use Comala Document Management and to prepare for the upgrade by
validating your existing data
providing estimates of the time to complete the upgrade
Below the Run Checks button the console displays the pages with activity including
a list of the spaces that will need upgrading
the total number of pages in each space
the total number of pages with workflow activity in each space
the current upgrade check status
Run the Document Activity Upgrade checks
To run the upgrade checks
select one or more spaces listed in the console
choose Run checks
A progress bar will display the upgrade check progress for each selected space.
Successful validation of the upgrade checks for each space will be displayed in the Status column including the date and time of the check. A duration time for the upgrade of the space is also displayed.
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.
Each upgrade check runs in parallel, you may notice some performance impacts when starting a large number of checks at the same time. We recommend that you consider:
scheduling checks for low traffic hoursĀ
doing checks in small batches
using the Upgrade checks REST API to manage the initiation and reporting on the upgrade checks
Upgrade check errors
The console will display the following warning message if an error has been found in one or more spaces.
Upgrade validation check errors for a space will be displayed in the 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 link to download a Support Package is also added to each space listing where an error has been found.
If a validation check error occurs
download the Support Package for each space with a validation error
contact Comala Support and include the Support Package as an attachment to this request.
Upgrade checks Rest API
REST API endpoints are provided for customers and partners to manage and run upgrade checks.