Use the Add FastCGI Application and Edit FastCGI Application dialog boxes to add or edit general and processing properties for an application.

For more information about FastCGI applications, see the FastCGI Settings Page.

UI Element List

Element Name Description

Full Path

Specifies the physical path of the process executable to use in the FastCGI application pool.

Click to find the physical location of your FastCGI process executable file.

Arguments

Specifies the command-line arguments that are passed to the FastCGI process. These arguments can be used to uniquely identify a FastCGI process pool in cases where several FastCGI process pools exist for a single process executable.

EnvironmentVariables

Specifies the collection of environment variables that will be set for the process executable program. This property is optional. Click the Browse () button to open the EnvironmentVariables Collection Editor, from which you can add and remove members and define property values. For more information, see the Environment Variables Editor Dialog Box UI Help page.

InstanceMaxRequests

Controls the FastCGI process-recycling behavior. Specifies the maximum number of requests that a FastCGI application is allowed to handle before the process is recycled. The default value is 200.

MaxInstances

Specifies the maximum number of FastCGI processes to allow in the application process pool for the selected FastCGI application. This number also represents the maximum number of concurrent requests that the FastCGI application can handle. The default value is 4.

For the Windows® 7 and Windows Server® 2008 R2 operating systems only, setting the MaxInstances property to 0 lets IIS automatically select the optimal number of FastCGI processes for the current execution environment.

ActivityTimeout

Specifies the maximum length of time that a FastCGI process for the application is allowed to run without communicating with IIS before the process times out. This time-out can be used to detect and shut down hung processes. The default value is 30 (seconds).

FlushNamedpipe

Specifies whether the named pipe is flushed at the end of each request and before shutting down the application. If the named pipe is flushed, the value is set to true. The default value is false. This property applies only when the named-pipe protocol is used.

Protocol

Specifies the protocol to use to communicate with the FastCGI process. The possible values for the Protocol property are 0 (NamedPipe) or 1 (TCP). The default value is 0 (NamedPipe).

IdleTimeout

Specifies the time interval that a FastCGI process for the application can remain idle, after which an idle process ends. The default value is 300 (seconds).

QueueLength

Specifies the maximum number of requests that will be queued for the FastCGI application pool. When the queue is full, subsequent requests will return the HTTP error code 503 (Service Unavailable) to clients. This indicates that the application is too busy. The default value is 1000.

RapidFailPerMinute

Specifies the number of FastCGI process failures allowed in a minute before the FastCGI handler takes the process offline. The default value is 10.

RequestTimeout

Specifies the maximum time allowed for a request to the application. If a FastCGI process takes longer than the specified time on a single request, it will be terminated. The default value is 90 seconds.

MonitorChangesTo

This property applies to the Windows 7 and Windows Server® 2008 R2 operating systems only.

Specifies the path of a file. Changes to this file will trigger recycling of FastCGI processes. You can specify the absolute path and also the path that is relative to the location of the FastCGI executable.

stderrMode

This property applies to the Windows 7 and Windows Server® 2008 R2 operating systems only.

Specifies how to handle errors that are reported by a FastCGI process. The following options exist:

  • ReturnStderrIn500 — This module sets the status code to 500 and sends what is received on STDERR as a response. This is the default value and has the same behavior as IIS.

  • ReturnGeneric500 — This module sets the status code to 500, but will return a generic 500. This configuration is useful if you want to enable detailed error logging for a server but do not want to return these errors to users.

  • IgnoreAndReturn200 — This module sends what is received on STDOUT as a response with the status code 200. The text on the STDERR stream is ignored. This property is useful if you want to use debug statements for tracking purposes.

  • TerminateProcess — This module terminates the FastCGI process and returns the generic 500 error message.