Skip to main content

Set the logging level from the command line

Use the psdebug program on an application server to configure logging output from various Bravura Security Fabric software components. It is helpful when troubleshooting installation or functionality problems.

The psdebug utility allows for adding specific exceptions (one binary or script at a time) to global application-wide logging settings configured in the Logging Service, for more refined logging. Using psdebug allows for smaller, more relevant and more readable logs; there is less interference from other subsystems when troubleshooting a specific issue.

  1. Open an Administrative instance prompt

  2. Execute the psdebug command by running:

    util\psdebug -level 6 -prog <executable>

    where <executable> is the name, without file extension , of the core product binary, script (default or custom), connector pack agent or interface for which we want to increase logging specifically. The debug level for most binaries is 5, but here we use 6 as the increased debug level for some agents and interfaces.

    For example, to enable the most detailed logging (Verbose = 99) for the Active Directory DN agent, the command to execute would be:

    util\psdebug -level 99 -prog agtaddn
  3. If more than one binary, custom script, or connector pack agent is relevant to the issue, repeat the last step as necessary.

  4. To create an idmsuite.log file which contains only the time period in which the issue is reproduced, execute the command:

    service\idmsuite.exe -rotatelog
  5. If the affected binary is a service, ensure the log level change takes effect by executing:

    service\idmlogsvc.exe -trace-restart
  6. Execute the steps required to reproduce the issue.

  7. To remove the additional logging settings added at step 2 (change "agtaddn" to match the required binary) execute:

    util\psdebug -remove -prog agtaddn
  8. If the affected binary is a service, apply the default settings by execurting:

    service\idmlogsvc.exe -trace-restart

See psdebug usage for more command-line usage information and examples.