Partage via

Configurer les paramètres de cache pour une application web dans SharePoint Server

  • Article

S’APPLIQUE À :oui-img-132013 oui-img-162016 oui-img-192019 oui-img-seÉdition d’abonnement no-img-sopSharePoint dans Microsoft 365

Cet article explique comment configurer le cache BLOB sur disque, les profils de cache de sortie de page et le cache d’objets pour une application web dans SharePoint Server.

Vous activez et configurez le cache BLOB, et modifiez la configuration des profils de cache de sortie de pages et du cache d'objets dans le fichier web.config de l'application Web à laquelle vous souhaitez appliquer ces changements. Les modifications du fichier web.config seront appliquées à toutes les collections de sites au sein de l'application Web.

SharePoint Server inclut des moniteurs de performances du cache qui vous permettent de vérifier que les paramètres de cache de la batterie de serveurs sont corrects et que la mise en cache s’exécute à des performances maximales. Pour plus d’informations, voir Surveiller les performances du cache dans SharePoint Server 2016.

Notes

La configuration des profils de cache de sortie de pages et du cache d'objets au niveau de l'application Web va remplacer toute configuration mise en place par les administrateurs de site au niveau de la collection de sites ou à un niveau inférieur.

Conseil

Il se peut que le cache BLOB se désynchronise du contenu. Par exemple, après la restauration d'une base de données de contenu, le cache BLOB sera désynchronisé du contenu. Pour remédier à cette situation, vous devez vider le cache BLOB. Pour plus d’informations, voir Vider le cache BLOB dans SharePoint Server.

Pour plus d’informations, voir Opérations des paramètres de cache dans SharePoint Server.

Configurer les paramètres du cache BLOB

Par défaut, le cache BLOB disque est désactivé et vous devez l’activer sur le serveur Web frontal si vous voulez l’utiliser. Suivez la procédure suivante pour configurer les paramètres du cache disque pour une application Web.

Importante

Avant de modifier le fichier web.config, faites-en une copie sous un nom différent (par exemple, web.config1), pour pouvoir restaurer le fichier d'origine en cas d'erreur.

Pour configurer les paramètres du cache BLOB

  1. Vérifiez que vous disposez des informations d'identification d'administrateur suivantes : vous devez être membre du groupe Administrateurs sur l'ordinateur local pour configurer les paramètres du cache BLOB.

  2. Ouvrez Gestionnaire de serveur, cliquez sur Outils, puis sur Gestionnaire des services IIS.

  3. Dans le Gestionnaire des services Internet (IIS), dans le volet Connexions , développez le nom du serveur qui contient l’application web, puis développez Sites pour afficher l’application web ou les applications qui ont été créées.

  4. Cliquez avec le bouton droit sur le nom de l'application Web pour laquelle vous souhaitez configurer le cache disque, puis cliquez sur Explorer. L'Explorateur Windows s'ouvre et affiche la liste des répertoires pour l'application Web sélectionnée.

  5. Dans la boîte de dialogue Ouvrir avec , cliquez sur Bloc-notes, puis sur OK.

  6. Dans le fichier web.config Bloc-notes, recherchez la ligne suivante : <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" />

    Lorsque vous utilisez les rendus d'image, la taille maximale par défaut d'une image est de 40 mégapixels. Pour modifier cette valeur, ajoutez le paramètre imageRenditionMaxSourcePixels. Par exemple : <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" /> Cela définit la taille maximale de l’image pour que les rendus d’image fonctionnent à environ 100 méga pixels.

  7. Dans cette ligne, modifiez l’attribut location pour spécifier un répertoire qui dispose de suffisamment d’espace pour prendre en charge la taille du cache.

    Notes

    Nous vous recommandons vivement de spécifier un répertoire situé sur un lecteur différent de celui sur lequel les fichiers d'échange du système d'exploitation du serveur ou les fichiers journaux du serveur sont stockés.

  8. Pour ajouter ou supprimer des types de fichiers de la liste des types de fichiers à mettre en cache, pour l’attribut path , modifiez l’expression régulière pour inclure ou supprimer l’extension de fichier appropriée. Si vous ajoutez des extensions, veillez à séparer chaque type de fichier par une barre verticale (|), comme indiqué dans cette ligne de code.

  9. Pour modifier la taille du cache, modifiez la valeur de l'attribut maxSize. La taille est exprimée en gigaoctets (Go), et la valeur par défaut est 100 Go.

    Importante

    Il est recommandé de ne pas définir la taille du cache sur moins de 10 Go. Lorsque vous la définissez, veillez à indiquer un nombre suffisamment grand pour fournir un tampon d'au moins 20 pour cent de plus que la taille estimée du contenu qui sera stocké dans le cache.

  10. Pour activer le cache BLOB, remplacez l’attribut enabled par "true""false" .

  11. Enregistrez le fichier de Bloc-notes, puis fermez-le.

