| Table of Contents | ||||||||
|---|---|---|---|---|---|---|---|---|
|
| Status | ||||
|---|---|---|---|---|
|
Overview
Comala Document Management 7 and later (data center only app) use Document Activity to record workflow events and activity. Workflow data in existing spaces with an applied workflow prior to installation of the data center only app will need to have the workflow data updated to use document activity capabilities.
The Document Activity Upgrade console is available from Comala Document Management 6.17+ release to allow allows 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 estimate the time for the data upgrade for each space data to support planning for the data upgrade process
upgrade the data in each space to utilize document activity
The Document Activity Upgrade console is available from Comala Document Management 6.17+ release to enable the running of pre-upgrade checks prior to an install of Comala Document Management 7.0 (Data Center only) Comala Document Management 7 release
| Status | ||||
|---|---|---|---|---|
|
The following spaces in your data center instance will automatically utilize document activity
new spaces on application of a workflow in the space
existing spaces without an applied workflow (prior to installation of the data center only app) on application of a workflow in the space
Document Activity Upgrade console
...
The Document Activity Upgrade console allows you identify the current spaces that use Comala Document Management workflows and to prepare for the upgrade by
...
validating your existing data
...
require upgrading.
The console will run pre-upgrade checks to
select one or more spaces to check and upgrade
validate your existing data in the selected spaces
provide estimates of the time to complete the upgrade for each space
...
Below the The Run Checks button the console table displays the pages with activity includingspaces
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/upgrade status
A summary of thecheck can be copied using the option in the Pre-upgrade checks statistics dialog box
Once the check has been completed and no errors are identified the selected space(s) can be upgraded to use document activity data.
...
| Info |
|---|
The pre-upgrade check and upgrade of a space can be undertaken in a single action if no errors are identified. |
Run the document activity pre-upgrade checks
To run the upgrade checks
...
A progress bar will display the upgrade check progress for each selected space.
...
...
| Tip |
|---|
Successful validation of the pre-upgrade |
...
check 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 pre-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.
| Tip |
|---|
Each pre-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:
|
...
Pre-upgrade check errors
The console will display the following warning message if an a pre-upgrade error has been found in one or more spaces.
...
Upgrade validation pre-upgrade check errors for a space will be displayed in the Status column. This includes
...
A link to download a Support Package is also added to each space listing where an error has been found.
If a validation pre-upgrade 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.
...
Pre-upgrade checks Rest API
REST API endpoints are provided for customers and partners to manage and run pre-upgrade checks.