Debugging Tools for Windows

Dealing with Unavailable Symbol Stores

If one of the symbol stores that SymSrv is configured to obtain files from is down or otherwise unavailable, the result can be long waits from the client for every file request. When SymSrv is called from SymProxy, you can avoid most of these waits by setting up SymSrv to stop trying to access the store in question. When this feature is engaged, SymSrv stops trying to use the store for a set period of time after it experiences a specified number of timeouts from the same store during a set interval. The values of these variables can be controlled either by an .ini file or from the registry.

To control symbol store access using a .ini file
  1. 1.In %WINDIR%\system32\inetsrv\Symsrv.ini, create a section called timeouts.
  2. 2.Add the values trigger, count, and blackout to this section.

Trigger indicates the amount of time in minutes to watch for timeouts. Count indicates the number of timeouts to look for during the trigger period. Blackout indicates the length of time in minutes to disable the store after the threshhold is reached.

For example, we recommend the following settings:

[timeouts]
trigger=10
count=5
blackout=15

In this example, the store access is turned off if five timeouts are experienced in a 10-minute period. At the completion of a 15-minute blackout, the store is reactivated.

To control symbol store access using the registry
  1. 1.Create a key named

    HKLM\ Software\Microsoft\Symbol Server\Timeouts

  2. 2.Add three REG_DWORD values trigger, count, and blackout to this key. Set these values as you would in the .ini file.

Whether using the registry or an .ini file, if any of the trigger, count, or blackout values are set to 0 or if any of the keys or values do not exist, this functionality is disabled.

This feature of SymSrv is currently available only when running as a service. This means that the only practical application of this feature is when it is called from SymProxy.

Build machine: CAPEBUILD