Impostazioni di riavvio periodice per il riciclo <del pool di applicazioni PeriodicaRestart>

Articolo
07/19/2023

Panoramica

L'elemento <periodicRestart> contiene impostazioni di configurazione che consentono di controllare quando un pool di applicazioni viene riciclato. È possibile specificare che Internet Information Services (IIS) 7 ricicla il pool di applicazioni dopo un intervallo di tempo (in minuti) o in un'ora specifica ogni giorno. È anche possibile configurare IIS per basare il riciclo sulla quantità di memoria virtuale o memoria fisica usata dal processo di lavoro nel pool di applicazioni o configurare IIS per riciclare il pool di applicazioni dopo che il processo di lavoro ha elaborato un numero specifico di richieste.

Compatibilità

Versione	Note
IIS 10.0	L'elemento `<periodicRestart>` non è stato modificato in IIS 10.0.
IIS 8,5	L'elemento `<periodicRestart>` non è stato modificato in IIS 8.5.
IIS 8,0	L'elemento `<periodicRestart>` non è stato modificato in IIS 8.0.
IIS 7,5	L'elemento `<periodicRestart>` non è stato modificato in IIS 7.5.
IIS 7.0	L'elemento `<periodicRestart>` è stato introdotto in IIS 7.0.
IIS 6.0	L'elemento `<periodicRestart>` sostituisce parti della proprietà metabase IIsApplicationPools IIS 6.0.

Installazione

La <applicationPools> raccolta è inclusa nell'installazione predefinita di IIS 7.

Procedure

Come configurare il riciclo periodico per un pool di applicazioni

Aprire Gestione Internet Information Services (IIS):
- Se si usa Windows Server 2012 o Windows Server 2012 R2:
  - Nella barra delle applicazioni fare clic su Server Manager, scegliere Strumenti e quindi fare clic su Gestione Internet Information Services (IIS).
- Se si usa Windows 8 o Windows 8.1:
  - Tenere premuto il tasto Windows, premere la lettera X e quindi fare clic su Pannello di controllo.
  - Fare clic su Strumenti di amministrazione e quindi fare doppio clic su Gestione Internet Information Services (IIS).
- Se si usa Windows Server 2008 o Windows Server 2008 R2:
  - Nella barra delle applicazioni fare clic su Start, scegliere Strumenti di amministrazione e quindi fare clic su Gestione Internet Information Services (IIS).
- Se si usa Windows Vista o Windows 7:
  - Nella barra delle applicazioni fare clic su Start e quindi fare clic su Pannello di controllo.
  - Fare doppio clic su Strumenti di amministrazione e quindi fare doppio clic su Gestione Internet Information Services (IIS).
Nel riquadro Connessioni espandere il nome del server e quindi fare clic su Pool di applicazioni.
Nel riquadro Pool di applicazioni selezionare il pool di applicazioni che si vuole modificare.
Nel riquadro Azioni fare clic su Riciclo...
Nella pagina Condizioni di riciclo della Procedura guidata Modifica impostazioni riciclo pool di applicazioni selezionare almeno una delle opzioni nella sezione Intervalli fissi , digitare i valori nelle caselle di testo appropriate e quindi fare clic su Avanti.
(Facoltativo) Nella pagina Eventi di riciclo per registrare la procedura guidata Modifica impostazioni riciclo pool di applicazioni selezionare gli eventi di riciclo configurabili e gli eventi di riciclo in fase di esecuzione che si desidera inviare IIS al registro eventi al momento dell'esecuzione e quindi fare clic su Fine.

Configurazione

L'elemento <periodicRestart> è configurabile a livello di server nel file ApplicationHost.config.

Attributi

Attributo	Descrizione
`memory`	Attributo uint facoltativo. Specifica la quantità di memoria virtuale (in kilobyte) che un processo di lavoro può usare prima che il processo di lavoro venga riciclato. Il valore predefinito è `0`, che disabilita l'attributo.
`privateMemory`	Attributo uint facoltativo. Specifica la quantità di memoria privata (in kilobyte) che un processo di lavoro può usare prima del riciclo del processo di lavoro. Il valore predefinito è `0`, che disabilita l'attributo.
`requests`	Attributo uint facoltativo. Specifica che il processo di lavoro deve essere riciclato dopo aver elaborato un numero specifico di richieste. Il valore predefinito è `0`, che disabilita l'attributo.
`time`	Attributo timeSpan facoltativo. Specifica che il processo di lavoro deve essere riciclato dopo un periodo di tempo specificato trascorso. Il valore predefinito è `29:00:00` (29 ore).

Elementi figlio

