Wednesday, March 18, 2009

How to Debug Enterprise Portal Code in Dynamics AX 2009

  • To set up debugging for pages
    1. Log into the server that is running the AOS.
    2. Open the Microsoft Dynamics AX Server Configuration utility (Start > Control Panel > Administrative Tools > Microsoft Dynamics AX 2009 Server Configuration).
    3. Create a new configuration that allows debugging.
    a. Click Manage and then click Create configuration. In
    the Create Configuration window, name the new configuration, such as "DAX
    Debugging". Click OK.
    b. On the Application Object
    Server tab, select Enable breakpoints to debug code X++ code running on this
    server. Click Apply.
    4. Click OK to close the configuration window. If you receive a message about the AOS, indicate that it should be restarted.
    5. Log in to the server that is running IIS and Enterprise Portal. If the system is remote, you can do this using Terminal Services. From the Start menu, click Run. Type the following in the Open box and click OK:
    mstsc /console
    This opens a console session in Terminal Services.
    6. Enable desktop interaction for the World Wide Web Publish Service.
    a. Open the Services window for the system (Start >
    Control Panel > Administrative Tools > Services).
    b. Right-click the World Wide Web Publishing
    Service, and then click Properties.
    c. Click the Log On tab.
    d. Select Allow service to interact with desktop.
    e. Click OK to close the properties window.
    7. Open the web.config file located in \Inetpub\wwwroot\wss\VirtualDirectories\\, where is the port number of the site where Enterprise Portal is installed. Modify the file by doing the following:
    a. Locate the compilation element, and then set the
    debug attribute to true. This reduces the chance of the Web session having a
    timeout error when stopped at a breakpoint.
    b. Save
    the changes.
    8. Reset IIS by typing the iisreset command at the command-line window.
    9. Open the Microsoft Dynamics AX Configuration utility (Start > Control Panel > Administrative Tools > Microsoft Dynamics AX 2009 Configuration).
    10. Set the Application Object Server Instance drop-down menu to Business Connector (non-interactive use only).
    11. Create a new configuration that allows debugging.
    a. Click Manage and then click Create configuration. In
    the Create Configuration window, name the new configuration, such as "DAX
    Debugging". Click OK.
    b. On the Developer tab,
    select Enable user breakpoints to debug code running in the Business Connector.
    Click Apply.
    12. Click OK to close the configuration window.
    13. Open the Microsoft Dynamics AX client.
    14. On the Tools menu, click Options to display the Options window.
    15. On the Development tab, select When Breakpoint from the Debug mode list box, and then click Apply. This enables debugging mode on the client.
    16. Close the Options window.
    Debugging an Element on a Web Page
    To debug an element on a Web page
    1. Log in to the server that is running Internet Information Services (IIS) and Enterprise Portal. If the system is remote, you can do this using Terminal Services. From the Start menu, click Run. Type the following in the Open box and click OK:
    mstsc /console
    This opens a console session in Terminal Services, and is necessary if you want to debug on a remote system.
    Important
    If you are debugging on a remote system, you must use console mode when connecting. Otherwise, debugging will not work.
    2. Open the Microsoft Dynamics AX client.
    3. Be sure that you are logged on as a user who is also one of the following:
    · The user who started the session of Microsoft Dynamics AX
    · The user who will set breakpoints in X++ code
    4. In the AOT, locate the element that you want to debug. Typically, you will debug data sets, classes, Web forms, reports, Web reports, or weblets.
    5. Set breakpoints in the X++ code by using the Code Editor. For more information, see X++ Code Editor.
    6. Open the debugger by clicking Tools, then clicking Development tools, and finally clicking Debugger. The Debugger must be open before you can run code that contains breakpoints.
    7. Open the Web page that includes the element that you want to debug. As the page is rendered, the Debugger should stop at the breakpoints that you set.

3 comments:

  1. Debug enterprise portal DAX 2009 on Windows 2008.

    In previues version of windows it was possible to connect to Session 0, which where done with mstsc.exe /console or mstsc.exe /admin. With Windows 2008 this is no longer possible.

    It is necessary to connect to session 0, since the IIS is running as a service in this session.

    How can you debug enterprise portal X++ code on a Windows 2008 server?

    Regards
    Michael Troelsen

    Ref
    http://blog.shijaz.com/2008/01/no-more-mstscexe-console.html

    ReplyDelete
  2. Hi I'd love to thank you for such a great made site!
    Was thinking this is a perfect way to make my first post!

    Sincerely,
    Robin Toby
    if you're ever bored check out my site!
    [url=http://www.partyopedia.com/articles/diego-party-supplies.html]diego Party Supplies[/url].

    ReplyDelete
  3. Hi Dilip,

    For some reason the debugger doesn't get called in my case.
    I am trying on EP server which is on Windows 2003, debugger already opened and all other steps are done. Still no luck.
    I am trying to debug code under a web form clicked method.

    Any idea please?

    Thank you
    Nag Kothapalli

    ReplyDelete