How to enable debug mode for Plesk backup operations

Symptoms

Logging of Plesk backup procedure is not detailed enough. How to increase its verbosity?

Resolution

For backup tasks that are performed in Plesk Backup Manager

Nothing needs to be done. Logs are collected with the debug switch by default.

For scheduled backup tasks

To increase verbosity for scheduled backups, enable the verbose_scheduled_backup_logs parameter in Plesk database:

1. Access the Plesk database:

2. Run the following query:

   MYSQL_LIN: REPLACE INTO misc (param,val) VALUES ('verbose_scheduled_backup_logs', 'true');

   Warning: As with any other log file, it is strongly recommended that you disable verbosity once you have finished troubleshooting the issue. Otherwise, the server might quickly run out of free disk space, which will in turn lead to data loss and service downtime. Server performance will be affected as well.

   To turn debug off, run the following query in MySQL:

   MYSQL_LIN: DELETE FROM misc WHERE param='verbose_scheduled_backup_logs';

For the command-line utility pleskbackup

Add one or more verbose -v options to the backup command.

For example, the below commands will back up the whole server with maximum verbosity in logs and output in a command-line interface:

• On Linux:

  # /usr/local/psa/bin/pleskbackup server -vvvvv

• On Windows Server, multiple verbose options cannot be joined and has to be specified separately:

  C:\> "%plesk_cli%\pleskbackup" --server -v -v -v -v -v

Additional Information

In addition to debug mode mentioned above, enable debug mode for the pmmcli utility.

1. Open the pmmcli-rc file in a text editor:

   • On Linux:

     MYSQL_LIN: /usr/local/psa/admin/share/pmmcli/pmmcli-rc

   • On Windows Server:

     C:\> C:\Program Files (x86)\Plesk\admin\share\pmmcli\pmmcli-rc

2. Change the value of the FORCE_DEBUG_LOG parameter from 0 to 1:

   CONFIG_TEXT: FORCE_DEBUG_LOG 1

3. Save the changes and close the file.

   Note: Do not forget to revert the changes back after troubleshooting.