VisibleThread -
Help Center Find helpful articles on different VisibleThread Products


Upgrading an onsite deployment to a new release

Periodically new versions of the VisibleThread server software become available, for instance you may wish to upgrade from Server version 3.x to 3.y

This section is for those performing such an upgrade.


Red Hat and Ubuntu deployments each have a different upgrade mechanism. Each one will be covered below

NOTE: As of VT Docs 4.02 upgrades require PostgreSQL to be version 10+. To check your PostgreSQL version run 'psql --version'.

NOTE: If your server is a Virtual Machine, please take a snapshot of the machine before you upgrade it. This will make recovery very simple in the event of an upgrade failure. Please reach out to for more details.


Upgrading a VT Docs Ubuntu deployment

VisibleThread product upgrades are shipped as upgrade files with the extension '.tar.gz', for example  Upgrade-2.14-build-2168.tar.gz

Download details for each upgrade are emailed to all VisibleThread customers as soon as the upgrade becomes available. If you are missing details of where to retrieve an upgrade please contact our support team.

When you have downloaded your upgrade file, it needs to be added to the home folder on the VisibleThread Virtual Appliance:


Uploading the upgrade file to the Virtual Appliance

You can upload the upgrade file to the Virtual Appliance via SSH (Secure SHell) using port 22. The easiest way to do this is to use one of a number of freely available tools such as the FileZilla client ( or WinSCP ( The next section outlines the detailed steps to complete this:

  • Connect to your Virtual Appliance using the following details:
    • IP address: The IP Address of your Virtual Apppliance/VisibleThread Server.
    • username: visiblethread
    • Password: password (unless changed when deploying the VisibleThread server)
    • Port: 22
  • Once connected navigate to the /home/visiblethread/VisibleThreadTools/upgrade folder.
  • Upload the upgrade file to this folder.

Applying the upgrade to the Virtual Appliance

Note: Applying the upgrade will bring down the VisibleThread application for several minutes.

The VisibleThread Virtual Appliance contains an upgrade script that will perform an upgrade of the Virtual Appliance. To run this script log on to the VisibleThread Virtual Appliance console and execute the following commands:

cd /home/visiblethread/VisibleThreadTools
screen ./ upgrade/<upgradefilename.tar.gz>


Note: You may be prompted for the "visiblethread" user password when running this command. This will unpack the archive, deploy the upgrade files and restart the application.


Upgrading a VT Docs Red Hat deployment

Upgrades are distributed in the form of a new rpm package. You will have been provided details of where to download this upgrade file from VisibleThread support via e-mail. Mail should you not have received these details. 

NOTE: We recommend that you take a snapshot and/or a backup of the database before upgrading. To do that run:


Download the new .rpm to your Red Hat server, and to install it :

yum install --setopt=clean_requirements_on_remove=0 visiblethread-docs-4.4.3-1.x86_64.rpm

This will install the new application version and restart the services.


Testing the upgrade

To verify the upgrade was performed successfully, point your browser at https://<VisibleThreadServerAddress> and verify the version number (e.g. 4..4.3) on the sign-in screen looks like the one below





Was this article helpful?
1 out of 1 found this helpful

Get Additional Help

Visit our Helpdesk for additional help and support.