As we release new versions of VisibleThread (formerly known as VT Docs), we encourage you to upgrade your customer-hosted instance to get access to the latest features and patch any security issues.
This section is for those performing such an upgrade. We recommend any upgrade is performed in a test environment prior to upgrading your production system. We recommend you take a backup or snapshot of your system before upgrading.
Red Hat and Ubuntu deployments each have a different upgrade mechanism. Each one will be covered below
NOTE: As of VisibleThread 7+ upgrades require PostgreSQL to be version 16+. To check your PostgreSQL version run 'psql --version'. The Windows VisibleThread 7+ Installer will upgrade your PostgreSQL version to 17.
NOTE: We recommend you take a backup or snapshot of your system before upgrading.
Upgrading VT Docs to VisibleThread 7+ on RHEL
Upgrades are distributed in the form of a new rpm package.
NOTE: If your RHEL system is running a PostgreSQL version less than 16, you must upgrade PostgreSQL first, by following this guide: How to Upgrade PostgreSQL to Version 16+ for VisibleThread 7+ on Red Hat 9
NOTE: We recommend that you take a snapshot and/or a backup of the database before upgrading. To do that run:
/opt/visiblethread/VisibleThreadTools/vt-backup.sh
Download the new .rpm's to your Red Hat server:
VTAPI
https://visiblethread.s3.us-east-1.amazonaws.com/public/download/visiblethread-api-1.0.10-1.x86_64.rpm
MD5 hash: 00da16f4ba72598b5d10829b3853efa7
VisibleThread 7:
https://visiblethread.s3.us-east-1.amazonaws.com/public/download/visiblethread-docs-7.2.1-1.x86_64.rpm
MD5 hash: 7883e15251988d84a6f810cd2aa9f59d
VTRAG:
https://visiblethread.s3.us-east-1.amazonaws.com/public/download/vtrag-1.0.7-1.x86_64.rpm
MD5 hash: a37477a057c8737b2264e3a1bfa825aa
To install :
VTAPI
Visit the article below to install and configure VTAPI:
https://support.visiblethread.com/hc/en-us/articles/37081761908626-How-to-install-and-configure-VTAPI
VTDocs 7
sudo yum install visiblethread-docs-7.2.1-1.x86_64.rpm This will install the new application version and restart the services.
VTRAG
sudo yum install vtrag-1.0.7-1.x86_64.rpm This will install the new VTRAG component for VisibleThread 7. For setup and configuration of VTRAG, please see this guide: How to Deploy VisibleThread RAG (VTRAG) for VisibleThread 7+
Upgrading VT Docs to VisibleThread 7+ on Windows
Upgrades are distributed in the form of a new .EXE file. The Windows VisibleThread 7+ Installer will upgrade your PostgreSQL version to 17.
NOTE: VTRAG and VTAPI is bundled in the Windows installer.
NOTE: We recommend that you take a snapshot and/or a backup of the database before upgrading. To do that run:
# Windows
cd C:\Program Files\visiblethread\vtdocs\VisibleThreadTools
vt-backup.bat
Install Windows Upgrade
Download the new .exe file to your Windows server:
https://visiblethread.s3.us-east-1.amazonaws.com/public/download/vtdocs_windows-x64_7_2_1.exe
MD5 hash: 8c85d305bf7d60d923a326dd49f733db
And install it by double clicking and following the on-screen instructions.
Testing the upgrade
To verify the upgrade was performed successfully, point your browser at https://<VisibleThreadServerAddress> and verify the version number (e.g. 7.2.1) on the sign-in screen looks like the one below