Arborescence des dossiers du référentiel de symboles

Le magasin de symboles qui sauvegarde les requêtes SMB et HTTP est une arborescence de dossiers résidant sur un disque local.

Pour simplifier l’administration, le nom du sous-dossier (par exemple, les symboles) peut également être utilisé comme nom de partage de fichiers et également le nom du répertoire virtuel. Si un nouveau magasin de symboles devait être ajouté, un nouveau sous-dossier serait effectué sous D :\SymStore, et un nouveau partage de fichiers et répertoire virtuel de ce nom serait effectué pour exposer le magasin aux clients.

L’emplacement de l’arborescence de dossiers doit être choisi avec soin et le système de fichiers du disque. Le magasin de symboles peut être extrêmement volumineux (téraoctets) lors de la mise en cache des fichiers à partir de serveurs de build (internes) et d’Internet. L’arborescence des dossiers doit résider sur un disque capable d’un nombre élevé de lectures et d’un faible nombre d’écritures. Le système de fichiers peut affecter les performances : ReFS peut fonctionner mieux que NTFS et doit être examiné pour les déploiements volumineux. De même, la mise en réseau vers le serveur doit être suffisamment rapide pour gérer la charge des clients, ainsi que la charge dans les magasins de symboles en amont pour récupérer les symboles pour la population du cache.

Structure Single-Tier ou Two-Tier du Magasin de symboles

Normalement, les fichiers sont placés dans une structure de répertoire de niveau unique dans laquelle un sous-répertoire unique existe pour chaque nom de fichier mis en cache. Sous chaque dossier de nom de fichier, des dossiers supplémentaires sont créés pour stocker chaque version du fichier. L’arborescence aura cette structure :

D:\SymStore\Symbols\ntdll.dll\...\
D:\SymStore\Symbols\ntdll.pdb\...\
D:\SymStore\Symbols\kernel32.dll\...\
D:\SymStore\Symbols\kernel32.pdb\...\

Si un grand nombre de fichiers doivent être stockés, une structure à deux niveaux peut être utilisée à la racine du magasin de symboles. Les 2 premières lettres du nom de fichier sont utilisées comme nom de dossier intermédiaire.

Pour utiliser une structure à deux niveaux, placez un fichier appelé index2.txt à la racine de D :\SymStore\Symbols. Le contenu du fichier n’est pas important. Quand ce fichier existe, symsrv.dll crée et consomme des fichiers à partir de l’arborescence à deux niveaux à l’aide de cette structure :

D:\SymStore\Symbols\nt\ntdll.dll\...\
D:\SymStore\Symbols\nt\ntdll.pdb\...\
D:\SymStore\Symbols\ke\kernel32.dll\...\
D:\SymStore\Symbols\ke\kernel32.pdb\...\

Si vous souhaitez convertir la structure après le remplissage du magasin de symboles, utilisez l’application convertstore.exe dans le dossier du débogueur. Pour permettre à l’outil de fonctionner, créez un dossier appelé 000Admin dans le dossier racine. Ce dossier est requis par convertstore.exe afin qu’il puisse contrôler le verrouillage du magasin de symboles.

Voir aussi

Magasins de symboles HTTP

Serveur de symboles pour débogueur du partage de fichiers (SMB)