Troubleshooting Tomcat on NetWare

  • 7001210
  • 25-Aug-2008
  • 26-Apr-2012

Environment

Novell Tomcat on NetWare 4.0
Novell NetWare 6.5

Situation

One of the following symptoms is present :
  • Tomcat does not start.
  • Running "java -show" does not show any org.apache.catalina.startup.Bootstrap in the Classname table:
    Classname                                                    ID
    ============================================================ ============

    NW65A:
  • Failing with the error :
    tccheck: LDAP is not up yet; waiting
    LDAP connectivity not found on ldap://localhost:636
    Please load NLDAP and then manually execute command: sys:/tomcat/4/bin/startup

    If your server host certificates have change recently, executing sys:/system/tckeygen.ncf may be needed to restore secure LDAP connectivity java: Class com.novell.application.tomcat.util.tccheck.LDAPVerifier exited successfully
  • Error 500 or 503 status codes when connecting to a tomcat-based web application.

Resolution

  1. Ensure that LDAP is operational :
    1. Run TCPCON.
    2. Select "Protocol Information".
    3. Select "TCP".
    4. Open the connection table.  This lists the open TCP ports.  It is divided into two sides - a local and a remote site, each one containing a hostname/IP address and a port number.
    5. Browse down the local side looking for "ldaps" or "636" for the local port.  If it is not found, unload NLDAP, then load NLDAP back up.  Then repeat the process.  If this fails, ensure the server has valid SSL certificates (run PKIDIAG, then hit options 4,5,6 and 0).  If this fails, consult the knowledge base regarding LDAP failures.
  2. Once it is verified that the LDAP is listening on the proper port, run "TCKEYGEN".  On the logger screen, this should display something similar to the following :
    Exporting the Host certificate from:localhost
    Trying to import Certificate 0 subjectDN=CN=nw65a.lab.novell.com, O=TOPO
    Trying to import Certificate 1 subjectDN=O=TOPO, OU=Organizational CA
    java: Class com.novell.application.tomcat.util.EDirectoryIntegrator exited successfully
  3. After properly importing the Certificate into the keystore, start tomcat using "TOMCAT4".