Sun Java System Web Server 6.1 SP10 Administrator's Configuration File Reference

Directives

The following table lists

Table 3–2 magnus.conf Directives

Directive  

Allowed Values  

Default Value  

Description  

AcceptTimeout

Any number of seconds 

30 for servers that don't use hardware encryption devices and 300 for those that do

Specifies the number of seconds the server waits for data to arrive from the client. If data does not arrive before the timeout expires then the connection is closed. 

ACLCacheLifetime

Any number of seconds 

120

Determines the number of seconds before cache entries expire. Each time an entry in the cache is referenced, its age is calculated and checked against ACLCacheLifetime. The entry is not used if its age is greater than or equal to the ACLCacheLifetime. If this value is set to 0, the cache is turned off.

ACLUserCacheSize

 

200

Determines the number of users in the User Cache. 

ACLGroupCacheSize

 

4

Determines how many group IDs can be cached for a single UID/cache entry. 

AsyncDNS

on, off

off

Specifies whether asynchronous DNS is allowed. 

CGIExpirationTimeout

Any number of seconds 

300 (5 minutes) recommended

Specifies the maximum time in seconds that CGI processes are allowed to run before being killed. 

CGIStubIdleTimeout

Any number of seconds 

30

Causes the server to kill any CGIStub processes that have been idle for the number of seconds set by this directive. Once the number of processes is at MinCGIStubs, the server does not kill any more processes.

CGIWaitPid

on, off

on

(UNIX only) makes the action for the SIGCHLD signal the system default action for the signal. Makes the SHTML engine wait explicitly on its exec cmd child processes. 

ChildRestartCallback

on, off, yes, no, true, false

no

Forces the callback of NSAPI functions that were registered using the daemon_atrestart function when the server is restarting or shutting down.

ChunkedRequestBufferSize

Any number of bytes 

8192

Determines the default buffer size for “un-chunking” request data. 

ChunkedRequestTimeout

Any number of seconds 

60 (1 minute).

Determines the default timeout for “un-chunking” request data. 

ConnQueueSize

Any number of connections (including 0) 

4096

Specifies the number of outstanding (yet to be serviced) connections that the web server can have. 

This setting can have performance implications. For more information, see the Sun Java System Web Server 6.1 SP10 Performance Tuning, Sizing, and Scaling Guide.

DefaultLanguage

en (English),fr (French),de (German),ja (Japanese)

en

Specifies the default language for the server. The default language is used for both the client responses and administration. 

DNS

on, off

on

Specifies whether the server performs DNS lookups on clients that access the server. 

ErrorLogDateFormat

See the manual page for the C library function strftime

%d/%b/%Y:%H:%M:%S

The date format for the error log. 

ExtraPath

A path 

(none) 

Appends the specified directory name to the PATH environment variable. This is used for configuring Java on Windows NT. There is no default value; you must specify a value.

Favicon

On / Off

on

Provides the web server administrator the ability to disable or change the icon which appears in the web address book or favorites list on Internet Explorer browsers (so, favicon translates as favorite icon).

HeaderBufferSize

Any number of bytes 

8192 (8 KB)

The size (in bytes) of the buffer used by each of the request processing threads for reading the request data from the client. The maximum number of request processing threads is controlled by the RqThrottle setting.

HTTPVersion

m.n; m is the major version number and n the minor version number

1.1

The current HTTP version used by the server. 

KeepAliveQueryMaxSleepTime

 

100

On lightly loaded systems that primarily service keep-alive connections, you can lower this number to enhance performance. However doing so can increase CPU usage. 

This directive specifies an upper limit to the time slept (in milliseconds) after polling keep-alive connections for further requests. 

KeepAliveQueryMeanTime

 

100 is appropriate for almost all installations.

Note that CPU usage will increase with lower KeepAliveQueryMeanTime values. 

This directive specifies the desired keep-alive latency in milliseconds. 

KeepAliveThreads

Any number of threads 

1

Specifies the number of threads in the keep-alive subsystem. It is recommended that this number be a small multiple of the number of processors on the system. 

KeepAliveTimeout

300 seconds maximum

30

Determines the maximum time that the server holds open an HTTP Keep-Alive connection or a persistent connection between the client and the server. 

KernelThreads

0 (off), 1 (on)

0 (off)

If on, ensures that the server uses only kernel-level threads, not user-level threads. If off, uses only user-level threads. 

ListenQ

Ranges are platform-specific 

4096 (AIX), 200 (NT), 128 (all others)

Defines the number of incoming connections for a server socket. 

LogFlushInterval

Any number of seconds 

30

Determines the log flush interval, in seconds, of the log flush thread. 

MaxCGIStubs

Any number of CGI stubs 

10

Controls the maximum number of CGIStub processes the server can spawn. This is the maximum concurrent CGIStub processes in execution, not the maximum number of pending requests. 

