FastCGI SAF Parameters (Sun Java System Web Server 6.1 SP7 FastCGI Plug-in Release Notes)

Sun Java System Web Server 6.1 SP7 FastCGI Plug-in Release Notes

FastCGI SAF Parameters

FastCGI plug-in SAFs auth-fastcgi and responder-fastcgi both accept the following parameters unless otherwise mentioned explicitly:

Note –

Parameters chroot, user, group and nice are applicable to only UNIX platforms. On Windows platforms, these parameters are ignored.

app-path - (Optional) FastCGI server application path that processes the request. The functionality is dependent on the value of the “bind-path“ as follows:
- If only app-path is specified, the plug-in will create FastCGI server application. This server application will listen to UNIX Domain Sockets created by the plug-in.
- If both app-path and bind-path are specified, the plug-in will create FastCGI server applications. This server application will listen to the TCP/IP address and port value specified in bind-path or UNIX Domain Sockets created by the FastCGI plug-in.
- If only bind-path is specified, the plug-in will directly communicate with the FastCGI server application.
- If both app-path and bind-path are not specified, then the plug-in will log an error message.
app-args — (Optional) Values that are passed as the arguments to the FastCGI application process. Multiple app-args parameters are allowed. The format for the multiple app-args parameters is:
```
app-args="value" app-args="value" ..
```
bind-path - (Optional) Can be a UNIX Domain Socket (UDS) name or of the form host:port. The description of app-path parameter explains the usage of bind-path parameter. Note that the UDS name is applicable only on UNIX platforms; on Windows platforms, bind-path must be specified as host:port.
min-procs - (Optional) Integer specifying the minimum number of FastCGI application processes to be created. Defaults to 1.
max-procs - (Optional) Integer specifying the maximum number of FastCGI application processes that could be created at any time. It should be equal to or greater than min-procs. Defaults to 1.
chroot - (Optional) Used to set the root directory of the chroot jail that the FastCGI server application runs in. Defaults to the server's root directory.
user - (Optional) Specifies the user ID the FastCGI server application runs as. Defaults to server's user ID.
group - (Optional) The FastCGI server application would be running under the specified group. Defaults to server's group.
nice - (Optional) Specifies the nice value of FastCGI server application processes.
listen-queue - (Optional) Integer specifying the listen queue size for the socket. Defaults to 20.
app-env - (Optional) Value pairs which will be passed as environment variables to the FastCGI server application process. Multiple app-env parameters are allowed. The format for multiple app-env parameters is:

app-env="name=value" app-env="name=value"....
reuse-connection - (Optional) Boolean value that determines if connections to FastCGI server applications are reused. False (0, false, no) indicates that the connections to FastCGI server applications are closed after each request. True (1, true, yes) indicates that existing connections are reused for new requests. See also connection-timeout.
connection-timeout - (Optional) If reuse-connection is true, this value specifies the timeout value in seconds for the pooled connections. If a connection is idle for the specified amount period of time, the plug-in closes the connection. See also reuse-connection .
resp-timeout - (Optional) Integer representing the FastCGI server response timeout in seconds. If there is no response from the FastCGI server application within the specified period of time, the request is discarded.
restart-interval - (Optional) Integer representing the time interval (in minutes) after which the FastCGI server application is restarted. Defaults to 60 minutes (1 hour).
req-retry - (Optional) Integer representing the number of times the plug-in should resend the request when the FastCGI server application rejects the request.

The error-fastcgi SAF accepts the following parameters:

error-url - Specifies the page, URI or URL to be displayed in case a failure or error occurs. The value of this parameter can be an absolute path, a path relative to docroot, or an URL or URI.
error-reason - (Optional) String representing the FastCGI protocol error. This is used to differentiate error URLs to be displayed, in case of any plug-in errors.