How to enable Plesk backend tools debug tracking

Created:

2016-11-16 13:09:15 UTC

Modified:

2017-04-24 11:56:10 UTC

0

Was this article helpful?


Have more questions?

Submit a request

How to enable Plesk backend tools debug tracking

Applicable to:

  • Plesk 11.0 for Windows
  • Plesk 11.0 for Linux
  • Plesk 10.x and below for Linux
  • Plesk 10.x and below for Windows

Question

How to enable Plesk backend tools debug tracking?

Answer

Since Plesk 9.x to Plesk 11.0 it is possible to enable the tracking of Plesk utilities. This feature allows to see commands with parameters used for some operations in Control Panel.

Linux: To enable Plesk utilities tracking, update the misc table in the psa database:

# MYSQL_PWD=`cat /etc/psa/.psa.shadow` mysql -u admin psa -e "replace into misc(param, val) values('debug_util_exec', 'true');"

Utilities execution log will be written to /usr/local/psa/tmp/util_exec.log .

Windows:

Create a registry key debugutilexec with string value TRUE in the HKEY_LOCAL_MACHINE\\SOFTWARE\\Wow6432Node\\PLESK\\PSA Config\\Config hive.Utilities execution log will be written to %plesk_dir%\ mp\\util_exec.log .

There is no need to restart any services after enabling the debug log.

How to read the log

The debug log contains the list of executed commands with their parameters:

11/05/2011 10:58:46     eeeb28f3910ea9d92e50e58cd0f91221        /admin/subscription/create      usermng /usr/local/psa/admin/bin/usermng '--user-exist' '--user=testutilexec'   TRUE    0.01377

11/05/2011 10:58:46     eeeb28f3910ea9d92e50e58cd0f91221        /admin/subscription/create      logrot\\_mng      /usr/local/psa/admin/bin/logrot\\_mng 'example.com' 'on' 'by\\_size' '204800000' '10' 'true' ''        TRUE    0.03793

11/05/2011 10:58:47     eeeb28f3910ea9d92e50e58cd0f91221        /admin/subscription/create      mailmng /usr/local/psa/admin/bin/mailmng '--add-domain' '--domain-name=example.com'        TRUE    0.16681

Each line contains date, time, session ID, execution command with its parameters, execution status, and execution time.The log contains the list of executed utilities, but not the execution result. If some operation fails, the execution status will be equal to FALSE .

If an error is received in Plesk with utility tracking enabled, it is possible to discover which utility is failing to be executed.

Additional Information

Do not forget to disable utility tracking after the investigation by removing the record or setting it to FALSE .

Linux:

# MYSQL_PWD=`cat /etc/psa/.psa.shadow` mysql -u admin psa -e "replace into misc(param, val) values('debug_util_exec', 'false');"

Windows:

Set the registry key debugutilexec to FALSE in the HKEY_LOCAL_MACHINE\\SOFTWARE\\Wow6432Node\\PLESK\\PSA Config\\Config hive, or simply delete the key.

Have more questions? Submit a request
Please sign in to leave a comment.