Runtime do Servidor <serverRuntime>

Visão geral

O elemento <serverRuntime> define as seguintes configurações relacionadas ao runtime do servidor IIS (Serviços de Informações da Internet) 7:

• Definir o atributo enabled como true configurará o IIS 7 para servir conteúdo na URL em que o elemento <serverRuntime> está configurado, e definir o atributo enabled como falseconfigurará o IIS 7 para não servir conteúdo para essa URL.

• O atributo alternateHostName especifica um nome de host diferente do nome do computador no cabeçalho de localização de conteúdo HTTP.

• O atributo appConcurrentRequestLimit especifica o número máximo de solicitações simultâneas que podem ser enfileiradas para um aplicativo.

• O atributo enableNagling habilita ou desabilita o nagling, que é uma otimização para HTTP sobre TCP que aumenta a eficiência tentando minimizar o número de pacotes necessários antes que os dados sejam enviados. Ele funciona aguardando para enviar um pacote até que sua área de dados esteja cheia, até que um intervalo de tempo limite de 200 milissegundos expire ou até que o remetente indique que o envio de dados foi concluído. As versões 5.1 e anteriores do IIS usam o nagling para todos os dados enviados ao cliente.

  Observação

  O nagling tem uma possível desvantagem; se uma extensão não preencher o pacote, ainda haverá um atraso de 200 milissegundos antes que a resposta seja enviada. Esse comportamento é visto com mais frequência quando você usa extensões ISAPI que oferecem suporte a um cabeçalho keep-alive HTTP na resposta ao cliente. Nesse caso, o IIS não fecha a conexão após a resposta, portanto, o pacote final acaba aguardando 200 milissegundos.

• O IIS 7 verifica o status de dois atributos para determinar o nível de tráfego de uma URL específica. O atributo frequentHitThreshold configura o número de solicitações e o atributo frequentHitTimePeriod configura a quantidade de tempo permitida antes que a URL seja considerada como frequentemente visitada. Essas informações são usadas ao escrever módulos HTTP que usam essas informações para processamento. Para obter mais informações, consulte o artigo Método IHttpUrlInfo::IsFrequentlyHit.

• Os atributos maxRequestEntityAllowed e uploadReadAheadSize, respectivamente, configuram limites para o número máximo de bytes permitidos no corpo da entidade de uma solicitação e o número de bytes que um servidor Web lerá em um buffer e passará para uma extensão ISAPI. Deve-se levar em consideração que o aumento desses valores permite que o usuário final carregue mais conteúdo, o que pode ter um efeito sobre os recursos de memória de tempo de execução do IIS. Recomenda-se manter esses valores em um número consistente com as necessidades do aplicativo e, somente em circunstâncias extremas, usar o valor máximo.

Novidades no IIS 7.5

O IIS 7.5 adicionou o atributo authenticatedUserOverride ao elemento <serverRuntime>, que configura se o tempo de execução do servidor IIS 7 fornecerá a identidade do usuário autenticado ou a identidade do processo de trabalho nos métodos IHttpUser::GetPrimaryToken e IHttpUser::GetImpersonationToken. Esse atributo pode ser definido como UseAuthenticatedUser ou UseWorkerProcessUser, e esses valores, respectivamente, especificam se o tempo de execução do servidor IIS 7 fornecerá a identidade do usuário autenticado ou a identidade do processo de trabalho para qualquer módulo que esteja usando representação.

Compatibilidade

Instalação

O elemento <serverRuntime> está incluído na instalação padrão do IIS 7.

Instruções

Não há nenhuma interface do usuário que permita configurar o elemento <serverRuntime> para IIS 7. Para obter exemplos de como configurar o elemento <serverRuntime> programaticamente, confira a seção Exemplos de Código deste documento.

Configuração

Atributos

Elementos filho

Nenhum.

Exemplo de configuração

O exemplo de configuração a seguir define o atributo enable do elemento <serverRuntime> como true e, em seguida, configura o número de solicitações para que uma URL seja considerada “frequentemente visitada” definindo o atributo frequentHitThreshold como 5 solicitações e o atributo frequentHitTimePeriod como 20 segundos.

<location path="Default Web Site">
   <system.webServer>
      <serverRuntime enabled="true"
         frequentHitThreshold="5"
         frequentHitTimePeriod="00:00:20" />
   </system.webServer>
</location>

Exemplo de código

Os exemplos de código a seguir definem o atributo enable do elemento <serverRuntime> como true e, em seguida, configuram o número de solicitações para que uma URL seja considerada “frequentemente visitada” definindo o atributo frequentHitThreshold como 5 solicitações e o atributo frequentHitTimePeriod como 20 segundos.

AppCmd.exe

appcmd.exe set config "Default Web Site" -section:system.webServer/serverRuntime /enabled:"True" /commit:apphost
appcmd.exe set config "Default Web Site" -section:system.webServer/serverRuntime /frequentHitThreshold:"5" /commit:apphost
appcmd.exe set config "Default Web Site" -section:system.webServer/serverRuntime /frequentHitTimePeriod:"00:00:20" /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 serverRuntimeSection = config.GetSection("system.webServer/serverRuntime", "Default Web Site");
         serverRuntimeSection["enabled"] = true;
         serverRuntimeSection["frequentHitThreshold"] = 5;
         serverRuntimeSection["frequentHitTimePeriod"] = TimeSpan.Parse("00:00:20");

         serverManager.CommitChanges();
      }
   }
}

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 serverRuntimeSection As ConfigurationSection = config.GetSection("system.webServer/serverRuntime", "Default Web Site")
      serverRuntimeSection("enabled") = True
      serverRuntimeSection("frequentHitThreshold") = 5
      serverRuntimeSection("frequentHitTimePeriod") = TimeSpan.Parse("00:00:20")

      serverManager.CommitChanges()
   End Sub

End Module

JavaScript

var adminManager = new ActiveXObject('Microsoft.ApplicationHost.WritableAdminManager');
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST";

var serverRuntimeSection = adminManager.GetAdminSection("system.webServer/serverRuntime", "MACHINE/WEBROOT/APPHOST/Default Web Site");
serverRuntimeSection.Properties.Item("enabled").Value = true;
serverRuntimeSection.Properties.Item("frequentHitThreshold").Value = 5;
serverRuntimeSection.Properties.Item("frequentHitTimePeriod").Value = "00:00:20";

adminManager.CommitChanges();

VBScript

Set adminManager = WScript.CreateObject("Microsoft.ApplicationHost.WritableAdminManager")
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST"

Set serverRuntimeSection = adminManager.GetAdminSection("system.webServer/serverRuntime", "MACHINE/WEBROOT/APPHOST/Default Web Site")
serverRuntimeSection.Properties.Item("enabled").Value = True
serverRuntimeSection.Properties.Item("frequentHitThreshold").Value = 5
serverRuntimeSection.Properties.Item("frequentHitTimePeriod").Value = "00:00:20"

adminManager.CommitChanges()