Getting Started
Only a few steps, BUT...
You need the following at hand in this guide:
- the means to authenticate with Confluence
- the means to authenticate with SharePoint Online
- two new SharePoint sites
- the client ID of a registered Azure AD application
Note that all of the above is covered in the quick start video below, including the Azure AD configuration.
Quick Start Video - First Confluence Migration
STEP ONE: Download WikiTraccs
Click to open the WikiTraccs download page: DOWNLOAD page.
Download the zip file.
No installation required
WikiTraccs has no installer. It is provided as portable version which means you extract a zip file and run the program.Extract the zip file - it contains two folders WikiTraccs.Console and WikiTraccs.GUI.
In the WikiTraccs.GUI folder run WikiTraccs.GUI.exe.
Unblock WikiTraccs
Windows might block WikiTraccs.GUI.exe from running, showing a blue warning message. This message shows because the file has not been signed. Unblock the file:
- Open Microsoft Windows Explorer to locate WikiTraccs.GUI.exe
- Select WikiTraccs.GUI.exe with the right mouse button and choose Properties
- Choose Unblock in the lower right corner of the resulting dialog(*)
- Select OK to close the dialog
(*) If the Unblock button or option is not present, the file is not blocked.
A blue-ish window opens. We’ll call this just WikiTraccs for the remainder of this page, instead of WikiTraccs.GUI.
Congratulations, you downloaded and started WikiTraccs.
Proceed with the next step.
STEP TWO: Configure WikiTraccs and test connections
The window you opened in the previous step should look like this:
WikiTraccs main view
You will now use this view to configure everything for a first migration.
Select the Confluence base address input field and enter the base address of Confluence. This is the source system whose content will be migrated to SharePoint Online.
Under Confluence authentication type select the authentication type to use. Choose Anonymous to have WikiTraccs access Confluence as anonymous user. Choose Interactive login to open a browser window for logging in when starting the migration.
Select the WikiTraccs site input field and enter a SharePoint site address. Now is a good time to create this site.
WikiTraccs Site
WikiTraccs uses this site to store migration-related data. The site is also used to configure aspects of the migration. The site should not be used for other purposes.Select the Try auto-detect from site button to detect the tenant ID. If this doesn’t work enter the tenant ID manually into the Tenant ID input field.
Select the Azure AD Application Client ID input field and enter the ID of the Azure AD application that WikiTraccs should use to access SharePoint.
Where to get the Azure AD Application Client ID from?
Refer to Authenticating with SharePoint for details.Under SharePoint authentication type select the authentication type to use. Choose Interactive (MFA supported).
Proceed with the next step.
STEP TWO AND A HALF: Validate the configuration
Choose the Test Confluence connection button to test the Confluence connection.
A message box will open and tell whether this succeeded or not.
Choose the Test SharePoint connection button to test the SharePoint connection.
A message box will open and tell whether this succeeded or not.
Something didn't work?
If something goes wrong refer to the Troubleshooting section.When both of those tests where successful, select the Prepare WikiTraccs site and update space inventory button. You might have to log in again.
If successful, a message box will open and show you the number of Confluence spaces that were found.
Proceed with the next step.
STEP THREE: Start the migration
First, you need to select the Confluence spaces to migrate.
Choose the Open space inventory to choose source spaces button.
A browser window opens, showing the space inventory SharePoint list. It contains information about all spaces that were found in Confluence. WikiTraccs filled this list when you selected the Prepare WikiTraccs site and update space inventory button in the previous step.
For each element in the space inventory list, choose the RequestTransformation option to include this space in the migration:
Include a Confluence space in the migration.
When you are finished, return to the WikiTraccs window.
Select the Target site input field and enter the address of the target SharePoint site. This site will be the new home for migrated pages. Now is a good point to create this site.
Only one target site?
Yes, you can only configure one target site here. Configuring a different target site per space is currently possible via the settings file.Select the Start transformation button to start the migration.
A new window opens - WikiTraccs.Console - and the migration begins.
Multiple log ins
You might have to authenticate twice because WikiTraccs.GUI first tests the connection, then hands over to WikiTraccs.Console which authenticates again.Congratulations. Your first migration is running.
Look at the Site Pages library of your target SharePoint site. After a minute or so new pages should appear. Those are the transformed Confluence pages.