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.