Generating a Liberty server dump from the command line
From the command line, you can use the server dump or server javadump command to capture status information for a Liberty server.
About this task
The server dump command is useful for problem diagnosis of a Liberty server because the result file contains server configuration, log information, and details of the deployed applications in the workarea directory. The command can be applied to either a running or a stopped server.
For
a running server, the following information is also included:
- State of each OSGi bundle in the server
- Wiring information for each OSGi bundle in the server
- Component list that is managed by the Service Component Runtime (SCR) environment
- Detailed information of each component from SCR
- Configuration administration data of each OSGi bundle
- Information about registered OSGi services
- Runtime environment settings such as Java™ virtual machine (JVM), heap size, operating system, thread information, and network status
The server javadump command
is useful for diagnosing problems at the JVM level, such as hung threads,
deadlocks, excessive processing, excessive memory consumption, memory
leaks, and defects in the virtual machine. The command can be used
only on a running server. Each dump type creates a file, but not all
dump types are supported by all virtual machines. See Server command options. The default directory for
dump files is ${server.output.dir}. To set a different
default directory, you must use an IBM® JVM
and set the following environment variables:
- IBM_HEAPDUMPDIR
- IBM_COREDIR
- IBM_JAVACOREDIR