Share via


recycling Element for add for applicationPools [IIS Settings Schema]

Note

For more information about the recycling element, see the following topic on the Microsoft IIS.net Web site: Recycling Settings for an Application Pool <recycling>.

Configures recycling settings for an application pool.

Note

Individual application pool settings override default settings unless the default settings are locked.

Syntax

Attributes and Elements

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

Attributes

Attribute

Description

disallowOverlappingRotation

Optional Boolean attribute.

Specifies whether the WWW Service should start another worker process to replace the existing worker process while that process is shutting down. The value of this property should be set to true if the worker process loads any application code that does not support multiple worker processes.

The default value is false.

disallowRotationOnConfigChange

Optional Boolean attribute.

Specifies whether the WWW Service should rotate worker processes in an application pool when the configuration has changed.

The default value is false.

logEventOnRecycle

Optional flags attribute.

Specifies that IIS should log an event when an application pool is recycled. The logEventOnRecycle property must have a bit set corresponding to the reason for the recycle if IIS is to log the event.

The logEventOnRecycle attribute can be one or more of the following possible values. If you specify more than one value, separate them with a comma (,). The default values are Time, Memory, and PrivateMemory.

ValueDescription
ConfigChangeLog an event when an application pool recycles because of a configuration change. The numeric value is 64.
IsapiUnhealthyLog an event when an application pool recycles after an ISAPI extension reports to the worker process that it is in an unhealthy state. The numeric value is 16.
MemoryLog an event when an application pool recycles after it uses a specified amount of virtual memory. The numeric value is 8.
OnDemandLog an event when an application pool is recycled immediately to correct a problem. The numeric value is 32.
PrivateMemoryLog an event when an application pool recycles after it uses a specified amount of virtual memory. The numeric value is 128.
RequestsLog an event when an application pool recycles after it reaches a configured number of requests. The numeric value is 2.
ScheduleLog an event when an application pool recycles after it reaches a configured time of day. The numeric value is 4.
TimeLog an event when an application pool recycles after a configured time. The numeric value is 1.

Child Elements

Element

Description

periodicRestart

Optional element.

Specifies conditions under which application pools are recycled.

Parent Elements

Element

Description

configuration

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

system.applicationHost

Specifies the root element for configuring Web process settings.

applicationPools

Contains default configuration settings for all application pools on the server and defines configuration settings for specific application pools.

add

Configures an application pool in the server configuration.

Remarks

For more information about the recycling element, see the following topic on the Microsoft IIS.net Web site: Recycling Settings for an Application Pool <recycling>.

Element Information

Configuration locations

ApplicationHost.config

Requirements

Microsoft Internet Information Services (IIS) version 7.0

See Also

Reference

periodicRestart Element for recycling for add for applicationPools [IIS Settings Schema]