Hitachi

uCosminexus Application Server Definition Reference Guide


4.10.3 Parameters used for setting up the log output method of Cosminexus HTTP Server

This table describes the parameters used for setting up the log output method of Cosminexus HTTP Server. In the table below, Default value means the value that is assumed when the parameter is not specified. VR is the version of Application Server on which parameters are introduced or changed.

Table 4‒9: Parameters used for setting up the log output method of the Cosminexus HTTP Server log

Value of param-name

Value of param-value

Specifiable value

Default value

VR

CustomDivideFileNum

Enabled when Div is specified in HttpsdCustomMethod.

Specifies the number of divided log files. If the number of divided files exceeds the number specified here, the oldest files are deleted. If 0 is specified, the files are not deleted.

Specify the value using an integer from 0 to 256.

8

07-50

CustomDivideTimeDifference

Enabled when Div is specified in HttpsdCustomMethod.

Specifies the standard time for dividing the log files (unit: minutes) in a range from -1439 to 1439 as the difference for GMT. If 0 is specified, January 1, 1970, 0:0:0 (GMT) becomes the standard time.

Specify the value using an integer from -1439 to 1439.

540

07-50

CustomDivideTimeInterval

Enabled when Div is specified in HttpsdCustomMethod.

Specifies the time interval used for one log file in a range from 1 to 31536000.

Specify the value using an integer from 1 to 31536000.

86400

07-50

CustomWraparoundFileNum

Enabled when Wrap is specified in HttpsdCustomMethod.

Specifies the maximum number of log files to be output in a range from 1 to 256.

If the size of the log file exceeds the size specified in CustomWraparoundFilesize, log is output to the next log file. In such a case, if the same number of log files as the maximum number specified in this parameter are already created, the files are re-used from the file with the name .001.

Specify the value using an integer from 1 to 256.

5

07-50

CustomWraparoundFilesize

Enabled when Wrap is specified in HttpsdCustomMethod.

Specifies the maximum size of the log file (units: kilobytes) in a range from 1 to 2097151.

During log output, if the log file size exceeds the maximum size specified in this parameter, the log is output to the next log file. In such a case, the contents of the log file in which the log is output are cleared.

Specify the value using an integer from 1 to 2097151.

8192

07-50

ErrorDivideFileNum

Enabled when Div is specified in HttpsdErrorMethod.

Specifies the number of divided log files in a range from 0 to 256. If the number of divided files exceeds the number specified here, the oldest files are deleted. If 0 is specified, the files are not deleted.

Specify the value using an integer from 0 to 256.

8

07-50

ErrorDivideTimeDifference

Enabled when Div is specified in HttpsdErrorMethod.

Specifies the standard time for dividing the log files (unit: minutes) in a range from -1439 to 1439 as the difference for GMT. If 0 is specified, January 1, 1970, 0:0:0 (GMT) becomes the standard time.

Specify the value using an integer from -1439 to 1439.

540

07-50

ErrorDivideTimeInterval

Enabled when Div is specified in HttpsdErrorMethod.

Specifies the time interval used for one log file in a range from 1 to 31536000.

Specify the value using an integer from 1 to 31536000.

86400

07-50

ErrorWraparoundFileNum

Enabled when Wrap is specified in HttpsdErrorMethod.

Specifies the maximum number of log files to be output in a range from 1 to 256.

If the size of the log file exceeds the size specified in ErrorWraparoundFilesize, log is output to the next log file. In such a case, if the same number of log files as the maximum number specified in this parameter are already created, the files are re-used from the file with the name .001.

Specify the value using an integer from 1 to 256.

5

07-50

ErrorWraparoundFilesize

Enabled when Wrap is specified in HttpsdErrorMethod.

Specifies the maximum size of the log file (units: kilobytes) in a range from 1 to 2097151.

During log output, if the log file size exceeds the maximum size specified in this parameter, the log is output to the next log file. In such a case, the contents of the log file in which the log is output are cleared.

Specify the value using an integer from 1 to 2097151.

8192

07-50

HttpsdCustomLogFileDir

Specifies the directory to output the access log output by the Web server.

Specify any string.

Logs

07-50

HttpsdCustomlogFormat

Specifies the label name provided by Cosminexus HTTP Server or an optional format.

The formats corresponding to the label names provided by Cosminexus HTTP Server are as follows:

  • common

  • combined

  • combinedio

  • hws_std

  • hws_trace

To specify a format other than the above, specify the optional format. The contents specified in the format are set up in the argument of the CustomLog directive in httpsd.conf (Cosminexus HTTP Server definition file).

For details on the contents to be specified in the format, see the description about the CustomLog directive in the manual Cosminexus HTTP Server.

When you are using UNIX and the value of the manager.web.send_request_method parameter is reverseproxy, if you directly edit httpsd.conf, do not delete the LogFormat directive that is specified by default.

Specify any string with a maximum of 1024 characters.

hws_std

07-50

HttpsdCustomMethod

Specifies one of the following as the log output method for access log:

Off:

Does not change the settings in httpsd.conf (Cosminexus HTTP Server definition file)

If httpsd.conf is not edited, the default value is set.

On:

Outputs the log with a monotonic increase.

Div:

Divides and outputs the log in fixed time units.

Wrap:

Divides the log by the file size and outputs the log with wraparound.

The following strings can be specified:

  • Off

  • On

  • Div

  • Wrap

Div

07-50

HttpsdErrorLogFileDir

Specifies the directory to output the error log output by the Web server.

Specify any string.

Logs

07-50

HttpsdErrorMethod

Specifies one of the following as the error log output method:

Off:

Does not change the settings in httpsd.conf (Cosminexus HTTP Server definition file) If httpsd.conf is not edited, Wrap is set.

On:

Outputs the log with a monotonic increase.

Div:

Divides and outputs the log in fixed time units.

Wrap:

Divides the log by the file size and outputs the log with wraparound.

The following strings can be specified:

  • Off

  • On

  • Div

  • Wrap

Wrap

07-50

HttpsdLogFileDir

Specifies the directory to which log information is to be output by the Web server.

Specify any string.

Logs

06-50

07-50

HttpsdRequestLogFileDir

Specifies the directory to output the request log output by the Web server.

Specify any string.

Logs

07-50

HttpsdRequestMethod

Specifies one of the following as the request log output method:

Off:

Does not change the settings in httpsd.conf (Cosminexus HTTP Server definition file) If httpsd.conf is not edited, the default value is set.

On:

Outputs the log with a monotonic increase.

Div:

Divides and outputs the log in fixed time units.

Wrap:

Divides the log by the file size and outputs the log with wraparound.

The following strings can be specified:

  • Off

  • On

  • Div

  • Wrap

Div

07-50

HWSRequestIofilter

Enabled when "on" is set up in HWSRequestLogLevel.

Specified when the I/O filter trace showing the execution trigger is output for the I/O filter function implemented in the module. The amount of output is large, so specification in real operations is not recommended.

Specify one of the following values:

true:

Output the I/O filter trace

false:

Do not output the I/O filter trace

The following strings can be specified:

  • true

  • false

false

07-50

HWSRequestLogLevel

Specifies whether to output to the request log. Specify one of the following values:

on:

Output the I/O filter trace

none:

Do not output the I/O filter trace

If "on" is set up in this parameter, the following parameter settings are enabled:

  • HWSRequestIofilter

  • HWSRequestModuleDebug

  • HWSRequestModuleInfo

  • HWSRequestRequest

By default, the following parameters are output:

  • HWSRequestModuleInfo

  • HWSRequestRequest

The following strings can be specified: Note that the value is not case sensitive.

  • on

  • none

On

07-50

HWSRequestModuleDebug

Enabled when "on" is set up in HWSRequestLogLevel.

Specified when the module trace for internal module is output and trace corresponding to external module is output. The amount of output is large, so specification in real operations is not recommended.

Specify one of the following values:

true:

Output the I/O filter trace

false:

Do not output the I/O filter trace

The following strings can be specified:

  • true

  • false

false

07-50

HWSRequestModuleInfo

Enabled when "on" is set up in HWSRequestLogLevel.

Specified when module trace is output for the external module.

Specify one of the following values:

true:

Output the I/O filter trace

false:

Do not output the I/O filter trace

The following strings can be specified:

  • true

  • false

true

07-50

HWSRequestRequest

Enabled when "on" is set up in HWSRequestLogLevel.

Specified in the following cases:

  • When trace is output after connection is established and after response is complete

  • When trace is to be output even after receiving the next request line for KeepAlive connection

Specify one of the following values:

true:

Output the I/O filter trace

false:

Do not output the I/O filter trace

The following strings can be specified:

  • true

  • false

true

07-50

RequestDivideFileNum

Enabled when Div is specified in HttpsdRequestMethod.

Specifies the number of divided log files in a range from 0 to 256. If the number of divided files exceeds the number specified here, the oldest files are deleted. If 0 is specified, the files are not deleted.

Specify the value using an integer from 0 to 256.

8

07-50

RequestDivideTimeDifference

Enabled when Div is specified in HttpsdRequestMethod.

Specifies the standard time for dividing the log files (unit: minutes) in a range from -1439 to 1439 as the difference for GMT. If 0 is specified, January 1, 1970, 0:0:0 (GMT) becomes the standard time.

Specify the value using an integer from -1439 to 1439.

540

07-50

RequestDivideTimeInterval

Enabled when Div is specified in HttpsdRequestMethod.

Specifies the time interval used for one log file in a range from 1 to 31536000.

Specify the value using an integer from 1 to 31536000.

86400

07-50

RequestWraparoundFileNum

Enabled when Wrap is specified in HttpsdRequestMethod.

Specifies the maximum number of log files to be output in a range from 1 to 256.

If the size of the log file exceeds the size specified in RequestWraparoundFilesize, log is output to the next log file. In such a case, if the same number of log files as the maximum number specified in this parameter are already created, the files are re-used from the file with the name .001.

Specify the value using an integer from 1 to 256.

5

07-50

RequestWraparoundFilesize

Enabled when Wrap is specified in HttpsdRequestMethod.

Specifies the maximum size of the log file (units: kilobytes) in a range from 1 to 2097151.

During log output, if the log file size exceeds the maximum size specified in this parameter, the log is output to the next log file. In such a case, the contents of the log file in which the log is output are cleared.

Specify the value using an integer from 1 to 2097151.

8192

07-50