AOLserver

# AOLserver Detailed Configuration Reference

$Header: /cvsroot/aolserver/aolserver.com/docs/admin/config-detailed.html,v 1.2 2002/03/20 21:39:02 kriston Exp $

Please visit the Annotated Configuration Reference first. Where the documents differ, the Annotated Configuration Reference always takes precedence.

The Parameters Section

ns/parameters

This section is used to specify global AOLserver parameters.

Parameter

Default Value

Description

AuxConfigDir

A directory containing additional configuration files whose contents will be merged with the primary configuration file. After loading the primary configuration file (the value of the -c parameter on the nsd command line, usually nsd.ini), any files in the directory specified by AuxConfigDir with an .ini extension are loaded in alphabetical order.

If a configuration file section in an auxiliary configuration file already exists in the primary configuration file, the key/value pairs in that section are added to the end of the existing section from the primary configuration file. If, as a result, a specific parameter is set more than once in a section, the first setting will be used. Therefore, a parameter set in an auxiliary configuration file cannot override the same parameter set in the primary configuration file or in an auxiliary configuration file loaded before it. Some parameters, such as the Map parameters in the CGI section, can have multiple settings. In this case, all Map parameter settings will be used.

CheckExitCode

off

Boolean value. If set to on, an error is reported when a child process exits with a non-zero status.

CrashCmd

The name of a Tcl function which, when executed, will crash the server.

Debug

off

Boolean value. If set to on, debug messages will be printed to the global server log. Note: Setting Debug on will produce a large amount of debug output.

DNSCache

on

Boolean. If set to on, enables DNS cache to speed lookup of remote IP addresses. Since the DNS cache can dramatically speed lookup time, especially in the case of a busy server with the nslog module set to resolve host names, it is recommended that DNSCache be left on.

DNSCacheTimeout

60

The number of minutes between cache purges for the DNS cache.

Gid

(If neither Gid nor Group is set, the default group of the user specified by the User parameter is used.)

Unix group number.

Group

(If neither Gid nor Group is set, the default group of the user specified by the User parameter is used.)

Unix group name. This parameter is ignored if the gid parameter is set.

Home

The AOLserver home directory (the directory where AOLserver was installed). This parameter is required.

ListenBacklog

32

The maximum length of the queue of pending connections.

LogMaxBackup

10

The maximum number of server log backup files.

LogRoll

on

Boolean value. If set to on, the server log file will be rolled on a SIGHUP.

MailHost

localhost

The SMTP server AOLserver should use when sending email using the Tcl ns_sendmail function.

PidFile

serverhome/log

/nspid.setup-server-port

The pathname of the file where the server puts its pid.

ServerLog

/log/server.log under the AOLserver home directory

The file to contain any notices, warnings, or errors generated by AOLserver if AOLserver is run as a background process. If AOLserver is run in the foreground, messages are written to standard output, and this parameter is ignored.

SockNoWarn

off

Boolean value. If set to on, errors encountered while making outgoing tcp connections will be logged.

StackSize

SGI and DEC OSF: 32000

All others: the operating system default

The thread stack size. You may need to increase this parameter if an AOLserver request function or Tcl script is deeply nested, exhausting the stack space of the thread. If AOLserver is configured to use ADPs, for example, you may want to increase the thread stack size to 128K or more.

Uid

Unix uid which can be set instead of setting the User parameter.

User

The user name that AOLserver is to be run as. If you start the AOLserver as the root user, you must set this parameter. If you have selected a port number below 1024 (a "privileged" port), you will need to start the AOLserver as the "root" and specify a Unix user for the server to change to after it acquires the port. If your port number is greater than 1024, you can leave this blank.

The MIME Types Section

The ns/mimetypes configuration file section allows you to have global settings for MIME types.

ns/mimetypes

This section is used to map file name extensions to the content-type headers returned to browsers. Each parameter specifies an extension and the type to return. Any extension and content-type pair specified here will either override the default setting (if the extension is the same as a default extension) or be added to the default settings (if the extension does not exist in the default settings).

Parameter

Default Value

Description

