{"id":658,"date":"2021-07-23T12:34:58","date_gmt":"2021-07-23T12:34:58","guid":{"rendered":"https:\/\/ssdsunucum.com\/blog\/full-disaster-recovery\/"},"modified":"2021-07-23T12:34:58","modified_gmt":"2021-07-23T12:34:58","slug":"full-disaster-recovery","status":"publish","type":"post","link":"https:\/\/ssdsunucum.com\/blog\/full-disaster-recovery\/","title":{"rendered":"Full Disaster Recovery"},"content":{"rendered":"<\/p>\n
\n
\n
\n

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

\n

Version:<\/h4>\n

82<\/h4>\n

94<\/h4>\n<\/div><\/div>\n
\n

Overview<\/h2>\n
\n
Warning:<\/div>\n
\n
    \n
  • Only<\/strong> experienced system administrators should use the procedures in this document.<\/li>\n
  • cPanel, L.L.C. cannot<\/strong> support failed hard drives or hard drive recovery. We are not<\/strong> responsible for any data loss.<\/li>\n<\/ul><\/div>\n<\/div>\n

    In some circumstances, you may need to completely restore your server from a crashed or failed hard drive.<\/p>\n

    Prepare to restore your server<\/h2>\n

    If you have recent remote backups and can\u2019t boot the failed hard drive, you can proceed to rebuilding your server.<\/p>\n

    \n
    Warning:<\/div>\n
    \n

    If you don\u2019t have recent remote backups, we strongly recommend that you rework your backup strategy to store regularly-scheduled backups in a remote location.<\/p>\n<\/p><\/div>\n<\/div>\n

    If you don\u2019t<\/strong> have recent remote backups but can<\/strong> boot the failed hard drive, perform one of the following actions:<\/p>\n

      \n
    • If you can<\/strong> access WHM from the failed hard drive, create a backup with WHM\u2019s Backup Configuration<\/em> interface (WHM >> Home >> Backup >> Backup Configuration<\/em>).<\/li>\n
    • If you can\u2019t<\/strong> access WHM from the failed hard drive, run the \/usr\/local\/cpanel\/scripts\/pkgacct<\/code> script.<\/li>\n<\/ul>\n

      After you complete the backup procedure, transfer the backup files to a remote location.<\/p>\n

      Rebuild the server<\/h2>\n

      Some data centers and hosting providers offer system restoration and imaging. Contact your hosting provider for more information.<\/p>\n

      \n
      Important:<\/div>\n
      \n
        \n
      • The replacement cPanel & WHM server should contain identical software to the original server. This includes MySQL\u00ae or MariaDB\u00ae, PHP, PHP extensions, Apache\u00ae, Apache extensions, and other software options. If you do not use the same version of MySQL or MariaDB on the new server, you may encounter serious errors.<\/li>\n
      • If you wish to update any of the software on the server, we strongly<\/strong> recommend that you perform the transfer or restoration first and then perform any updates.<\/li>\n<\/ul><\/div>\n<\/div>\n

        Manually provision the new hard drive<\/h3>\n
        \n
        Important:<\/div>\n
        \n
          \n
        • If you use an ISO, get it from the operating system\u2019s official mirrors. Third-party drive images may cause unexpected problems.<\/li>\n
        • If you use CentOS, we strongly<\/strong> recommend that you use the CentOS Minimal ISO.<\/li>\n<\/ul><\/div>\n<\/div>\n

          To manually provision the new hard drive, perform the following steps:<\/p>\n

            \n
          1. Install a new hard drive as the primary hard drive and make the old hard drive the secondary hard drive.<\/li>\n
          2. Install the operating system. For more information, read our Installation Guide documentation.<\/li>\n
          3. Install cPanel & WHM with the following commands:\n
            \n
            \n\n\n
            \n
            1\n<\/span>2\n<\/span>3\n<\/span><\/code><\/pre>\n<\/td>\n
            		\n
            cd \/home\ncurl -o latest -L https:\/\/securedownloads.cpanel.net\/latest\nsh latest<\/code><\/pre>\n<\/td>\n<\/tr>\n<\/table>\n<\/div>\n<\/div>\n<\/li>\n<\/ol>\n
            Request a new hard drive and image<\/h3>\n
            Make sure to request that the data center installs your old hard drive as a secondary drive. After they finish this, perform one of the following actions to update cPanel & WHM to the latest version:<\/p>\n
              \n
            • Run the \/usr\/local\/cpanel\/scripts\/upcp<\/code> script.<\/li>\n
            • Use WHM\u2019s Upgrade to Latest Version<\/em> interface (WHM >> Home >> cPanel >> Upgrade to Latest Version<\/em>).<\/li>\n<\/ul>\n
              Recover your files<\/h2>\n
              If you don\u2019t have a recent remote backup and can\u2019t boot the failed hard drive on your server, you can proceed to restoring your files.<\/p>\n
              In all other scenarios, perform the following steps as the root<\/code> user to recover your files:<\/p>\n
                \n
              1. Mount the secondary drive in a chroot<\/code> environment. To do this, run the following commands, where sdb1<\/code> represents the device name of your secondary drive:\n
                \n
                \n\n\n
                \n
                1\n<\/span>2\n<\/span><\/code><\/pre>\n<\/td>\n
                		\n
                mkdir \/mnt\/chroot\/\nmount \/dev\/sdb1 \/mnt\/chroot\/<\/code><\/pre>\n<\/td>\n<\/tr>\n<\/table>\n<\/div>\n<\/div>\n
                \n
                Important:<\/div>\n
                \n
                You must<\/strong> mount the drive and partitions before you can bind mount the filesystems.<\/p>\n<\/p><\/div>\n<\/div>\n<\/li>\n
              2. Mount the proc<\/code>, dev<\/code>, and sys<\/code> filesystems in a chroot<\/code> environment. To do this, run the following commands:\n
                \n
                \n\n\n
                \n
                1\n<\/span>2\n<\/span>3\n<\/span><\/code><\/pre>\n<\/td>\n
                		\n
                mount --bind \/proc \/mnt\/chroot\/proc\nmount --rbind \/dev \/mnt\/chroot\/dev\nmount --bind \/sys \/mnt\/chroot\/sys<\/code><\/pre>\n<\/td>\n<\/tr>\n<\/table>\n<\/div>\n<\/div>\n
                \n
                Note:<\/div>\n
                \n
                We use the rbind<\/code> command instead of the bind<\/code> command for the dev<\/code> directory in order to ensure that we mount the \/dev\/pts<\/code> partition properly.<\/p>\n<\/p><\/div>\n<\/div>\n<\/li>\n
              3. Run the grep chroot \/etc\/mtab<\/code> command to verify that the system properly mounted each filesystem. Your results should resemble the following output:\n
                \n
                \n\n\n
                \n
                1\n<\/span>2\n<\/span>3\n<\/span>4\n<\/span><\/code><\/pre>\n<\/td>\n
                		\n
                \/dev\/sdb1 \/mnt\/chroot none rw,bind 0<\/span> 0<\/span>\n\/mnt\/chroot\/proc \/proc none rw,bind 0<\/span> 0<\/span>\n\/mnt\/chroot\/dev \/dev none rw,bind 0<\/span> 0<\/span>\n\/mnt\/chroot\/sys \/sys none rw,bind 0<\/span> 0<\/span><\/code><\/pre>\n<\/td>\n<\/tr>\n<\/table>\n<\/div>\n<\/div>\n<\/li>\n
              4. Run the screen<\/code> command to start a screen<\/code> session. This lets you use the chroot<\/code> environment in a session that you can reconnect to if you lose your connection. Disconnections from sessions with chroot<\/code> environments can cause problems for services such as MySQL, which may experience InnoDB issues.<\/li>\n
              5. Run the following commands to let the system perform as if you booted into the crashed drive:\n
                \n
                \n\n\n
                \n
                1\n<\/span>2\n<\/span><\/code><\/pre>\n<\/td>\n
                		\n
                chroot \/mnt\/chroot \/bin\/bash -l\nexport PS1=<\/span>\"{chrooted}<\/span>$PS1\"<\/span><\/code><\/pre>\n<\/td>\n<\/tr>\n<\/table>\n<\/div>\n<\/div>\n
                Your results should resemble the following output:<\/p>\n
                \n
                {<\/span>chrooted}<\/span>bash-4.1#<\/code><\/pre>\n<\/div>\n<\/li>\n
              6. Run the source \/etc\/environment && source \/etc\/profile<\/code> command to recover the cPanel & WHM environment.<\/li>\n
              7. To start required services from the old hard drive, run the necessary commands to start any services that the \/usr\/local\/cpanel\/scripts\/pkgacct<\/code> script will require. For example, you will need the MySQL service for Webmail databases, or the PostgreSQL\u00ae service if you use that database service.\n
                  \n
                • If your server runs CentOS 6, run the following command:\n
                  \n
                  service mysql start<\/code><\/pre>\n<\/div>\n<\/li>\n
                • If your server runs CentOS 7 or 8, run the following command:\n
                  \n
                  test -f \/etc\/sysconfig\/mysql &&<\/span> source \/etc\/sysconfig\/mysql; \/usr\/sbin\/mysqld --daemonize --user=<\/span>mysql --pid-file=<\/span>\/var\/run\/mysqld\/mysqld.pid ${<\/span>MYSQLD_OPTS}<\/span><\/code><\/pre>\n<\/div>\n<\/li>\n<\/ul>\n<\/li>\n
                • To start dnsadmin<\/code>, run the following command:\n
                  \n
                  \/usr\/local\/cpanel\/libexec\/dnsadmin-startup --start<\/code><\/pre>\n<\/div>\n<\/li>\n
                • To back up accounts from the old hard drive, run the following commands. These commands store the backups in the \/mnt\/chroot\/home<\/code> directory and also stores the feature lists and packages settings:\n
                  \n
                  \n\n\n
                  \n
                  1\n<\/span>2\n<\/span><\/code><\/pre>\n<\/td>\n
                  		\n
                  cd \/var\/cpanel\/users\nfor<\/span> i in `<\/span>ls -1 *`<\/span>; do<\/span> \/scripts\/pkgacct --skipdnszones $i; done<\/span><\/code><\/pre>\n<\/td>\n<\/tr>\n<\/table>\n<\/div>\n<\/div>\n
                  \n
                  Warning:<\/div>\n
                  \n
                  We strongly<\/strong> recommend that you do not<\/strong> use the rsync<\/code> command to back up accounts. This may cause issues with services such as MySQL.<\/p>\n<\/p><\/div>\n<\/div>\n<\/li>\n
                • To back up service configurations from the old hard drive, run the following commands:\n
                  \n
                  \n\n\n
                  \n
                  1\n<\/span>2\n<\/span><\/code><\/pre>\n<\/td>\n
                  		\n
                  cd \/usr\/local\/cpanel\nbin\/cpconftool --modules=<\/span>cpanel::smtp::exim,cpanel::system::backups,cpanel::system::mysql,cpanel::system::whmconf,cpanel::easy::apache,cpanel::ui::themes --backup<\/code><\/pre>\n<\/td>\n<\/tr>\n<\/table>\n<\/div>\n<\/div>\n
                  The results will resemble the following output:<\/p>\n
                  \n
                  \n\n\n
                  \n
                  1\n<\/span>2\n<\/span><\/code><\/pre>\n<\/td>\n
                  		\n
                  Backup Successful\n\/home\/whm-config-backup-configuration__to__backup-10.550000-1452006507.tar.gz<\/code><\/pre>\n<\/td>\n<\/tr>\n<\/table>\n<\/div>\n<\/div>\n<\/li>\n
                • Transfer backup files to remote storage. Use the scp<\/code> command or the rsync<\/code> command to copy the files to a remote storage location.\n
                  \n
                  Important:<\/div>\n
                  \n
                  You can directly transfer the files from the old hard drive to the new hard drive. However, we strongly<\/strong> recommend that you transfer them to a remote location first. This protects your backup files from hardware issues that may have caused the hard drive to fail.<\/p>\n<\/p><\/div>\n<\/div>\n<\/li>\n
                • Run the following commands to stop all services in the chroot<\/code> environment, unmount the filesystems, and exit the chroot<\/code> environment:\n
                  \n
                  \n\n\n
                  \n
                  1\n<\/span>2\n<\/span>3\n<\/span><\/code><\/pre>\n<\/td>\n
                  		\n
                  service mysql stop\numount {<\/span>\/proc,\/dev,\/sys}<\/span>\nexit<\/code><\/pre>\n<\/td>\n<\/tr>\n<\/table>\n<\/div>\n<\/div>\n<\/li>\n
                • To close the screen<\/code> session, run the exit<\/code> command.<\/li>\n<\/ol>\n
                  Restore your files<\/h2>\n
                  To restore the content from the backup files to your new hard drive in the server, perform the following steps as the root<\/code> user:<\/p>\n
                    \n
                  1. Run the scp<\/code> command or the rsync<\/code> command to copy the files from the remote location to the new hard drive.<\/li>\n
                  2. To restore feature lists to the server, run the following commands:\n
                    \n
                    \n\n\n
                    \n
                    1\n<\/span>2\n<\/span><\/code><\/pre>\n<\/td>\n
                    		\n
                    cd \/backups\ntar -xzvf _var_cpanel.tar.gz var\/cpanel\/features tar -xzvf _var_cpanel.tar.gz var\/cpanel\/features<\/code><\/pre>\n<\/td>\n<\/tr>\n<\/table>\n<\/div>\n<\/div>\n<\/li>\n
                  3. To restore accounts to the server, run the following commands, where BACKUPDIRECTORY\/TYPE\/DATE\/<\/code> represents your backup directory:\n
                    \n
                    \n\n\n
                    \n
                    1\n<\/span>2\n<\/span><\/code><\/pre>\n<\/td>\n
                    		\n
                    cd BACKUPDIRECTORY\/TYPE\/DATE\/accounts\/\nfor<\/span> archive in `<\/span>ls`<\/span>; do<\/span> \/scripts\/restorepkg $archive; done<\/span><\/code><\/pre>\n<\/td>\n<\/tr>\n<\/table>\n<\/div>\n<\/div>\n
                    \n
                    More:<\/div>\n
                    \n
                    For more information, read our The restorepkg<\/code> Script documentation.<\/p>\n<\/p><\/div>\n<\/div>\n<\/li>\n
                  4. Run the \/usr\/local\/cpanel\/bin\/cpconftool<\/code> script to restore the configuration settings for Apache, backups, cPanel themes, Exim, MySQL, and WHM to the server.<\/li>\n
                  5. If you run CloudLinux\u2122, restore CloudLinux settings to the server.<\/li>\n<\/ol>\n
                    Test the server<\/h2>\n
                    Test the websites, applications, and services on the new server. Make certain that you have successfully restored the server\u2019s data and configuration.<\/p>\n
                    Reconnect to a screen session<\/h2>\n
                    To reconnect to a screen<\/code> session, perform the following steps as the root<\/code> user:<\/p>\n
                      \n
                    1. Run the screen -ls<\/code> command to list your active sessions. Your results should resemble the following output:\n
                      \n
                      \n\n\n
                      \n
                      1\n<\/span>2\n<\/span>3\n<\/span>4\n<\/span><\/code><\/pre>\n<\/td>\n
                      		\n
                      There are screens on:\n    12565<\/span>.screen1   (<\/span>Detached)<\/span>\n    12568<\/span>.screen2   (<\/span>Detached)<\/span>\n2<\/span> Sockets in \/var\/run\/screen\/S-root.<\/code><\/pre>\n<\/td>\n<\/tr>\n<\/table>\n<\/div>\n<\/div>\n<\/li>\n
                    2. Run the screen -x screenname<\/code> command to reconnect to the session, where screenname<\/code> is the session\u2019s name.<\/li>\n<\/ol><\/div>\n","protected":false},"excerpt":{"rendered":"
                      Valid for versions 94 through the latest version Version: 82 94 Overview Warning: Only experienced system administrators should use the procedures in this document. cPanel, L.L.C. cannot support failed hard drives or hard drive recovery. We are not responsible for any data loss. In some circumstances, you may need to completely restore your server from …<\/p>\n","protected":false},"author":1,"featured_media":659,"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\/658"}],"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=658"}],"version-history":[{"count":0,"href":"https:\/\/ssdsunucum.com\/blog\/wp-json\/wp\/v2\/posts\/658\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/ssdsunucum.com\/blog\/wp-json\/wp\/v2\/media\/659"}],"wp:attachment":[{"href":"https:\/\/ssdsunucum.com\/blog\/wp-json\/wp\/v2\/media?parent=658"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/ssdsunucum.com\/blog\/wp-json\/wp\/v2\/categories?post=658"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/ssdsunucum.com\/blog\/wp-json\/wp\/v2\/tags?post=658"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}