VisibleThread -
Help Center Find helpful articles on different VisibleThread Products

Follow

How to install VT Docs on Windows

Minimum Server Spec

8GB RAM
2 CPU Cores
80GB disk

Windows installs have been tested and verified on the following version:
Windows 10, 11
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_5_0_5.exe

 

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

certutil -hashfile vtdocs_windows-5_0_5.exe MD5

The valid SHA256 Hash is: b7744d9a725d60c8ba5dc73617e5ebe3

 

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.

install2.png

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

install1.png

 

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

postgres.png

  • 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 Restartservice.png

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

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

Get Additional Help

Visit our Helpdesk for additional help and support.