For cPanel & WHM version 68
(WHM >> Home >> Backup >> Backup System Migration)
The Backup System Migration interface only appears when backups exist under the legacy backup configuration. We strongly recommend the following actions:
That you set up and only use the Backup Configuration interface (WHM >> Home >> Backups >> Backup Configuration) to configure your server backups.
- After you complete the above step, use the Backup System Migration interface to migrate existing legacy backups to the Backup system.
For additional information about backup configurations, read our Backup Configuration documentation.
The Backup System Migration interface automatically converts and migrates any Legacy Backup system files to the current Backup system. The Backup system offers the same features as the Legacy Backup system and increases efficiency and performance for your system.
We implemented the Backup System Migration interface in cPanel & WHM version 64. We plan to remove the Legacy Backup Configuration interface (WHM >> Home >> Backup >> Backup Configuration) from WHM in a future release.
Backup system conversion
To convert and migrate your Legacy Backup system files to the Backup system, click Migrate.
The Legacy Backup system only allows you to retain one retention point for incremental backups. The Backup system grants multiple retention points for incremental backups. When you migrate to the Backup system, you must update your retention point value in the Backup Configuration interface (WHM >> Home >> Backup >> Backup Configuration) or you will lose your existing backup. You can set this value in the Retention box under the Scheduling and Retention section in WHM's Backup Configuration interface (WHM >> Home >> Backup >> Backup Configuration).
If you wish to use the maximum number of retention points, set your retention point value to
The system performs the following actions when you click Migrate:
- The conversion and migration process creates the new
/var/cpanel/backups/configfile for the Backup system. This file duplicates the existing Legacy Backup configuration.
After the system converts the Legacy Backup system files to the Backup system files, the system renames the Legacy Backup configuration file.
The new Legacy Backup configuration filename resembles the filename format
/etc/cpbackup.conf-1234567891234, where the
1234567891234value represents the number of seconds, in Unix epoch time.
/backup directory structure
MultiExcerpt named 'Backup Directory Structure' was not found The page: The backups_create_metadata script was found, but the multiexcerpt named 'Backup Directory Structure' was not found. Please check/update the page name used in the 'multiexcerpt-include macro.