MaxKeepAliveConnections

0 - 1048576 (for 64–bit server)

25616

Specifies the maximum number of Keep-Alive and persistent connections that the server can have open simultaneously. 

MaxProcs

Any number of processes1 

1

(UNIX only) Specifies the maximum number of processes that the server can have running simultaneously. 

MaxRqHeaders

1 - 512

64

Specifies the maximum number of header lines in a request. 

MinCGIStubs

Any number less than MaxCGIStubs 

2

Controls the number of processes that are started by default. 

NativePoolMaxThreads

Any number of threads 

1285

Determines the maximum number of threads in the native (kernel) thread pool. 

NativePoolMinThreads

Any number of threads 

1

Determines the minimum number of threads in the native (kernel) thread pool. 

NativePoolQueueSize

Any nonnegative number 

0

Determines the number of threads that can wait in the queue for the thread pool. 

NativePoolStackSize

Any nonnegative number 

0

Determines the stack size of each thread in the native (kernel) thread pool. 

PidLog

A valid path to a file 

(none) 

Specifies a file in which to record the process ID (pid) of the base server process. 

PostThreadsEarly

1 (on), 0 (off)

0 (off) 

If on, checks whether the minimum number of threads are available at a socket after accepting a connection but before sending the response to the request. 

RcvBufSize

Range is platform-specific 

0 (uses platform-specific default)

Controls the size of the receive buffer at the server’s sockets. 

RqThrottle

Any number of requests (including 0) 

51216

Specifies the maximum number of simultaneous request processing threads that the server can handle simultaneously per socket. 

This setting can have performance implications. For more information, see the Sun Java System Web Server 6.1 SP10 Performance Tuning, Sizing, and Scaling Guide.

RqThrottleMin

Any number less than RqThrottle

484

Specifies the number of request processing threads that are created when the server is started. As the load on the server increases, more request processing threads are created (up to a maximum of RqThrottle threads).

Security

on, off

off

Globally enables or disables SSL by making certificates available to the server instance. Must be on for virtual servers to use SSL.

SndBufSize

Range is platform-specific 

0 (uses platform-specific default)

Controls the size of the send buffer at the server’s sockets. 

SSL3SessionTimeout

5 - 86400

86400 (24 hours).

The number of seconds until a cached SSL3 session becomes invalid. 

SSLCacheEntries

A non-negative integer 

10000 (used if 0 is specified)

Specifies the number of SSL sessions that can be cached. There is no upper limit. 

SSLClientAuthDataLimit

Number of Bytes 

1048576 (1MB)

Specifies the maximum amount of application data that is buffered during the client certificate handshake phase. 

SSLClientAuthTimeout

Any number of seconds 

60

Specifies the number of seconds after which the client certificate handshake phase times out. 

SSLSessionTimeout

5 - 100

100

Specifies the number of seconds until a cached SSL2 session becomes invalid. 

StackSize

Number of Bytes 

The most favorable machine- specific stack size. 

Determines the maximum stack size for each request handling thread. 

StrictHttpHeaders

on, off

off

If on, rejects connections that include inappropriately duplicated headers.

TempDir

A path 

/tmp (UNIX)

TEMP (environment variable for Windows NT)

Specifies the directory the server uses for its temporary files. On UNIX, this directory should be owned by, and writable by, the user the server runs as. 

TempDirSecurity

on, off

on

Determines whether the server checks if the TempDir directory is secure. On UNIX, specifying TempDirSecurity off allows the server to use /tmp as a temporary directory.

TerminateTimeout

Any number of seconds 

30

Specifies the time in seconds that the server waits for all existing connections to terminate before it shuts down. 

ThreadIncrement

Any number of threads 

10

The number of additional or new request processing threads created to handle an increase in the load on the server. 

Umask

A standard UNIX umask value 

(none) 

UNIX only: Specifies the umask value used by the NSAPI functions System_fopenWA() and System_fopenRW() to open files in different modes.

UseNativePoll

1 (on), 0 (off)

1 (on)

Uses a platform-specific poll interface when set to 1 (on). Uses the NSPR poll interface in the KeepAlive subsystem when set to 0 (off).

UseOutputStreamSize

Any number of bytes 

8192 (8 KB)

Determines the default output stream buffer size for the net_read and netbuf_grab NSAPI functions.

User

A login name, 8 characters or less 

(none) 

(Windows NT) specifies the user account the server runs with, allowing you to restrict or enable system features for the server. 

(UNIX) if the server is started by the superuser or root user, the server binds to the Port you specify and then switches its user ID to the user account specified with the User directive. This directive is ignored if the server isn’t started as root.

WincgiTimeout

Any number of seconds 

60

WinCGI processes that take longer than this value are terminated when this timeout expires.