Options Section

The Options section of the Relay Server configuration file specifies the properties that apply to each Relay Server in the farm.

The Relay Server configuration file supports only one Options section. It is identified by the options keyword.

Property Description
auto_config Configures the Relay Server so that Outbound Enablers can connect by using the token of unseen backend farms and backend servers.
log_size_limit (Windows only) Sets the maximum size of the Relay Server log file. The supported units are: k, K, m, M, g, and G. The default value is 0 (no limit).
min_thread (Windows only) Specifies the minimum number of threads to allocate to the thread pool. The default setting is auto: threads are not returned to the idle pool if the size of the idle pool is equal to or greater than half of max_thread.
max_thread (Windows only)

Specifies the maximum number of threads to allocate to the thread pool. The default setting is auto: the Relay Server does not limit the number of active threads in the pool. If requests arrive when there are no threads left in the idle pool, then the Relay Server allocates new threads up to the thread limit of 65,535. max_thread must be greater than min_thread.

To exceed 5,000 concurrent requests for IIS7, use the following configuration:

%systemroot%\system32\inetsrv\appcmd.exe set config "Default Web Site" -section:system.webServer/serverRuntime /appConcurrentRequestLimit:"<new-limit>" /commit:<apphost>

For max_thread to work as a soft limit, set <new-limit> higher than max_thread.

shared_mem (Linux only)

(Optional) Specifies the maximum amount of shared memory that the Relay Server uses for state tracking. The default value is 10 MB. The maximum setting is 4 GB. Consider changing this setting when any of the following conditions occurs:

  • Improved speed in the network between the Relay Server and the Outbound Enabler
  • Significant growth in the number of backend farms
  • Significant growth in the size of the backend farm
  • Significant growth in the number of clients
  • Significant growth in HTTP response size
  • Addition of slower clients or slower networks

Specifies the verbosity level:

  • 0

    (Default) Log errors only. Use this logging level for deployment.

  • 1

    Request logging. All HTTP requests are written to the Relay Server log file.

  • 2

    Request logging. Provides a more detailed view of HTTP requests.

  • 3 or higher

    Detailed logging. Used primarily for Technical Support.

Errors are displayed regardless of the log level specified, and warnings are displayed only if the log level is greater than 0.