{"id":241,"date":"2021-07-23T12:26:19","date_gmt":"2021-07-23T12:26:19","guid":{"rendered":"https:\/\/ssdsunucum.com\/blog\/system-backups\/"},"modified":"2021-07-23T12:26:19","modified_gmt":"2021-07-23T12:26:19","slug":"system-backups","status":"publish","type":"post","link":"https:\/\/ssdsunucum.com\/blog\/system-backups\/","title":{"rendered":"System Backups"},"content":{"rendered":"<\/p>\n
\n
\n
\n

Valid for versions 90 through the latest version<\/em><\/p>\n<\/div>\n

\n

Version:<\/h4>\n

82<\/h4>\n

86<\/h4>\n

88<\/h4>\n

90<\/h4>\n<\/div><\/div>\n
\n

Overview<\/h2>\n

If you enable system backups, your server saves system backup files in the local backup directory (\/var\/cpanel\/backup<\/code>) by default. You can also save system backup files to an additional destination. You can do this manually, via API, or via WHM\u2019s Backup Configuration<\/em> interface (WHM >> Home >> Backup >> Backup Configuration<\/em>).<\/p>\n

The \/usr\/local\/cpanel\/bin\/backup<\/code> script uploads a .tar<\/code> file that contains all of the system backup files to each destination that you configure to receive system backups. The system only<\/strong> sends system backup files to destinations whose files contain a upload_system_backup<\/code> value of 1<\/code> (enabled).<\/p>\n

\n
Note:<\/div>\n
\n
    \n
  • cPanel & WHM does not<\/strong> include an interface to restore system backup files. To restore content from system backup files, you must<\/strong> perform the restoration manually.<\/li>\n
  • The additional destination configuration file uses YAML format, which contains a simple associative array.<\/li>\n
  • For security purposes, ensure that the destination server is on your secure network. If your backups will not<\/strong> transfer to a server on your secure network, use a secure method such as SFTP, Amazon S3\u2122, or WebDAV with SSL.<\/li>\n<\/ul><\/div>\n<\/div>\n

    How to enable system backup file saves<\/h2>\n

    To enable system backup file saves, you can perform one of the following actions:<\/p>\n

      \n
    • \n

      Select the Back up System Files<\/em> checkbox in the Backup Settings<\/em> tab in WHM\u2019s Backup Configuration<\/em> interface (WHM >> Home >> Backup >> Backup Configuration<\/em>).<\/p>\n<\/li>\n

    • \n

      Use the WHM API 1 backup_config_set<\/code> function and set the backupfiles<\/code> value to 1<\/code>.<\/p>\n<\/li>\n<\/ul>\n

      System backup files and directories<\/h2>\n
      \n
      Important:<\/div>\n
      \n

      The server backs up DNSSEC databases as part of the system files backup. The system can corrupt the DNSSEC database if it encounters an Out Of Memory (OOM) or disk full condition. The system administrator can also corrupt this database inadvertently.<\/p>\n

      The system administrator can restore the database from the system backup files. If they do not<\/strong> back up system files, they will need to perform the following steps:<\/p>\n

        \n
      • Rebuild the PDNS.db<\/code> file from scratch.<\/li>\n
      • Regenerate the DNSSEC keys for each domain that lost its DNSSEC key.<\/li>\n
      • Tell users to register the new<\/strong> DNSSEC keys with their domain registrar.<\/li>\n<\/ul><\/div>\n<\/div>\n

        cPanel & WHM backs up the following files and directories:<\/p>\n

        Files<\/h3>\n
          \n
        • \/etc\/exim.conf<\/code><\/li>\n
        • \/etc\/exim.conf.local<\/code><\/li>\n
        • \/etc\/exim.conf.localopts<\/code><\/li>\n
        • \/etc\/named.conf<\/code><\/li>\n
        • \/etc\/named.conf<\/code><\/li>\n
        • \/etc\/proftpd.conf<\/code><\/li>\n
        • \/etc\/pure-ftpd.conf<\/code><\/li>\n
        • \/etc\/localdomains<\/code><\/li>\n
        • \/etc\/apache2\/conf\/httpd.conf<\/code><\/li>\n
        • \/etc\/group<\/code><\/li>\n
        • \/etc\/shadow<\/code><\/li>\n
        • \/etc\/passwd<\/code><\/li>\n
        • \/etc\/fstab<\/code><\/li>\n
        • \/etc\/ips<\/code><\/li>\n
        • \/etc\/ips.remotemail<\/code><\/li>\n
        • \/etc\/ips.remotedns<\/code><\/li>\n
        • \/etc\/manualmx<\/code><\/li>\n
        • \/etc\/reservedips<\/code><\/li>\n
        • \/etc\/reservedipreasons<\/code><\/li>\n
        • \/etc\/wwwacct.conf<\/code><\/li>\n
        • \/etc\/remotedomains<\/code><\/li>\n
        • \/etc\/rndc.conf<\/code><\/li>\n
        • \/etc\/secondarymx<\/code><\/li>\n
        • \/etc\/my.cnf<\/code><\/li>\n
        • \/root\/.my.cnf<\/code><\/li>\n
        • \/etc\/apache2\/conf\/httpd.conf<\/code><\/li>\n<\/ul>\n

          Directories<\/h3>\n
            \n
          • \/etc\/cpanel<\/code><\/li>\n
          • \/etc\/named<\/code><\/li>\n
          • \/etc\/valiases<\/code><\/li>\n
          • \/etc\/proftpd<\/code><\/li>\n
          • \/etc\/vdomainaliases<\/code><\/li>\n
          • \/etc\/ssl<\/code><\/li>\n
          • \/etc\/vfilters<\/code><\/li>\n
          • \/usr\/local\/cpanel\/3rdparty\/mailman<\/code><\/li>\n
          • \/var\/lib\/rpm<\/code><\/li>\n
          • \/var\/named<\/code><\/li>\n
          • \/var\/cpanel<\/code><\/li>\n
          • \/var\/spool\/cron<\/code><\/li>\n
          • \/var\/cpanel\/bandwidth<\/code><\/li>\n
          • \/var\/cpanel\/ssl<\/code><\/li>\n
          • \/var\/lib\/mysql<\/code><\/li>\n
          • \/etc\/pki\/tls\/certs\/<\/code><\/li>\n<\/ul>\n

            Custom files<\/h2>\n

            To configure system backups to include custom files or directories, create a new file or directory in the \/var\/cpanel\/backups\/extras<\/code> directory (for example, \/var\/cpanel\/backups\/extras\/etc<\/code>). In that file, enter an absolute path to any files that you wish to back up (for example, \/etc\/example.conf<\/code>).<\/p>\n

            \n
            Note:<\/div>\n
            \n

            The server administrator can edit the \/etc\/my.cnf<\/code> file to change the MySQL\u00ae data directory location. The system will back up the directory at its new location.<\/p>\n<\/p><\/div>\n<\/div>\n

            How to configure an additional destination to receive system backups<\/h2>\n

            To configure an additional destination to receive system backups, perform one of the following procedures:<\/p>\n

            Interface method<\/h3>\n

            In WHM\u2019s Backup Configuration<\/em> interface, select the Additional Destinations<\/em> tab and enter the additional destination\u2019s information.<\/p>\n

            \n
            Important:<\/div>\n
            \n

            Make certain that you select the Transfer System Backups to this Destination<\/em> checkbox.<\/p>\n<\/p><\/div>\n<\/div>\n

            Manual configuration method<\/h3>\n

            To manually modify the configuration file of an additional destination, perform the following steps:<\/p>\n

              \n
            1. Identify the configuration file in the \/var\/cpanel\/backups<\/code> directory.\n
                \n
              • Each destination requires its own configuration file.<\/li>\n
              • The file name contains the destination name, the User ID (UID) label, and a UID character string. For example:\n
                \n
                myftp_UID_Z6rdq0rko2Z28uWTIN33SeCY.backup_destination<\/code><\/pre>\n<\/div>\n
                \n
                Note:<\/div>\n
                \n
                The UID sequence prevents conflicts with previously-created destinations that share the same name.<\/p>\n<\/p><\/div>\n<\/div>\n<\/li>\n<\/ul>\n<\/li>\n
              • Open the file with a text editor and add the following line:\n
                \n
                upload_system_backup: 1<\/span><\/code><\/pre>\n<\/div>\n<\/li>\n
              • Save the file.<\/li>\n<\/ol>\n
                API call method<\/h3>\n
                To use API calls to modify the configuration file of an additional destination, perform the following steps:<\/p>\n
                  \n
                1. Call the WHM API 1 backup_destination_list<\/code> function to retrieve the ID of the additional destination to which you wish to send system backups.<\/li>\n
                2. Call the WHM API 1 backup_destination_set<\/code> function and include the following parameters and values:\n
                    \n
                  • id<\/code> \u2014 The ID that the backup_destination_list<\/code> function returned.<\/li>\n
                  • upload_system_backup<\/code> \u2014 1<\/code><\/li>\n<\/ul>\n<\/li>\n<\/ol>\n
                    Log files<\/h2>\n
                    The system\u2019s backup initialization logs to the \/usr\/local\/cpanel\/logs\/error_log<\/code> file. The error_log<\/code> file points to the individual account package logs. For more information, read our cPanel & WHM Log Files documentation.<\/p>\n<\/p><\/div>\n","protected":false},"excerpt":{"rendered":"
                    Valid for versions 90 through the latest version Version: 82 86 88 90 Overview If you enable system backups, your server saves system backup files in the local backup directory (\/var\/cpanel\/backup) by default. You can also save system backup files to an additional destination. You can do this manually, via API, or via WHM\u2019s Backup …<\/p>\n","protected":false},"author":1,"featured_media":242,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":[],"categories":[1],"tags":[],"amp_enabled":true,"_links":{"self":[{"href":"https:\/\/ssdsunucum.com\/blog\/wp-json\/wp\/v2\/posts\/241"}],"collection":[{"href":"https:\/\/ssdsunucum.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/ssdsunucum.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/ssdsunucum.com\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/ssdsunucum.com\/blog\/wp-json\/wp\/v2\/comments?post=241"}],"version-history":[{"count":0,"href":"https:\/\/ssdsunucum.com\/blog\/wp-json\/wp\/v2\/posts\/241\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/ssdsunucum.com\/blog\/wp-json\/wp\/v2\/media\/242"}],"wp:attachment":[{"href":"https:\/\/ssdsunucum.com\/blog\/wp-json\/wp\/v2\/media?parent=241"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/ssdsunucum.com\/blog\/wp-json\/wp\/v2\/categories?post=241"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/ssdsunucum.com\/blog\/wp-json\/wp\/v2\/tags?post=241"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}