Attention

Lorsque vous enregistrez des modifications dans le fichier web.config, l'application web Internet Information Services (IIS) 7.0 est automatiquement recyclée. Ce recyclage peut entraîner une courte interruption de service des sites de l'application web, et les utilisateurs peuvent perdre l'état de leur session. Pour plus d'informations sur le recyclage des applications web IIS 7.0, voir l'article sur le recyclage de processus IIS.

Configurer les paramètres du profil de cache

Les paramètres du profil de cache peuvent être configurés dans l’interface utilisateur au niveau de la collection de sites par un administrateur de collection de sites, ainsi qu’au niveau de l’application Web par un administrateur sur le serveur Web frontal. Le cache de sortie de pages doit être activé au niveau de la collection de sites pour pouvoir configurer les profils de cache de sortie de pages au niveau de la collection de sites ou de l'application Web. Si les profils de cache de sortie de pages sont activés au niveau de l'application Web, les paramètres spécifiés dans web.config seront utilisés pour tous les profils de cache de sortie de pages et remplaceront les valeurs saisies via l'interface utilisateur au niveau de la collection de sites.

Notes

Pour utiliser le cache de sortie de pages et les paramètres de profil de cache associés, vous devez utiliser la fonctionnalité de publication de votre site.

Notes

Il existe un problème connu avec le composant WebPart de recherche de contenu. Le paramètre SendContentBeforeQuery du composant WebPart ne fonctionne pas correctement sur les pages qui utilisent le cache de sortie. Ce problème a été résolu dans la mise à jour cumulative de SharePoint Server 2013 de mars 2013. Pour plus d'informations, consultez l'article 2767999 de la Base de connaissances Microsoft : Description de la mise à jour de SharePoint Server 2013 : le 12 mars 2013.

Utilisez la procédure suivante pour configurer les paramètres du profil de cache pour une application Web.

Importante

Avant de modifier le fichier web.config, faites-en une copie sous un nom différent (par exemple, web.config1), pour pouvoir restaurer le fichier d'origine en cas d'erreur.

Pour configurer les paramètres de profil du cache de sortie de page

  1. Vérifiez que vous disposez des informations d'identification d'administrateur suivantes : vous devez être membre du groupe Administrateurs sur l'ordinateur local pour configurer les paramètres du profil de cache.

  2. Ouvrez Gestionnaire de serveur, cliquez sur Outils, puis sur Gestionnaire des services IIS.

  3. Dans le Gestionnaire des services Internet (IIS), dans le volet Connexions , développez le nom du serveur qui contient l’application web, puis développez Sites pour afficher l’application web ou les applications qui ont été créées.

  4. Cliquez avec le bouton droit sur le nom de l'application Web pour laquelle vous souhaitez configurer le cache disque, puis cliquez sur Explorer. L'Explorateur Windows s'ouvre et affiche la liste des répertoires pour l'application Web sélectionnée.

  5. Cliquez avec le bouton droit surweb.config, cliquez sur Ouvrir et choisissez Bloc-notes si vous êtes invité à trouver un programme à utiliser pour ouvrir ce fichier.

  6. Dans le fichier web.config Bloc-notes, recherchez la ligne suivante : <OutputCacheProfiles useCacheProfileOverrides="false" varyByHeader="" varyByParam="*" varyByCustom="" varyByRights="true" cacheForEditRights="false" />

  7. Pour activer le profil de cache au niveau de l’application web, remplacez l’attribut useCacheProfileOverrides par "false""true".

    Notes

    Si vous définissez cette valeur sur true, les paramètres spécifiés dans web.config seront utilisés pour tous les profils de cache de sortie de pages. Ils remplaceront les valeurs entrées via l'interface utilisateur au niveau de la collection de sites.

  8. Pour remplacer l’attribut varyByHeader , tapez un paramètre personnalisé tel que spécifié dans l’entrée HttpCachePolicy.VaryByHeaders Property de la bibliothèque de classes .NET Framework.

  9. Pour remplacer l’attribut varyByParam , tapez un paramètre personnalisé tel que spécifié dans l’entrée HttpCachePolicy.VaryByParams Property de la bibliothèque de classes .NET Framework.

  10. Pour remplacer l’attribut varyByCustom , tapez un paramètre personnalisé tel que spécifié dans la méthode HttpCachePolicy.SetVaryByCustom de la bibliothèque de classes .NET Framework.

  11. Pour remplacer l’attribut varyByRights , remplacez la valeur par "true""false". Cela supprimera l'obligation pour les utilisateurs de disposer d'autorisations effectives identiques sur tous les objets sécurisables pour afficher la même page mise en cache que les autres utilisateurs.

  12. Pour remplacer l’attribut cacheForEditRights , remplacez l’attribut cacheForEditRights par "false""true". Cette modification contournera la façon habituelle dont les personnes disposant d'autorisations de modification mettent leurs pages en cache.

  13. Enregistrez le fichier de Bloc-notes, puis fermez-le.

