Appendix D - Using the Antigen diagnostic utility (AntigenDiag.exe)

Applies to: Microsoft Antigen

To accurately diagnose a problem, support engineers typically need a variety of information about Antigen for SMTP Gateways and the SMTP gateway server it is running on. This information consists of Antigen for SMTP Gateways version information, third-party scan engine versions, registry settings, and Antigen for SMTP Gateways databases. Gathering this configuration information is a significant effort and slows the troubleshooting process.

To make it easier for you to collect this information, the Antigen Diagnostic Utility automates the process, assembling all the necessary data in one file that can then be uploaded to Microsoft. When you contact Microsoft support, you will be told where to upload the file. For more information about support, see Chapter 17 - Troubleshooting overview.

The Antigen Diagnostic Utility can collect any or all of the following information, based on your requests:

• Antigen for SMTP Gateways file versions (including scan engine file versions)
• Exchange file versions
• Antigen for SMTP Gateways registry keys
• Antigen for SMTP Gateways database (*.adb) files
• Antigen for SMTP Gateways archive files
• Antigen for SMTP Gateways program log file
• Windows event log files
• Dr. Watson log file
• User.dmp file
• Antigen for SMTP Gateways installation log file

You can request any or all of this information.

Running the antigen diagnostic utility

The selected data is gathered and compressed into a single file to be uploaded to Microsoft.

To run the Antigen Diagnostic Utility

1. Navigate to the Antigen for SMTP Gateways installation folder (default: C:\Program Files\Microsoft Antigen for SMTP) and launch AntigenDiag.exe. The tool runs in a Command Prompt window. You may also run the tool from the command line by navigating to the Antigen for SMTP Gateways installation folder and entering antigendiag at a command prompt.

2. Select the information to be included by answering each of the following screen prompts. Type Y for yes or N for no, and then press ENTER after each response.

   Add Antigen file versions Yes(Y)/No(N) ?

   Add Exchange file versions Yes(Y)/No(N) ?

   Add Antigen registry key Yes(Y)/No(N) ?

   Add Antigen database files Yes(Y)/No(N) ?

   Add Antigen archive files Yes(Y)/No(N) ?

   Add Antigen Program log Yes(Y)/No(N) ?

   Add Windows Event log Yes(Y)/No(N) ?

   Add Dr. Watson log Yes(Y)/No(N) ?

   Add User.dmp Yes(Y)/No(N) ?

   Add Antigen Install.log Yes(Y)/No(N) ?

   After the final prompt, the tool gathers the requested information and compresses the results into a new file in the Log\Diagnostics folder (in the Antigen for SMTP Gateways installation directory). The file name, constructed from the name of the server, the date, and the time, has the following format:

   **Format—**AntigenDiag-servername-date-time.zip

   date has the format yyyymmdd

   time has the format hh.mm.ss (where hh represents a 24-hour clock)

   **Example—**C:\Program Files\Microsoft Antigen for ISA\Log\Diagnostics\

   AntigenDiag-Server1-20051210-17.50.27.zip

3. Upload the compressed file to Microsoft.