Reporting a problem

If you experience a problem with the HCL Nomad application, you need to provide a clear description of the problem (including the date and time of the problem along with screen shots and/or logs), information on your browser environment (what browser and what browser version), and information on your server environment (any proxies, any firewalls, Nomad web proxy/SafeLinx, and Domino).

About this task

To obtain logs for a clear description of the problem, complete the following steps:

Procedure

  1. Reproduce the issue with HCL Nomad. Take screen shots of any errors, unexpected behaviors, etc.
  2. Create a zip file of the logs that you download to your local machine and then provide to support with one of the following options:
    • Generate Problem Report

      While Nomad is running, navigate to the Help menu and select Generate Problem Report. This creates a zip file of the logs that you download to your local machine and then provide to support. Some error dialogs will also have a Generate Problem Report button to generate the zip file.

    • nprDownload() command
      If Generate Problem Report is not available and you do not have a dialog with a Generate Problem Report button, issue nomad.nprDownload() in the browser's console to generate the zip file of the logs that you download to your local machine and then provide to support.

      • In Firefox, the Console is accessed via the 3 bar/hamburger button normally found to the right of the address bar: More Tools > Web Developer Tools.

      • In Chrome and Edge, the Console is accessed via the 3 dot button normally found to the right of the address bar: More Tools > Developer Tools. If you are running as a Progressive Web Application, use the 3 dot button and select Open in Chrome to get back to Chrome (from which you can open the Developer Tools).
  3. Because the browser writes message directly to the console in a manner that HCL Nomad cannot capture in the Problem Report, it is also recommended to provide the Console log to support. Follow the instructions in step 2 -> nprDownload() command to open the Console and then save the contents as follows:
    To Get Web Console logs:
    • In Firefox, control (right) click inside the console and select Save all Messages to File.
    • In Chome and Edge, control (right) click inside the console and select Save As...
  4. (Optional) If the problem is related to network connectivity, HTTP headers or file downloads, a network trace may be helpful. Follow the instructions in step 2 -> nprDownload() command to open the Console and then switch to the Network tab (this must be done before recreating the problem as the network traffic, unlike the console, is only captured while the tools are open). Save the network trace as follows:

    • In Firefox, click on the gear icon (Network Settings) and select Save All As HAR.

    • In Chrome and Edge, click the down arrow icon (Export HAR...).