Troubleshooting the service installation

If the service installs properly, but fails to start, you can use the steps provided here to troubleshoot.

For additional details on using the Tomcat service and service monitor, see http://tomcat.apache.org/tomcat-6.0-doc/windows-service-howto.html.

As you are troubleshooting, check the log files (endeca-portal\tomcat-6.0.x\logs\jakarta_service*.log) for the relevant messages.

If the service will not start:

  1. If you downloaded the service installer and monitor files manually, then make sure that you have used the correct version of the Tomcat download:
    • Tomcat version 6.0.x
    • For a 32-bit JVM (including the bundled JVM), apache-tomcat-6.0.x-windows-x86.zip
    • For a 64-bit JVM, apache-tomcat-6.0.x-windows-x64.zip
  2. If you are not using the bundled JVM, make sure that the JAVA_HOME environment variable is set to the location of your JDK.

    By default, service.bat looks for %JAVA_HOME%\jre\server\jvm.dll.

    To change JAVA_HOME after the service is installed:
    1. Uninstall the service. To uninstall the service, run the following command:
      service.bat remove
    2. Update JAVA_HOME.
    3. Reinstall and restart the service.
  3. Make sure the Tomcat service monitor is configured to point to the location of your JVM.
    1. Double-click the monitor executable.
    2. On the properties dialog, click the Java tab.
    3. Uncheck Use default.
    4. In the Java Virtual Machine field, specify the path to jvm.dll.

      For the bundled JVM, the file is endeca-portal\tomcat-6.0.x\jre1.6.0_x\win\bin\client\jvm.dll.

      If you are not using the bundled JVM, then set the path to your JVM.

    5. Click OK.
  4. Use the Tomcat service monitor to set the startup and shutdown modes to Java.
    1. Double-click the monitor executable.
    2. On the properties dialog, click the Startup tab.
    3. From the Mode drop-down list, select Java.
    4. Click the Shutdown tab.
    5. From the Mode drop-down list, select Java.
    6. Click OK.