Configurare le impostazioni della cache per un'applicazione Web in SharePoint Server

SI APPLICA A:yes-img-132013 yes-img-162016 yes-img-192019 yes-img-seSubscription Edition no-img-sopSharePoint in Microsoft 365

Questo articolo descrive come configurare la cache BLOB basata su disco, i profili della cache di output della pagina e la cache degli oggetti per un'applicazione Web in SharePoint Server.

Per abilitare e configurare la cache BLOB e apportare modifiche di configurazione ai profili della cache di output delle pagine e alla cache oggetti, è necessario utilizzare il file web.config dell'applicazione Web a cui si desidera applicare le modifiche. Le modifiche apportate al file web.config verranno applicate a tutte le raccolte siti dell'applicazione Web.

SharePoint Server include monitoraggi delle prestazioni della cache che consentono di verificare che le impostazioni della cache della farm siano corrette e che la memorizzazione nella cache sia in esecuzione al massimo delle prestazioni. Per altre informazioni, vedere Monitorare le prestazioni della cache in SharePoint Server 2016.

Nota

La configurazione dei profili della cache di output delle pagine e della cache oggetti a livello di applicazione Web avrà la priorità su qualsiasi configurazione eseguita dagli amministratori dei siti a livello di raccolta siti o a livello inferiore.

Consiglio

In alcuni casi la cache BLOB non è sincronizzata con il contenuto. Ad esempio, dopo il ripristino di un database del contenuto, la cache BLOB non è più sincronizzata con il contenuto. Per ovviare a questo problema, è necessario scaricare la cache BLOB. Per altre informazioni, vedere Scaricare la cache BLOB in SharePoint Server.

Per altre informazioni, vedere Operazioni sulle impostazioni della cache in SharePoint Server.

Configurare le impostazioni della cache BLOB

Per impostazione predefinita, la cache BLOB basata su disco è disattivata e deve essere abilitata nel server Web front-end se si desidera utilizzarla. Per configurare le impostazioni della cache basata su disco per un'applicazione Web, attenersi alla procedura seguente.

Importante

Prima di apportare modifiche al file web.config, crearne una copia con un altro nome, ad esempio web.config1. In questo modo, se si commette un errore nel file, sarà possibile ripristinare il file originale.

Per configurare le impostazioni della cache BLOB

  1. Verificare di disporre delle credenziali amministrative seguenti: è necessario essere membri del gruppo Administrators nel computer locale per configurare le impostazioni della cache BLOB.

  2. In Server Manager, fare clic su Strumenti, quindi fare clic su Gestione Internet Information Services (IIS).

  3. In Gestione Internet Information Services (IIS) nel riquadro Connessioni espandere il nome del server che contiene l'applicazione Web e quindi espandere Siti per visualizzare l'applicazione Web o le applicazioni create.

  4. Fare clic con il pulsante destro del mouse sul nome dell'applicazione Web per la quale si desidera configurare la cache basata su disco e quindi scegliere Esplora. Verrà visualizzata la schermata di Esplora risorse, con l'elenco delle directory relative all'applicazione Web selezionata.

  5. Nella finestra di dialogo Apri con fare clic su Blocco note e quindi su OK.

  6. Nel file web.config Blocco note individuare la riga seguente: <BlobCache location="C:\BlobCache\14" path="\.(gif|jpg|jpeg|jpe|jfif|bmp|dib|tif|tiff|themedbmp|themedcss|themedgif|themedjpg|themedpng|ico|png|wdp|hdp|css|js|asf|avi|flv|m4v|mov|mp3|mp4|mpeg|mpg|rm|rmvb|wma|wmv|ogg|ogv|oga|webm|xap)$" maxSize="10" enabled="false" />

    La dimensione massima predefinita per un'immagine quando si usano rendering immagine è di 40 mega pixel. Se vuoi modificare questo valore, dovrai aggiungere il parametro imageRenditionMaxSourcePixels. Ad esempio: <BlobCache location="C:\BlobCache\14" path="\.(gif|jpg|jpeg|jpe|jfif|bmp|dib|tif|tiff|themedbmp|themedcss|themedgif|themedjpg|themedpng|ico|png|wdp|hdp|css|js|asf|avi|flv|m4v|mov|mp3|mp4|mpeg|mpg|rm|rmvb|wma|wmv|ogg|ogv|oga|webm|xap)$" maxSize="10" imageRenditionMaxSourcePixels="100000000" enabled="true" /> In questo modo le dimensioni massime dell'immagine per rendering delle immagini verranno impostate a circa 100 mega pixel.

  7. In questa riga modificare l'attributo location per specificare una directory con spazio sufficiente per contenere le dimensioni della cache.

    Nota

    È consigliabile specificare una directory in un'unità diversa da quella in cui sono archiviati i file di scambio del sistema operativo del server o i file di log del server.

  8. Per aggiungere o rimuovere tipi di file dall'elenco dei tipi di file da memorizzare nella cache, per l'attributo path modificare l'espressione regolare in modo da includere o rimuovere l'estensione di file appropriata. Se si aggiungono estensioni di file, è necessario separare ogni estensione con una barra verticale (|), come illustrato in questa riga di codice.

  9. Per modificare le dimensioni della cache, digitare un nuovo numero per maxSize. Le dimensioni sono espresse in gigabyte (GB) e l'impostazione predefinita è 10 GB.

    Importante

    È consigliabile non impostare dimensioni della cache inferiori a 10 GB. Quando si impostano le dimensioni della cache, specificare un valore sufficientemente alto da fornire un buffer superiore almeno del 20% rispetto alle dimensioni previste del contenuto che verrà memorizzato nella cache.

  10. Per abilitare la cache BLOB, modificare l'attributo enabled da "false" a "true".

  11. Salvare il file del Blocco note e chiuderlo.

