Configurações de modelo de processo para um pool de aplicativos <processModel>

Visão geral

Usando o elemento <processModel>, você pode configurar muitos dos recursos de segurança, desempenho, integridade e confiabilidade dos pools de aplicativos no IIS 7 e posteriores. Isso inclui os seguintes recursos:

• Identidade do pool de aplicativos, que é o nome do serviço ou da conta de usuário na qual o processo de trabalho do pool de aplicativos é executado. Isso é definido pelo atributo identityType. Por padrão, a partir do IIS 7.5, um pool de aplicativos é executado na conta interna ApplicationPoolIdentity, que é criada dinamicamente pelo WAS (Serviço de Ativação de Processos do Windows). (No IIS 7.0, a identidade padrão era a conta NetworkService.) Você pode alterar o valor do atributo identityType para a conta interna NetworkService, a conta LocalService, a conta interna LocalSystem ou uma conta personalizada que você criar. Se você escolher uma conta personalizada, defina as credenciais da conta usando os atributos userName e password. No entanto, lembre-se de que as contas NetworkService, LocalService e LocalSystem têm mais direitos de usuário do que a conta ApplicationPoolIdentity. (Aviso: é um sério risco de segurança executar um pool de aplicativos usando direitos de usuário de alto nível.) Além disso, você pode usar o atributo logonType para especificar se a identidade do processo deve fazer logon como um usuário ou serviço em lote. (Para obter informações adicionais sobre tipos de logon, consulte o artigo Função LogonUser.)
• A jardinagem da Web e uso do hardware NUMA (acesso não uniforme à memória), que você pode configurar definindo o atributo maxProcesses. Para jardinagem da Web, consulte maxProcesses para um valor maior que um. Para usar o hardware NUMA, defina maxProcesses como um valor de "0" para especificar que o IIS executa o mesmo número de processos de trabalho que há nós do NUMA.
• Configurações de tempo limite ocioso, que permitem definir por quanto tempo um processo de trabalho permanece ocioso antes de ser desligado. Edite o atributo idleTimeout para configurar essa definição.
• Monitoramento de integridade habilitando pings no processo de trabalho, o tempo máximo permitido para um processo de trabalho responder a um ping e a frequência de pings enviados a um processo de trabalho para monitorar sua integridade. Edite os atributos pingingEnabled, pingInterval e pingResponseTime para definir essas definições.
• Limites de tempo de inicialização e desligamento do processo de trabalho. O primeiro limite é definido pelo atributo shutdownTimeLimit e determina o intervalo que o IIS 7 e posteriores fornece a um processo de trabalho para concluir todas as solicitações antes que o serviço WWW encerre o processo de trabalho. O segundo limite é definido pelo atributo startupTimeLimit e especifica a quantidade de tempo que o IIS 7 e posteriores permitem que um pool de aplicativos seja iniciado.

Compatibilidade

Instalação

A coleção <applicationPools> está incluída na instalação padrão do IIS 7 e posteriores.

Instruções

Como editar as configurações do modelo de processo

1. Abra o Gerenciador dos Serviços de Informações da Internet (IIS):

   • Caso você esteja usando o Windows Server 2012 ou o Windows Server 2012 R2:

     • Na barra de tarefas, clique em Gerenciador do Servidor, em Ferramentas e em Gerenciador dos Serviços de Informações da Internet (IIS).

   • Se você estiver usando o Windows 8 ou Windows 8.1:

     • Mantenha pressionada a tecla Windows, pressione a letra X e clique em Painel de Controle.
     • Clique em Ferramentas Administrativas e clique duas vezes em Gerenciador dos Serviços de Informações da Internet (IIS).

   • Caso você esteja usando o Windows Server 2008 ou o Windows Server 2008 R2:

     • Na barra de tarefas, clique em Iniciar, vá para Ferramentas Administrativas e clique em Gerenciador dos Serviços de Informações da Internet (IIS).

   • Se você estiver usando o Windows Vista ou Windows 7:

     • Na barra de tarefas, clique em Iniciar e, depois, em Painel de Controle.
     • Clique duas vezes em Ferramentas Administrativas e clique duas vezes em Gerenciador dos Serviços de Informações da Internet (IIS).

2. No painel Conexões, expanda o nome do servidor e clique em Pools de Aplicativos e no pool de aplicativos que deseja editar.

3. No painel Ações, clique em Configurações Avançadas...

4. Na caixa de diálogo Configurações Avançadas, clique na propriedade do modelo de processo que deseja editar, edite-a na seção de valor da propriedade da caixa de diálogo e clique em OK. Por exemplo, altere o limite de tempo de desligamento (segundos) e os limites de tempo de inicialização (segundos) para 30.
   

Como configurar o IIS para uso com o hardware NUMA (acesso não uniforme à memória)

1. Abra o Gerenciador dos Serviços de Informações da Internet (IIS):

   • Se você estiver usando o Windows Server 2012 ou posterior:

     • Na barra de tarefas, clique em Gerenciador do Servidor, em Ferramentas e em Gerenciador dos Serviços de Informações da Internet (IIS).

   • Se você estiver usando o Windows 8 ou versões posteriores:

     • Mantenha pressionada a tecla Windows, pressione a letra X e clique em Painel de Controle.
     • Clique em Ferramentas Administrativas e clique duas vezes em Gerenciador dos Serviços de Informações da Internet (IIS).

