Export (0) Print
Expand All

recycling Element for applicationPoolDefaults for applicationPools [IIS Settings Schema]

IIS 7.0

NoteNote:

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 default recycling settings for all application pools on a server.

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 settings for application pool recycling.

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

Specifies the root element for the configuration for all application pools on a server.

applicationPoolDefaults

Specifies default settings for all application pools on a server.

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>.

Configuration locations

ApplicationHost.config

Requirements

Microsoft Internet Information Services (IIS) version 7.0

Community Additions

ADD
Show:
© 2015 Microsoft