Confluence Migrator Application (Pro)

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

Buy extension
from 2000€ Try extension
for free Contact us

Category	Application
Active Installs	0
Rating	1 2 3 4 5 0 Votes
License	GNU Lesser General Public License 2.1
Minimal XWiki version supported	14.10
Sources	Issues

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.

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.

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.

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".

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.

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.

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.

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.

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.

Contents

Navigate to the Extension Manager
Install the Extension
Get a License
Install the License
Use the Extension
Installing Paid Apps on Subwikis

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.

Install the Extension

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

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.

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:

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	2000

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