Default

The default MIME type to use if there is no explicit mapping specified for a file name extension.

NoExtension

The MIME type to use for files with no extension.

file-extension

type (default MIME types listed below)

A content-type to return in the header information for the specified file extension.

The default MIME type parameter definitions are:

     .ai application/postscript
     .aif audio/aiff
     .aiff audio/aiff
     .ani application/x-navi-animation
     .art image/x-art
     .au audio/basic
     .avi video/x-msvideo
     .bin application/x-macbinary
     .bmp image/bmp
     .dcr application/x-director
     .dir application/x-director
     .dp application/commonground
     .dxr application/x-director
     .elm text/plain
     .exe application/octet-stream
     .gbt text/plain
     .gif image/gif
     .gz application/x-compressed
     .hqx application/mac-binhex40
     .htm text/html
     .html text/html
     .jfif image/jpeg
     .jpe image/jpeg
     .jpg image/jpeg
     .jpeg image/jpeg
     .js application/x-javascript
     .ls application/x-javascript
     .map application/x-navimap
     .mocha application/x-javascript
     .mov video/quicktime
     .mpe video/mpeg
     .mpeg video/mpeg
     .mpg video/mpeg
     .nvd application/x-navidoc
     .nvm application/x-navimap
     .pbm image/x-portable-bitmap
     .pdf application/pdf
     .pgm image/x-portable-graymap
     .pic image/pict
     .pict image/pict
     .pnm image/x-portable-anymap
     .ps application/postscript
     .qt video/quicktime
     .ra audio/x-pn-realaudio
     .ram audio/x-pn-realaudio
     .ras image/x-cmu-raster
     .rgb image/x-rgb
     .rtf application/rtf
     .sit application/x-stuffit
     .snd audio/basic
     .stl application/x-navistyle
     .tar appliation/x-tar
     .text text/plain
     .tgz application/x-compressed
     .tif image/tiff
     .tiff image/tiff
     .txt text/plain
     .vrml x-world/x-vrml
     .wav audio/x-wav
     .wrl x-world/x-vrml
     .xbm image/x-xbitmap
     .xpm image/x-xpixmap
     .z application/x-compressed
     .zip application/x-compressed

The Servers Sections

ns/servers

This section lists (and names) each of the servers that are to be run within the AOLserver process.

Parameter

Possible Values

Description

servername

"description text"

The name (user-defined) of a server, which must be all lowercase. The description text can be any user-defined comments.

ns/server/servername

This section configures a server. There should be one of these sections for each server listed in the ns/servers section if you want to change any of the default settings for the parameters.

Parameter

Default Value

Description

ConnsPerThread

100

After the specified number of connections, a connection thread will exit. This parameter is useful for working around memory leaks in Tcl code.

DirectoryFile

index.htm, index.html

A comma-separated list of default files to get if the URL specifies only a directory. For example:

DirectoryFile "index.htm,index.html"

This server will try each of the filenames in the list, left to right.

EnableAOLpress

on

If set to on, "NaviServer/2.0 " is prepended to the Server: output header.

KeepAliveTimeout

30

Number of seconds after which to hang up on clients while waiting for an HTTP request in a connection: keep-alive situation.

MaxConnections

100

Maximum number of concurrent HTTP connections (should be equal to MaxThreads).

MaxThreads

50

The maximum number of threads this server can use within the AOLServer process. If more threads are requested than MaxThreads, the requests will be forced to wait until the number of waiting requests drops below MaxThreads.

MaxKeepAlive

100

Maximum number of connections which can use HTTP keep-alive; should be equal to MaxConnections,

MinThreads

0

The number of threads in the AOLserver process to initialize when this server is started.

PageRoot

/servers/server/pages

Directory where pages and graphics for this server are stored.

Realm

The realm in which to request authentication when returning a "401 Unauthorized" error.

SockTimeout

30

Number of seconds to wait for an HTTP request before closing the connection.

ThreadTimeout

120

Number of seconds for threads to live with no connection.

ns/server/servername/adp

This section is used to configure AOLserver Dynamic Pages (ADPs).

