Configuring isapi_scgi

isapi_scgi is configured through the isapi_scgi.ini file which must be located in the same directory as the isapi_scgi.dll extension. This file is in the standard Windows INI file format and may contain the variables described below. These must be defined in the [SCGI] section of the file.

Note that the file is only needed if the defaults described below do not match your desired configuration.

Variable name Description Default
ISAPI SCGI configuration variables
IOCPQueueMax Integer value corresponding to the maximum number of queued IOCP requests. 50
KeepStatistics If non-0, the extension keeps certain statistics that can be useful in troubleshooting or tuning. 0
LogFile Path to the log file. isapi_scgi.log in the same directory as isapi_scgi.dll.
LogLevel Verbosity of logging. 0 turns off, 1 logs only errors. 1
NumThreads Integer value corresponding to the number of worker threads to be run. 10
SCGIServerAddress IP address of the SCGI server. 127.0.0.1
SCGIServerPort Port the SCGI server is listening on. 9999
SCGIServerStartCommand Command to execute start the SCGI application server. See Starting the SCGI server automatically. None. No server is started by default.
SCGIServerStopCommand Command to execute stop the SCGI application server. See Starting the SCGI server automatically. None.
StatisticsLogInterval Controls how often statistics are written to the log file. The interval is given in seconds. 60

The optimal values for NumThreads and IOCPQueueMax depend on the system (memory, number of processors and their speed, etc.) and configuration (for example, whether the SCGI server on a different system). On heavily loaded systems, you should determine these values empirically through load testing.