Sun GlassFish Enterprise Server v2.1.1 Troubleshooting Guide

Identifying the Problem

Java EE application servers are typically deployed in complex and highly sophisticated operating environments. The Sun GlassFish Enterprise Server covers a broad range of technologies, including Java, Java servlets, XML, JSP, JDBC data sources, EJB technology, and more. Other products and tools associated with the Enterprise Server are LDAP, Web Server, , deployment and migration tools, and so on. Understanding and diagnosing complex issues involving so many disparate components requires thorough knowledge and a careful diagnostic process.

Gathering any or all of the following information will make it easier to classify a problem and search for solutions. Note that operating system utilities, such as pkginfo and showrev on Solaris and rpm on Linux, are helpful in gathering system information.

ProcedureVerifying configuration information

  1. What are the exact version numbers of the operating system and products installed?

  2. Have any patches been applied? If so, specify product and operating system patch numbers.

  3. How is the system configured?

  4. What system resources does the system have (memory, disk, swap space, and so on)?

  5. How many application servers, web servers, and directory servers are installed?

  6. How is the web server connected to Enterprise Server? On the same machine or not?

  7. How is the Enterprise Server connected to the directory server?

  8. Are application servers in a cluster or not?

  9. Was any upgrade done? If so, what were source and target versions?

  10. Was a migration done? If so, what were source and target versions?

  11. Have any new applications been deployed?

  12. Is SSL enabled or not?

  13. What versions of the HADB and the backend database are being used?

  14. What JDBC driver is being used to access the database?

  15. What JDK version is being used?

  16. What are the JVM heap, stack, and garbage collection-related parameters set to?

  17. What are the JVM options?

  18. What third-party technologies are being used in the installation?

  19. Are the interoperating component versions in compliance with the compatibility matrix specified in the release notes?

    After gathering this information:

    • Collect web server error and access log data (web server instance-specific).

    • Collect any Enterprise Server stack traces. Note that a fresh set of logs associated with the specific problem should be run. This avoids scanning gigabytes of irrelevant log information.

    • Determine the sequence of events that occurred when the problem first appeared, including any steps that may already have been taken to resolve the problem.