Árvore de Pastas do Repositório de Símbolos

O repositório de símbolos que dá suporte a solicitações SMB e HTTP é uma árvore de pastas que reside em um disco local.

Para manter a administração simples, o nome da subpasta (por exemplo, Símbolos) também pode ser usado como o nome do Compartilhamento de Arquivos e também o nome do Diretório Virtual. Se um novo repositório de símbolos fosse adicionado, uma nova subpasta seria feita em D:\SymStore e um novo Compartilhamento de Arquivos e Diretório Virtual desse nome seriam feitos para expor o repositório aos clientes.

O local da árvore de pastas deve ser escolhido com cuidado, bem como o sistema de arquivos do disco. O repositório de símbolos pode obter terabytes (extremamente grandes) ao armazenar arquivos em cache de servidores de build (internos) e da Internet. A árvore de pastas deve residir em um disco capaz de um alto número de leituras e baixo número de gravações. O sistema de arquivos pode afetar o desempenho – o ReFS pode ter um desempenho melhor do que o NTFS e deve ser investigado para implantações grandes. Da mesma forma, a rede para o servidor deve ser de velocidade suficiente para lidar com a carga dos clientes e também a carga para o upstream repositórios de símbolos para recuperar os símbolos para a população de cache.

Estrutura de Single-Tier ou Two-Tier do Repositório de Símbolos

Normalmente, os arquivos são colocados em uma estrutura de diretório de camada única na qual existe um único subdiretório para cada nome de arquivo armazenado em cache. Em cada pasta de nome de arquivo, pastas adicionais são feitas para armazenar cada versão do arquivo. A árvore terá esta estrutura:

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

Se um grande número de arquivos deve ser armazenado, uma estrutura de duas camadas pode ser usada na raiz do repositório de símbolos. As duas primeiras letras do nome do arquivo são usadas como um nome de pasta intermediário.

Para usar uma estrutura de duas camadas, coloque um arquivo chamado index2.txt na raiz de D:\SymStore\Symbols. O conteúdo do arquivo não tem importância. Quando esse arquivo existir, symsrv.dll criará e consumirá arquivos da árvore de duas camadas usando esta estrutura:

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

Se você quiser converter a estrutura depois que o repositório de símbolos for preenchido, use o aplicativo convertstore.exe na pasta do depurador. Para permitir que a ferramenta funcione, crie uma pasta chamada 000Admin na pasta raiz. Essa pasta é exigida por convertstore.exe para que possa controlar o bloqueio do repositório de símbolos.

Confira também

Repositórios de símbolos HTTP

Servidor de Símbolos do Depurador de Compartilhamento de Arquivos (SMB)