The following table lists the Init functions available in the obj.conf file:
Table 5–31 Init Functions
Function/Parameter |
Allowed Values |
Default Value |
Description |
---|---|---|---|
Creates a performance bucket. You can use this parameter to measure the performance of SAFs in obj.conf. This function only works 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 before a cache entry expires. |
|
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. |
|||
true, on, yes, or 1;false, off, no, or 0 |
Turns on relaxed logging, which skips logging components that normally block static page acceleration if static page acceleration is enabled. |
||
Number of bytes |
8192 |
Specifies the size of the global log buffer. |
|
The lower bound is 1. Files must contain at least one buffer. 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. |
||
thread-buffer-size |
Number of bytes |
8192 (8 KB) |
Specifies the size of the per thread log buffer. |
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 a.m. while 1800 indicates 9 p.m. |
||
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 Proxy Server 4.0.13 NSAPI Developer’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 after following log file rotation. The program passes 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 Proxy Server 4.0.13 NSAPI Developer’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 specifies 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 can 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. |
|||
disable |
true, false |
true |
Disables the function when true. |
Configures pooled memory allocation. |
|||
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. |
|
Enables you to extend the HTTP protocol by registering new HTTP methods. |
|||
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 setting 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. |
|||
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. |
||
tune-cache |
Enables you to tune the performance of your proxy server's cache. |
||
byte-ranges |
Determines whether the proxy can generate byte-range responses from the cache. |
||
tune-proxy |
Enables you to tune the performance of your proxy server. Do not change the default settings. |
||
ftp-listing-width |
80 characters |
Increasing the width of FTP listings allows longer file names and thus reduces file name truncation. |
|
um-define-junction |
Defines a URL Mapping that will be enforced by the "URL Mapping" layer. |
||
jct-name |
The name of the junction. |
||
fe-uri-prefix |
The front-end URI prefix that is associated with this junction definition or mapping. |
||
be-url-prefix |
The back-end URL prefix that is associated with this junction definition or mapping. |
||
junction-mapping |
yes |
A junction mapping. |
|
parser-config |
Specifies the parser configuration that is used for this junction. |
||
passthru-cookies |
Specifies a comma-separated list of cookie names that is passed through to the junction without translation. |
||
has-javascript |
yes |
Enables JavaScript rewriting for all JavaScript content. |
|
onload-handler |
um_jct |
Inserts special bit of code into each request to this junction. |
|
base-tag-handler |
no |
<base> tags receive special handling |
|
rewrite-events |
yes |
Rewrite event attributes within HTML tags |
|
redirect-without-trailing-slash |
Requests that match fe-uri-prefix without the trailing slash are immediately redirected to fe-uri-prefix with the trailing slash. |
||
add-headers |
Specifies a static list of headers to be added to all requests within this junction. |
||
lookup-equiv-hosts |
no |
Prevent a new junction from adding the back-end server's IP addresses to this list. |
|
add-equiv-hosts |
Specifies a comma-delimited list of additional host names (and/or IP addresses) that are considered to be equivalent to this junction's host name. |
||
output-buffer-size |
Enables (or disables) output buffering. To enable this, set output-buffer-size to a nonzero value. |
||
references-other-jcts |
Searches other junctions while trying to rewrite URLs for this junction. |
||
use-template |
Assigns an object name (which matches the junction's name) to requests that match this junction. |
||
name |
Overrides the object name for this junction. |
||
um-init |
Initializes the URL Mapping module. |
||
global-passthru-cookies |
Specifies a comma-delimited list of cookies that are always passed through to the back-end applications. |
||
jct-cookie-name |
um_jct |
Sets the name of the cookie that stores the last-used back-end URL's name. |
|
jct-cookie-prefix |
Informs the URL Mapping layer which cookies to pass to the back-end server on a given request. |
||
jct-cookie-domain |
Sets the URL Mapping cookie in specified domain. |
||
default-output-buffer-size |
Sets the default output buffer size for URL Mappings that do not explicitly set output-buffer-size. |
||
um-load-parser-config |
Loads a parser configuration into memory. |
||
file |
Specifies the location of the parser configuration file. |
||
config-name |
Specifies the name associated with this parser configuration. |