Attenzione

Quando si salva una modifica al file web.config, l'applicazione Web in Internet Information Services (IIS) 7.0 viene riciclata automaticamente. Il riciclo può causare una breve interruzione del servizio nei siti inclusi nell'applicazione Web ed è possibile che lo stato della sessione non sia più disponibile. Per informazioni sul riciclo di applicazioni Web in IIS 7.0, vedere Riciclo dei processi IIS.

Configurare le impostazioni dei profili della cache

Le impostazioni dei profili della cache possono essere configurate nell'interfaccia utente a livello di raccolta siti da un amministratore della raccolta, nonché a livello di applicazione Web da un amministratore del server Web front-end. È necessario abilitare la cache di output delle pagine a livello di raccolta siti per poter configurare i profili della cache di output delle pagine a livello di raccolta siti o di applicazione Web. Se i profili della cache di output delle pagine vengono abilitati a livello di applicazione Web, le impostazioni specificate nel file web.config verranno utilizzate per tutti i profili della cache di output delle pagine, sostituendo gli eventuali valori immessi tramite interfaccia utente a livello di raccolta siti.

Nota

Per utilizzare la cache di output delle pagine e le impostazioni dei profili di cache associati, è necessario eseguire la caratteristica Pubblicazione sul proprio sito.

Nota

Esiste un problema noto relativo alla web part Ricerca contenuto. L'impostazione SendContentBeforeQuery della web part non funziona correttamente nelle pagine in cui è utilizzata la memorizzazione nella cache di output. Questo problema viene risolto nell'aggiornamento cumulativo di SharePoint Server 2013 per marzo 2013. Per altre informazioni, vedere l'articolo della Microsoft Knowledge Base 2767999: Descrizione dell'aggiornamento di SharePoint Server 2013: 12 marzo 2013.

Per configurare le impostazioni dei profili della cache per un'applicazione Web, attenersi alla procedura seguente.

Importante

Prima di apportare modifiche al file web.config, crearne una copia con un altro nome, ad esempio web.config1. In questo modo, se si commette un errore nel file, sarà possibile ripristinare il file originale.

Per configurare le impostazioni dei profili della cache di output delle pagine

  1. Verificare di disporre delle credenziali amministrative seguenti: è necessario essere membri del gruppo Administrators nel computer locale per configurare le impostazioni dei profili della cache.

  2. In Server Manager, fare clic su Strumenti, quindi fare clic su Gestione Internet Information Services (IIS).

  3. In Gestione Internet Information Services (IIS) nel riquadro Connessioni espandere il nome del server che contiene l'applicazione Web e quindi espandere Siti per visualizzare l'applicazione Web o le applicazioni create.

  4. Fare clic con il pulsante destro del mouse sul nome dell'applicazione Web per la quale si desidera configurare la cache basata su disco e quindi scegliere Esplora. Verrà visualizzata la schermata di Esplora risorse, con l'elenco delle directory relative all'applicazione Web selezionata.

  5. Fare clic con il pulsante destro del mouse suweb.config, scegliere Apri e scegliere Blocco note se viene richiesto di trovare un programma da usare per aprire il file.

  6. Nel file web.config Blocco note individuare la riga seguente: <OutputCacheProfiles useCacheProfileOverrides="false" varyByHeader="" varyByParam="*" varyByCustom="" varyByRights="true" cacheForEditRights="false" />

  7. Per abilitare il profilo della cache a livello di applicazione Web, modificare l'attributo useCacheProfileOverrides da "false" a "true".

    Nota

    Se si imposta l'attributo su true, le impostazioni specificate nel file web.config verranno utilizzate per tutti i profili della cache di output delle pagine. In questo modo verranno sostituiti gli eventuali valori immessi tramite interfaccia utente a livello di raccolta siti.

  8. Per eseguire l'override dell'attributo varyByHeader , digitare un parametro personalizzato come specificato nella voce HttpCachePolicy.VaryByHeaders della libreria di classi .NET Framework.

  9. Per eseguire l'override dell'attributo varyByParam , digitare un parametro personalizzato come specificato nella voce HttpCachePolicy.VaryByParams della libreria di classi .NET Framework.

  10. Per eseguire l'override dell'attributo varyByCustom , digitare un parametro personalizzato come specificato nella voce HttpCachePolicy.SetVaryByCustom della libreria di classi .NET Framework.

  11. Per eseguire l'override dell'attributo varyByRights , modificare il valore da "true" a "false". In questo modo non sarà più necessario che gli utenti dispongano di autorizzazioni identiche valide per tutti gli oggetti a protezione diretta per visualizzare la stessa pagina memorizzata nella cache come qualsiasi altro utente.

  12. Per eseguire l'override dell'attributo cacheForEditRights , modificare l'attributo cacheForEditRights da "false" a "true". In questo modo verrà ignorato il comportamento normale in base al quale le pagine degli utenti con autorizzazioni di modifica vengono memorizzate nella cache.

  13. Salvare il file del Blocco note e chiuderlo.

