Upgrade Apache Tomcat

1.     Backup Tomcat folder if it exists ensuring that you backup at a minimum the following items

• BravaServer in webapps
• All configuration *.config files in conf folder
• JKS and SSL certificate file in conf folder

2.     Uninstall previous Java Runtime Environment

3.     Uninstall previous Tomcat server

4.     Download the Java Installer and the appropriate Apache Tomcat installers

5.     Restart web server

6.     Install the JavaSetup8u221 executable with all the defaults

7.     Install the Apache Tomcat 9.0.31 executable

8.     During installation provide pd_usr login and password which saves the values in the tomcat-users.xml file with manager-gui role. (NOTE: The password will not be encrypted)

9.     On finish do not start the Apache Tomcat Service when asked by the installer

10.  Copy BravaServer to the webapps folder and configuration files along with JKS and SSL certificate to conf folder (eg. E:\Program Files (x86)\Apache Software FoundationOld\webapps\BravaServer)

11.  Configure Apache Tomcat service to run under pd_usr, set to Automatic start, and set it to Restart on any failures for 1st, 2nd, and subsequent failures

12.  Start the service

13.  Verify HTML5 publishing and viewing are successful by uploading a new file and using a non-Internet Explorer browser, try to view the uploaded file

Apache Tomcat Max Memory Pool Update

To access the dialog in the screenshot below, double click on Tomcat8w.exe in the \Program Files\IGC\Brava\bin folder

• Double click the Tomcat8 executable with the “w.exe” which will open the Tomcat Properties dialog
• Tomcat8w is a GUI application for monitoring and configuring Tomcat services
• Click on the Java tab and update the Maximum memory pool to 1024
• Restart the Apache Tomcat service

Java Heap Update

When Brava! is used in a production environment with Apache Tomcat as the servlet engine, it is recommended that the Apache Tomcat JVM Heap Size setting be increased from the default (128MB min - 256MB max) to 1GB max to prevent the Brava! Server from becoming unresponsive.

1. Go to the Control Panel and launch the Java Console
2. Choose the Java tab, click View
3. Choose the System tab and click into the Runtime Parameters
4. Set the Apache Tomcat JVM Heap Size for production at 1GB, by typing -Xms1024m
5. Click OK and navigate out of the Control Panel

Post Install Tasks

1.  Services:  Ensure that all ProjectDox Services are restarted

1. Check that each ProjectDox Service is configured to login with the appropriate account for each
2. Set Failures to Retry for 1st, 2nd and 3rd Retries
3. Change the Startup type to Automatic and then restart the services
4. Check Debug.txt file for any errors and correct

2.  Apache Tomcat Log Files:  The log files for the Apache Tomcat web server will continuously accumulate on the web server until they eventually will consume the entire storage space on the partition where Apache is installed.  To prevent this from happening, you can comment out the following line in the server.xml file for your Tomcat installation.