Prerequisites

This article describes the prerequisites for running WikiTraccs.

Prerequisites of the Migration Machine

Operating System

WikiTraccs runs on Windows.

Tested so far have been Windows 10, Windows 11, Windows Server 2012 R2, Windows Server 2016, Windows Server 2019, Windows Server 2022.

If Confluence only supports TLS 1.3, choose Windows 11 or Windows Server 2022. See the note about TLS 1.3 below.

Hardware

ComponentWorks
CPU64-bit 2.6-GHz quad core processor
RAM16 GB
Operating systemWindows 11 client
ComponentWorks
CPU64-bit 3.1-GHz quad core processor
RAM24 GB
Operating systemWindows Server 2012 R2 Standard

Provide enough storage for all of Confluence to be downloaded. Confluence has 500 GB of attachments? Provide at least 500 GB of hard drive storage.

Software Requirements

A recent version of the Chrome browser needs to be installed (for authenticating with Confluence, refer to the authentication article for details on authentication)

Windows Configuration

The Windows swap file should be at least 12 GB of size. This proved to be helpful in low-memory environments (e.g. only 3 GB of RAM in a Windows VM) to prevent out of memory errors. It probably won’t be necessary with more RAM, but it doesn’t hurt either.

Endpoint Requirements

Refer to the endpoints article on required endpoints.

Security Note

WikiTraccs doesn’t need to run with admin rights, and should not be run with admin rights.

Note that WikiTraccs automatically downloads the Google ChromeDriver that is used to automate the Chrome browser window to show the Confluence login with interactive login. There have been a couple of cases where either this download, or the ChromeDriver have been blocked from running. Unblocking the ChromeDriver or running WikiTraccs with admin rights tended to solve the issue in those cases.

Note about TLS 1.3

When the Confluence server only supports TLS 1.3 connections, you have to run WikiTraccs on a Windows version that officially supports TLS 1.3; those are Windows Server 2022 and Windows 11.

There have been issues reported where the Confluence server was upgraded to only support TLS 1.3 and Windows subsequently failed to properly negotiate a cipher. Please test this scenario before starting the migration or refrain from changing the TLS protocol during the migration. A workaround is available, though, in the form of the WikiTraccs proxy mode.

Last modified September 7, 2024