Confluence Migrator Application (Pro)

Last modified by Administrator on 2023/11/23 00:11

Confluence Migrator Application (Pro)

The Confluence Migrator Pro is an all-in-one toolkit that allows you to migrate and reorganise your data in only a few minutes! The migrator is available for any deployment method, whether it is on your server or in the XWiki Cloud. Try it now.

migrator-pro-homepage-prerequisites-collapsed.png
CategoryApplication
Active Installs0
Rating
0 Votes
LicenseGNU Lesser General Public License 2.1
Minimal XWiki version supported14.10
SourcesIssues

Migrate your Confluence data, users, attachments and metadata in just a few minutes using the multi space migrator. 

To migrate from Confluence to XWiki you will need: 

  • an XWiki instance with administrator access
  • access to your XWiki instance's configuration files, if you are running XWiki on your premise
  • a Confluence server XML backup file

The application will take you through the few steps that are needed to complete the migration of a Confluence space. Please follow the instructions in the "Documentation" tab for a full breakdown of each step. 

The Confluence Migrator Pro license and support is included in any Gold and Platinum support contract. 

 

Prerequisites

  • an XWiki instance with administrator rights
  • access to your XWiki instance's configuration files (if you are running XWiki on premise)
  • Confluence Migrator Pro, Pro Macros and Task Manager Pro installed on your XWiki instance
  • administrator access to the Confluence instance that you wish to migrate content from or a server XML backup file

Once you have installed the Confluence Migrator Pro, open the prerequisites section and perform the necessary configuration in order to make sure the XWiki instance will support the data migration. 

migrator-pro-preprequisites.png

If a prerequisite is met, a checkmark will appear next to its respective line in the dedicated section. 

Data migration

In order to migrate your data, first attach the Confluence backup file in the dedicated section of the migrator. 

migrator-pro-data-import.png

You will be able to attach multiple files and start the data migration from any of them. It is also possible to use a space export. If your Confluence backup fails to upload please make sure that your XWiki instance has enough storage and memory, and also that the attachment limit is not too low. If you are using XWiki in the Cloud, please contact the support team, in order for them to perform the necessary configuration. 

Once you have identified the export file that you wish to use, click on "Select package". You will be redirected to the title page, where you can name your migration and configure the import options. 

migrator-pro-set-title.png

If you wish to modify the default import configuration, for example, to skip user import or to not preserve history, click on "Advanced migration options".

migrator-pro-fs-config.png

Once you are satisfied with the configuration, click on "Save & View". You will be redirected to the package analyser step. The analysis of the package may take a while if the export is very large. 

migrator-pro-analyser.png

Once the analysis of the package is done, the list of spaces will appear. You can select all, multiple or one space and search for a space based on their key. 

migrator-pro-list-spaces.png

After you have selected all the spaces that you wish to migrate in this run, click on "Confirm". You will be redirected on the import log page. The process of importing and moving the pages into their correct location may take a while if the export is very large.

migrator-pro-import-step.png

Finally, when the data migration is done, you will be redirected to the report page, where you will see the pages that have been successfully imported, along with the ones affected by errors.

migrator-pro-pages-imported-successfully.png

migrator-pro-errors.png

You will be able to also later review the report by clicking on the migration page in the application's homepage. Moreover, you can run multiple migrations in parallel and see their status.

migrator-pro-migration-status.png

Installation Steps

This paid extensions requires 14.10 or above. In order to install the extension, follow the next steps inside your XWiki instance (on cloud or on premise).

Navigate to the Extension Manager

In the Applications Panel click on "More Applications..." and then "Install new applications...". Alternatively navigate directly to the Administration and select the "Extensions" section.

step1.png

Install the Extension

Search for the extension you wish to install and use the Install button to install it.

step2.png

Get a License

Navigate to the "Licenses" section of the Administration, fill your details, look for the extension you just installed in the live table and click the buttons to get a trial license or to buy a license.

step3.png

Install the License

If you have selected a trial license then you're good and there's nothing else to do. Your trial license is automatically installed.

However if you've selected to buy a license you'll be redirected to a page to perform the payment. At the end you need to come back to the "Licenses" administration section and click on the "Check for Updates" button. This will download and apply the license you bought.

Use the Extension

Start using the Extension! Refer to the extension's documentation to know how to use it.

Installing Paid Apps on Subwikis

If you want to install an application on the whole farm (main wiki + subwikis), you can do so directly from the main wiki’s Extension Manager, as seen below:

step4.png

Extensions can also be installed only on a particular subwiki by global admins. Subwiki admins will not be able to install these extensions due to their limited rights.

Options

The price is per year and varies depending on the support level and the number of users.

Support / Users Unlimited
Gold

Benefits

What do you get when you purchase an XWiki extension?

1 year license

By purchasing an XWiki extension license, you'll benefit from it during one year.

Free updates

You benefit from all the extension updates during one year. You are always up to date.

Support included

If you are facing an issue, you can reach the XWiki support. Our team is always available to help.

How to Buy

To buy, install this extension from inside your XWiki instance and follow the instructions.

Release notes

v1.7.0

Improvements:

#26 Add the option to specify path to the Confluence export in the server

Tasks:

#27 Rename Step 2 in "Choose an export package"

v1.6.0

Improvements:

#17 Maintain image width and height set in Confluence

Uses version 9.29.0 of Confluence XML

Tasks:

#29 Upgrade Licensor dependency to version 1.24.3

v1.5.0

Improvements:

Uses version 9.28.0 of Confluence XML

v1.4.0

Improvements:

Uses version 9.27.0 of Confluence XML

v1.3.0

Improvements:

Uses version 9.26.0 of Confluence XML

v1.2.0

Bugs fixed:

#25 Space selection does not filter out blogs from other spaces #25

Improvements:

Uses version 9.25.0 of Confluence XML which supports blog-only migrations and adf extensions (the note macro)

v1.1.0

Bugs fixed:

#18 Cannot use the migrator on subwikis

Improvements:

#20 Support permissions migration

Tasks:

#19 Support Blog Posts migration

v1.0.1

Bugs fixed:

#14 The pro migrator is not working for free licenses
#15 The license manager fails to initialize after the Confluence Migrator Pro is installed and XWiki is restarted

 

v1.0

First version of the application containing the following functionalities:

  • homepage with prerequisites, backup packages and reports on previous migrations,
  • multi space migration,
  • run multiple migration simultaneously 
  • import configuration 
  • detailed report showing the pages imported successfully, along with the ones affected by errors

Extension details

This information is only displayed to Administrators. Your users can't see this tab.

License

  • GNU Lesser General Public License 2.1

Sources

Issues

Type

  • xar

Developed by

Compatibility

  • Requires 14.10 or above.

Installable with the Extension Manager

Dependencies

  • com.xwiki.confluencepro:application-confluence-migrator-pro-default 1.7.0
  • org.xwiki.contrib.listeneradmin:application-listener-admin-ui 1.0.2
  • com.xwiki.licensing:application-licensing-licensor-api 1.24.3
  • org.xwiki.platform:xwiki-platform-rendering-macro-velocity 14.10
  • org.xwiki.platform:xwiki-platform-display-html 14.10
  • org.xwiki.platform:xwiki-platform-livedata-macro 14.10
  • org.xwiki.platform:xwiki-platform-filter-script 14.10
Tags:
Created by Stefana Nazare on 2023/09/27 09:39
XWiki SAS Copyright © 2021