Attenzione

Quando si salva una modifica al file web.config, l'applicazione Web in Internet Information Services (IIS) 7.0 viene riciclata automaticamente. Il riciclo può causare una breve interruzione del servizio nei siti inclusi nell'applicazione Web ed è possibile che lo stato della sessione non sia più disponibile. Per informazioni sul riciclo di applicazioni Web in IIS 7.0, vedere Avviare o arrestare il server Web (IIS 8).

Configurare le impostazioni della cache oggetti

Le impostazioni della cache oggetti possono essere configurate a livello di raccolta siti nell'interfaccia utente da un amministratore della raccolta siti e sono attivate per impostazione predefinita. Le dimensioni massime della cache possono essere configurate a livello di applicazione Web nel server Web front-end, in modo da applicare restrizioni alla quantità massima di memoria che sarà usata dalla cache per tutte le raccolte siti. Nelle singole raccolte siti è possibile ad esempio che la cache oggetti sia impostata su 100 MB, mentre per l'applicazione Web è possibile che sia impostata su 1 GB. In questo caso, non verrà utilizzato più di 1 GB di memoria da tutte le cache del server.

Nota

Per utilizzare la cache oggetti, è necessario eseguire la caratteristica Pubblicazione sul proprio sito.

Per configurare le impostazioni della cache oggetti per un'applicazione Web in un server Web front-end, attenersi alla procedura seguente.

Importante

Prima di apportare modifiche al file web.config, crearne una copia con un altro nome, ad esempio web.config1. In questo modo, se si commette un errore nel file, sarà possibile ripristinare il file originale.

Per configurare le impostazioni della cache oggetti

  1. Verificare di disporre delle credenziali amministrative seguenti: è necessario essere membri del gruppo Administrators nel computer locale per configurare le impostazioni della cache oggetti.

  2. In Server Manager, fare clic su Strumenti, quindi fare clic su Gestione Internet Information Services (IIS).

  3. In Gestione Internet Information Services (IIS) nel riquadro Connessioni espandere il nome del server che contiene l'applicazione Web e quindi espandere Siti per visualizzare l'applicazione Web o le applicazioni create.

  4. Fare clic con il pulsante destro del mouse sul nome dell'applicazione Web per la quale si desidera configurare la cache basata su disco e quindi scegliere Esplora. Verrà visualizzata la schermata di Esplora risorse, con l'elenco delle directory relative all'applicazione Web selezionata.

  5. Fare clic con il pulsante destro del mouse suweb.config, scegliere Apri e selezionare Blocco note se viene richiesto di trovare un programma da usare per aprire il file.

  6. Nel file Web.config Blocco note individuare la riga seguente: <ObjectCache maxSize="100" />

  7. Per modificare le dimensioni della cache, digitare un nuovo numero per maxSize. Le dimensioni sono espresse in megabyte (MB) e l'impostazione predefinita è 100 MB.

  8. Salvare il file del Blocco note e chiuderlo.

Attenzione

Quando si salva una modifica al file web.config, l'applicazione Web in Internet Information Services (IIS) 7.0 viene riciclata automaticamente. Il riciclo può causare una breve interruzione del servizio nei siti inclusi nell'applicazione Web ed è possibile che lo stato della sessione non sia più disponibile. Per informazioni sul riciclo di applicazioni Web in IIS 7.0, vedere Avviare o arrestare il server Web (IIS 8).

Vedere anche

Concetti

Cache settings operations in SharePoint Server

Pianificare la memorizzazione nella cache e le prestazioni in SharePoint Server