Migration Path - FAQ for Confluence

Below is a step-by-step guide to help you migrate your FAQ app data to Confluence Cloud.

Before you start, please read carefully this checklist

We recommend reading this Atlassian article to plan your migration.

We recommend reading carefully our major change to migration process https://support.covectors.io/space/SAMM/661291017 released on Jan 2, 2024

Please check that you have FAQ’s latest version for server and the latest version of FAQ Cloud" installed in both Confluence instances (having previous versions in any of them won't trigger the FAQ migration; it will just migrate a Confluence space without FAQ data).

Make sure that Confluence users have valid email addresses that are the same as their cloud counterparts.

Ideally, perform the migration with users that have admin site privileges on your Confluence Cloud site.

Update the Confluence Cloud Migration Assistant to the latest version.

Running a migration of FAQ Data

Step 1

Start by making sure that your FAQ App is tagged as needed in Cloud in order to trigger the right event once a space is migrated via the Migration Assistant.

Navigate to Confluence Administration and choose Migration Assistant. Choose the Assess your apps option and select our FAQ app to be needed in Cloud :

Select the Assess your Apps Option

Step 2

Select your Cloud site where your data will be migrated.

To do so:

Enter the site from which you want to migrate data and select the cloud site which data will be migrated to
Make sure the admin’s email address is the same on both cloud and server environment
Check “Allow Atlassian” to access migrations data
Confirm

Now that your pre-configuration is done, you can proceed to creating a new migration plan.

Step 3

Navigate to home page and create a new migration.

You will be redirect to the interface to confirm your cloud site selection and will be asked to choose what to migrate as following:

Select Migrate spaces to choose after what spaces to migrate
Select the users policy. Make sure that users who have created FAQ content within your Confluence server exist in your Confluence Cloud site. If not, and the user who created the FAQ content cannot be found during migration, they will be replaced by the user performing the migration to avoid data loss or breaking the feature.

Proceed to space select to migrate content from and migrate FAQ data from as following:

After confirming the action, the migration assist will provide you with a list of checks and errors to fix before migration.

You will get a recap of your migration before to run it: Details about your spaces, number of pages, what apps are impacted, etc.

You simply need to run the migration. You will be redirected to the home page where you can select the migration that you just launched to follow its state.

Please note that app migration progress will take time before displaying the feedback.

Two types of feedback are handled based on Atlassian API:

Migration App data state

Migration App data state

COMPLETE

Your data are successfully migrated after space content and users migration.

INCOMPLETE

Something happened that may have broken the migration.

Some common cases for migration data errors:

Non existing users in cloud
Space data not found during migration due to latencies within cloud instance or internet
Error in date to be migrated: FAQ data containing special characters not handled in Cloud, null labels after data manipulation in Server, or server database, broken data.