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

Debian Linux

Make sure Ensure that your server meets the requirements listed in the following article: Server requirements.
1. Specifically, Ubuntu 18.04, Debian 9 Stretch is , and Debian 10 Buster are no longer supported as of XTRF 10.
Update the XTRF repository address in your apt configuration, as it has changed with the release of XTRF 9. 3. You should get it from our XTRF Self-Service Manager.

Execute the following commands on your server:

Code Block
sudo apt-get update sudo apt-get install xtrf9xtrf10-full

The script will download the latest XTRF 910.x, perform a database backup (only with default, unmodified configuration), upgrade the necessary files, and restart your new systemAs of release 9.3, the applications
The package installs an additional service jbossservice jboss-xtrf-file-stats.service running on the same java version as the core application. This service is decoupled from the main application for performance reasons.
The package installs an additional service jboss-xtrf-tomcat.service running on the same java version as the core application. This service is decoupled from the main application for performance reasons. It can be used to host additional customizations. If there are none, this service is automatically disabled.

Debian maintenance procedures

You can restart XTRF manually by issuing the following command:

Code Block
systemctl restart jboss-xtrf.service

XTRF is managed as a systemd service, so all the usual administrative commands from systemd apply.

Make sure that your server meets the requirements listed in the following article: Server requirements.

Note
Please note that installing XTRF on the Windows Server has been deprecated. Please review your options for migrating to a different, supported hosting platform.

Download the jbossMake sure that your server meets the requirements listed in the following article: Server requirements.
Download the jboss-xtrf-full-910.x.y.zip file zip file from XTRF Self-Service Manager.
Stop all XTRF services from services.msc.
Database backup is recommended. Please follow the instructions in the link: Database backup.
Rename the C:\jboss-xtrf\ folder to C:\jboss-xtrf_OLD_yyyy-mm-dd.
Extract the downloaded archive to C:\jboss-xtrf\ so you have C:\jboss-xtrf\bin subdirectory. Please make sure that the new JBoss folder is located exactly as the one you had before.
Copy the following file (xtrfDatabaseConfig.xml) from the old JBoss directory (C:\jboss-xtrf_OLD_yyyy-mm-dd\standalone\configuration) to the new, unzipped jboss-xtrf folder (C:\jboss-xtrf\standalone\configuration)Database Backup - XTRF Help - XTRF Knowledge Base.
Adjust the local configuration C:\jboss-xtrf\bin\standalone.local.bat if necessary, based on the previous version.
Run (as administrator) the install-windows-service.bat in C:\jboss-xtrf\bin to create and update XTRF services. From Starting with 9.3, this step is critical.
Copy all custom applications (*.war) from old standaloneold standalone/custom-deployments/ to a new JBoss Tomcat directory.
Start all XTRF services through services.msc. Note that this may include newly created services.

Table of Contents