WarningImporting a Confluence instance is a multi-step process. This tool allows to import an export from Confluence into XWiki pages, but additional specific actions need to be handled, including supporting standard or custom Confluence macros. For large instances, some specific issues might occur, such as too long page names or hierarchies that cannot be imported or unsupported macros.
InformationXWiki SAS, a sponsoring company of the XWiki Open Source software, is providing software and services to help with the migration:
- The paying macro package has been released and is available on the XWiki SAS store: https://store.xwiki.com/xwiki/bin/view/Extension/ProMacros/
- XWiki SAS is working on a migration package to handle all steps of the migration in one application. This package is currently in development.
- XWiki SAS can provide services to analyse a Confluence instance and study what is needed to migrate it (which package, which process, what macros are needed).
You can contact XWiki SAS on the XWiki SAS web site: https://xwiki.com
To get started with the Confluence Import, you will need to install the Filter Streams Converter Application and this Confluence XML module. You can install these apps using the Extension Manager.
You then need to export your confluence data from the Confluence administration and upload the zip file to the XWiki server. Make sure you make it accessible to the user running your java process.
ErrorBest practice: The Image macro, when used in the "documentation" space, must specify a 'size' parameter and no 'width' one.
After you have installed the two extensions, click on the Filter Stream Converter entry from the Applications panel.
ErrorBest practice: The Image macro, when used in the "documentation" space, must specify a 'size' parameter and no 'width' one.
Follow these steps on the screenshot below:
- Choose the "Confluence XML input stream (confluence+xml)" input type
- Fill in the source field which contains "file:" followed by the path of the Confluence zip file, located on the machine where XWiki is running
- Choose the "XWiki instance output stream (xwiki+instance)" output type to import the Confluence pages in your wiki
Note: in some cases, the Java Application server cannot access all the directories from your computer or server. You can try storing the file in a directory used by the application server (root directory of the application server or log directory). Alternatively it is also possible to make your file accessible on a web server and indicate the URL of that file.
ErrorBest practice: The Image macro, when used in the "documentation" space, must specify a 'size' parameter and no 'width' one.
After you have completed these steps, click the "Convert" button. After that, you will see the conversion progress. For example:
ErrorBest practice: The Image macro, when used in the "documentation" space, must specify a 'size' parameter and no 'width' one.
For example with the following initial page from Confluence:
ErrorBest practice: The Image macro, when used in the "documentation" space, must specify a 'size' parameter and no 'width' one.
You'll get the following page in XWiki after you've made the import:
ErrorBest practice: The Image macro, when used in the "documentation" space, must specify a 'size' parameter and no 'width' one.
You're all set! 
To find more about the current topic, you can search or use the table below and filter the columns to narrow your choices.
