Knowledgebase

Introduction

When backups fail, the backup log is the best place to look for the cause. Backup logs are located in the /usr/local/cpanel/logs/cpbackup/ folder and are named with the epoch time that the log file was created. The following procedure will help you use the log file to identify why a backup failed.

Procedure

1. Access the server's command line as the 'root' user via SSH or "Terminal" in WHM.
2. Run the following command to find the problem the backup process encountered.

   awk -F'/' '/ERROR_PATTERNS =/,/]/ { if ($2) print $2; }' /usr/local/cpanel/bin/backup | while read ERROR;do grep --with-filename "$ERROR" /usr/local/cpanel/logs/cpbackup/$lognum.log;done

   Please note that "$lognum" must be replaced by the number of the appropriate log.

Additional resources

How does cPanel determine if a backup failed?

Backup Configuration