Changing the Hyena configuration

The default Hyena configuration takes place during installation of the Web administration component of Sybase Search. You can change the configuration of the Hyena servlet container using a text editor to edit the Hyena configuration file called server.xml, located in install_location\Hyena\config.

Table 4-1: *HTTP server tag attributes*
Attribute	Default value	Description
port	None	The TCP/IP port on which Hyena listens for connections.
host	localhost	The name or IP address of the host on which the Hyena servlet container resides.
stdOutput	false	All standard output (for example, printed to java.lang.System.out and java.lang.System.err) is always redirected to the Hyena log file. When set to true, the output is sent to the original standard output (usually the console) as well.

Table 4-2 shows the attributes for the Request-Handler tag.

**Table 4-2: *Request-Handler tag* attributes**
Attribute	Default value	Description
minThreads	10	The minimum number of server threads that Hyena uses to serve connections.
maxThreads	75	The maximum number of server threads that Hyena uses to serve connections.
maxIdleTime	10000	The number of milliseconds an idle server thread is kept alive before being destroyed. This parameter applies only when the current number of server threads exceeds the minimum.
debug	false	If set to true, request handling debug information is written to standard output for every HTTP connection received.

Table 4-3 shows the attributes for the Request-Parser tag.

Table 4-3: *Request-Parser tag attributes*
Attribute	Default value	Description
maxHeaderLength	None	The maximum number of characters accepted in any one HTTP request header (including GET parameters). Requests using headers longer than this value are denied. Requests that send large parameter values should use the POST method.
maxNumberOfHeaders	None	The maximum number of request headers accepted as part of any single request. Requests formed using more headers than this value are denied.

Table 4-4 shows the attributes for the Request-Keep-Alive tag.

**Table 4-4: *Request-Keep-Alive tag* attributes**
Attribute	Default value	Description
enabled	false	When set to true, HTTP keep-alive is used with all HTTP clients that support it.
maxRequests	None	The maximum number of requests that are served by any one connection.
timeout	None	The number of milliseconds the server waits for further requests on an open connection before breaking it.

Table 4-5 shows the attributes for the Remote-Admin tag.

**Table 4-5: *Remote-Admin tag* attributes**
Attribute	Default value	Description
enabled	false	When set to true, authorized stop and start commands sent through HTTP are accepted.
authCode	None	The authorization code required by the remote administration listener.

Table 4-6 shows the attributes for the Logging tag.

**Table 4-6: *Logging tag* attributes**
Attribute	Default value	Description
enabled	false	If set to true, HTTP requests are logged.
directory	None	Designates the directory in which log files are written.
prefix	None	The standard prefix for all log file names (appears before the date).
suffix	None	The standard suffix to use for all log file names (appears after the date).
timestamp	false	If set to true, the time of each HTTP request is written to the log.

Table 4-7 shows the attributes for the Container tag.

**Table 4-7: *Container tag* attributes**
Attribute	Default value	Description
debug	false	Prints debugging information to the standard output stream. Information includes the context name and path, the Java libraries used, and details of each servlet that is loaded.

Table 4-8 shows the attributes for the JSP-Handler tag.

**Table 4-8: *JSP-Handler tag* attributes**
Attribute	Default value	Description
vigilance	0	The number of seconds that must elapse before the last modified date of the .JSP file is checked to determine whether it needs to be recompiled. Set this value to zero or a negative number to never check the file. If this attribute is set to a positive value, you must load the Java compiler library. For more information about obtaining and loading a Java compiler library, contact Sybase Technical Support.

Table 4-9 shows the attributes for the Error-Template tag.

**Table 4-9: *Error-Template tag* attributes**
Attribute	Default value	Description
path	install_location\config\error_template.htm	Defines the path to an HTML template with which error messages are formatted to display to clients when an application error is encountered.

Table 4-10 shows the attributes for the Context tag.

**Table 4-10: *Context tag* attributes**
Attribute	Default value	Description
name	None	All context resource URIs implicitly start with this value, which must begin with a forward slash. For example, the context named /omniq can have its home page at /omniq/index.html.
path	None	The full path of the directory that contains the context.