2. No painel Conexões, expanda o nome do servidor e clique em Pools de Aplicativos.

3. No painel Pools de Aplicativos, selecione o pool que deseja configurar para NUMA.

4. No painel Ações, selecione Configurações Avançadas.

5. No painel Modelo de Processo, defina o Máximo de Processos de Trabalho como 0.

   

Como configurar a ação de tempo limite ocioso

1. Abra o Gerenciador dos Serviços de Informações da Internet (IIS):

   • Se você estiver usando o Windows Server 2012 R2:

     • Na barra de tarefas, clique em Gerenciador do Servidor, em Ferramentas e em Gerenciador dos Serviços de Informações da Internet (IIS).

   • Se você estiver usando o Windows 8.1:

     • Mantenha pressionada a tecla Windows, pressione a letra X e clique em Painel de Controle.
     • Clique em Ferramentas Administrativas e clique duas vezes em Gerenciador dos Serviços de Informações da Internet (IIS).

2. No painel Conexões, clique duas vezes no nome do servidor, clique duas vezes em Pools de Aplicativos e, em seguida, selecione o pool de aplicativos a ser configurado.

3. No painel Ações, clique em Configurações Avançadas.

4. Na seção Modelo de Processo da caixa de diálogo Configurações Avançadas, para idleTimeoutAction, selecione Encerrar ou Suspender.

5. Clique em OK.

   

Configuração

Você configura o elemento <processModel> no nível do servidor no arquivo ApplicationHost.config.

Atributos

Elementos filho

Nenhum.

Exemplo de configuração

O exemplo de configuração a seguir usa o elemento do pool <add> de aplicativos para criar um novo pool de aplicativos chamado Contoso. O elemento <recycling> configura o registro em log para reinicializações do pool de aplicativos, o elemento <periodicRestart> é configurado quando o pool de aplicativos é reiniciado e o elemento <processModel> configura os atributos shutdownTimeLimit e startupTimeLimit para desligar e iniciar os processos de trabalho no pool de aplicativos por 30 segundos cada. Se esses limites de tempo forem excedidos, o IIS encerrará o processo de trabalho.

<add name="Contoso">
   <recycling logEventOnRecycle="Schedule">
      <periodicRestart>
         <schedule>
            <clear />
            <add value="03:00:00" />
         </schedule>
      </periodicRestart>
   </recycling>
   <processModel identityType="NetworkService" shutdownTimeLimit="00:00:30" startupTimeLimit="00:00:30" />
</add>

Exemplo de código

Os exemplos a seguir alteram os valores da propriedade processModel.shutdownTimeLimit e processModule.startupTimeLimit para 30 segundos cada para um pool de aplicativos chamado Contoso.

AppCmd.exe

appcmd.exe set apppool "Contoso" /processModel.shutdownTimeLimit:00:00:30

appcmd.exe set apppool "Contoso" /processModel.startupTimeLimit:00:00:30

Você também pode usar a seguinte sintaxe:

appcmd.exe set config -section:system.applicationHost/applicationPools /[name='Contoso'].processModel.shutdownTimeLimit:"00:00:30" /commit:apphost

appcmd.exe set config -section:system.applicationHost/applicationPools /[name='Contoso'].processModel.startupTimeLimit:"00:00:30" /commit:apphost

C#

using System;
using System.Text;
using Microsoft.Web.Administration;

internal static class Sample
{
   private static void Main()
   {
      using (ServerManager serverManager = new ServerManager())
      {
         Configuration config = serverManager.GetApplicationHostConfiguration();
         ConfigurationSection applicationPoolsSection = config.GetSection("system.applicationHost/applicationPools");
         ConfigurationElementCollection applicationPoolsCollection = applicationPoolsSection.GetCollection();

         ConfigurationElement addElement = FindElement(applicationPoolsCollection, "add", "name", @"Contoso");
         if (addElement == null) throw new InvalidOperationException("Element not found!");

         ConfigurationElement processModelElement = addElement.GetChildElement("processModel");
         processModelElement["shutdownTimeLimit"] = TimeSpan.Parse("00:00:30");
         processModelElement["startupTimeLimit"] = TimeSpan.Parse("00:00:30");

         serverManager.CommitChanges();
      }
   }

   private static ConfigurationElement FindElement(ConfigurationElementCollection collection, string elementTagName, params string[] keyValues)
   {
      foreach (ConfigurationElement element in collection)
      {
         if (String.Equals(element.ElementTagName, elementTagName, StringComparison.OrdinalIgnoreCase))
         {
            bool matches = true;
            for (int i = 0; i < keyValues.Length; i += 2)
            {
               object o = element.GetAttributeValue(keyValues[i]);
               string value = null;
               if (o != null)
               {
                  value = o.ToString();
               }
               if (!String.Equals(value, keyValues[i + 1], StringComparison.OrdinalIgnoreCase))
               {
                  matches = false;
                  break;
               }
            }
            if (matches)
            {
               return element;
            }
         }
      }
      return null;
   }
}

