Configure the GBC development environment

Configure a development environment to troubleshoot an Genero Browser Client (GBC) application.

To troubleshoot and debug an application, you may need to view the application log files and the AUI tree. For this you will need to set up a development environment by performing the following steps.
Warning: The --development option forces the GBC into debug mode. This may effect the behavior of the GBC in the browser. For example, the prompt that is usually displayed when the user presses the browser's back button, is no longer displayed:
Are you sure you want to leave this page? 
  1. In the GAS configuration file (default $FGLASDIR/etc/as.xcf), change the res.uaproxy.param resource:
    From:
    <RESOURCE Id="res.uaproxy.param" Source="INTERNAL"></RESOURCE>
    To:
    <RESOURCE Id="res.uaproxy.param" Source="INTERNAL">--development</RESOURCE>
    Tip: Alternatively, you can also run the dispatcher from the command line and override the settings in the GAS configuration file for res.uaproxy.param:

    httpdispatch.exe -E res.uaproxy.param=--development

  2. Restart the dispatcher.
    The dispatcher must be restarted whenever you modify the application server configuration file in order for the changes to take effect.
  3. Enter the application URL in your browser.
    You should now see the Debug Tools icon (next to the close application icon) on the right-hand side of your web application window. For more information, see the Genero Browser Client User Guide.