Comment : modifier les paramètres du cache pour un serveur de couche Application
Mise à jour : novembre 2007
En tant qu'administrateur de Team Foundation, vous pouvez modifier les paramètres du cache du fichier de contrôle de code source sur le serveur de couche Application de Team Foundation à tout moment après l'installation. Par défaut, ce cache est activé sur le serveur de couche Application. Il améliore les performances en permettant de télécharger les fichiers à partir du cache plutôt que directement à partir de la base de données.
.gif "Remarque") Remarque : |
|---|
Vous pouvez également activer le cache sur Team Foundation Server Proxy, si vous avez choisi de l'installer. Pour plus d'informations, consultez Gestion des connexions à distance avec Team Foundation Server Proxy. |
Vous pouvez également modifier les paramètres de plusieurs manières :
spécifier un dossier racine différent pour le cache ;
modifier la limite à laquelle les anciens fichiers sont supprimés du cache ;
modifier la quantité de cache à libérer lorsque les fichiers anciens sont supprimés ;
modifier l'intervalle d'enregistrement des informations relatives aux performances du cache sur un fichier.
Vous pouvez effectuer ces tâches en modifiant le fichier Web.config pour le contrôle de version, qui se trouve dans le répertoire d'installation de couche Application.
| Remarque : |
|---|
Par défaut, le répertoire d'installation de couche Application est Lecteur:\%Program Files%\Microsoft Visual Studio 2008 Team Foundation Server\Web Services\VersionControl. |
Pour plus d'informations, consultez les rubriques suivantes :
Comment : modifier les paramètres de configuration des composants Team Foundation Server
Paramètres du fichier Web.Config de contrôle de version dans les composants Team Foundation Server
Autorisations requises
Pour exécuter ces procédures, vous devez être membre du groupe de sécurité Administrateurs sur le serveur de couche Application de Team Foundation.
Outre ces autorisations, il vous faudra peut-être répondre aux exigences suivantes sur un ordinateur exécutant Windows Server 2008 ou Windows Vista :
Pour suivre une procédure de ligne de commande, vous devrez peut-être ouvrir une invite de commandes avec les autorisations élevées. Pour ce faire, cliquez sur Démarrer, cliquez avec le bouton droit sur Invite de commandes, puis cliquez sur Exécuter en tant qu'administrateur.
Pour suivre une procédure qui requiert Internet Explorer, vous devrez peut-être démarrer l'application en tant qu'administrateur. Pour ce faire, cliquez sur Démarrer, puis sur Tous les programmes, cliquez avec le bouton droit sur Internet Explorer et cliquez sur Exécuter en tant qu'administrateur.
Pour modifier des fichiers web.config, vous devrez peut-être démarrer l'éditeur de texte en tant qu'administrateur. Pour ce faire, cliquez sur Démarrer, puis sur Tous les programmes, cliquez avec le bouton droit sur l'éditeur et cliquez sur Exécuter en tant qu'administrateur.
Pour accéder au Gestionnaire de rapports, à des rapports ou à des sites Web pour SQL Server Reporting Services, vous devrez peut-être ajouter ces sites à la liste des sites de confiance dans Internet Explorer ou démarrer Internet Explorer en tant qu'administrateur.
Pour plus d'informations, consultez le site Web Microsoft (page pouvant être en anglais).
Pour spécifier un dossier racine différent pour le cache
Sur le serveur de couche Application, créez un dossier de cache.
Vous pouvez créer le dossier aux emplacements suivants : disque local, chemin UNC ou lecteur monté.
.gif "Note de sécurité")
Note de sécurité :Le dossier du cache stocke les informations sensibles non chiffrées. Par conséquent, assurez-vous que seul le compte de service de la couche Application dispose des autorisations de lecture et d'écriture sur le dossier du cache.
Cliquez avec le bouton droit sur le dossier, puis cliquez sur Propriétés.
La boîte de dialogue des propriétés du dossier s'ouvre.
Cliquez sur l'onglet Sécurité, puis sur Add.
Ajoutez le groupe local TFS_APPTIER_SERVICE_WPG et cliquez sur OK.
Activez les cases à cocher Read et Write et désactivez toutes les autres, puis cliquez sur OK.
Ouvrez l'Explorateur Windows et accédez à Lecteur:\%Program Files%\Microsoft Visual Studio 2008 Team Foundation Server\Web Services\VersionControl.
Ouvrez le fichier Web.config dans un éditeur de texte ou XML et accédez à la section <appSettings>.
Recherchez l'élément <add key="fileCacheRoot">.
Remplacez l'emplacement du dossier racine du cache actuel par le nouvel emplacement comme illustré dans l'exemple suivant :
<add key="fileCacheRoot" value="NewCacheRootFolderLocation" />Enregistrez et fermez le fichier Web.config.
Remarque :Pour augmenter les performances, copiez les fichiers de l'ancien dossier du cache dans le nouveau.
Ouvrez une fenêtre d'invite de commandes, tapez iisreset, puis appuyez sur Entrée.
Supprimez l'ancien dossier racine du cache.
Remarque :Par défaut, le dossier racine du cache se trouve à l'emplacement …\Program Files\Microsoft Visual Studio 2008 Team Foundation Server\Web Services\VersionControl\Data.
Modification des limites du cache pour la suppression de fichiers
Une limite maximale est définie pour la quantité d'espace de stockage que la couche Application peut utiliser pour la mise en cache des fichiers. Lorsque cette limite est atteinte, les anciens fichiers du cache sont supprimés afin de libérer de l'espace de stockage utilisé pour mettre en cache de nouveaux fichiers demandés. Le nettoyage supprime les fichiers en fonction de la date de leur dernière consultation. Les fichiers qui n'ont pas été consultés depuis longtemps sont supprimés en premier.
Pour modifier la limite à laquelle les anciens fichiers sont supprimés du cache
Sur le serveur de couche Application, ouvrez l'Explorateur Windows, puis accédez à Lecteur:\%Program Files%\Microsoft Visual Studio 2008 Team Foundation Server\Web Services\VersionControl.
Ouvrez le fichier Web.config dans un éditeur de texte ou XML.
Dans le fichier Web.config, recherchez l'élément <appSettings>.
Sélectionnez l'une des options suivantes :
Pour spécifier un pourcentage d'espace disque disponible à remplir avant de supprimer les anciens fichiers du cache, recherchez et mettez à jour l'élément <add key="CacheLimitPercent">.
Par exemple, la ligne suivante spécifie que le cache doit remplir jusqu'à 60 % de la capacité de l'espace disque disponible avant de supprimer les anciens fichiers :
<add key="CacheLimitPercent" value="60" />Pour spécifier une taille fixe en Mo à atteindre avant de supprimer les anciens fichiers, recherchez et mettez à jour l'élément <add key="CacheLimit">.
Par exemple, la ligne suivante spécifie que le cache doit atteindre 500 Mo avant la suppression des anciens fichiers :
<add key="CacheLimit" value="500" />Remarque :Les éléments "CacheLimitPercent" et "CacheLimit" ne peuvent pas être appliqués en même temps. Pour désactiver l'un des deux éléments, omettez sa valeur.
Enregistrez et fermez le fichier Web.config.
Ouvrez une fenêtre d'invite de commandes, tapez iisreset, puis appuyez sur Entrée.
Pour modifier la quantité de cache à libérer lors de la suppression des anciens fichiers
Sur le serveur de couche Application, ouvrez l'Explorateur Windows, puis accédez à Lecteur:\%Program Files%\Microsoft Visual Studio 2008 Team Foundation Server\Web Services\VersionControl.
Ouvrez le fichier Web.config dans un éditeur de texte ou XML.
Recherchez l'élément <add key="CacheDeletionPercent">.
Mettez à jour l'élément <add key="CacheDeletionPercent"> en modifiant le pourcentage d'espace de cache à libérer lors de la suppression des anciens fichiers.
Par exemple, la ligne suivante spécifie qu'il faut libérer 50 % du cache lors de la suppression des anciens fichiers :
<add key="CacheDeletionPercent" value="50" />Enregistrez et fermez le fichier Web.config.
Ouvrez une fenêtre d'invite de commandes, tapez iisreset, puis appuyez sur Entrée.
Modification de l'intervalle d'enregistrement des statistiques de performance du cache
Vous pouvez modifier l'intervalle d'enregistrement des statistiques de performance du cache sur un fichier XML nommé ProxyStatistics.xml. Ces statistiques sont suivies par les compteurs de performance installés par défaut. Le fichier ProxyStatistics.xml se trouve dans le dossier App_Data du répertoire d'installation de couche Application.
Vous pouvez consulter ces statistiques de performance à partir de l'analyseur de performances ou à l'aide du service Web ProxyStatistics. Pour plus d'informations, consultez Comment : examiner les performances du cache à l'aide du service Web ProxyStatistics.
Pour modifier l'intervalle d'enregistrement des statistiques de performance sur un fichier
Sur le serveur de couche Application, ouvrez l'Explorateur Windows, puis accédez à Lecteur:\%Program Files%\Microsoft Visual Studio 2008 Team Foundation Server\Web Services\VersionControl.
Ouvrez le fichier Web.config dans un éditeur de texte ou XML.
Dans le fichier Web.config, recherchez l'élément <appSettings>.
Recherchez l'élément <add key="StatisticsPersistTime">.
Mettez à jour l'élément <add key="StatisticsPersistTime"> en modifiant le nombre d'heures pour chaque intervalle.
Remarque :L'intervalle minimal par défaut est égal à 1 heure. L'intervalle maximal est 24 heures.
Par exemple, la ligne suivante indique que l'intervalle d'enregistrement des statistiques d'un fichier doit être de 2 heures :
<add key="StatisticsPersistTime" value="2" />Enregistrez et fermez le fichier Web.config.
Ouvrez une fenêtre d'invite de commandes, tapez iisreset, puis appuyez sur Entrée.
Voir aussi
Concepts
Gestion des serveurs de couche Application pour Team Foundation