Skip to content

Enabling module tracing

Enable tracing to debug your module information and improve performance through trace string or with cookies.

  1. Enable tracing through trace string.

    1. To debug a module or theme, enable portal tracing with the following trace string.

      com.ibm.wps.resourceaggregator.CombinerDataSource.RemoteDebug=all
      

      This string loads the modules by using separate links and script tags, isolating each one independently. If the module definition defines a debug version, it also loads debug versions of each contribution. Typically, the debug version is an uncompressed version of the <script> tag that contains the same data as the normal version.

      Both using separate links and by using uncompressed <script> tags makes it easier to debug a running HCL WebEngine environment from the browser.

  2. Enable tracing with cookies.

    1. In the Helm chart set, WP ConfigService resourceaggregation.client.debug.mode.allowed=true.

    2. Apply the Helm changes.

When a user sets a cookie that is named com.ibm.portal.resourceaggregator.client.debug.mode to true, debug versions of module contributions are loaded if they are defined. Modules are loaded without using separate links and script tags. All resources are downloaded as a combined unit in that case.