server.xml elements beginning with K and L
The following elements are discussed below:
keep-alive
The keep-alive element configures the HTTP keep-alive subsystem. This element may appear zero or one time within the server element. For more information, see server.
Subelements
The keep-alive element can contain the following subelements:
Table 3-29 List of keep-alive Subelements
| Element | Occurrences | Description |
|---|---|---|
| enabled | 0 or 1 | Determines whether the keep-alive subsystem is enabled at runtime. The default value is true. |
| threads | 0 or 1 | The number of keep-alive subsystem threads. The value can be from 1 to 128. The default value is 1. |
| max-connections | 0 or 1 | The maximum number of concurrent keep-alive connections that the server supports. The value can be from 1 to 1048576. The default value is 200. |
| timeout | 0 or 1 | The timeout (in seconds) after which an inactive keep-alive connection can be closed. The value can be from 0.001 to 3600. The default value is 30 seconds. |
| poll-interval | 0 or 1 | The interval (in seconds) between polls. The value can be from 0.001 to 1. The default value is .001. |
See Also
lifecycle-module
The lifecycle-module element configures a Java server lifecycle module, a user-defined class that implements com.sun.appserv.server.LifecycleListener. This element may appear zero or more times within the server element. For more information, see server.
Subelements
The lifecycle-module element can contain the following subelements:
Table 3-30 List of lifecycle-modules Subelements
| Element | Occurrences | Description |
|---|---|---|
| enabled | 0 or 1 | Determines whether the lifecycle module is enabled at runtime. The default value is true. |
| name | 1 | The name that uniquely identifies the lifecycle module. |
| class | 1 | The class that implements the lifecycle module. The value is the name of a class that implements com.sun.appserv.server.LifecycleListener. |
| load-order | 0 or 1 | The order in which the lifecycle module is loaded. It is recommended that you choose a load-order value that is greater than or equal to 100 to avoid conflicts with internal lifecycle modules. The value can be from 0 to 2147483647. Values from 0 to 99 are reserved for internal use. |
| is-failure-fatal | 0 or 1 | Determines whether the server should treat exceptions thrown during lifecycle module initialization as fatal. The default value is true. |
| class-path | 0 or 1 | The classpath for the lifecycle module. |
| property | 0 or more | Configures optional lifecycle-module-specific properties. For more details, see property. |
| description | 0 or 1 | The description of the resource. |
localization
The localization element configures how the server chooses the language in which it presents information to the client. This element may appear zero or one time within the server element, and zero or one time within the virtual-server element. For more information, see server, and virtual-server.
Subelements
The localization element can contain the following subelements:
Table 3-31 List of localization Subelements
| Element | Occurrences | Description |
|---|---|---|
| default-language | 0 or 1 | The default language in which the messages and content are displayed. The value is a language tag. |
| negotiate-client-language | 0 or 1 | Determines whether the server attempts to use the Accept-language HTTP header to negotiate the content language with clients. The default value is false. |
lock-db
The lock-db element configures the WebDAV lock database. This element may appear zero or one time within the dav element, and zero or one time within the dav-collection element. For more information, see dav and dav-collection.
Subelements
The lock-db element can contain the following subelements:
Table 3-32 List of lock-db Subelements
| Element | Occurrences | Description |
|---|---|---|
| path | 0 or 1 | The path of the WebDAV lock database. If a relative path is used, it is relative to the server's config directory. |
| update-interval | 0 or 1 | The interval (in seconds) at which WebDAV lock databases are synchronized to disk. The value can be from 0.001 to 3600, or 0 to disable caching of WebDAV lock information. |
See Also
log
The log element configures the logging subsystem. This element may appear zero or one time within the server element. For more information, see server.
Subelements
The log element can contain the following subelements:
Table 3-33 List of log Subelements
| Element | Occurrences | Description |
|---|---|---|
| log-stdout | 0 or 1 | Determines whether the server logs data that applications write to stdout. The default value is true. |
| log-stderr | 0 or 1 | Determines whether the server logs data that applications write to stderr. The default value is true. |
| log-virtual-server-name | 0 or 1 | Determines whether the server includes the virtual server name in log messages. The default value is false. |
| create-console | 0 or 1 | Determines whether the server creates a console window (Windows only). The default value is false. |
| log-to-console | 0 or 1 | Determines whether the server writes log messages to the console. The default value is true. |
| log-to-syslog | 0 or 1 | Determines whether the server writes log messages to syslog (UNIX only ) or Event Viewer (Windows only). The default value is false. |
| date-format | 0 or 1 | The date format for log message timestamps. The default value is %d/%b/%Y:%H:%M:%S. For more information, see Appendix D: Using Time Formats. |
| archive-suffix | 0 or 1 | The suffix appended to rotated log file names. The default value is %Y%m%d%H%M. |
| archive-command | 0 or 1 | The command executed after the server rotates a log file. The program is passed the post-rotation file name of the log file as an argument. The value is a program command line. For example,<archive-command>gzip</archive-command>}}or{{<archive-command>"c:\Program Files\Perl\perl.exe" archive.pl</archive-command> |
| log-level | 0 or 1 | The log verbosity for the server. The value can be finest (most verbose), finer, fine, info, warning, failure, config, security, or catastrophe (least verbose). |
| log-file | 0 or 1 | Defines the log file for the server. The value is the file name of the log file, for example, ../logs/errors. If a relative path is used, it is relative to the server's config directory. |