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