4.9.5 Acquiring the Administration Agent Memory Dump
This section describes how to acquire the Administration Agent memory dump for each OS.
- Organization of this subsection
(1) In Windows
If Administration Agent is running (if the adminagent process exists), collect the memory dump from the task manager#.
If Administration Agent is down, collect the memory dump from the Windows debug tool#.
- #
-
For details, see the Microsoft website.
To acquire the memory dump when Administration Agent is down, you need to specify settings in advance. For details on how to specify the settings, see 3.3.15 Settings for Collecting a User Dump.
(2) In UNIX
If Administration Agent (the adminagent process) is down, acquire the core dump output in Application-Server-installation-directory/manager/bin.
After acquiring a core dump, if you want to acquire only the stack trace information from the core dump, execute the javatrace command. The stack trace information is the information required for investigating the cause of abnormal termination of JavaVM. For details about how to acquire the stack trace information, see 4.18 JavaVM stack trace information.
You can acquire a core dump in the following cases. The following describes how to acquire a core dump for each case:
-
Acquiring a core dump when Administration Agent is running
To acquire a core dump while Administration Agent is running, check the process ID of the adminagent process and execute the kill command. Execute the kill command in the following format. Note that the process terminates when the kill command is executed. Therefore, we recommend that you execute the kill command before Administration Agent is restarted.
kill -6 Administration-Agent-(adminagent)-process-ID
-
Acquiring a core dump and thread dump concurrently in a running Java process
Execute the javacore command to acquire a core dump and thread dump concurrently in the running Java process. The execution format of the javacore command is described below. For details about the options that can be specified, see javacore (Acquiring the core file and thread dump/in UNIX) in the uCosminexus Application Server Command Reference Guide.
javacore -p process-ID
The following message is output if you execute the command in the above format.
send SIGQUIT to 8662: ? (y/n)
If you enter y, javacoreprocess-ID.output-date-and-time.core (core dump) and javacoreprocess-ID.output-date-and-time.txt (thread dump) are output to the current directory from where the Java program is being executed. If you enter n, the command is terminated without acquiring the core dump and thread dump.
When the core dump and thread dump are acquired, the following message is output to the running Java program. Note that the information in italics is not actually displayed.
Now generating core file (javacore8662.030806215140.core)... done (End of core dump and thread dump output) Writing Java core to javacore8662.030806215140.txt... OK