Knowledgebase

"Could not list files in destination" when backing up to a Windows FTP server Symptoms When attempting to validate a remote backup destination using Windows FTP Service, you... AWS S3 "Could not upload test file: Timeout" error Symptoms You are trying to validate your new S3 destination, but receive the above error.... Account backups not being copied to the remote backup destination because they're timing out Symptoms Account backups are not being copied or fully copied to the remote backup destination,... Account restore failed: Exceeded max filesystem nodes while making permissions safe at /usr/local/cpanel/Cpanel/Archive/Utils.pm line 66. Symptoms A restore fails with the following error in the logs: Failed to extract the... Account transfer or backup results in: The system failed to read up to 64 KB from a file handle because of an error: Is a directory Symptoms When running an account backup or transferring an account to a new server using... Acronis Cpanel enduser plugin missing after upgrade to v100 Symptoms After upgrading or installing version 100, the Acronis backup plugin is missing for... Are Backup Transfers to Google Drive Secure? Question Are backup transfers to Google Drive secure?    Answer When backups are transferring... Available disk space is too low. Backups will not run. Symptoms You may see fewer backups on your server or remote backup destination than there are... BackUp Transfers To S3 Buckets Fail With "RequestTimeTooSkewed" Error Symptoms:  Backup transfers to S3 buckets could occasionally fail with the following error... Backblaze times out when validating a remote destination. Symptoms When Backblaze is configured as an additional destination, the destination never... Backup Destination is Showing a Timeout Error. Symptoms When attempting to validate a remote backup destination you may see an error such as:... Backup Process Fails With Error "The system failed to create the file “$PATH.meta” with permissions “0600”: No such file or directory" Symptoms When investigating the backup logs in /usr/local/cpanel/logs/cpbackup/ you are... Backup Restoration ERROR: time out reached Symptoms When restoring an account backup via the WHM Backup Restoration interface, the... Backup fails with "The command "/usr/local/cpanel/bin/cpuwatch" failed to report errors to the status file" error Symptoms When the cPanel backup fails with a "partial failure" error, you may find something... Backup restore stalls when running AutoDomains script Symptoms When performing a backup restore via pkgacct or the "Transfer or Restore a cPanel... Backup restore without email Introduction This article aims to describe how to overwrite/restore account backups without... Backup transport fails to validate with rsync.net and other rsync implementations without full shell capabilities Symptoms Attempting to use a backup transporter via Rsync destination reports a failure to... Backup transports to Hetzner fail with an unclear message Symptoms When using a Hezner storage server as an Additional Backup destination, the validation... Backups File and Directory restoration error Symptoms Attempting to restore an account via FIle and Directory restoration returns an error... Backups PartialFailure "backup_incomplete" in our /backup directory and the old backup won't delete/prune Symptoms After cPanel daily backups run, the below error is received:   Note: The backup logs... Can I Use the "File and Directory Restoration" Feature When "Mount Backup Drive as Needed" Option Is Enabled? Question: Is it possible to use the "File and Directory Restoration" features in WHM and cPanel,... Can I try out JetBackup before purchasing a license? Question Is it possible to give JetBackup a trial run before purchasing a license for it?... Can I use NFS mounts for backups? Question Do NFS mounts work with cPanel for backups and restorations?   Answer While it is... Can separate retention policies be set for local and remote backup destinations? Question Can separate retention policies be set for local and remote backup destinations?... Can the Backup or Backup Wizard interfaces be used to restore from a full cPanel account backup? Question Can the Backup or Backup Wizard interfaces be used to restore from a full cPanel... Can you tell me the contents of a cPanel Backup Tarball? Question Can you tell me the contents of a cPanel Backup Tarball?   Answer When you create a... Changing the JetBackup temporary workspace to another directory Introduction By default, JetBackup uses the following directory as a temporary directory when... Copied incremental backups use more space Symptoms While upgrading your backup drive, you may find that incremental backups that are... Do I need previous incremental backups to restore later incremental backups? Question Do I need previous incremental backups to restore later incremental backups?   Answer... Does cPanel back up all accounts to a local mount/dir, then start the transfer to the destination source? Question Does cPanel back up all accounts to a local mount/dir, then start uploading the backups... Does cPanel offer a full system backup option like snapshots or bare metal backups? Question Does cPanel offer the ability to perform a full system backups such as a snapshot or... Does transferring a JetBackup license copy the Master Key? Question   When I clicked the 'Generate Master Key’ it gave a message box that said: “Success:... Dot files aren't being transported Question   Why aren't dot files such as '.master.meta' being transported with my backups?... Edit the Backup Destination Path from the command line Symptoms Additional backup destinations cannot be configured to use absolute file paths via the... Enable backups for suspended accounts Error when using cPanel >> Backups to restore a MySQL database Symptoms When using the cPanel >> Backups page to restore a MySQL database, you may... Example script to backup databases and remove old by threshold Introduction There may be a requirement to backup databases more frequently than backups... FTP Destination type missing from JetBackup configuration Symptoms When configuring JetBackup, the FTP Destination type is not available.... Google Drive API Deprecation Notice Inquiry [September 13, 2021] Google recently issued a notice to Drive Developers stating changes to the API taking... Google Drive backup validation [Failed with 403: Forbidden] Question When attempting to validate Google Drive remote destination backups, I received the... Google Drive backup validation failure: "Could not create path directory" Symptoms When validating the Google Drive backup destination you might receive an error such as... Gzip variable error during backups on Ubuntu systems Symptoms When performing a cPanel backup on the Ubuntu operating system, you may encounter this... How To Install the Acronis Backup Plugin Introduction This document describes how to install and use the Acronis Backup plugin for WHM... How are backups taken when schedules converge? Question If a cPanel server has multiple backup schedules configured (daily, weekly, monthly)... How can I adjust the Backup Fork TTL setting in JetBackup? Introduction The Backup Fork TTL setting is used to set a time limit on the. forked backup... How can I change the backup time? Question How can I change the backup time?   Answer When backups are enabled the backup... How can I create Google Drive account credentials for backups? Question   How can I create Google Drive account credentials for backups?   Answer   To... How can I create an account backup in cPanel? Question How can I create an account backup in cPanel?   Answer The recommended method to... How can I move the Backup creation and staging to a new directory on the server? Qestion How can I move the Backup creation and staging to a new directory on the server?... How can I provide the Restore Wizard from JetBackup for a reseller? Question How can I allow a WHM reseller to view the Restore Wizard feature within JetBackup?... How can I restore my backups from a remote backup destination? Question How can I restore backups from a remote backup destination?   Answer To use a remote... How do I configure JetBackup snapshot retention for incremental backups? Question I am seeing in my backup log that 0 snapshots were deleted. "Clearing old... How do I manually locate and extract data from a cPanel backup? Question How do I manually locate and extract data from a cPanel backup?   Answer Note:... How do I recover from a failed hard disk? Question How do I recover from a failed hard disk?   Answer While we do not have any... How do I restore multiple backups using the API? Introduction   How can I restore multiple backups using the WHM API?   Procedure   Multiple... How do you restore multiple cP-move files at once? Introduction cPanel Software does not have a built-in API or commands that will allow you to... How does cPanel determine if a backup failed? Question How does cPanel determine if a backup failed?   Answer cPanel analyzes the... How to Create New Destinations for JetBackup Introduction This article links to resources on setting up destinations for backups with... How to Create a Backup with JetBackup Introduction This article aims to include some information and resources on creating a backup... How to Exclude Files from Backups Question How can I exclude certain files from cPanel backups automatically?   Answer cPanel... How to Resolve CIFS mounted backup drive permission errors Introduction Use the steps below to resolve CIFS mounted backup drive errors. If needed, please... How to automatically remove local backups when transporting backups to a remote destination Introduction   When using a remote backup destination in WHM >> Backup Configuration... How to avoid backups filling up server's disk space Introduction Here is how you can configure your server to never run out of disk space due to... How to backup to a remote destination Question How do you backup to a remote destination?   Answer Remote Backup Destinations can... How to determine how much space a backup for an account takes up Introduction This article will help you determine how much space a backup for a customer account... How to determine what is causing Backup Partial Failure Question How to determine what is causing Backup Partial Failure?   Answer List the... How to determine when backups are finished running Question How can you determine when backups are finished running?   Answer The easiest way to... How to diagnose backup issues Introduction When backups fail, the backup log is the best place to look for the cause. Backup... How to diagnose failed restoration attempts in JetBackup Introduction   Use the following procedure to check the logs for failed JetBackup logs.... How to disable backups for a cPanel user I want to exclude a single user from backups. How can I disable backups for a cPanel user using... How to disable database compression in JetBackup? Introduction   Database compression can increase the IO load on your server. Preventing... How to disable metadata generation for backups Introduction The FTP and SFTP backup transports do not support transferring metadata, so it is... How to disable the BACKUPMOUNT option for cPanel backups Introduction The BACKUPMOUNT option is used when you have a disk or partition that needs to be... How to enable MySQL database backups in WHM Introduction This article provides the procedure to backup MySQL databases when backups run.... How to enable debug logging in JetBackup Introduction   Debug logging can help diagnose issues with JetBackup jobs when default logging... How to generate a backup of my entire cPanel account from the cPanel interface Question How to generate a backup of my entire cPanel account from the cPanel interface... How to generate a backup of my entire cPanel account from the command-line interface? Question How do I generate a backup of my account from the command line via SSH as the root user... How to generate a site backup inside of cPanel Introduction The "Backup" interface in a user's cPanel allows you to generate and download full... How to generate ondemand/manual backup with JetBackup5 Introduction Generating a backup for accounts can be performed in a very similar method to... How to get a list of accounts and the backups available via the whmapi1 API Introduction You may want to write a script and need the users and backups available for those... How to increase the priority of cPanel backups Introduction   Depending on the size of your server's cPanel accounts, automatic backups may... How to locate the directory where backup files are located in the WHM interface? Question     When using the Backup Feature in the WHM interface, how can you determine where... How to manually extract individual files from a cPanel backup with the tar utility? Question How to manually extract individual files from a cPanel backup with the tar utility?... How to manually transfer all accounts using pkgacct and restorepkg? Introduction While the Transfer Tool can move all accounts between two servers that are online... How to manually transport backups to a remote backup destination Introduction This article will cover the process of transporting backups to the remote... How to reindex backups in Jetbackup 4 Introduction When adding a destination from a previous server with Jetbackup 4, it may be... How to reindex backups in Jetbackup 5 Introduction JetBackup destinations can be reindexed from WHM or the command line. This... How to restore an account from your server backups Question How do you restore an account from server backups? Answer You can restore an account... How to run a manual backup from the command line Question How do you run a manual backup from the command line?   Procedure Access the... How to run cPanel backups outside their scheduled time or when they have already run for the day Introduction cPanel's backup script can be run with the --force flag to force backups to run.... How to select which accounts are backed up Introduction   The cPanel backup system can include some accounts and exclude others. This... How to setup remote backup for DigitalOcean Spaces Introduction DigitalOcean provides an S3 environment for a storage solution called Spaces.... How to start the backup transporter Introduction   There may be times where the cPanel backup transporter needs to be restarted,... How to use the File and Directory Restoration feature Introduction The article provides a walkthrough of using the File and Directory Restoration... How to use the automount feature with cPanel backups Introduction If you have the "Mount Backup Drive as Needed" option enabled, cPanel reads the... How-To Disable Backup Success Notifications Introduction   The purpose of this article is to assist you with disabling the Backup Success... How-To Speed up cPanel nightly backups Introduction The purpose of this article is to provide a step-by-step guide on how you... How-To adjust the number backups retained by WHM Introduction In some cases, you may wish to keep more than one backup of your accounts.... How-To manually restore a cPanel account from JetBackup generated backups Introduction This article aims to assist you with manually restoring a JetBackup-generated... Incremental backups are not copied to the remote destination. Symptoms Incremental backups are not being copied to the remote backup destination.... Is it possible to configure different backup destinations for different backup types? Question   I want to configure daily backups locally on my cPanel server while sending weekly... Is it possible to restore an individual database from the "Entire MySQL Directory" backup? Question Is it possible to restore an individual database from the "Entire MySQL Directory"... JetBackup 5 fails to install :: your CPU is missing AVX instruction set flag Symptoms When attempting to install the Jetbackup software the installation does not complete.... JetBackup Fails to Start Symptoms JetBackup will not start, and messages similar to the following may be found in... JetBackup Restoration Guide Question How can I use JetBackup to restore an account? Answer Access your server using WHM... JetBackup Restorations failing with: [ERROR] Server load is too high for to much time, cancelling restore process Symptoms   You have found errors similar to the following in the JetBackup restoration logs:... JetBackup Restore Error: The name “databasename” does not begin with the required prefix "username_" Symptoms Restoring a backup through JetBackup fails, and you receive an error resembling the... JetBackup fails to backup account: API failure: No key with the ID "$keyid" exists. Symptoms JetBackup fails to backup an account completely, and an error similar to the... JetBackup partially completed Symptoms JetBackup fails to back up one or more accounts with a "partial backup" error.... Jetbackup 5 - Why are the accounts showing as suspended. Question How do I unsuspend Jetbackup 5 accounts that show as suspended even though they are not... Jetbackup being reinstalled after it was uninstalled Question Why was Jetbackup reinstalled after it was removed?   Answer The nightly cPanel... Jetbackup: Settings Introduction This article aims to include information and resources on using the functions... Mail Node Backup and Restore Question How are mail account backups handled on cPanel mail node servers? What happens if... Missing certificate and/or key IDs breaks JetBackup (5) backups. Symptoms When running JetBackup 5, the following error or similar is noted in the logs: Failed... No suitable servers found (set `serverSelectionTryOnce`): [connection closed by calling ismaster at 'localhost: 27217'] Symptoms Attempting to reindex your backups, within Jetbackup, may result in an error similar to... Pkgacct and daily backups lock the mysql user passwords Symptoms When running the script "/scripts/pkgacct" or daily backups, it can be observed that... Prevent slow backups due to high load Introduction If you have a busy server in which your backups are often paused due to high load,... Quotas show as 0M in WHM after configuring backups Symptoms After configuring or making an adjustment to the backups on the machine, all the... Receiving permission error when using a CIFS mount for backups Symptoms A backup or restore job may fail with similar permission errors: /bin/cp: failed to... Remote backup transport using incremental backups Question Can I use "Incremental" Backup Type when using an additional remote destination to... Restoring a backup in-place results in duplicate Mailman data Symptoms After restoring a full account backup in-place using tools like the "Transfer or... Restoring a backup with a new username retains the old database prefix Symptoms After restoring a backup using /scripts/restorepkg --newuser, the databases for... Should I use "incremental" or "compressed" backups? Question Should I use "incremental" or "compressed" backups?   Answer The cPanel Backup... Some S3 Compatible services use a custom region not on the AWS regions list, causing backup validation failures. Symptoms Attempting to validate an S3 Compatible Additional Destination in Backup Configuration... Successful account backups do not contain their databases Symptoms   You may see that an account's backups do not contain the databases used by the... Unable to restore from backup: "Failed to extract the archive" Symptoms When attempting to restore an account from a tar file, either from the command line or... Unable to restore terminated accounts with staged WP Squared domains Symptoms Attempting to restore a backup of a terminated account on WP Squared returns a... Unable to send backup to destination There might be a time we come across specific issues with backups being unable to be moved to... Using SCP Introduction   Occasionally you will need to retrieve files that are located outside of a... Validating a remote SFTP backup destination results in: "Cpanel::FileUtils::Permissions::String::str2oct" was given an invalid permissions string Symptoms   You may receive the following error when validating a remote SFTP backup... WHM Backup error: “mysqldump: Got error: 1049: Unknown database“ Symptoms The following error is received during WHM backups: The backup process encountered the... What is jetmongod? I received a failure notification for jetmongod. What is this service? Answer jetmongod is the... What is the meaning of the "/bin/gtar: /var/run/program/sock: socket ignored" warning message mean? Question     What is the meaning of the "/bin/gtar: /var/run/program/sock: socket ignored"... What is the metadata for backups? Question When I run backups, I see cPanel creates metadata for backups. What is this for?... What operating systems does JetBackup support? Question   What operating systems do JetBackup 4 and JetBackup 5 support?   Answer... What type of remote Backup Destination are there when using the cPanel account interface? Question What type of remote Backup Destination are available inside the cPanel interface for... When does JetBackup's daily cleanup occur? Question When does JetBackup's daily cleanup occur?   Answer JetBackup has a daily cleanup... Where are Local Backups Stored? Question Where are backups stored on the server? In which directory can I find the local files... Where are the JetBackup logs? Question Where can I find JetBackup logs?   Answer The JetBackup system logs are stored in... Where are the backup configuration files for remote destinations? Question Where are the cPanel backup configuration files located?   Answer cPanel places the... Where are the cPanel Backup logs? Question Where are the cPanel Backup logs?   Answer The backup logs are located in... Where can I configure account and system files backups? Question Where can I configure account and system file backups?   Answer Account and system... Why am I receiving an error during a JetBackup restoration referencing "lve_suwrapper" and "Cannot allocate memory"? Question   Why am I receiving an error during a JetBackup restoration referencing... Why am I receiving multiple user Download Notifications from JetBackup? Question Why am I receiving multiple user Download Notifications from JetBackup?   Answer If... Why are backups kept locally after transferring to my remote backup destination? Question   Why are backups kept locally after transferring to my remote backup destination?... Why are my backups not showing in the "Backup Restoration" interface of WHM? Question Why are my backups not showing in the "Backup Restoration" interface of WHM?   Answer... Why are my system backups not being transported to my additional backup destination? Question Why are my cPanel system backups not being automatically transported to my additional... Why are uncompressed backups stored as .tar files? Question Why are uncompressed backups stored as .tar files?   Answer When the... Why do I have more backups than I set in my backup retention settings? Question Why do I have more backups than I set in my backup retention settings? Why aren't they... Why is Google Drive missing from Jetbackup 5? Question You may have recently upgraded from Jetbackup 4 to Jetbackup 5 and found that some... Why is my additional backup destination disabled? Question   Why is my additional backup destination disabled?   Answer   Additional backup... Why is the WHM Backup Configuration showing banner to purchase JetBackup while the license for JetBackup is already active? Question After purchasing JetBackup and activating the license, WHM Backup Configuration shows... Why won't cPanel delete ( prune ) old backups? - Why is my backup retention setting not enforced? Question The following are the same questions, just phrased differently: Why won't cPanel... Will a Backup Process pause/suspend when a Backup is being moved by Additional Destinations? Question Will a backup process pause or be suspended when a backup is being moved by additional... Will restoring a backup remove or overwrite any files that already exist in an account? Question Will restoring a backup remove or overwrite any files that already exist in an account?... You may not have more than 0 of the resource “addon domains”. Introduction When you are attempting to restore a backup, you might experience the following... [Jetbackup] dumping PostgreSQL may fail - FATAL: no pg_hba.conf entry for host "::1" Symptoms   In some cases, Jetbackup might fail to backup PostgreSQL databases with the... [cpbackup_transporter] Failed with 403: Forbidden Symptoms You may notice the following error when attempting to transfer a backup to a Google... cPanel Backup/Restoration Compatibility Question Are there any compatibility issues with the cPanel full restoration process between... cPanel interface gives a "backup already in progress" error Symptoms You may receive the following error when you try and perform a backup through the... cPanel user-backups seem to disappear after completing Symptoms Creating a user backup via the cPanel interface "cPanel / Backup" or the API results in... mysqldump: Couldn't execute 'show fields from `table`': Incorrect file format error during backup Symptoms You may come across the following errors during backup: The backup process encountered... whmapi1 backup_destination_validate always validates true Symptoms The whmapi1 backup_destination_validate call always returns true (valid)... Blackblaze Destination type missing from JetBackup configuration Symptoms When configuring JetBackup, the Blackblaze Destination type is not available.... Can you directly upgrade from Jetbackup 4 to Jetbackup 5? Question Can you directly upgrade from Jetbackup 4 to Jetbackup 5?   Answer This is not... How can i remove backups from jetbackup? Question How can I remove backups from jet backup?  Is it possible to remove backups manually?... How to change backup retention copies Introduction You may find that the configured backup retention causes the backups to... How to use the restorepkg script Introduction Restorepkg is the command-line utility used to restore cPanel backups. This... Manually Adding Absolute Path To /var/cpanel/backups/*.backup_destination Makes "WHM > Backups > BackUp Configuration > Additional Destinations > Edit" Interface Uneditable Symptoms:    The backup destination configuration files in... Where can I configure cPanel backups? Question Where can I configure cPanel backups?   Answer Backups are configured with the... Why are my system backups not being transported to my additional backup destination? Question Why are my cPanel system backups not being automatically transported to my additional... Will a Backup Process pause/suspend when a Backup is being moved by Additional Destinations? Question Will a backup process pause or be suspended when a backup is being moved by additional...