Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents
minLevel1
maxLevel2
outlinefalse
typelist
printablefalse

Info

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

Windows Server

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

  2. Download the jboss-xtrf-full-9.x.y.zip file from https://ssm.xtrf.eu/.

  3. Stop all XTRF services from services.msc.

  4. Database backup is recommended. Please follow the instructions in the link: Database backup.

  5. Rename the C:\jboss-xtrf\ folder to C:\jboss-xtrf_OLD_yyyy-mm-dd.

  6. 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.

  7. 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.

  8. Adjust the local configuration C:\jboss-xtrf\bin\standalone.local.bat if necessary, based on the previous version.

  9. Run (as administrator) the install-windows-service.bat in C:\jboss-xtrf\bin to create and update XTRF services. From 9.3, this step is critical.

  10. Copy all custom applications (*.war) from old standalone/custom-deployments/ to a new JBoss directory.

  11. Start all XTRF services through services.msc. Note that this may include newly created services.

Debian Linux

Info

Package change

Starting with XTRF 8.6, the package has been redesigned and renamed to xtrf9-full The contents are largely unchanged. In order to update to this version, simply install the new package.

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

    1. Specifically, Debian 9 Stretch is no longer supported

  2. 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 Service Desk

  3. Execute the following commands on your server:

    Code Block
    sudo apt-get update
    sudo apt-get install xtrf9-full
  4. The script will download the latest XTRF 9.x, perform a database backup (only with unmodified configuration), upgrade the necessary files, and restart your new system

  5. As of release 9.3, the package installs an additional service 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.

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.

Easy heading
linkText4
linkText3
linkText10
linkText3linkText6
linkText5
relatedLinksLabels
linkText2linkText1
headingTagsH1,H2,H3,H4
linkText1
sidebarMaxHeight650500
linkType2Page
linkType3Page
linkType1Page
linkType10Page
sidebarTitleUpdate UPDATE XTRF
linkUrl3
linkUrl4
linkUrl1
linkUrl2
linkUrl10
linkText8linkText7
relatedLinksOrderLabels_First
linkText7
sidebarModeOpened
headingNumberingModeNo_Numbers
linkText9
sidebarMarginRight20
relatedContentIds
relatedLinksTargetNew_Window
relatedLinksTitleRELATED LINKS
linkUrl9
linkUrl7
linkUrl8
linkUrl5
numberedHeadingTagsH1,H2,H3
linkUrl5linkUrl6
linkType8Page
linkType9Page
linkType6Page
headingLinkTextModeWrap
linkType7linkType6Page
linkType4linkType7Page
linkType5linkType4Page
sidebarWidth350
linkType5Page
sidebarTop160
headingLinkExpandModeExpand_All_By_Default
headingLinkIndent10