Using Artifactory as Your Symbol Server
Configuring your system to use Artifactory as your Symbol Server requires the following main steps:
- Configure your debugger
- Configure your build
- Configure repositories in Artifactory
- Install the Artifactory Symbol Server Plugin
- Configure IIS
- Configure Visual Studio
Configuring Your Debugger
To enable you to step into and debug your source files, your debugger needs the corresponding
.pdb files and searches for them in the following order until they are found:
- The directory from which your binary was loaded
- The hard-coded build directory specified in the Debug Directories entry of your portable executable (PE) file
- Your Symbol Server cache directory (assuming you have a Symbol Server set up)
- The Symbol Server itself
So to fully support this search order, you need to specify the Symbol Server URL in your debugger.
Under Tools | Options | Debugging | Symbols enter
Configuring Your Build
You need to configure your build machine to publish your
.pdb files into a known directory which is later used in your IIS configuration.
Assuming you are using TFS, and want to publish your
Builds/symbols, your build definition would look something like the below:
Configure Repositories in Artifactory
Create the following repositories:
A Remote repository.
Set the repository URL to point to the virtual directory configured in your IIS below. (For the example on this page we will use
A Remote repository.
Set the repository URL to point to the Microsoft Symbol Server URL:
A virtual repository.
Configure this repository to aggregates the other two repositories, resolving from microsoft-symbols-IIS first. Once configured, this repository will aggregate all the NuGet packages with symbol (.pdb) files.
Install the Artifactory Symbol Server Plugin
The Artifactory Symbol Server Plugin listens for requests for symbol files and then redirects them to the Microsoft Symbol Server.
Download the Artifactory Symbol Server Plugin from GitHub and install it in your
To ensure that the plugin is loaded, check that your
If you do modify this system property, you need to restart Artifactory for this modification to take effect.
To configure your Internet Information Services (IIS) machine, you need to
- Add a virtual directory on which your
- Define a MIME type to be associated with
- Enable directory browsing.
To add a virtual directory on your IIS, execute the following steps:
- Under Control Panel | System and Security | Administrative Tools | Internet Information Service(IIS) Manager, right click Default Website and select Add Virtual Directory.
- Set Physical path to
To define a MIME type so that your IIS associates the
.pdb file extension with Symbol files, execute the following steps:
- Right click the MIME Type symbol and select Open Feature.
Click Add… on the right side of the window fill in the fields as follows:
Field Value File name extension .pdb MIME type
Configuring Visual Studio
Before you configure Visual Studio, you need to remove the symbol cache located under
Once you have removed the symbol cache, you need to change the location of the symbol (
.pdb) file. Under Tools | Options | Debugging | Symbols add a new symbol server pointing to the symbols virtual directory you defined in Artifactory above.
This should be
Note that there is no way to set the path directly to Artifactory since the symbol server cannot take a URL as a path.