VisibleThread -
Help Center Find helpful articles on different VisibleThread Products


Upgrading an on-premise VT Writer deployment

This article contains the necessary instructions for upgrading an on-premise VT Writer Deployment to a newer release.


Note:  This article applies to deployments using an Ubuntu virtual appliance. For customers deployed on Red Hat, see this article:


Upgrade files have an extension of ‘.tar.gz’ so an example file might be ‘VisibleThreadReadabilityUpgrade2.4.4.tar.gz’.

When an upgrade is available, the VisibleThread support team will be in touch with each customer with details on how to download the upgrade file.

When you have downloaded your upgrade file, it needs to be added to the /home/visiblethread/VisibleThreadTools/upgrades folders 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:

  1. Connect to your Virtual Appliance using the following details:
    • IP address
    • Username: visiblethread – Password: password (unless changed)
    • Port: 22
  2. Once connected, navigate to the /home/visiblethread/VisibleThreadTools/upgrades folder.
  3. Upload the upgrade file to this folder. 


Back up the VisibleThread data

Note: We recommend that you perform a backup of data prior to upgrading, in the event that the upgrade encounters any unforeseen issues.

To do so, follow the steps outlined here

Applying the upgrade to the Virtual Appliance

The VT Writer server contains an upgrade script that will perform an upgrade of the application. 
To run this script, log on to the server console and execute the following commands:

cd /home/visiblethread/VisibleThreadTools
sudo ./ upgrades/<upgradefilename.tar.gz>


Note: You may be prompted for the “visiblethread” user password when running this command.
This will unpackage the archive and deploy the release files and restart the application.

Verifying the upgrade is successful


To verify the upgrade was successful take the following steps:

     1. Check the version of each of the following by running each command below:

  • dpkg -s vtapi-doc-worker
  • dpkg -s vtapi-web-worker
  • dpkg -s vtapi-scan-worker
  1. They should all be version 0.22

  2. Browse to the VT Writer application, and verify the version number is 2.4.4. The version number should be displayed on the login screen.
  3. Sign in to the VT Writer application and upload a document for analysis, verify the analysis completes.
  4. If you are using the Email service send an email with a document attached (Word or PDF document) to the email address you have designated for readability scans.
  5. Verify you get a response with the document analysis results.


The upgrade process generates a log file in the following location:


You should send this file to and they will verify that the upgrade was successful.


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

Get Additional Help

Visit our Helpdesk for additional help and support.