Export (0) Print
Expand All

cpu Element for add for applicationPools [IIS Settings Schema]

IIS 7.0

NoteNote:

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

Configures values for CPU usage parameters and CPU actions that will be used an application pools.

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

Attributes

Attribute

Description

action

Optional enum attribute.

Configures the action(s) that IIS takes when an worker process exceeds its configured CPU limit. The action attribute is configured on a per-application pool basis.

The action attribute can be one of the following possible values. The default value is NoAction.

ValueDescription
KillW3wpApplication pool worker processes that exceed their CPU limit will be forced to shut down.The numeric value is 1.
NoActionNo action is taken when the CPU limit is exceeded. A warning is written to the event log.The numeric value is 0.

limit

Optional uint attribute.

Configures the maximum percentage of CPU time (in 1/1000ths of one percent) that the worker processes in an application pool are allowed to consume over a period of time as indicated by the resetInterval attribute. If the limit set by the limit attribute is exceeded, an event is written to the event log and an optional set of events can be triggered. These optional events are determined by the action attribute.

The default value is 0, which disables CPU limiting.

resetInterval

Optional timeSpan attribute.

Specifies the reset period (in minutes) for CPU monitoring and throttling limits on an application pool. When the number of minutes elapsed since the last process accounting reset equals the number specified by this property, IIS resets the CPU timers for both the logging and limit intervals.

Important   The value in resetInterval must be greater than the time between logging operations, otherwise IIS will reset counters before logging has occurred, and process accounting will not occur.

NoteNote:
Because process accounting in IIS uses Windows job objects to monitor CPU times for the whole process, process accounting will only log and throttle applications that are isolated in a separate process from IIS.

The default value is 0, which disables CPU monitoring.

smpAffinitized

Optional Boolean attribute.

Specifies whether a particular worker process assigned to an application pool should also be assigned to a given CPU. This property is used together with the smpProcessorAffinityMask attribute.

The default value is false.

smpProcessorAffinityMask

Optional uint attribute.

Configures the hexadecimal processor mask for multi-processor computers, which indicates to which CPU the worker processes in an application pool should be bound. Before this property takes effect, the smpAffinitized attribute must be set to true for the application pool.

NoteNote:
Do not set this property to 0. Doing so disables symmetric multiprocessing (SMP) affinity and creates an error condition. This means that processes running on one CPU will not remain affiliated with that CPU throughout their lifetime.

The default value is 4294967295. If you set the value to 1 (which corresponds to 00000000000000001 in binary), the worker processes in an application pool run on only the first processor. If you set the value to 2 (which corresponds to 0000000000000010 in binary), the worker processes run on only the second processor. If you set the value to 3 (which corresponds to 0000000000000011 in binary) the worker processes run on both the first and second processors.

smpProcessorAffinityMask2

Optional uint attribute.

Specifies the high-order DWORD hexadecimal processor mask for 64-bit multi-processor computers, which indicates to which CPU the worker processes in an application pool should be bound. Before this property takes effect, the smpAffinitized attribute must be set to true for the application pool.

Note: On 64-bit computers, the smpProcessorAffinityMask attribute contains the low-order DWORD for the processor mask, and the smpProcessorAffinityMask2 attribute contains the high-order DWORD for the processor mask. On 32-bit computers, the smpProcessorAffinityMask2 attribute has no effect.

The default value is 4294967295.

Child Elements

None.

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.

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

Configuration locations

ApplicationHost.config

Requirements

Microsoft Internet Information Services (IIS) version 7.0

Community Additions

ADD
Show:
© 2015 Microsoft