How to create a log file to troubleshoot ABO Mapper errors in IIS 7.5 and 7.0

Applies to: Internet Information Services 7.5

Introduction


This article discusses how to create a log file that can help you troubleshoot Internet Information Services (IIS) Admin Base Object (ABO) Mapper errors in Internet Information Services 7.5 and 7.0.

More Information


Important This section, method, or task contains steps that tell you how to modify the registry. However, serious problems might occur if you modify the registry incorrectly. Therefore, make sure that you follow these steps carefully. For added protection, back up the registry before you modify it. Then, you can restore the registry if a problem occurs. For more information about how to back up and restore the registry, see the following article in the Microsoft Knowledge Base:

322756 How to back up and restore the registry in Windows


IIS 7.5 and 7.0 include a compatibility feature that enables scripts and programs that used ABO in earlier versions of IIS to work with IIS 7.5 and 7.0. This compatibility feature is known as the ABO Mapper.

Changes that are made by the legacy scripts and code that use ABO are written to the ApplicationHost.config file in IIS. The ABO Mapper subcomponent maps the legacy metabase configuration settings to the new distributed configuration system in IIS. In some cases, this subcomponent may encounter problems.

To help troubleshoot these problems, you can configure the computer that is running IIS to create an error log file for the ABO Mapper feature. To do this, follow these steps:

  1. Click Start, type regedit in the Start Search box, and then press Enter.

    Note If you are prompted for an administrator password or for confirmation, type the password or click Continue.
  2. In Registry Editor, locate the following registry key:
    HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\IISADMIN
  3. Right-click IISADMIN, point to New, and then click Key.
  4. Type Parameters for the new key name, and then press Enter.
  5. Right-click Parameters, point to New, and then click DWORD (32-bit) Value.
  6. Type EnableABOMapperLog for the DWORD Value name, and then press Enter.
  7. Right-click EnableABOMapperLog, and then click Modify.
  8. Set the Value data value to 1 to enable the log file. A value of 0 turns off ABOMapper logging.
  9. Close the registry.
  10. Click Start, type Services in the Start Search box, and then click Services

    Note If you are prompted for an administrator password or for confirmation, type the password or click Continue.
  11. In Services, right-click IIS Admin Service, and then click Restart.

By default, all errors that occur during the ABOMapper process are written to the Abomapper.log file. This log file is located in the %windir% \System32\ folder. Only members of the Administrators group can access the Abomapper.log file.