The following table lists the Init functions available in the magnus.conf file:
Table 3–1 magnus.conf Init Functions
Function/Parameter |
Allowed Values |
Default Value |
Description |
---|---|---|---|
Changes the default characteristics for fancy indexing. |
|||
s |
(None) |
(optional) is a string of letters specifying the options to activate. Currently there is only one possible option:
|
|
Comma separated numbers of characters |
Minimums required to display column titles |
(optional) Specifies the width for each of the four columns in the indexing display: name, last-modified date, size, and description respectively. The final three values can each be set to 0 to turn the display for that column off. The name column cannot be turned off. |
|
GMT or local |
local |
(optional, iPlanet Web Server 4.x only) Indicates whether the last-modified time is shown in local time or in Greenwich Mean Time. |
|
Format for the UNIX function strftime() |
%d-%b-%Y %H:%M |
(optional, iPlanet Web Server 4.x only) Determines the format of the last modified date display. |
|
Wildcard pattern |
.* |
(optional) Specifies a wildcard pattern for file names the server should ignore while indexing. File names starting with a period (.) are always ignored. |
|
/mc-icons/ |
(optional) Specifies the URI prefix the index-common function uses when generating URLs for file icons (.gif files). If icon-uri is different from the default, the pfx2dir function in the NameTrans directive must be changed so that the server can find these icons. |
||
Creates a performance bucket, which you can use to measure the performance of SAFs in obj.conf (see the Sun Java System Web Server 6.1 SP9 NSAPI Programmer’s Guide). This function works only if the perf-init function is enabled. |
|||
A name for the bucket, for example cgi-bucket. |
|||
A description of what the bucket measures, for example CGI Stats. |
|||
Configures DNS caching. |
|||
32 to 32768 (32K) |
1024 |
(optional) Specifies how many entries are contained in the cache. |
|
1 to 31536000 seconds (1 year) |
1200 seconds (20 minutes) |
(optional) specifies how long (in seconds) it takes for a cache entry to expire. |
|
Initializes the flexible logging system. |
|||
logFileName |
A path or file name |
The full path to the log file or a file name relative to the server’s logs directory. In this example, the log file name is access and the path is /logdir/access: access="/logdir/access" |
|
Specifies the format of each log entry in the log file. See the Sun Java System Web Server 6.1 SP9 NSAPI Programmer’s Guide for more information. |
|||
Number of bytes |
8192 |
Specifies the size of the global log buffer. |
|
The lower bound is 1. There always needs to be at least one buffer per file. The upper bound is dictated by the number of buffers that exist. The upper bound on the number of buffers that exist can be defined by the num-buffers parameter. |
Determined by the server |
Specifies the number of buffers for a given log file |
|
1000 |
Specifies the maximum number of logging buffers to use. |
||
Enables rotation for logs. |
|||
A 4-digit string indicating the time in 24-hour format |
Indicates the time to start rotation. For example, 0900 indicates 9 am while 1800 indicates 9 pm. |
||
Number of minutes |
|
Indicates the number of minutes to elapse between each log rotation. |
|
yes, no |
yes |
(optional) determines whether common-log, flex-log, and record-useragent logs are rotated. For more information, see the Sun Java System Web Server 6.1 SP9 NSAPI Programmer’s Guide. |
|
yes, no |
yes |
(optional) determines whether error logs are rotated. |
|
A path |
(optional) specifies the file name of a user-supplied program to execute following log file rotation. The program is passed the post-rotation name of the rotated log file as its parameter. |
||
Changes the default settings for CGI programs. |
|||
Number of seconds |
300 |
(optional) specifies how many seconds the server waits for CGI output before terminating the script. |
|
|
(optional) specifies the path to the CGI stub binary. If not specified, iPlanet Web Server looks in the following directories, in the following order, relative to the server instance’s config directory: ../private/Cgistub, then ../../bin/https/bin/Cgistub. For information about installing an suid Cgistub, see the Sun Java System Web Server 6.1 SP9 NSAPI Programmer’s Guide. |
||
env-variable |
(optional) specifies the name and value for an environment variable that the server places into the environment for the CGI. |
||
Initializes the Common Log subsystem. |
|||
logFileName |
A path or file name |
Specifies either the full path to the log file or a file name relative to the server’s logs directory. |
|
Loads user home directory information. |
|||
(optional) specifies the full file system path to a file other than /etc/passwd. If not provided, the default UNIX path (/etc/passwd) is used. |
|||
Loads shared libraries into the server. |
|||
Specifies either the full path to the shared library or dynamic link library or a file name relative to the server configuration directory. |
|||
A comma separated list with no spaces |
A list of the names of the functions in the shared library or dynamic link library to be made available for use by other Init or Service directives. The dash (-) character may be used in place of the underscore (_) character in function names. |
||
yes, no |
yes |
(optional) specifies which threading model to use. no causes the routines in the library to use user-level threading. yes enables kernel-level threading. |
|
|
The name of a custom thread pool, as specified in thread-pool-init. |
||
Enables the NT console, which is the command-line shell that displays standard output and error streams. |
|||
console |
Directs error messages to the NT console. |
||
console |
Directs output to the NT console. |
||
Enables system performance measurement via performance buckets. |
|||
true, false |
true |
Disables the function when true. |
|
Configures pooled memory allocation. |
|||
block-size |
(optional) size (in bytes) of the memory blocks allocated by the internal pooled memory allocator. Default value is 32768. |
||
1048576 bytes or less |
(optional) maximum size in bytes of free block list. |
||
true, false |
false |
(optional) flag to disable the use of pooled memory if true. |
|
Lets you extend the HTTP protocol by registering new HTTP methods. |
|||
A comma separated list |
Names of the methods you are registering. |
||
Enables reporting of performance statistics in XML format. |
|||
yes, no |
no |
Enables NSAPI performance profiling using buckets. This can also be enabled through perf-init. |
|
1 or greater |
5 |
The period in seconds between statistics updates within the server. |
|
1 or greater |
1000 |
The maximum number of virtual servers for which statistics are tracked. This number should be set higher than the number of virtual servers configured. |
|
Configures an additional thread pool. |
|||
Name of the thread pool. |
|||
Maximum number of threads in the pool.You can use only five threads at a time in the FastTrack edition of iPlanet Web Server. |
|||
Minimum number of threads in the pool. |
|||
Number of bytes |
Size of the queue for the pool. |
||
Number of bytes |
Stack size of each thread in the native (kernel) thread pool. |