5.3. Upgrade

The Spotfire Server and node manager upgrade tools copy all relevant settings, including configurations and node manager trust, to your new Spotfire environment.

5.3.1. Prerequisites

Before upgrading, create a working backup of your Spotfire database.

5.3.2. Spotfire Server Upgrade (Windows)

  1. Stop your Spotfire Server (services) and disable automatic restart of your Spotfire server to prevent the old installed services from starting automatically and causing a port conflict with the new installation.

  2. Install Spotfire as described in “Spotfire Server Setup (Windows)”.

    • Configure the new server to use the same ports as the previous installation.

    • Do not start or configure the newly installed server before running the upgrade tool.

  3. Upgrade the server by running the server upgrade tool.

    • Go to the following directory: <new version Spotfire Server dir>/tools/upgrade

    • Double-click upgradetool.bat

    • Select previous server installation, enter the path to its installation directory.

    • Specify the database and database driver you are using.

    • Provide the database connection string, username and password.

    • If there are changes needed after the upgrade (for example, port configuration or the location of TLS certificate), then manually edit the server.xml file, located in the directory <Spotfire Server install dir>/tomcat/conf

  4. Optional: Remove the previous installation (deinstallation)

5.3.3. Spotfire Server Upgrade (Linux)

  1. Stop your Spotfire Server by running

    • systemctl stop tss-<version number> (<= 12) or

    • systemctl stop spotfireserver-<version number>

  2. Install Spotfire as described in “Spotfire Server Setup (Linux)”.

    • Configure the new server to use the same ports as the previous installation.

    • Do not start or configure the newly installed server before running the upgrade tool.

  3. Upgrade the server by running the server upgrade tool.

    • Go to the following directory: <new version Spotfire Server dir>/tools/upgrade

    • Execute upgradetool.sh

    • Select previous server installation, enter the path to its installation directory.

    • Specify the database and database driver you are using.

    • Provide the database connection string, username and password.

    • If there are changes needed after the upgrade (for example, port configuration or the location of TLS certificate), then manually edit the server.xml file, located in the directory <Spotfire Server install dir>/tomcat/conf

  4. Optional: Remove the previous installation

    • Remove the node manager service by running the following commands (<= 12):

      • rm /usr/lib/systemd/system/tss-<version number>.service

      • rm /lib/systemd/system/tss-<version number>.service

    • Remove the node manager service by running the following commands (>= 14)

      • rm /usr/lib/systemd/system/spotfireserver-<version number>.service

      • rm /lib/systemd/system/spotfireserver-<version number>.service

    • Reload all and clear by running the following commands:

      • systemctl daemon-reload

      • systemctl reset-failed

    • Remove the folder with Spotfire Server files

5.3.4. Node Manager Upgrade

  1. Stop your Spotfire Node Manager (services) and disable automatic restart of your Spotfire Node Manager to prevent the old installed services from starting automatically and causing a port conflict with the new installation.

  2. Install the Node Manager as described in “Node Manager Setup”.

    • Configure the new node manager to use the same ports as the previous installation.

    • Do not start or configure the newly installed node manager before running the upgrade tool.

  3. Upgrade the node manager by running the upgrade tool.

    • Go to the following directory: <new version Node Manager dir>/nm/upgrade/upgradetool

    • Double-click upgradetool.bat

  4. Remove the previous installation (deinstallation)