XADM: How to Load Exchange Symbols for Dr. Watson

ID: Q150564


The information in this article applies to:
  • Microsoft Exchange Server, versions 4.0, 5.0, 5.5


SUMMARY

Debug Symbol files (symbols) are required for both kernel and user-mode debugging in Windows NT. Symbols provide a way to reference global variables and function names in the loaded executable.

Symbols are produced by the linker. They are removed from the retail product and saved in a separate (.dbg) file. This considerably reduces file size, decreasing file load time and increasing system performance. Symbols represent Function/API names and global variables.

Load the Microsoft Exchange Symbols on the Microsoft Exchange Server computer to help in debugging Dr. Watson event logs on the Exchange Server computer. After you load the symbols, Dr. Watson logs contain references to the global variables and function names which aid you in troubleshooting.


MORE INFORMATION

Steps to load Microsoft Exchange Symbols for Dr. Watson:

  1. If the computer is running Exchange Server on Windows NT 3.5x, copy the Symbols directory and subdirectories from the Windows NT Server CD, Support\Debug\Symbols\platform, to the Winnt directory on the Microsoft Exchange Server computer. In the Symbols directory you now have Winnt\Symbols with nine subdirectories. In Windows NT 4.0, run Expndsym.exe from the \Support\Debug\Symbols directory.

    You may need to run the Expndsym.exe from a command line with the following syntax:


  2. EXPNDSYM F: C:\WINNT
    where \WINNT is the %SystemRoot% where Windows NT is installed. This creates a C:\%SystemRoot%\Symbols directory structure and places the *.dbg files in the appropriate subdirectory (Dll, Exe, and so on).

  3. Determine the version of Exchange Server:


    1. For version 4.0, run Setup.bat from the Support\Symbols\Debug\platform directory on the Exchange Server 4.0 distribution compact disk as follows:
      Support\Symbols\Debug\platform\Setup.bat
      to ensure that the symbols are collected the next time Dr. Watson traps a fault.

      NOTE: You must also install Symbols for any service packs and hotfixes installed on the computer. For Service Packs 1-3:


    2. SP1: Run Setup.bat from \Support\Symbols\platform.
      SP2: Run Setup.bat from \Server\language\Support\Symbols\platform.
      SP3: Copy all files from \Support\Symbols directory into the \Winnt\Symbols directory on your hard disk drive.
    3. For version 5.0, run Setup.exe from the Support\Symbols directory on the Exchange Server 5.0 distribution compact disk. The Setup program installs all necessary symbols in the correct locations.


    4. For version 5.5, run Setup.exe from the Server\Support\Symbols directory on the Exchange Server 5.5 distribution compact disk. The Setup program installs all necessary symbols in the correct locations.


  4. From File Manager, run Drwtsn32 -I, and click OK. This sets Dr. Watson as the default debugger for Windows NT.


  5. From File Manager, run Drwtsn32, and on the Options menu, click Create Crash Dump File.

    Note that the information contained in the crash dump file may not be useful for the system administrator; only collect a crash dump file if one is requested by a Microsoft Support Professional.


Additional query words:

Keywords : XADM exc4 exc5 exc55
Version : winnt:4.0,5.0,5.5
Platform : winnt
Issue type : kbhowto


Last Reviewed: August 3, 1999
© 2000 Microsoft Corporation. All rights reserved. Terms of Use.