Comment : modifier les paramètres du cache pour Team Foundation Server Proxy

  • Article

Mise à jour : novembre 2007

En tant qu'administrateur Team Foundation Server, vous pouvez modifier les paramètres du cache de fichiers de contrôle de version lorsque vous configurez Team Foundation Server Proxy après l'installation ou à tout autre moment.

Remarque :

Une fois que vous avez installé Team Foundation Server Proxy, vous devez le configurer pour qu'il active et gère le cache. Pour plus d'informations, consultez Comment : activer la mise en cache du contrôle de version pour Team Foundation Server Proxy.

Vous pouvez modifier les paramètres du cache de l'une des manières suivantes :

  • Spécifiez un dossier racine de cache différent.

  • Modifiez la limite de cache à laquelle les anciens fichiers sont supprimés du cache.

  • Modifiez la quantité d'espace à libérer lorsque les anciens fichiers sont supprimés.

  • Modifiez l'intervalle d'enregistrement des informations de performance du cache dans un fichier.

Vous pouvez effectuer ces étapes en modifiant le fichier Proxy.config sur le serveur proxy. Le fichier Proxy.config se trouve dans le répertoire d'installation du proxy. Pour plus d'informations, consultez Paramètres du fichier Web.Config de Team Foundation Server Proxy.

Remarque :

Le répertoire d'installation par défaut du proxy est Lecteur:\Program Files\Microsoft Visual Studio 2008 Team Foundation Server\Web Services\VersionControlProxy.

Une fois que vous avez effectuez une ou plusieurs de ces tâches, vous devez recycler le pool d'applications en utilisant la commande IISRESET pour récupérer la version la plus récente du fichier Proxy.config.

Autorisations requises

Pour effectuer cette procédure, vous devez être membre du groupe de sécurité Administrateurs sur l'ordinateur Team Foundation Server Proxy.

Outre ces autorisations, sur les ordinateurs qui exécutent Windows Server 2008 ou Windows Vista :

  • Pour suivre une procédure de ligne de commande, il peut s'avérer nécessaire d'ouvrir une invite de commandes avec les autorisations élevées. Cliquez sur Démarrer, cliquez avec le bouton droit sur Invite de commandes, puis cliquez sur Exécuter en tant qu'administrateur.

  • Pour modifier des fichiers web.config, il peut s'avérer nécessaire d'ouvrir un éditeur de texte en tant qu'administrateur. Cliquez sur Démarrer, puis sur Tous les Programmes, cliquez avec le bouton droit sur l'éditeur, puis cliquez sur Exécuter en tant qu'administrateur.

Pour plus d'informations, consultez le site Web Microsoft (page pouvant être en anglais).

Pour spécifier un dossier racine de cache différent

  1. Sur l'ordinateur Team Foundation Server Proxy, créez un dossier de cache.

    Vous pouvez créer le dossier de cache dans les emplacements suivants : sur un disque local, dans le chemin d'accès UNC ou sur un lecteur monté. Assurez-vous que ce dossier dispose d'un espace suffisant, car il peut contenir les fichiers de tous les serveurs Team Foundation que le proxy représente.

    Note de sécurité :

    Le dossier de cache stocke des informations sensibles qui ne sont pas chiffrées. Par conséquent, vérifiez que seul le compte de service Team Foundation Server Proxy dispose des autorisations Lire et Écrire pour le dossier de cache. Pour plus d'informations, consultez Comment : configurer la sécurité du cache pour Team Foundation Server Proxy.

  2. Ouvrez l'Explorateur Windows et localisez le répertoire d'installation du proxy.

  3. Ouvrez le fichier Proxy.config dans un éditeur de texte ou XML.

  4. Recherchez l'élément <CacheRoot>.

  5. Mettez à jour l'élément <CacheRoot> en remplaçant l'emplacement du dossier racine du cache actuel par le nouvel emplacement comme suit :

    <CacheRoot>NewCacheRootFolderLocation</CacheRoot>

  6. Enregistrez et fermez le fichier Proxy.config.

    Remarque :

    Pour optimiser les performances, copiez les fichiers de l'ancien dossier de cache vers le nouveau dossier de cache.

  7. Ouvrez une fenêtre d'invite de commandes, tapez iisreset, puis appuyez sur Entrée.

  8. Supprimez l'ancien dossier racine de cache.

    Le dossier racine de cache par défaut est situé dans ...\Program Files\Microsoft Visual Studio 2008 Team Foundation Server\Web Services\VersionControlProxy\Data.