Parameter

Default Value

Description

Cache

on

Boolean value. If set to on, ADP caching is enabled.

DebugInit

"ns_adp_debuginit"

The procedure to run when debugging begins.

DefaultParser

"adp"

The default parser to use for ADPs with a file extension that is not associated with a parser in the ns/server/servername/adp/parsers section. For example:

    ns_section "ns/server/server1/adp"
    ns_param "map" "/*.adp"
    ns_param "map" "/*.inc"
    ns_param "map" "/*.fadp"
    ns_param "DefaultParser" "adp"

EnableExpire

off

Boolean value. If set to on, the "Expires: now" header is set on all outgoing ADPs.

EnableDebug

off

Boolean value. If set to on, appending "?debug" to a URL will enable TclPro debugging.

Map

The Map parameter specifies which pages the server will parse. You can specify a file extension (such as /*.adp) or a directory (such as /usr/pages/adp). If no directory is specified, the pages directory is assumed. The wildcards * ? and [] can be included in the Map specification. You can specify multiple Map settings.

The following example specifies that all files in the pages directory with the extensions .adp or .asp will be parsed, and all files in the /usr/pages/myadps directory will be parsed.

     Map "/*.adp"
     Map "/*.asp"
     Map "/foo/myadps"

StartPage

The file to be run on every connection instead of the requested ADP. It can be used to perform routine initialization. It would then usually include the requested ADP by calling:

ns_adp_include [ns_adp_argv 0]

TagLocks

off

Boolean value. If set to on, ADP tags may be registered after server startup. Pages will be served less quickly when this is turned on.

If set to off, ADP tags can only be registered before the first ADP is served.

ns/server/servername/adp/parsers

This section is used to configure ADP parsers. For more information on ADP parsers, see the AOLserver Tcl Developer's Guide.

Parameter

Valid Value

Description

parser-name

file-extension

An association between an ADP parser and a file extension. The specified parser will be used to parse all ADPs with the specified file extension.

Two pre-defined parsers, "adp" and "fancy", are already registered. You can register additional parsers with the Ns_AdpRegisterParser C API function. For example:

     ns_section "ns/server/server1/adp/parsers"
     ns_param "adp" ".adp"
     ns_param "fancy" ".fadp"

ns/server/servername/db

This section specifies the database pools that will be accesible by a server. The available database pools are listed in the ns/db/pools section. There should be one of these sections for each server if you want to restrict a server's access to a subset of the available database pools.

Parameter

Default Value

Description

DefaultPool

The default pool for the ns_conn db and ns_db gethandle Tcl functions to access.

Pools

(no database pools are accessible by default)

A comma-delimited list of pool names specifying the pools that are to be accessible from this server, or "*" to signify that all pools should be accessible.

The available pools are listed in the ns/db/pools section.

ns/server/servername/fastpath

This section configures fastpath for a specific server. There should be one of these sections for each server if you want to change any of the default settings for the parameters.

Parameter

Default Value

Description

DirectoryFile

index.htm, index.html

A comma-separated list of default files to get if the URL specifies only a directory. For example:

DirectoryFile "index.htm,index.html"

This server will try each of the filenames in the list, left to right.

MMap

off

If set to on, uses the potentially faster mmap method of sending files. Not all socket drivers implement this.

Cache

on

If set to on, enables file caching.

CacheMaxEntry

8192

Maximum size of a file to cache. Files larger than this won't be cached.

CacheMaxSize

5120000

Maximum size for file cache, per thread. The actual maximum memory usage will be this number times MaxThreads.

PageRoot

/servers/server/pages

Directory where pages and graphics for this server are stored.

ns/server/servername/redirects

This section configures redirects for a specific server. There should be one of these sections for each server if you want to change any of the default settings for the parameters.

Parameter

Default Value

Description

status

url

When returning the specified status, send a redirect to the specified url. You can define multiple status and url pairs.

ns/server/servername/tcl

This section configures Tcl for a specific server. There should be one of these sections for each server if you want to change any of the default settings for the parameters.

Parameter

Default Value

Description

AutoClose

on

If AutoClose is on, all non-shared files opened by an individual interpreter in the group will be closed when Ns_TclDeAllocateInterp is invoked. (Other interpreters in the group are not affected.) Ns_TclDeAllocateInterp is called after each Tcl request procedure.

It is recommended that you leave the AutoClose parameter set to on and share files between interpreters.

Debug

Off

Boolean value. If set to On, names of files sourced during startup are written to the server log.

Library

/servers/server1/modules/tcl

Directory for private Tcl script library for this server. Tcl scripts in this private library will override identically-named Tcl scripts in the shared Tcl library.

ns/server/servername/modules

This section lists the AOLserver modules that are to be loaded into a server. There should be one of these sections for each server listed in the ns/servers section.

The name of the module can be any name you choose, but it must then be referenced as the module name in the appropriate ns/server/servername/module/module-name section. For example, if you set mylog to nslog.so, you must configure the module in a section called ns/server/servername/module/mylog instead of ns/server/servername/module/nslog.

The file specified as the usual value for each parameter exists in the bin directory under the AOLserver home directory by default. If it resides somewhere else, include an absolute path specification along with the file.

Parameter

Usual Value

Description

nscgi

nscgi.so

If present, enables CGI support for this server. Configure CGI in the ns/server/servername/module/nscgi section.

nscp

nscp.so

If present, enables the control port administration interface for the server.

nslog

nslog.so

If present, enables an access log for this server.Configure the access log in the ns/server/servername/module/nslog section.

nsperm

nsperm.so

If present, enables access control capabilities for this server. Configure these capabilities in the ns/server/servername/module/nsperm section.

nssock

nssock.so

If present, allows TCP/IP sockets connection for this server.Configure the sockets connection in the ns/server/servername/module/nssock section.

nsvhr

nsvhr.so

If present, enables virtual host redirection, which allows you to proxy requests to different servers.

ns/server/servername/module/nscgi

This section configures CGI for a server. There should be one of these sections for each server that includes the nscgi module if you want to change any of the default settings for the parameters.

Parameter

Default Value

Description

BufferSize

8192

The number of bytes to buffer before sending them out to the browser.

Debug

off

Boolean value. If set to On, extra debugging is enabled.

Environment

Specifies a section in the configuration file to be used as the default environment for CGI scripts run on this server. For example, if you set Environment to CGIenv, you must include a ns/environment/CGIenv section in the configuration file containing environment variable definitions. The environment variables will be in addition to the standard CGI variables.

GetHostByAddr

off

Boolean value. If set to Off (the default), REMOTE_HOST will be the same as REMOTE_ADDR, thereby improving performance by eliminating reverse lookup requests. If set to On, a reverse lookup request is used to supply the REMOTE_HOST value.

Interps

Specifies a section in the configuration file to define mappings between extensions of CGI script files and programs. For example, if you set Interp to CGIinterps, you must include a ns/interps/CGIinterps section in the configuration file containing appropriate mappings. See below for a description of the format of an Interps section.

Limit

0 (unlimited)

Maximum number of concurrent CGI processes.

Map

Method, URL, and directory where CGI programs reside. A trailing slash on the URL is not allowed. The directory must be an absolute pathname. A trailing slash on the directory is optional. If the directory is missing, the pages directory is assumed. Examples:

Map "GET /cgi /usr/local/cgi"

Map "POST /*.cgi"

You may have more than one Map entry. Typically, there are at least Map entries for the GET and POST methods.

MaxOutput

10240

Maximum number of bytes of output the CGI program can send.

SystemEnvironment

off

Boolean value. If set to on, sets the ??? environment variable.

ns/server/servername/module/nscp

This section configures the control port, through which you can administer the server. There should be one of these sections for each server that includes the nscp module if you want to change any of the default settings for the parameters.

Parameter

Default Value

Description

Address

"127.0.0.1"

The address to bind to.

Binary

"bin/nscp"

The path for the control port executable.

InitCmds

Commands to be executed by the control port when it starts. For example, to automatically view the log when you log into the control port, set this parameter as follows: ns_param initcmds "tail -f log/server.log&"

Port

9999

The port to listen on. To access the administration interface, telnet to the specified Port at the specified Address. For example:

    telnet localhost 9999

ns/server/servername/module/nscp/users

This section the users allowed to access the control port for the server. There should be one of these sections for each server that includes the nscp module if you want to change any of the default settings for the parameters.

ns_param user "username:encrypted-password"

ns/server/servername/module/nslog

This section configures the nslog module for a server. There should be one of these sections for each server that includes an nslog module if you want to change any of the default settings for the parameters.

Parameter

Default Value

Description

File

access.log

The name of the file where the access log is to be stored. If no directory is specified, the file will be created in the /servers/servername/modules/nslog directory. If you specify only an absolute or relative directory and no filename, the file access.log will be created in that directory.

Accesses are logged in CERN Common Logfile Format.

FormattedTime

On

Boolean value. If set to On, nslog will use the common log format for the timestamp. When Off, the time will be logged as seconds since Jan 1 1970. That will provide a small speedup in heavily accessed sites because of locking that occurs in performing timzeone conversions.

LogCombined

off

Boolean value. If set to on, logs will be generated in the NCSA combined log format. The NCSA combined log format will include the referring URL and the user agent (so you can turn off LogRefer and LogUserAgent), and it will not surround them with double quotes.

MaxBackup

5

The maximum number of access logs that will be saved. This amount includes the current access log. For example, a value of 5 means the current access log plus 4 backup logs.

RollHour

0 (midnight)

The hour at which the access log will be rolled on the day or days specified by the RollDay parameter. The hour must be specifed as an integer from 0 to 23 representing the hour in military time.

RollLog

on

Boolean value. If set to On, the access log is rolled according to the settings for the RollDay and RollHour parameters. If set to Off, log entries will be written to the same access log indefinitely. However, the access log can still be rolled on SIGHUP if the RollOnSignal parameter is set to On (the default).

RollOnSignal

on

Boolean value. The default, "on", specifies that the access log will be rolled when a SIGHUP signal is sent to the process id of the running server. The process id can be found in the file specified by the PidFile parameter.

If set to "off", the access log will not be rolled when a signal is sent.

ns/server/servername/module/nsperm

This section configures the nsperm module for a server. There should be one of these sections for each server that includes an nsperm module if you want to change any of the default settings for the parameters.

Parameter

Default Value

Description

SkipLocks

on

Boolean value. If set to on, permissions lookups will be faster, but no permissions settings may be added while the server is running.

ns/server/servername/module/nssock

This section configures the nssock module for a server. Each server must have an nssock module loaded. There should be one of these sections for each server that includes an nssock module if you want to change any of the default settings for the parameters.

Parameter

Default Value

Description

Address

IP Address or hostname where this server listens for requests. If this parameter is not set, AOLserver will listen on all interfaces. This means that if one server does not set an address, no other server may use the same Port.

Hostname

AOLserver queries the DNS (Domain Name Service) for the host name.

Host name used in response to clients. This may be an alias for your site, such as www.avalon.com. Make sure the IP address of the Hostname you set is valid or users will be unable to process redirects from your site.

Location

The URL that redirects come back to. This parameter is useful when the server machine is part of a group of machines responding to requests through a DNS rotor. By default, the server will use http://hostname as the location.

Port

80

Port number where this server listens for requests. If two servers use the same port, they must use different Addresses.

ns/server/servername/module/nsvhr

This section configures the nsvhr module for a server. There should be one of these sections for each server that includes an nsvhr module if you want to change any of the default settings for the parameters.

Parameter

Default Value

Description

BusyURL

An URL to redirect to if a proxy attempt times out.

ErrorURL

An URL to redirect to when an unknown host is requested or the host could not be reached.

Method

A method to proxy. Can be GET, POST, or HEAD. This parameter may be specified multiple times.

Timeout

30

The number of seconds to wait for a back-end host while proxying.

ns/server/servername/module/nsvhr/maps

This section configures the nsvhr module for a server. There should be one of these sections for each server that includes an nsvhr module if you want to change any of the default settings for the parameters.

Parameter

Default Value

Description

hostname

url

If a request comes in with Host: hostname, the request will be proxied to the specified url. For example:

phony.hosting.com=http://127.0.0.0:2000/

phony2.hosting.com=unix://phony2

The phony2 domain is a UNIX domain socket file name defined in the ns/server/servername/module/nsunix section. The syntax for the UNIX domain socket file name follows the URL syntax of a host name. The unix:// prefix is required before the socket file name.

ns/server/servername/module/nsunix

This section configures the nsunix module for a server. This section is needed if you want the nsvhr module to proxy over a UNIX domain socket instead of a TCP socket. Initially, this driver accepts a connection on a Unix domain socket and receives a message sent by nsvhr.so. The message contains the passed file descriptor of the connection socket and the initial data from that connection socket. The rest of the data is read from the passed file descriptor after the initial data has been consumed from the message. These are the required parameters:.

Parameter

Default Value

Description

Hostname

Host name used in response to clients. This may be an alias for your site, such as www.avalon.com. Make sure the IP address of the Hostname you set is valid or users will be unable to process redirects from your site.

Port

Port number where this server listens for requests.

SocketFile

The file name for the UNIX domain socket. It follows the same syntax of a host name named by the Hostname parameter. No slashes (/) are permitted in the file name, but the dot (.), dash (-), and underscore (_) characters are permitted. The socket file is created in the modules/nsunix/ directory. For example:

ns_param SocketFile "server2.nsunix"

There is a comprehensive sample nsd.tcl file in the nsvhr/ directory that shows how to configure the nsvhr module to proxy to a nsunix module of a different server. The two servers are started with these commands:

    bin/nsd -s server1 -f -t nsd.tcl
    bin/nsd -s server2 -f -t nsd.tcl

Database Drivers and Pools

ns/db/drivers

This section lists the available database drivers to be used with the database pools. The name of the driver can be any name you choose, but it must then be referenced as the driver name in the appropriate ns/db/driver/driver-name section. Note that the driver parameter in the ns/db/pool/pool-name section must also reference the driver name to associate a database driver with a particular database pool.

The file specified as the usual value for each parameter exists in the bin directory under the AOLserver home directory by default. If it resides somewhere else, include an absolute path specification along with the file.

Parameter

Usual Value

Description

postgres

nspostgres.so

If present, enables the Postgres database driver. No configuration is necessary for the Postgres driver.

solid

nssolid.so

If present, enables the SOLID database driver. No configuration is necessary for the SOLID driver.

extname

nsext.so

The external database driver name. There can be multiple (uniquely-named) instances of this parameter, one for each proxy daemon interface. By convention, the external driver names are prepended with "ext". For example: extIll or extSyb.

ns/db/driver/extname

This section configures an external database driver. There should be one of these sections in your configuration file if an external driver is listed in the ns/db/drivers section and you want to change any of the default settings for the parameters

Parameter

Usual Value

Description

LocalDaemon

Sybase: nssybpd

The local database proxy daemon.

Use this parameter only for local database proxy daemons.

MaxElement-Size

32K

An integer value specifying the maximum element size for an external database driver.

RemoteHost

A remote host name. Use this parameter only for remote database proxy daemons.

RemotePort

A remote port number. Use this parameter only for remote database proxy daemons.

Param

/usr/local/miadmin/MiParams

For Sybase, the value of the SYBASE environment variable.

TrimData

off

Boolean value. For Sybase. If set to On, the external driver will trim from the right the data returned by the Sybase server. This parameter is useful when, for example, you don't want all the empty whitespace from a 32-character char or when "empty" varchars are returning a non-empty 2-byte value.

Note that this will probably corrupt image types that are holding binary data in a BLOB (the "text" type in Sybase), so it is recommended that you leave this parameter Off if you're working with BLOBs.

ns/db/pools

This section lists (and names) each of the available database pools for AOLserver.

Parameter

Default Value

Description

pool-name

pool description

The name (user-defined) of a database pool, which is actually a collection of connections accessible to AOLserver to the associated database. The database connection itself is configured in the ns/db/pool/pool-name section.

The pool description can be any user-specified comments about the pool.

ns/db/pool/pool-name

This section configures a database pool. There should be one of these sections for each database pool listed in the ns/db/pools section.

Parameter

Default Value

Description

Connections

2

The maximum number of connections that can be established at any one time. The server automatically makes connections as needed up to this maximum number. If additional connections are requested during processing, the requests must wait.

Note: Some databases do not handle multiple connections very well. In this case, you should set Connections to 1 (one).

Datasource

Postgres: host:port:database

Solid: TCP/IP hostname port

The location and name of the database, according to the specifications of the database being used.

Driver

Value can be any driver named in the ns/db/drivers section: postgres (for Postgres), solid (for SOLID), or an external database driver.

LogSQLErrors

off

Boolean value. If set to On, SQL errors are written to the server log along with the offending SQL statement(s). If set to Off and Verbose is also Off, SQL errors are not written to the server log.

MaxIdle

600

The maximum length of time in seconds that a database connection within this pool can remain open and idle.

The default setting causes connections that are idle for 10 minutes to be closed. Note that MaxIdle will not have an effect if it is equal to MaxOpen.

Setting MaxIdle to 0 makes it impossible for database handles to become stale, unless the MaxOpen time expires.

MaxOpen

3600

The maximum length of time in seconds that a database connection within this pool can remain open. It is recommended that MaxOpen be a multiple of MaxIdle; otherwise, MaxOpen may be off by as much as (MaxOpen mod MaxIdle).

The default setting causes all connections to be closed after one hour, regardless of activity level. Database pool connections will then be opened again as needed up to the value of the Connections parameter.

Setting MaxOpen to 0 makes it impossible for database handles to become stale when they are not idle.

Password

Password to log into the database.

User

Username to log into the database.

Verbose

off

Boolean value. If set to On, all SQL statements executed against this pool are written to the server log. Errors, connects, and disconnects are also logged. If set to Off, SQL statements are not written to the server log.

At no point is the same SQL statement written to the log twice, even if Verbose is On, LogSQLErrors is On, and the statement causes an error.

Note: Setting Verbose may result in a large amount of output in the server log file.

CGI Interpreters and Environment

ns/interps/interps-name

This section allows you to configure an interps section that can be used by CGI modules loaded into any of the servers..

Parameter

Default Value

Description

file-extension

program(environment)

A CGI interpreter definition used by a CGI module. The environment is optional and specifies a section of environment variables to set in addition to the CGI variables before executing the interpreter program. For example:

    .pl "c:\perl\bin\perl.exe"
    .sh "c:\mks\mksnt\sh.exe(MKSenv"

In this case, Perl will be invoked to interpret CGI scripts which end in .pl; the variables in the ns/environment/mksenv section will be set before the MKS Bourne shell is invoked to interpret CGI scripts which end in .sh.

To enable this section to be used by a specific CGI module, use the Interps parameter of the CGI module.

ns/environment/environment-name

This section allows you to configure an environment section that can be used by CGI modules loaded into any of the servers..

Parameter

Default Value

Description

variable

definition

An environment variable definition used by a CGI module. To enable this section to be used by a specific CGI module, use the Environment parameter of the CGI module or add the optional environment name in the definition of a CGI interpreter.

SGI IRIX Sproc-Based Threads

ns/threads

This section allows you to configure sproc-based threads available on IRIX 5.3 or 6.2 (not the pthreads-based approach available on IRIX 6.2).

Note that these parameters are provided for advanced IRIX users who need to fine-tune their system..

Parameter

Default Value

Description

InitSize

262144

The SGI arena size in bytes (minimum is 32768).

InitUsers

100

Maximum number of users for the SGI arena (miminum is 10; maximum is 1500).

MaxTLS

200

Maximum number of thread-local storage variables.

PoolTrace

File specification where debugging output of memory pools should be written.

StackSize

65536

Starting stack size for each thread. This value overrides the StackSize parameter in the ns/parameters section.