Microsoft KB Archive/857192

From BetaArchive Wiki
Knowledge Base


How to modify the Web.config file to show more detailed error messages in Microsoft CRM

Article ID: 857192

Article Last Modified on 1/4/2008



APPLIES TO

  • Microsoft CRM client for Microsoft Office Outlook, when used with:
    • Microsoft Dynamics CRM 4.0
    • Microsoft Dynamics CRM 3.0
  • Microsoft Business Solutions CRM Sales for Outlook, when used with:
    • Microsoft CRM 1.2
    • Microsoft Business Solutions CRM 1.0



This article describes how to modify the web.config file to show more detailed error messages in Microsoft Dynamics CRM 4.0, in Microsoft Dynamics CRM 3.0, in Microsoft CRM 1.2, and in Microsoft Business Solutions CRM 1.0.

MORE INFORMATION

You can receive more detailed (debug) error messages in one or more of the following products:

  • The Microsoft Dynamics CRM Web client
  • The Microsoft CRM 1.2 Sales for Outlook client (the Outlook client)
  • The Microsoft Dynamics CRM client for Microsoft Office Outlook

You can modify either or both of the Web.config files that are in the Microsoft CRM deployment. We do not recommend that you use debug error messages in production environments. However, you may find these messages useful when you try to debug a problem that occurs in Microsoft CRM.

To modify the Web.config file, follow these steps:

  1. In Windows Explorer, locate the Web.config file.
    • If you are receiving errors in the Microsoft Dynamics CRM Web client, modify the Web.config file that is located on the Microsoft Dynamics CRM server. By default, this file is located in the following folder:

      <system drive>:\inetpub\wwwroot

    • If you are receiving errors in the Microsoft CRM 1.2 Sales for Outlook client, modify the Web.config file that is located on the client computer. By default, this file is located in the following folder:

      <system drive>:\Program Files\Microsoft CRM\Client\res\Web


      Note This option is unavailable in the Microsoft CRM 1.0 Sales for Outlook client.
    • If you are receiving errors in the Microsoft CRM desktop client for Microsoft Office Outlook or in the Microsoft Dynamics CRM online client for Microsoft Office Outlook, modify the Web.config file that is located on the Microsoft CRM server. By default, this file is located in the following folder:

      <system drive>:\inetpub\wwwroot

    • If you are receiving errors in the Microsoft CRM laptop client for Microsoft Office Outlook or in the Microsoft Dynamics CRM offline client for Microsoft Office Outlook, modify the Web.config file that is located on the client computer. By default, this file is located in the following folder:

      <system drive>:\Program Files\Microsoft CRM Client\res\Web

  2. Open the file by using Notepad or another text editing program.
  3. In the file, scroll down the text toward the end of the file to find the following statement:

    <add key="DevErrors" value="Off"/>

    By default, this value is set to Off. Modify this line to read as follows:

    <add key="DevErrors" value="On"/>

    Then, save the file.
  4. After you modify the Web.config file on the Microsoft Dynamics CRM server, close the error window, and then retry the same action that resulted in the previous error message. You should receive a more detailed (debug) error message.
  5. After you use the detailed (debug) error message to troubleshoot, repeat steps 1 through 4 to change the value of the statement back to the default setting of Off. The statement now reads as follows:

    <add key="DevErrors" value="Off"/>

  6. Save the file.

This article was TechKnowledge Document ID: 27228

Keywords: kbmbscrm40 kbcrmv3c kbinfo kbmbsmigrate KB857192