When the Web server terminates abnormally and does not respond, the maintenance personnel requires documents like core dump, error log, and access log to check the cause of failure. You can collect the documents required to check the failure by the hwscollect command, in a single batch. The hwscollect command is valid only on UNIX version.
You need to execute the hwscollect command with root permission.
hwscollect directory-where-the-collection-information-is-output [-f definition-file-name] |
The following is the method to use this utility when Cosminexus HTTP Server is installed with a standard configuration:
/opt/hitachi/httpsd/maintenance/hwscollect /tmp |
Define the operations of hwscollect in hwscollect.conf file. Delimit the keywords and the value with a space, and code the hwscollect.conf. Note that the keywords are not case sensitive. Line which begins with a # symbol is a comment. Specify all the file names with an absolute path. The following table describes the specifications and keywords of configuration file:
Table 4-5 Specifications and keywords of configuration file
Keyword | Value to be specified | Specification | Multiple specifications | Wild card |
---|---|---|---|---|
ServerRoot | Specify the ServerRoot directive value of httpsd.conf. | Mandatory | N | N |
conf | Specify the file name of httpsd.conf. | Mandatory | N | N |
trcinfo | Specify the directory in which hwstraceinfo command exists. | Mandatory | N | N |
trcid | Specify the file name specified in the HWSTraceIdFile directive of the httpsd.conf. | Mandatory | N | N |
PidFile | Specify the file name specified in the PidFile directive of httpsd.conf. | Mandatory | N | N |
CORE | Specify the CoreDumpDirectory directive value and SSLCacheServerRunDir directive value of httpsd.conf. | Optional | Y | Y |
LOG | Specify the file name that specifies the log in the ErrorLog directive, the TransferLog directive, and the CustomLog directive, which are in httpsd.conf. | Optional | Y | Y |
FILES | Specify any other file useful for defect analysis in addition to the above-mentioned files. | Optional | Y | Y |
The following is an example of configuration file specification:
ServerRoot /opt/hitachi/httpsd |