Modification des limites du cache pour la suppression d'anciens fichiers

Pour modifier la limite à laquelle les anciens fichiers sont supprimés du cache.

  1. Sur l'ordinateur Team Foundation Server Proxy, ouvrez l'Explorateur Windows et localisez le répertoire d'installation du proxy.

  2. Ouvrez le fichier Proxy.config dans un éditeur de texte ou XML.

  3. Recherchez l'élément <CacheLimitPolicy>.

  4. Choisissez l'une des options suivantes :

    • Pour spécifier un pourcentage d'espace disque disponible à remplir avant la suppression d'anciens fichiers du cache, mettez à jour l'élément <PercentageBasedPolicy>.

      Par exemple, la ligne suivante spécifie que le cache doit atteindre 60 % de la capacité d'espace disque disponible avant de supprimer d'anciens fichiers :

      <PercentageBasedPolicy>60</PercentageBasedPolicy>

    • Pour spécifier une taille fixe en Mo que le cache doit atteindre avant de supprimer d'anciens fichiers, ajoutez ou mettez à jour l'élément <FixedSizeBasedPolicy>.

      Par exemple, la ligne suivante spécifie que le cache doit atteindre 500 Mo avant de supprimer d'anciens fichiers.

      <FixedSizeBasedPolicy>500</FixedSizeBasedPolicy>
    Remarque :

    Les éléments <PercentageBasedPolicy> et <FixedSizeBasedPolicy> ne peuvent pas être appliqués en même temps.

  5. Enregistrez et fermez le fichier Proxy.config.

  6. 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 d'anciens fichiers

  1. Sur l'ordinateur Team Foundation Server Proxy, ouvrez l'Explorateur Windows et localisez le répertoire d'installation du proxy.

  2. Ouvrez le fichier Proxy.config dans un éditeur de texte ou XML.

  3. Recherchez l'élément <CacheDeletionPercent>.

  4. Mettez à jour l'élément <CacheDeletionPercent> en modifiant le pourcentage d'espace de cache à libérer lors de la suppression d'anciens fichiers.

    Par exemple, la ligne suivante spécifie qu'il faut libérer 50 % du cache lors de la suppression d'anciens fichiers.

    <CacheDeletionPercent>50</CacheDeletionPercent>

  5. Enregistrez et fermez le fichier Proxy.config.

  6. 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 dans un fichier XML nommé ProxyStatistics.xml. Ces statistiques font l'objet d'un suivi à l'aide des compteurs de performance installés par défaut. Le fichier ProxyStatistics.xml se trouve dans le dossier App_Data dans le répertoire d'installation du proxy.

Vous pouvez afficher ces statistiques de performance dans l'outil d'analyse des performances ou à l'aide du service Web ProxyStatistics. Pour plus d'informations, consultez Comment : examiner les performances du cache à l'aide de l'analyseur de performances.

Pour modifier l'intervalle d'enregistrement des statistiques de performance dans un fichier

  1. Sur l'ordinateur Team Foundation Server Proxy, ouvrez l'Explorateur Windows et localisez le répertoire d'installation du proxy.

  2. Ouvrez le fichier Proxy.config dans un éditeur de texte ou XML.

  3. Recherchez l'élément <StatisticsPersistTime>.

  4. Mettez à jour l'élément <StatisticsPersistTime> en modifiant le nombre d'heures pour chaque intervalle.

    Remarque :

    L'intervalle par défaut et minimal est 1 heure. L'intervalle maximal est 24 heures.

    Par exemple, la ligne suivante spécifie que 2 heures doivent s'écouler entre les enregistrements des statistiques dans un fichier :

    <StatisticsPersistTime>2</StatisticsPersistTime>

  5. Enregistrez et fermez le fichier Proxy.config.

  6. Ouvrez une fenêtre d'invite de commandes, tapez iisreset, puis appuyez sur Entrée.

Voir aussi

Tâches

Comment : configurer la sécurité du cache pour Team Foundation Server Proxy

Concepts

Gestion des connexions à distance avec Team Foundation Server Proxy