Note: This can only be done with VT Docs version 3.2.2
Out of the box, our Tomcat application server runs on port 8080. We also have an Apache web server acting as a reverse proxy into Tomcat - this runs on port 443 (https).
If you wish to configure Tomcat to run on another port and configure Apache to reverse proxy to this other port. To implement this you will need to :
1. Edit the Tomcat config:
For Ubuntu deployments the file location is: /home/visiblethread/tomcat/conf/server.xml
For Red Hat deployments the file location is: /opt/visiblethread/tomcat/conf/server.xml
Find & change the port e.g.
<Connector port="8081" protocol="HTTP/1.1"
2. Edit the Apache config:
For Ubuntu deployments the file location is: /etc/apache2/sites-enabled/000-default.conf
For RedHat deployments the file location is: /etc/httpd/conf.d/visiblethread.conf
In here you need to change the ProxyPass and ProxyPassReverse to match the port you have chosen in the server.xml file. See example below, notice the ports below match the connector port above 8081.
ProxyPass / http://localhost:8081/
ProxyPassReverse / http://localhost:8081/
3. Restart Tomcat and Apache:
service supervisor restart && service apache2 restart
Red Hat deployments
service httpd restart && service visiblethread-docs restart
Now that you have changed the port it is advised that you log into the application and run the following functional tests:
Upload a document, Generate a compliance matrix, Generate a PDF via export
If you run into trouble or have any questions you can get in touch with us at email@example.com