Troubleshooting Apache Tomcat Issues

The following issues might arise during the AccuRev Web UI installation and testing process.

Another Web server (or other process) uses port 8080

By default, Apache Tomcat attempts to bind to port 8080 at startup. To change this value, open <CATALINA_HOME>\conf\server.xml, and search for 8080. Change that number to a port (higher than 1024) that is not in use. Save your changes and restart Apache Tomcat.

The Tomcat web server fails to start due to port conflicts, or because another Tomcat web server instance is already running

When the Tomcat web server starts, it binds two ports (HTTP and Server Shutdown), which are configurable in <CATALINA_HOME>\conf\server.xml. These bindings prevent more than one instance of the Tomcat web server from starting unless each instance is configured to run on a separate port. The details of configuring multiple Tomcat web server instances are beyond the scope of this document.

The Tomcat web server tries to use the wrong JRE/JDK

Microsoft Windows
Follow these instructions to set the default JRE or JDK:
  1. Right-click the Tomcat icon in the taskbar, and choose Configure. The Configuration dialog box appears.
  2. Navigate to the Java tab on the Configuration dialog box, and select the Use default checkbox.
  3. Click OK to save the change.
Linux
Check that the JRE_HOME (if using the JRE) or JAVA_HOME (if using the full JDK) environment variable indicates the version specified in Setting Up the Java Environment.