Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Step

Description

Image

1

Perform a regular migration using Atlassian’s migration assistant.

2

On your Server/DC instance

Either export a single topic using the /export2 REST endpoint on your Server / Data Center instance as described here (please expand “Using the REST interface”) or export all topics using the /exportAll endpoint.

Example:

Code Block
https://yourcompany.com/rest/simpleqa/1.0/exportAll

💡 Both endpoints deliver an url and a download link first. When you click the download link you will either get a message that the export has not been finished yet (ready : false) or the browser downloads the file already. In case the export has not been finished yet, reload the page e.g. every 10 seconds until you get the download.

3

On your Cloud instance

🕑 Based on the latest experience we had with a customer it might take a while after migration before the Confluence Cloud index picks up the migrated pages - our migration functions however need an up-to-date index. It might therefore be necessary to wait until the index is current.

First navigate to:

Code Block
<<your_url>>/plugins/servlet/ac/de.edrup.confluence.plugins.simple-qa/simple-qa-migration

Example:

Code Block
https://example.atlasstian.net/wiki/plugins/servlet/ac/de.edrup.confluence.plugins.simple-qa/simple-qa-migration

Once the page has been loaded you can configure the migration:

  1. Overwrite responses already imported: when selected answers will be re-imported and eventual changes after the first migration will be overridden

  2. Delete comments after migration (do NOT use before you checked the migration results): when selected the comments which are the basis for the migration of answers will be deleted. You should only use this option once you are sure the migration works well for you.

  3. Space key: defining a space key is only needed in case you are using data collected from the /export or /export2 endpoint of the Server/DC app below version 3.11.3. Below the mentioned version the exported data did not contain the space key. Therefore you can only import topic by topic always defining the space key here.

4

Select the file you have exported under step #2 and run the migration

...