| Table of Contents | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Pre-requisites
After
backing up your server instance
setting up your migration cloud instance including installation of Comala Document Management for Cloud
updating to the latest Atlassian Migration Assistant
Then follow the Atlassian Migration Process.
Access the Cloud Migration Assistant
In Confluence server or data center global administration
scroll down the left-hand sidebar to Atlassian Cloud
select Migration Assistant Assistant
In the Migrations Assistant home you must
Assess your apps
Once you have undertaken the app assessment
choose Prepare your apps
Before undertaking a migration you should also
assess and prepare your users
review all email domains
App assessment
choose Assess your apps
use the dropdown for each app to assess the app for the migration
set Comala Document Management as Needed in cloud
if required download a CSV file of the app assessment and decisions
highlight the app in the assessment screen to display details of the migration compatibility
choose Done
Confirmation of app assessment and the next step to Prepare the apps is displayed in an on-screen message.
Prepare apps
In the Migration Assistant home, under Prepare apps
choose Begin preparing
The first step is to connect a Confluence Cloud site as the destination for the migration
connect to a cloud site
Admin is required for the site.
To connect, you need to
log in to the cloud site
add the base URL for your hosted Confluence instance
Once connected, the current installation status in the cloud site for selected apps to migrate is displayed.
Install any required apps.
choose Continue
In the Agree to app migration screen, check the agreement status
if required choose View policy
Confirm agreement
choose Done
An on-screen message confirms the completion of the app's preparation in cloud.
Create a migration
In the Migration Assistant home
choose MIgrate your data to open the Migrations dashboard
You can continue without reviewing the email domains but will be unable to undertake the migration until email domain security is checked and confirmed.
choose Create new migration
The Atlassian Confluence Migration Assistant will step steps you through the migration process including connecting to the destination cloud site.
When using the Atlassian Migration Assistant option to Assess Apps ensure you set the dropdown option for the Comala Document Management app as Needed in cloud.
The following may be listed in the migration assistant error check when creating the migration.
Due to the complexity of the migration process and the known issue affecting the migration of current state of restricted pages.choose Connect to cloud
add the following using the text boxes or the dropdown menus
Name your migration
Choose migration stage
Choose your destination cloud site (required)
| Info |
|---|
You may also need to select the Choose Cloud site button to authenticate access. |
select the Choose what to migrate button
Use the options to select what is included in the migration
choose at least one space to add to the migration in the displayed list of spaces
choose Add to Migration button
choose Select to add your Apps
The migration assistant confirms that Comala Document Management was checked as Needed in cloud and a migration path exists.
choose Add to Migration
After selecting what to migrate (including users and global templates), the assistant displays a summary of the migration options decisions.
choose Check for errors
Checks are run for the data including the following app checks.
| Tip |
|---|
We recommend migrating space by space to mitigate the risk that an issue with one space delays your migration of for other spaces. |
It is not a blocking error and you can continue the migration.
You may like to test the migration process by initially creating the migration for a single space.
.png?version=1&modificationDate=1725961010592&cacheVersion=1&api=v2&width=374)
. Test the migration process by initially creating the migration for a single space. |
If errors are listed, you can triage these now (for the app or other areas of migration check such as users, domains, spaces or system errors).
Blocking errors must be resolved before migrating.
choose Continue and fix later to review a summary of the planned migration
Choose
Save to save the migration plan and amend it later
Back to update each option
View errors (if displayed) to rerun pre-migration checks and display outstanding errors
Run to undertake the migration (only available if there are no blocking errors)
After running a migration it is listed in the Migrations dashboard. The migration includes its current status, including migrations with an Incomplete or Failed migration status.
From Comala Document Management v6.18.7 for Server and v7.5.3 for data center these migrations do not need to be created again but can be re-run.
There is an Atlassian time limit on the ability to re-run a migration.
| Insert excerpt | ||||||||
|---|---|---|---|---|---|---|---|---|
|
| Insert excerpt | ||||||||
|---|---|---|---|---|---|---|---|---|
|
Re-running a failed or incomplete app migration
| Status | ||||
|---|---|---|---|---|
|
| Status | ||||
|---|---|---|---|---|
|
From Comala Document Management v6.18.7 for server and v7.5.3 for data center, if the app migration Fails or is Incomplete, an admin can re-run it from the cloud migration assistant.
A new migration plan does not need to be created.