Knowledgebase
Backup System Migration Print this Article
The Backup System Migration interface only appears when backups exist under the legacy backup configuration. We strongly recommend the following actions:
-
Set up and only use the Backup Configuration interface (WHM >> Home >> Backup >> 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.
Overview:
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 9999.
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 the1234567891234value represents the number of seconds, in Unix epoch time.
- The new Legacy Backup configuration filename resembles the filename format
Was this answer helpful?
Related Articles
Overview: The Backup Configuration interface allows system administrators to customize their...
Overview: This interface restores cPanel accounts from local backups or backups on a remote FTP...
Overview: The Backup User Selection interface allows you to exclude user accounts from your...
Overview: Important: To use this feature, you must enable account backups in WHM’s Backup...
Overview: Warning: We removed this interface in cPanel & WHM version 90. Use WHM’s...
