Minimum Server Spec

8GB RAM
2 CPU Cores
80GB disk

Windows installs have been tested and verified on the following version:
Windows Server 2016, 2019, 2022

Note: VT Docs requires port 443 for users to access the application from web browser.

Installing VT Docs

To install VT Docs on Windows download the .exe file from here:
https://visiblethread.s3.amazonaws.com/public/download/vtdocs_windows-x64_6_0_5.exe 

To verify that the download was completed successfully, you can check the hash:

certutil -hashfile vtdocs_windows-x64_6_0_5.exe MD5

The valid MD5 Hash is: 649b247e1ea6aa93b18cdea75f3a0ad3

VT Docs requires a HTTP server. There are two ways to deploy VT Docs with a HTTP Server:

1. Install Apache HTTP server as part of the VT Docs installation
2. Use Windows IIS server and configure it to work with VT Docs.

Install Using Apache Web Server

Run the install file and follow the install wizard instructions. Install instructions to note are the steps of installing a web server as a reverse proxy. If you wish to use Apache web server make sure the box is checked. All configuration for Apache web server will be done as part of the install.

Install Using IIS

If you wish to use IIS as a reverse proxy and for SSL termination make sure to uncheck the "Apache" box. We do NOT configure IIS as part of the install. Once the install wizard has finished, please follow this guide to configure IIS to work with VT Docs: IIS As Reverse Proxy For VT Docs

Install VT Docs with PostgreSQL installed on another Drive

The default install of VT Docs installs all components on the same Drive. If you wish to install PostgreSQL on a different drive, follow the instruction below. Otherwise, please ignore this section.

• Run the vtdocs_windows.exe file
• Uncheck PostgreSQL

• After Docs installs, open cmd(command prompt) and install postgresql with the args in the command below:
  "C:\Program Files\VisibleThread\vtdocs\setup\postgresql-14.2-2-windows-x64.exe" --mode unattended --superpassword <customer_to_provide> --servicename <customer_managed_pg_service> --prefix <customer_directory_path> --datadir <customer_provided>
  
  

• After PostgreSQL is installed using the above, download SQL files below.
  createDocsDB.sql
  vtdocs-tables.sql

• Run the following command to configure the database. Note, psql has to be run from the postgresql install directory\bin
  
  -W in the first command will prompt you for the password you created at install via --superpassword
  
  -W in the second command will prompt you for the password you created in the first psql command via -v pwd="''"
  psql -U postgres -W -f "\path\to\createDocsDB.sql" -v pwd="'asecurepassword'"

psql -U vtdocs -W -f vtdocs-tables.sql
  
• Update the context.xml file located at C:\Program Files\VisibleThread\vtdocs\tomcat\conf\context.xml to match the database User, DB and password created above. The two lines that need to be edited should look like this:
  

  url="jdbc:postgresql://127.0.0.1:5432/vtdocs"
  

  username="vtdocs" password="yourpasswordhere" maxTotal="20" maxIdle="10" maxWaitMillis="-1"

   Note "yourpasswordhere" is the password you set with the first psql command above

   

  Lastly, just restart the vtdocs-tomcat service. Type Services into the search bar and scroll until you find vtdocs-tomcat, select it and click Restart

If you have any issue with your installation, please contact us at support@visiblethread.com