18.1 Description
The adbinfoget command collects troubleshooting-information files that can be used to determine the cause of an error. The command also outputs troubleshooting information and estimates the size of the troubleshooting-information files that will be output.
- Important
-
When the multi-node function is being used, the adbinfoget command outputs troubleshooting information and estimates the size of and collects troubleshooting-information files on only the node where the command is executed. This means that when a failure occurs while the multi-node function is being used, you must execute the adbinfoget command on all nodes to collect troubleshooting-information files.
Execute this command to collect troubleshooting-information files whenever Contact the customer support center is given as the action to take in response to a message output during HADB server operation. The following figure shows the procedure for using the adbinfoget command to collect troubleshooting-information files.
|
-
Outputting troubleshooting information (while the HABD server is running)
The following troubleshooting information is output if the HADB server terminates abnormally:
-
Core files
-
HADB dumps
The preceding troubleshooting information is not output if an error occurs while the HADB server is running. Examples of such errors include an application program or command that does not terminate and an HADB server that has become unresponsive. Therefore, if you collect a troubleshooting-information file immediately after an error occurred, you cannot collect necessary information.
If an error occurs while the HADB server is running, you must first output the preceding troubleshooting information. Then, perform the following procedure.
- Note
-
Core files are output as troubleshooting information (detailed version). Output of core files might require a long time. Therefore, if you know that the detailed version of troubleshooting information will not be collected, only output HADB dumps.
-
-
Estimating the size of the troubleshooting-information files to be output
The adbinfoget command estimates the size of the troubleshooting-information files that will be output. A considerable amount of troubleshooting-information might be output, because it includes information about shared memory. Therefore, check its potential size before you collect the information. The required troubleshooting-information files will not be collected if there is insufficient disk space. Additionally, the performance of the HADB server might be adversely affected if a shortage of disk space occurs.
The command provides the maximum amount of disk space that might be required for collecting the troubleshooting-information files. This maximum amount of space might not end up corresponding to the size of the troubleshooting-information files that are actually output.
-
Collecting the troubleshooting-information files
There are the following four types of troubleshooting-information files. YYYYMMDDhhmmss in each file name indicates the time when the adbinfoget command was executed.
-
Troubleshooting-information file (mail version) (adbinfoYYYYMMDDhhmmss_mail.tar.gz)
This file stores the minimum amount of information required for troubleshooting.
-
Troubleshooting-information file (light version) (adbinfoYYYYMMDDhhmmss_light.tar.gz)
This file stores troubleshooting information, but excludes some information, such as core files and shared memory dump files.
-
Troubleshooting-information file (detailed version) (adbinfoYYYYMMDDhhmmss_detail.tar.gz)
This file stores all information that can be collected by the adbinfoget command.
-
Troubleshooting-information file (root version) (adbinfoYYYYMMDDhhmmss_root.tar.gz)
This file stores the additional information that can be collected by the adbinfoget command when it is executed with the -r option by a superuser.
Typically, you will collect all four types of troubleshooting-information files, the mail, light, detailed, and root versions. If collection of troubleshooting-information files is expected to take a long time because of the estimated output size of the detailed version, you might want to collect only the mail, light, and root versions. Always collect the root version of the troubleshooting-information files.
If the adbinfoget command is executed after the HADB server has terminated abnormally, the command collects troubleshooting information for the HADB server at the point when the failure occurred and collects OS status information as of the time of the command's execution. If the HADB server is running or has been terminated, the command collects the troubleshooting information for the HADB server and the OS status information as of the time of the command's execution.
-