Product Version UpgradesPermanent link for this heading

Note: A mixed installation with different Fabasoft app.telemetry product versions is not supported!

So you have to update the Fabasoft app.telemetry server, all Fabasoft app.telemetry agents and all Fabasoft app.telemetry web services (WebAPI) installations.

Note: Before starting the update process of the software, you should backup the configuration data of the Fabasoft app.telemetry server:

  • Linux: /etc/app.telemetry/infra.xml
  • Microsoft Windows: C:\ProgramData\Fabasoft app.telemetry\infra.xml

On updating the Fabasoft app.telemetry server (not a clean new installation), you may have to import a new license file either via the web browser client interface by opening the settings dialog and uploading a new license or by manually replacing the old license file in the file system with a new license file in the server’s configuration directory and restart the server process afterwards. For details see the following chapters:

Upgrading to Version 2015Permanent link for this heading

The installation of the new Fabasoft app.telemetry 2015 requires a new product license for the product name “Fabasoft app.telemetry 2015” and the product version “15”. Since product version 2015 only the major version number is relevant for the license check.

Special Notes for Upgrades on RHEL/CentOS 6 with SELinuxPermanent link for this heading

If you are upgrading an old existing app.telemetry installation on a RHEL/CentOS 6 system with activated SELinux you have to fully restart all app.telemetry and Apache daemons after the installation in order to get the SELinux rules applied correctly.

Upgrade Procedure on Linux SystemsPermanent link for this heading

The following installation paths have been changed for Linux installations from older product versions than “2010 Fall Release”:

  • Base installation: /opt/app.telemetry/
  • Configuration path: /etc/app.telemetry/
  • Data path: /var/opt/app.telemetry/

Upgrade Process for Linux Environment:

  1. Backup your configuration (especially your infrastructure infra.xml)
  2. Upgrade your app.telemetry server by means of upgrading all app.telemetry RPMs with the rpm command rpm -U (apptelemetryagent, apptelemetryserver, apptelemetryweb)
  3. Upgrade all app.telemetry agents (yum localupdate apptelemetryagent.rpm app.telemetry-libs.rpm) - and if the app.telemetry web service was installed on some agents that package has also to be
  4. Install a new app.telemetry license file
  5. Access the new app.telemetry web client via the new URL: http://.../apptelemetry/

Details for the Configuration of the Software-Telemetry web service module on Linux on upgrading from older product versions than “2010 Fall Release”:

Because the Software-Telemetry web service is now implemented as web service filter (instead of as a virtual directory) you have to remove any old Software-Telemetry module configuration directives from your custom web server configuration files.

The following configuration is loaded by default with the new Software-Telemetry web service RPM package (apptelemetryweb.rpm):

Apache Configuration

LoadModule softwaretelemetryweb_module /opt/app.telemetry/softwaretelemetryweb/softwaretelemetryweb.so

This module configures the global filter for "web.telemetry". For more details see the default configuration file: /etc/httpd/conf.d/softwaretelemetryweb.conf

For any embedded Apache (as in Fabasoft Folio) remove the old strudlwebapi.conf configuration file and any embedded configuration directive and replace it with the new Software-Telemetry web module filter ("LoadModule ..." as listed above) to the embedded Apache instance.

Upgrade Procedure on Microsoft Windows SystemsPermanent link for this heading

The following installation paths and registry keys have been changed for Windows installations from older product versions than “2010 Fall Release”:

  • Default installation path: C:\Program Files\Fabasoft app.telemetry\
  • Configuration parameters in the Windows registry: HKEY_LOCAL_MACHINE\SOFTWARE\Fabasoft app.telemetry
  • Default path for telemetry data: <AppDataDir>\Fabasoft app.telemetry\
    • Microsoft Windows Server 2008: C:\ProgramData\Fabasoft app.telemetry\

Upgrade Process for Microsoft Windows Environment:

  1. Backup your configuration (especially your infrastructure infra.xml)
  2. Upgrade your app.telemetry server by means of running the setup.exe (important: the setup.exe program performs some upgrade tasks!) file from the "Server" installation folder which will upgrade all server components (server, agent, telemetry web service)
  3. Upgrade all app.telemetry agents (upgrade the software package by means of running the setup.exe from the “Agent” installation folder) - and if the Software-Telemetry web service was installed on some agents that package has also to be updated (via the setup.exe from the “TelemetryWeb” installation folder)
  4. Install a new app.telemetry license file
  5. Access the new app.telemetry web client via the new URL: http://.../apptelemetry/

Configuration changes for Fabasoft Folio when using Software-Telemetry Web ServicePermanent link for this heading

After the upgrade of Fabasoft app.telemetry you must alter the Path to the Software-Telemetry web service inside the configuration object of the actual Fabasoft Folio Domain to “../tmp/web.telemetry”.

The reasons therefor are:

  1. The new Fabasoft app.telemetry web service (since 2010 Fall Release) is implemented as global web service filter listening on URLs ending with "web.telemetry".
  2. The web directory where the Software-Telemetry web service is run must have "Script & Executable" permissions.
  3. All requests to the app.telemetry web service must not be handled by the Fabasoft web service handler so the Fabasoft web server "tmp"-folder is used which provides static content and does not handle other requests.