Сервер среды выполнения <сервераRuntime>

Общие сведения

Элемент <serverRuntime> настраивает следующие параметры, связанные с серверной средой выполнения служб IIS 7:

• Если для атрибута enabledзадано значение true , iis 7 будут настроены для обслуживания содержимого по URL-адресу, <serverRuntime> в котором настроен элемент; если задать для атрибута enabledзначение false , служба IIS 7 не будет обслуживать содержимое для этого URL-адреса.

• Атрибут alternateHostName задает имя узла, отличное от имени компьютера в заголовке HTTP Content-location.

• Атрибут appConcurrentRequestLimit указывает максимальное количество одновременных запросов, которые можно поместить в очередь для приложения.

• Атрибут enableNagling включает или отключает nagling, что является оптимизацией для HTTP по ПРОТОКОЛу TCP, что повышает эффективность, пытаясь свести к минимуму количество пакетов, необходимых перед отправкой данных . Он работает, ожидая отправки пакета, пока его область данных не будет заполнена, пока не истечет 200 миллисекунда времени ожидания или пока отправитель не укажет, что отправка данных завершена. СЛУЖБЫ IIS версии 5.1 и более ранних версий используют nagling для всех данных, отправляемых клиенту.

  Примечание

  Наглинг имеет возможный недостаток; Если расширение не заполняет пакет, перед отправкой ответа по-прежнему возникает задержка в 200 миллисекундах. Такое поведение чаще всего наблюдается при использовании расширений ISAPI, поддерживающих заголовок HTTP Keep-Alive в ответе клиенту. В этом случае IIS не закрывает подключение после ответа, поэтому окончательный пакет ожидает 200 миллисекунда.

• IIS 7 проверяет состояние двух атрибутов, чтобы определить уровень трафика для определенного URL-адреса. Атрибут frequentHitThreshold настраивает количество запросов, а атрибут frequentHitTimePeriod — время, отведенное до того, как этот URL-адрес будет считаться часто встречающимся. Эти сведения используются при написании модулей HTTP, которые используют эти сведения для обработки. Дополнительные сведения см. в статье Метод IHttpUrlInfo::IsFrequentlyHit .

• Атрибуты maxRequestEntityAllowed и uploadReadAheadSize соответственно настраивают ограничения для максимального числа байтов, разрешенного в теле сущности запроса, и количества байтов, которые веб-сервер считывает в буфер и передает расширению ISAPI. Следует учитывать, что увеличение этих значений позволяет конечному пользователю отправлять больше содержимого, что может повлиять на ресурсы памяти среды выполнения IIS. Рекомендуется поддерживать эти значения в соответствии с потребностями приложения и использовать максимальное значение только в крайних случаях.

Новые возможности в IIS 7.5

СЛУЖБЫ IIS 7.5 добавили атрибут authenticatedUserOverride к элементу <serverRuntime> , который указывает, будет ли среда выполнения сервера IIS 7 предоставлять удостоверение прошедшего проверку подлинности пользователя или удостоверение рабочего процесса в методах IHttpUser::GetPrimaryToken и IHttpUser::GetImpersonationToken . Для этого атрибута можно задать значение UseAuthenticatedUser или UseWorkerProcessUser, и эти значения соответственно указывают, будет ли среда выполнения сервера IIS 7 предоставлять удостоверение пользователя, прошедшего проверку подлинности, или удостоверение рабочего процесса для любого модуля, использующем олицетворение.

Совместимость

Настройка

Элемент <serverRuntime> включен в установку iis 7 по умолчанию.

Инструкции

Отсутствует пользовательский интерфейс, позволяющий настроить <serverRuntime> элемент для IIS 7. Примеры настройки <serverRuntime> элемента программными средствами см. в разделе Примеры кода этого документа.

Конфигурация

Атрибуты

Дочерние элементы

Отсутствует.

Образец конфигурации

В следующем примере конфигурации атрибуту enable элемента присваивается <serverRuntime>значение true, а затем настраивается число запросов для URL-адреса, который считается "часто встречаемым", задав атрибуту frequentHitThreshold значение 5 запросов, а атрибуту frequentHitTimePeriod — значение 20 секунд.

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

Пример кода

В следующих примерах кода атрибуту enable элемента присваивается <serverRuntime>значение true, а затем настраивается количество запросов для URL-адреса, который считается "часто встречаемым", задав атрибуту frequentHitThreshold значение 5 запросов, а атрибуту frequentHitTimePeriod — значение 20 секунд.

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()