Enabling debug in the local controller configuration

A property is now available to enable debug in the local configuration on the Remote Control controller.

About this task

Use the debug.trace property to enable debug on the controller. To enable debug, complete the following steps:

Procedure

  1. Edit the trc_controller.cfg file that is in the Controller install folder.
    The file is in the following directory.
    Windows systems

    C:\Program Files\BigFix\Remote Control\Controller

    Linux systems

    /opt/bigfix/trc/controller

    macOS systems

    /Applications/Remote\ Control\ Controller.app/Contents/app

  2. Set debug.trace=true (add it if not already present).
  3. Save the file and restart the controller.
    Alternatively if you don’t have admin rights to edit the Controller config file you can enable the logs dump into a shell. Use the commands below to create the needed shell variables and start the Controller.
    Windows
    set TRC_TRACE=yes
    set TRC_TRACE_LEVEL=INFO
    "C:\Program Files\BigFix\Remote Control\Controller\jre\bin\java.exe" "-Djava.security.properties=C:\Program Files\BigFix\Remote Control\Controller\override.security" -jar "C:\Program Files\BigFix\Remote Control\Controller\TRCConsole.jar"
    Linux
    export TRC_TRACE=”yes”
    export TRC_TRACE_LEVEL=”INFO”
    /opt/bigfix/trc/controller/trc_controller.sh
    macOS
    export TRC_TRACE=”yes”
    export TRC_TRACE_LEVEL=”INFO”
    /Applications/Remote Control Controller.app/Contents/MacOS/TRCLauncher

    If you need to open a specific .trcjws file you can cd into the same folder where this is stored then you can issue the Controller starting command with this additional parameter: --trcjws "TRCController.trcjws"

    Attention: If you are running Controller 10.1.0.0442 or earlier, follow this procedure instead:
    1. Edit trc.properties in your home directory. The file is in the following directory.
      • Windows
        USERHOMEDIR\.trc\trc.properties
      • Linux or macOS
        USERHOMEDIR/.trc/trc.properties
    2. Set debug.trace=true (add it if not already present).
    3. Save the file and restart the controller.

Results

The next time that you start a session, the events that take place are logged in the trctrace_XXXXX.log file in your home directory. The file name contains the date and time stamp of when the file was created. For example, trctrace_20170309_124230.log.