This document is intended for Server Administrators with sufficient technical skills.

This article explains the procedure for migrating XTRF from Windows to the Linux operating system.

Before starting the migration, ensure that your new server meets the requirements listed in the Server requirements article.

Preparatory steps

Windows

(Recommended) Update your XTRF to the newest version. We highly recommend migrating between the same XTRF versions.

Change the TTL in the DNS record pointing to your XTRF to 1 minute.

Install the new XTRF version as described in Linux installation & update of XTRF 10.
Stop the jboss-xtrf.service.
Drop the XTRF database.
Create a new empty database. The owner and name should match the ones defined in /usr/local/jboss-xtrf/standalone/configuration/xtrfDatabaseConfig.xml.
Copy the contents of your XTRF home directory from the old server to the new server. Doing this before the migration can shorten the migration duration if you have a lot of project files.
Copy the /usr/local/jboss-xtrf/bin/standalone.conf.local.example to /usr/local/jboss-xtrf/bin/standalone.conf.local and add the following line at the end: JAVA_OPTS_ADDITIONAL="$JAVA_OPTS_ADDITIONAL -Dxtrf.systemHomeDirectory=/home/jboss/xtrf" where /home/jboss/xtrf is where you copied your XTRF home directory to.
Install and configure a reverse proxy as described in SSL Certificate installation (OnPremises only).

Stop and disable the XTRF service. This will start downtime.
Create a database dump as described in Database operations.
Copy the database dump to the Linux server, along with any files from the XTRF home directory that have been changed since your initial copy.

Point your DNS record to the new server.

Restore the database dump into the previously created empty database, as described in Database operations.
Start the jboss-xtrf.service.