Elemento	Descrizione
`schedule`	Elemento facoltativo. Specifica la pianificazione dei riavvii periodici dei pool di applicazioni.

Esempio di configurazione

L'esempio di configurazione seguente usa l'elemento del pool <add> di applicazioni per creare un nuovo pool di applicazioni denominato Contoso. L'elemento <recycling> configura la registrazione per i riavvii del pool di applicazioni, l'elemento <periodicRestart> configura quando il pool di applicazioni viene riavviato e l'elemento <processModel> configura gli attributi shutdownTimeLimit e startupTimeLimit per arrestare e avviare i processi di lavoro nel pool di applicazioni per 30 secondi. Se questi limiti di tempo vengono superati, IIS termina il processo di lavoro.

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

Codice di esempio

Gli esempi di codice seguenti aggiungono un pool di applicazioni denominato Contoso al server IIS 7, quindi imposta il pool di applicazioni sul riciclo giornaliero alle 3:00 A.M.

AppCmd.exe

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

appcmd.exe set config -section:system.applicationHost/applicationPools /+"[name='Contoso'].recycling.periodicRestart.schedule.[value='03:00:00']" /commit:apphost

È anche possibile usare la sintassi seguente:

appcmd.exe add apppool /name:"Contoso"

appcmd.exe set config -section:system.applicationHost/applicationPools /+"[name='Contoso'].recycling.periodicRestart.schedule.[value='03:00:00']" /commit:apphost

Nota

È necessario assicurarsi di impostare il parametro commit su apphost quando si usa AppCmd.exe per configurare queste impostazioni. Questa operazione esegue il commit delle impostazioni di configurazione nella sezione percorso appropriata nel file di ApplicationHost.config.

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 = applicationPoolsCollection.CreateElement("add");
         addElement["name"] = @"Contoso";
         ConfigurationElement recyclingElement = addElement.GetChildElement("recycling");
         ConfigurationElement periodicRestartElement = recyclingElement.GetChildElement("periodicRestart");
         ConfigurationElementCollection scheduleCollection = periodicRestartElement.GetCollection("schedule");
         ConfigurationElement addElement1 = scheduleCollection.CreateElement("add");
         addElement1["value"] = TimeSpan.Parse("03:00:00");
         scheduleCollection.Add(addElement1);
         applicationPoolsCollection.Add(addElement);
         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 applicationPoolsSection As ConfigurationSection = config.GetSection("system.applicationHost/applicationPools")
      Dim applicationPoolsCollection As ConfigurationElementCollection = applicationPoolsSection.GetCollection
      Dim addElement As ConfigurationElement = applicationPoolsCollection.CreateElement("add")
      addElement("name") = "Contoso"
      Dim recyclingElement As ConfigurationElement = addElement.GetChildElement("recycling")
      Dim periodicRestartElement As ConfigurationElement = recyclingElement.GetChildElement("periodicRestart")
      Dim scheduleCollection As ConfigurationElementCollection = periodicRestartElement.GetCollection("schedule")
      Dim addElement1 As ConfigurationElement = scheduleCollection.CreateElement("add")
      addElement1("value") = TimeSpan.Parse("03:00:00")
      scheduleCollection.Add(addElement1)
      applicationPoolsCollection.Add(addElement)
      serverManager.CommitChanges()
   End Sub
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 addElement = applicationPoolsCollection.CreateNewElement("add");
addElement.Properties.Item("name").Value = "Contoso";
var recyclingElement = addElement.ChildElements.Item("recycling");
var periodicRestartElement = recyclingElement.ChildElements.Item("periodicRestart");
var scheduleCollection = periodicRestartElement.ChildElements.Item("schedule").Collection;
var addElement1 = scheduleCollection.CreateNewElement("add");
addElement1.Properties.Item("value").Value = "03:00:00";
scheduleCollection.AddElement(addElement1);
applicationPoolsCollection.AddElement(addElement);

adminManager.CommitChanges();

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

Set addElement = applicationPoolsCollection.CreateNewElement("add")
addElement.Properties.Item("name").Value = "Contoso"
Set recyclingElement = addElement.ChildElements.Item("recycling")
Set periodicRestartElement = recyclingElement.ChildElements.Item("periodicRestart")
Set scheduleCollection = periodicRestartElement.ChildElements.Item("schedule").Collection
Set addElement1 = scheduleCollection.CreateNewElement("add")
addElement1.Properties.Item("value").Value = "03:00:00"
scheduleCollection.AddElement(addElement1)
applicationPoolsCollection.AddElement(addElement)

adminManager.CommitChanges()

Condividi tramite