VB.NET

Imports System
Imports System.Text
Imports Microsoft.Web.Administration

Module Sample
   Sub Main()
      Dim serverManager As ServerManager = New ServerManager
      Dim config As Configuration = serverManager.GetApplicationHostConfiguration
      Dim applicationPoolsSection As ConfigurationSection = config.GetSection("system.applicationHost/applicationPools")
      Dim applicationPoolsCollection As ConfigurationElementCollection = applicationPoolsSection.GetCollection
      Dim addElement As ConfigurationElement = FindElement(applicationPoolsCollection, "add", "name", "Contoso")

      If (addElement Is Nothing) Then
         Throw New InvalidOperationException("Element not found!")
      End If

      Dim processModelElement As ConfigurationElement = addElement.GetChildElement("processModel")
      processModelElement("shutdownTimeLimit") = TimeSpan.Parse("00:00:30")
      processModelElement("startupTimeLimit") = TimeSpan.Parse("00:00:30")
      serverManager.CommitChanges()
   End Sub

   Private Function FindElement(ByVal collection As ConfigurationElementCollection, ByVal elementTagName As String, ByVal ParamArray keyValues() As String) As ConfigurationElement
      For Each element As ConfigurationElement In collection
         If String.Equals(element.ElementTagName, elementTagName, StringComparison.OrdinalIgnoreCase) Then
            Dim matches As Boolean = True
            Dim i As Integer
            For i = 0 To keyValues.Length - 1 Step 2
               Dim o As Object = element.GetAttributeValue(keyValues(i))
               Dim value As String = Nothing
               If (Not (o) Is Nothing) Then
                  value = o.ToString
               End If
               If Not String.Equals(value, keyValues((i + 1)), StringComparison.OrdinalIgnoreCase) Then
                  matches = False
                  Exit For
               End If
            Next
            If matches Then
               Return element
            End If
         End If
      Next
      Return Nothing
   End Function


End Module

JavaScript

var adminManager = new ActiveXObject('Microsoft.ApplicationHost.WritableAdminManager');
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST";
var applicationPoolsSection = adminManager.GetAdminSection("system.applicationHost/applicationPools", "MACHINE/WEBROOT/APPHOST");
var applicationPoolsCollection = applicationPoolsSection.Collection;

var addElementPos = FindElement(applicationPoolsCollection, "add", ["name", "Contoso"]);
if (addElementPos == -1) throw "Element not found!";

var addElement = applicationPoolsCollection.Item(addElementPos);
var processModelElement = addElement.ChildElements.Item("processModel");
processModelElement.Properties.Item("shutdownTimeLimit").Value = "00:00:30";
processModelElement.Properties.Item("startupTimeLimit").Value = "00:00:30";

adminManager.CommitChanges();

function FindElement(collection, elementTagName, valuesToMatch) {
   for (var i = 0; i < collection.Count; i++) {
      var element = collection.Item(i);
      if (element.Name == elementTagName) {
         var matches = true;
         for (var iVal = 0; iVal < valuesToMatch.length; iVal += 2) {
            var property = element.GetPropertyByName(valuesToMatch[iVal]);
            var value = property.Value;
            if (value != null) {
               value = value.toString();
            }
            if (value != valuesToMatch[iVal + 1]) {
               matches = false;
               break;
            }
         }
         if (matches) {
            return i;
         }
      }
   }
   return -1;
}

VBScript

Set adminManager = createObject("Microsoft.ApplicationHost.WritableAdminManager")
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST"
Set applicationPoolsSection = adminManager.GetAdminSection("system.applicationHost/applicationPools", "MACHINE/WEBROOT/APPHOST")
Set applicationPoolsCollection = applicationPoolsSection.Collection

addElementPos = FindElement(applicationPoolsCollection, "add", Array("name", "Contoso"))
If siteElementPos = -1 Then
   WScript.Echo "Element not found!"
   WScript.Quit
End If

Set addElement = applicationPoolsCollection.Item(addElementPos)
Set processModelElement = addElement.ChildElements.Item("processModel")
processModelElement.Properties.Item("shutdownTimeLimit").Value = "00:00:30"
processModelElement.Properties.Item("startupTimeLimit").Value = "00:00:30"

adminManager.CommitChanges()

Function FindElement(collection, elementTagName, valuesToMatch)
   For i = 0 To CInt(collection.Count) - 1
      Set element = collection.Item(i)
      If element.Name = elementTagName Then
         matches = True
         For iVal = 0 To UBound(valuesToMatch) Step 2
            Set property = element.GetPropertyByName(valuesToMatch(iVal))
            value = property.Value
            If Not IsNull(value) Then
               value = CStr(value)
            End If
            If Not value = CStr(valuesToMatch(iVal + 1)) Then
               matches = False
               Exit For
            End If
         Next
         If matches Then
            Exit For
         End If
      End If
   Next
   If matches Then
      FindElement = i
   Else
      FindElement = -1
   End If
End Function