When troubleshooting Guacamole issues in the HTML5 Gateway, how do I enable debug logging for the guacd service?
Steps
To enable debug logging in the guacd service you will need to edit the logback.xml file. The location of this file depends on how Tomcat and Guacamole was installed, but by default this is under "/opt/tomcat/webapps/guac/WEB-INF/classes/logback.xml". In this file, make the following change:
Debug logs will appear in the default webapp log under "/var/opt/CARKpsmgw/logs/webapp/cyberark-psm-gateway-webapp.log".
==
To make guacd write debug logs its best to run it in foreground debug mode:
==
1. Stop the guacd service: service guacd stop
2. Run the following command to include the freerdp libraries in the libraries path:export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/opt/CARKpsmgw/lib64:/opt/CARKpsmgw/lib64/freerdp2
Note: for HTML5GW versions 11.6 and older, use freerdp instead of freerdp2
3. Start guacd in foreground mode: /opt/CARKpsmgw/bin/guacd –L debug –f
4. Reproduce the problem by starting a new PSM connection. The log output will be printed on the terminal.
5. To return to normal mode of operation:
- End the guacd foreground process by pressing Ctrl+C
- Start the service:service guacd start