application Element for fastCgi [IIS Settings Schema]

Note

For more information about the application element, see the following topic on the Microsoft IIS.net Web site: FastCGI Application <application>.

Adds a FastCGI process pool definition to the collection of FastCGI process pool definitions.

Syntax

Attributes and Elements

The following sections describe attributes, child elements, and parent elements for this section.

Attributes

Attribute

Description

activityTimeout

Optional int attribute.

Specifies the maximum time, in seconds, that a FastCGI process can take to process. Acceptable values are from 10 through 3600.

The default value is 30.

arguments

Optional string attribute.

Specifies the command-line arguments for the FastCGI process.

flushNamedPipe

Optional Boolean attribute.

Specifies whether named pipes are flushed at the end of each request. This property applies only when the named-pipe protocol is used.

The default value is false.

fullPath

Required string attribute.

Specifies the full path of the FastCGI process.

idleTimeout

Optional int attribute.

Specifies the maximum amount of time, in seconds, that a FastCGI process can be idle before the process is shut down. Acceptable values are from 10 through 604800.

The default value is 300.

instanceMaxRequests

Optional int attribute.

Specifies the maximum number of requests that can be processed by each FastCGI worker process before it is recycled. Acceptable values are from 1 through 10000000.

The default value is 200.

maxInstances

Optional int attribute.

Specifies the maximum number of FastCGI worker processes that can be started in an application pool. Acceptable values are from 1 through 10000.

The default value is 4.

protocol

Optional enum attribute.

Specifies the transport mechanism used to communicate with the FastCGI process.

The protocol attribute can be one of the following possible values.

The default value is NamedPipe.

ValueDescription
NamedPipeThe named-pipe protocol will be used to communicate with the FastCGI worker process.
TcpThe TCP protocol will be used to communicate with the FastCGI worker process.

queueLength

Optional int attribute.

Specifies the maximum number of requests that can be queued for a FastCGI process pool. Acceptable values are from 1 through 10000000.

The default value is 1000.

requestTimeout

Optional int attribute.

Specifies the maximum time, in seconds, that a FastCGI process request can take. Acceptable values are from 10 through 604800.

The default value is 90.

Child Elements

Element

Description

environmentVariables

Optional element.

Specifies a collection of environment variables that IIS will pass to the FastCGI application.

Parent Elements

Element

Description

configuration

Specifies the root element in every configuration file that is used by IIS 7.

system.webServer

Specifies the top-level section group (in ApplicationHost.config) in which this element is defined.

fastCgi

Contains a collection of fastCgi application pool definitions.

Remarks

For more information about the application element, see the following topic on the Microsoft IIS.net Web site: FastCGI Application <application>.

Element Information

Configuration locations

Machine.config

ApplicationHost.config

Root application Web.config

Application Web.config

Directory Web.config

Requirements

Microsoft Internet Information Services (IIS) version 7.0

See Also

Reference

environmentVariables Element for application for fastCgi [IIS Settings Schema]

fastCgi Element [IIS Settings Schema]

FastCgiApplicationElement Class [IIS 7 and higher]

FastCgiSection Class [IIS 7 and higher]