Attention

Lorsque vous enregistrez des modifications dans le fichier web.config, l'application web Internet Information Services (IIS) 7.0 est automatiquement recyclée. Ce recyclage peut entraîner une courte interruption de service des sites de l'application web, et les utilisateurs peuvent perdre l'état de leur session. Pour plus d’informations sur le recyclage des applications web dans IIS 7.0, consultez Démarrer ou arrêter le serveur web (IIS 8).

Configurer les paramètres du cache d’objets

Les paramètres du cache d’objets peuvent être configurés au niveau de la collection de sites dans l’interface utilisateur par un administrateur de collection de sites, et sont activés par défaut. La taille maximale du cache peut être configurée au niveau de l'application Web sur le serveur Web frontal pour placer une limitation sur la quantité maximale de mémoire utilisée par le cache pour toutes les collections de sites. Par exemple, pour les collections de sites individuelles, le cache d'objets peut être défini sur 100 Mo, tandis que l'application Web peut être définie sur 1 Go. Dans ce cas, au maximum 1 Go de mémoire sera utilisé par tous les caches sur le serveur.

Notes

Pour utiliser le cache d'objets, vous devez utiliser la fonctionnalité de publication sur votre site.

Utilisez la procédure suivante pour configurer les paramètres du cache d'objets pour une application Web sur un serveur Web frontal.

Importante

Avant de modifier le fichier web.config, faites-en une copie sous un nom différent (par exemple, web.config1), pour pouvoir restaurer le fichier d'origine en cas d'erreur.

Pour configurer les paramètres du cache d’objets

  1. Vérifiez que vous disposez des informations d'identification d'administrateur suivantes : vous devez être membre du groupe Administrateurs sur l'ordinateur local pour configurer les paramètres du cache d'objets.

  2. Ouvrez Gestionnaire de serveur, cliquez sur Outils, puis sur Gestionnaire des services IIS.

  3. Dans le Gestionnaire des services Internet (IIS), dans le volet Connexions , développez le nom du serveur qui contient l’application web, puis développez Sites pour afficher l’application web ou les applications qui ont été créées.

  4. Cliquez avec le bouton droit sur le nom de l'application Web pour laquelle vous souhaitez configurer le cache disque, puis cliquez sur Explorer. L'Explorateur Windows s'ouvre et affiche la liste des répertoires pour l'application Web sélectionnée.

  5. Cliquez avec le bouton droit surweb.config, cliquez sur Ouvrir et sélectionnez Bloc-notes si vous êtes invité à trouver un programme à utiliser pour ouvrir ce fichier.

  6. Dans le fichier Web.config Bloc-notes, recherchez la ligne suivante : <ObjectCache maxSize="100" />

  7. Pour modifier la taille du cache, modifiez la valeur de l'attribut maxSize. La taille est exprimée en mégaoctets (Mo), et la valeur par défaut est 100 Mo.

  8. Enregistrez le fichier de Bloc-notes, puis fermez-le.

Attention

Lorsque vous enregistrez des modifications dans le fichier web.config, l'application web Internet Information Services (IIS) 7.0 est automatiquement recyclée. Ce recyclage peut entraîner une courte interruption de service des sites de l'application web, et les utilisateurs peuvent perdre l'état de leur session. Pour plus d’informations sur le recyclage des applications web dans IIS 7.0, consultez Démarrer ou arrêter le serveur web (IIS 8).

Voir aussi

Concepts

Cache settings operations in SharePoint Server

Planifier la mise en cache et les performances dans SharePoint Server