Troubleshooting the Tomcat installation

If a blank page is displayed, then Tomcat was not installed properly. The most common reason for a Tomcat installation failure is configuring the HTTP/1.1 Connector Port to a port that was already in use.

To determine why Tomcat did not install and start properly, look at the following log file:
%TomcatDir%/logs/catalina.<date>.log

This file provides detailed information about why Tomcat did not start. For example, consider the following message:

May 28, 2013 11:16:30 AM org.apache.catalina.core.StandardService start
SEVERE: Failed to start connector [Connector[HTTP/1.1-80]]
LifecycleException:  service.getName(): "Catalina";  Protocol handler start failed: java.net.BindException: Address already in use: JVM_Bind <null>:80

This message indicates that Tomcat is configured to use HTTP/1.1 port 80, but this port is already used by another application. To solve this issue:

  1. Find a port that is not used by another application.

    You can use a utility such as netstat to get a list of ports already used.

  2. Open the %TomcatDir%/conf/server.xml file.
  3. Look for the <Connector> element for the HTTP/1.1 protocol.
    For example:
    <Connector port="80" protocol="HTTP/1.1" 
               connectionTimeout="20000" 
               redirectPort="8443" />
  4. Set the port attribute as appropriate; for example:
    <Connector port="8090" protocol="HTTP/1.1" 
               connectionTimeout="20000" 
               redirectPort="8443" />
  5. Save and close the file.
  6. Restart Tomcat.

Contact IXIASOFT Support if you cannot solve the issue.