Legacy Backup FAQ
What are my backup options?
You have two backup options. You can use the Legacy Backup Configuration
feature in WHM (Home >> Backup >> Legacy Backup Configuration
), or the Backup Configuration
feature in WHM (Home >> Backup >> Backup Configuration
). Both interfaces allow you to configure how automatic backups will run on your server.
This FAQ focuses on the Legacy Backup Configuration
What is stored up in a backup?
By default, backups only include system files and directories. When account backups are enabled, the account's home directory contents, databases, email filters and forwarders, and DNS records are copied and stored. You can enable account backups with the Backup Accounts
option on the Legacy Backup Configuration
Which files are included in a cPanel user's backup?
After you enable account backups, the backup process runs as the cPanel user whose data is backed up. Anything a user cannot access is not
- All of the files owned by the user are included in the backup.
- Files the user does not own but has access to are included in the backup.
- Files the user does not own and cannot access are not included in the backup — even if they are stored in the user's home directory.
Can I control which users' accounts are backed up?
Yes. You can use the Select Specific Users
option in the Legacy Configure Backup
interface to select specific users:
- Click the Select >> button.
- Under the column titled Legacy, click the button so that it says On.
- Click the Save button.
How are DNS zones handled?
This depends on which version of cPanel/WHM you're running.
In cPanel & WHM version 11.25 or earlier, the account's local DNS information is stored. In some cases, this may publicize outdated DNS information whenever the account is restored.
With a DNS ONLY cluster in cPanel & WHM version 11.27+, the
script will examine all of the DNS zones in the DNS cluster to find the record with the newest serial number. It will then store that DNS zone in the backup.
How can I use rsync with a cPanel backup?
We do not
support a backup procedure that uses rsync. While it is possible to use rsync with cPanel backups, we strongly
recommend that you use our tools to ensure reliable backups. Under certain conditions, rsync may corrupt SQL database backups.
Which scripts run backups?
The main scripts that run backups are:
Where can I find backup logs?
You can find backup logs in the
Where are backups stored?
Use the Legacy Backup Configuration feature
(Main >> Backup >> Legacy Backup Configuration
) to select the location where you want to store backups:
- Access the Legacy Backup Configuration feature (Main >> Backup >> Legacy Backup Configuration) from your WHM interface.
- Scroll down until you see the Backup Destination configuration option.
- Enter the location where you would like to store the backups in the text box next to the Backup Destination option.
- Note: You should use a directory, network filesystem, or coda mount with at least twice the space of your
/home directories or partitions. You should not set this value to your
/home directory or partition.
- Click Save to save your changes.
What gets backed up when I select configuration files? Where can I find the backups?
If configuration files are set to be backed up, they will be automatically stored in directories called
. When the entire MySQL directory is backed up, it can be found in the
The following directories are backed up into
The following files are backed up into
I want to run backups on a mounted filesystem. Can I do this?
If you use a mounted filesystem to store backups, we strongly
recommend that you mount the system with the
option. If you pass the
, you will prevent binaries from running on the mounted filesystem.
You can configure a filesystem to use
by default whenever it is mounted. To do so, you will need to edit the
file. This file contains a list of filesystems that can be mounted on your system. To configure a mountable filesystem that will automatically use
, you'll need to edit its entry in the
file to reflect the following:
nfs /path/to/nfs ext3 defaults,noexec 0 0
The example above describes the following configuration options:
|| Default Mount Point
|| Filesystem Type
|| Mount Options
|| Dump Option
|| fsck Order
How does cPanel & WHM determine when to run backups?
If you run
- cPanel & WHM creates a monthly backup if the existing monthly backups are more than 29 days old.
- cPanel & WHM creates a weekly backup if the existing weekly backups are more than 6 days old.
- cPanel & WHM creates a daily backup if the existing daily backups are more than 12 hours old.
- Note: If backups take more than 12 hours to run, they will skip a day.
Can I manually edit my backup schedule?
Automatic backups are run by a cronjob. This cronjob is not overwritten by
, so you can edit the crontab to control when backups will run. You can do this via SSH as
My backup partition is locked and will not unmount itself. How do I fix this?
There is a known incompatibility when cPanel runs on CloudLinux under Centos 5.X. After a nightly backup runs or a restore runs, the backup partition will get stuck in an active lock. The next time you perform a backup or a restore, you will see an error similar to the following:
[backupmount] Cannot umount: /backup. This mountpoint is still in use and has an active lock
mount: /dev/sdb1 already mounted or /backup busymount: according to mtab, /dev/sdb1 is already mounted on /backup
To resolve this, you will need to perform the following commands as
mount -r /backup
mount -o remount,rw /backup