IIS and FastCGI/Configuring

From Wikibooks, open books for an open world
< IIS and FastCGI
Jump to: navigation, search

A default fcgiext.ini file:

; -----------
; fcgiext.ini
; -----------
;
; This is the configuration file for the FastCGI handler for IIS 6.0.
; The FastCGI handler will look for this file in the same directory as
; fcgiext.dll.  By default, the FastCGI installer will place this file into
; the %windir%\system32\inetsrv directory.
;
; The configuration for FastCGI is a collection of one or more applications.
; A FastCGI application consists of a pool of processes that each handle HTTP
; requests.  Each process in the pool will handle one request at a time.
; After each request, the process will be returned to the pool to await
; another request.  Each application is required to have its own section in
; the configuration file to specify its behavior.
;
; The main section of the fcgiext.ini file is the [types] section.  This
; section associates file extensions from the URL with FastCGI applications.
;
; The general syntax is a follows:
;
; [types]
; abc=Application 1
; def=Application 2
; def:1701187997=Application 3
; *=Application 4
; *:1701187997=Application 5
;
; The above example consists of 5 mappings mapped as follows:
;
; - The file extension "abc" is associated with the FastCGI application
;   named "Application 1".
;
; - The file extension "def" is associated with the FastCGI application
;   named "Application 2".
;
; - The file extension "def" is associated with the FastCGI application
;   named "Application 3", but only for requests made to the web site
;   with the numeric identifier "1701187997".  Note that site-specific
;   mappings override non-site-specific mappings.
;
; - Requests with a file extension that does not have a specific mapping
;   are associated with the FastCGI application named "Application 4".
;
; - Requests to the web site with the identifier "1701187997" with a file
;   extension that does not have a specific mapping are associated with
;   the FastCGI application named "Application 5".
;
; Note that application names are ASCII and should generally contain only
; alphanumeric characters, and spaces are allowed.  Application names are
; case-insensitive.
;
; Note also that it is allowed for multiple mappings to be associated with
; the same FastCGI application.
;
; The following is a sample application section.  Note that the name of
; the section must correspond to at least one mapping in the [types] section
; in order to be used:
;
; [Application 1]
;
; ExePath=string
; - The ExePath property specifies the executable for the FastCGI process,
;   where 'string' is the full path to the executable.  A non-empty string
;   is required.
;
; Arguments=string
; - The Arguments property specifies any arguments to be passed to the
;   FastCGI executable, where 'string' represents the arguments.  Multiple
;   arguments may be space delimited. If there is a space within the argument
;   then this argument must be placed in quotes. This property is optional.
;
; EnvironmentVars=string
; - The EnvironmentVars property specifies optional environment variables
;   that will be set in the FastCGI executable.  If any of the supplied
;   variable names collide with existing server variables, the ones specified
;   in this property will be used.  The format of the string is a comma
;   delimited list in the form of 'name1:value1,name2:value2'.  If a
;   delimiting character, such as a comma, semicolon or slash is necessary in
;   a value, it can be preceded by a '/' character (For example:
;   'name1:with/,commas,name2:with/;semicolon,name3:with//slash'.  This
;   property is optional.
;
; Protocol=string
; - Specifies the protocol used to communicate with the FastCGI process.
;   The allowed values are 'NamedPipe' and 'Tcp'.  If not specified, the
;   default value is 'NamedPipe'.
;
; MaxInstances=n
; - Specifies the maximum number of processes that are allowed in the
;   application's process pool.  This number directly corresponds to the
;   maximum number of concurrent requests that can be handled by the
;   application.  If not specified, the default value is 10.
;
; QueueLength=n
; - Specifies the maximum number of requests to this application that will
;   be queued before the FastCGI handler starts returning errors to clients
;   indicating that the application is too busy.  If not specified, the default
;   value is 1000.
;
; IdleTimeout=n
; - Specifies the time, in seconds, that a FastCGI process for this application
;   is allowed to remain idle.  If a process remains idle for longer than this
;   period, it will be shut down.  If not specified, the default value is
;   300 seconds.
;
; ActivityTimeout=n
; - Specifies the maximum time, in seconds, that a FastCGI process for this
;   application is allowed to run without communicating with IIS.  In practice,
;   this timeout is used to detect and shut down 'hung' processes.  If not
;   specified, the default value is 30 seconds.
;
; RequestTimeout=n
; - Specifies the maximum allowed time, in seconds, for a request to this
;   application.  If a FastCGI process takes longer than this amount of time
;   on a single request, it will be terminated.  If not specified, the default
;   value is 90 seconds.
;
; InstanceMaxRequests=n
; - Specifies the number of requests a FastCGI process for this application is
;   allowed to handle.  After handling this number of requests, it is shut
;   down so that it can be replaced with a new process.  If not specified, the
;   default value is 1000.
;
; ResponseBufferLimit=n
; - Data from FastCGI processes is buffered before being returned to the client
;   as responses.  This property specifies the amount of response data, in
;   bytes, that will be buffered for requests to this application.  This buffer
;   will be flushed to the client once it is full, or when the response is
;   complete, whichever occurs first.  If not specified, the default value is
;   4194304 (4MB).
;
; FlushNamedPipe=n
; - Specifies whether or not the named pipe between FastCGI processes for this
;   application is flushed before shutting down the application.  Possible
;   values are 0 or 1.  For most applications, 0 is the correct value.  If you
;   see processes hanging after InstanceMaxRequests has been reached, try
;   setting this value to 1.  If not specified, the default value is 0.
;
; UnhealthyOnQueueFull=n
; - If 1, the worker process hosting is flagged to IIS as unhealthy any time
;   that the application's request queue is filled.  IIS checks health whenever
;   it does a ping to the worker process.  If that worker process has been
;   flagged as unhealthy, it (along with everything it is hosting) will be
;   recycled.  If not specified, the default value is 0.
;
; IgnoreExistingFiles=n
; - If 1, this application will ignore any requests where the target file
;   exists on the file system, so that IIS can serve them normally.  This
;   feature is useful in the case where the FastCGI handler is installed as
;   a wildcard script map.  If not specified, the default value is 0.  Note
;   that this feature only applies only to IIS 6.0.
;
; IgnoreExistingDirectories=n
; - If 1, this application will ignore any requests where the target is a
;   directory on the file system, so that IIS can serve them normally.  This
;   feature is useful in the case where the FastCGI handler is installed as
;   a wildcard script map.  If not specified, the default value is 0.  Note
;   that this feature only applies only to IIS 6.0.