{"id":879,"date":"2021-07-23T12:40:12","date_gmt":"2021-07-23T12:40:12","guid":{"rendered":"https:\/\/ssdsunucum.com\/blog\/restore-a-full-backup-cpmove-file\/"},"modified":"2021-07-23T12:40:12","modified_gmt":"2021-07-23T12:40:12","slug":"restore-a-full-backup-cpmove-file","status":"publish","type":"post","link":"https:\/\/ssdsunucum.com\/blog\/restore-a-full-backup-cpmove-file\/","title":{"rendered":"Restore a Full Backup\/cpmove File"},"content":{"rendered":"<\/p>\n<div class=\"col-md-9\">\n<div class=\"flex-column flex-md-row article-header\">\n<div id=\"versioned-article-header\">\n<p class=\"valid-version-info\"><em>Valid for versions 88 through the latest version<\/em><\/p>\n<\/div>\n<div id=\"version-select-group\" aria-label=\"select versions\">\n<h4>Version:<\/h4>\n<h4>82<\/h4>\n<h4>88<\/h4>\n<\/div><\/div>\n<hr>\n<h2 id=\"overview\">Overview<\/h2>\n<div class=\"callout callout-danger\">\n<div class=\"callout-heading\">Warning:<\/div>\n<div class=\"callout-content\">\n<p>We <strong>removed<\/strong> this interface in cPanel &#038; WHM version 90. Use WHM\u2019s <em>Transfer or Restore a cPanel Account<\/em> interface (<em>WHM &gt;&gt; Home &gt;&gt; Transfers &gt;&gt; Transfer or Restore a cPanel Account<\/em>). For more information, read our cPanel Deprecation Plan documentation.<\/p>\n<\/p><\/div>\n<\/div>\n<p>This feature performs a full restoration of a single cPanel account from a selected backup file. You can also recreate an account from a remote server with a <code>cpmove<\/code> file.<\/p>\n<div class=\"callout callout-danger\">\n<div class=\"callout-heading\">Warning:<\/div>\n<div class=\"callout-content\">\n<ul>\n<li>\n<p>The restore system uses multiple applications, such as MySQL\u00ae. Do <strong>not<\/strong> shut down or restart any processes on the server during the restore process.<\/p>\n<\/li>\n<li>\n<p>Do <strong>not<\/strong> use the <code>skip-name-resolve<\/code> setting in your server\u2019s MySQL\u00ae configuration. This setting <strong>will<\/strong> cause <strong>serious<\/strong> issues with server operations. If you are <strong>not<\/strong> an advanced MySQL administrator, expect issues with this setting. For example, you will see issues with account transfers and restoring backups. This setting will also cause issues with phpMyAdmin.<\/p>\n<\/li>\n<\/ul><\/div>\n<\/div>\n<h2 id=\"file-formats-and-locations\">File formats and locations<\/h2>\n<p>The filename of the backup <strong>must<\/strong> use one of the following formats:<\/p>\n<ul>\n<li><code>cpmove-{USER}<\/code><\/li>\n<li><code>cpmove-{USER}.tar<\/code><\/li>\n<li><code>cpmove-{USER}.tar.gz<\/code><\/li>\n<li><code>{USER}.tar<\/code><\/li>\n<li><code>{USER}.tar.gz<\/code><\/li>\n<li><code>backup-{MM.DD.YYYY}{HH-MM-SS}{USER}.tar<\/code><\/li>\n<li><code>backup-{MM.DD.YYYY}{HH-MM-SS}{USER}.tar.gz<\/code><\/li>\n<li><code>backup-{MM.DD.YYYY}_{HH-MM-SS}_{USER}.tar<\/code><\/li>\n<li><code>backup-{MM.DD.YYYY}_{HH-MM-SS}_{USER}.tar.gz<\/code><\/li>\n<\/ul>\n<p>In order for this feature to work, the backup or <code>cpmove<\/code> file <strong>must<\/strong> reside in one of the following directories:<\/p>\n<ul>\n<li><code>\/home<\/code><\/li>\n<li><code>\/usr\/home<\/code><\/li>\n<li><code>\/web<\/code><\/li>\n<li><code>\/home2<\/code><\/li>\n<li><code>\/home3<\/code><\/li>\n<li><code>\/root<\/code><\/li>\n<li><code>\/usr<\/code><\/li>\n<\/ul>\n<p>You may also select a file from your local filesystem.<\/p>\n<div class=\"callout callout-info\">\n<div class=\"callout-heading\">Note:<\/div>\n<div class=\"callout-content\">\n<p>When you restore a backup, the system expands the backup or <code>cpmove<\/code> file in its current directory. Make <strong>certain<\/strong> that the backup file\u2019s directory contains at least <strong>double<\/strong> the backup file\u2019s space. The system uses this extra space for the temporary files when it extracts the backups.<\/p>\n<\/p><\/div>\n<\/div>\n<h2 id=\"how-to-restore-a-cpmove-file\">How to restore a cpmove file<\/h2>\n<p>To begin a full restoration from the backup file of the account, perform the following steps:<\/p>\n<ol>\n<li>\n<p>If you wish to use Restricted Restore, select the <em>Restricted Restore<\/em> checkbox. The <em>Restricted Restore<\/em> feature lets the system perform extra security checks on the archive file. If part of the file has a security issue, the system will <strong>not<\/strong> restore that part of the archive file. This helps mitigate the risk of transfers from unfamiliar sources. The system enables this feature by default.<\/p>\n<div class=\"callout callout-danger\">\n<div class=\"callout-heading\">Warning:<\/div>\n<div class=\"callout-content\">\n<ul>\n<li>This feature is <strong>experimental<\/strong>. Do <strong>not<\/strong> consider it an effective security control. Exercise <strong>extreme<\/strong> caution when using the <em>Restricted Restore<\/em> feature.<\/li>\n<li>Before using this feature, read the Warnings about the Restricted Restore feature section below.<br \/>\n<\/li>\n<\/ul><\/div>\n<\/div>\n<\/li>\n<li>\n<p>Select whether to restore the backup file by username or by filename.<\/p>\n<ul>\n<li>\n<p>If you select <em>Restore with Username<\/em>, select the username that is associated with the cPanel account that you wish to restore.<\/p>\n<\/li>\n<li>\n<p>If you select <em>Restore with File<\/em>, click <em>Choose file<\/em> and select the backup file from your local filesystem.<\/p>\n<\/li>\n<\/ul>\n<\/li>\n<li>\n<p>Select whether to replace all instances of the original server\u2019s IP address with the new address or to only replace basic cPanel-provided A records in zone files.<\/p>\n<\/li>\n<li>\n<p>If you wish to overwrite the account with the data in the backup file, select the <em>Overwrite existing user<\/em> checkbox.<\/p>\n<\/li>\n<li>\n<p>Click <em>Restore<\/em>.<\/p>\n<\/li>\n<\/ol>\n<p>After you click <em>Restore<\/em>, the <em>Account Restore<\/em> interface will appear.<\/p>\n<h3 id=\"warnings-about-the-restricted-restore-feature\">Warnings about the Restricted Restore feature<\/h3>\n<div class=\"callout callout-danger\">\n<div class=\"callout-heading\">Warning:<\/div>\n<div class=\"callout-content\">\n<p>This feature is <strong>experimental<\/strong>. Do <strong>not<\/strong> consider it an effective security control. Exercise <strong>extreme<\/strong> caution when using the <em>Restricted Restore<\/em> feature.<\/p>\n<\/p><\/div>\n<\/div>\n<p>If you use the <em>Restricted Restore<\/em> feature, be advised that:<\/p>\n<ul>\n<li>When you restore an account with this feature, the system may leave behind unnecessary account data. This can cause conflicts and leave the account in a broken state. You must remove the account and then restore it <strong>without<\/strong> using the <em>Restricted Restore<\/em> feature.<\/li>\n<li>This feature will <strong>not<\/strong> restore parked (aliased) or addon domains.<\/li>\n<li>This feature <strong>only<\/strong> allows restored accounts to use <code>noshell<\/code> or <code>jailshell<\/code> environments. If the restored account uses another shell, the system will set the account to use <code>noshell<\/code> environment.<\/li>\n<li>If you use this feature to restore an account that contains PostgreSQL\u00ae databases, the target server <strong>must<\/strong> use PostgreSQL version 8.4 or newer.<\/li>\n<\/ul>\n<h2 id=\"compatibility-issues\">Compatibility issues<\/h2>\n<p>Because of changes to the backup system and other system features (for example, Horde), there are several compatibility issues in the restoration process.<\/p>\n<h3 id=\"postgresql-database-passwords\">PostgreSQL database passwords<\/h3>\n<p>In cPanel &#038; WHM version 11.42 and later, the system restores PostgreSQL databases to the account, but does <strong>not<\/strong> restore the user\u2019s password. This action locks the user out of the databases.<\/p>\n<p>The next time the user manages a database with the phpPgAdmin program, the system refreshes the user\u2019s privileges and restores their access.<\/p>\n<h3 id=\"horde\">Horde<\/h3>\n<p>You <strong>cannot<\/strong> restore Horde data from cPanel &#038; WHM version 11.50 and later to a earlier version of cPanel &#038; WHM version.<\/p>\n<div class=\"callout callout-warning\">\n<div class=\"callout-heading\">Important:<\/div>\n<div class=\"callout-content\">\n<p>Horde data is <strong>not<\/strong> backwards compatible for cPanel and WHM version 11.50 and later.<\/p>\n<\/p><\/div>\n<\/div>\n<div class=\"callout callout-info\">\n<div class=\"callout-heading\">Note:<\/div>\n<div class=\"callout-content\">\n<p>In cPanel &#038; WHM version 11.48 or earlier, Horde uses MySQL.<\/p>\n<\/p><\/div>\n<\/div>\n<p>Also, backups do not include some global Horde files. For more information, read our Backup Tarball Contents and Guide to Horde Data Behavior documentation.<\/p>\n<\/p><\/div>\n","protected":false},"excerpt":{"rendered":"<p>Valid for versions 88 through the latest version Version: 82 88 Overview Warning: We removed this interface in cPanel &#038; WHM version 90. Use WHM\u2019s Transfer or Restore a cPanel Account interface (WHM &gt;&gt; Home &gt;&gt; Transfers &gt;&gt; Transfer or Restore a cPanel Account). For more information, read our cPanel Deprecation Plan documentation. This feature &hellip;<\/p>\n","protected":false},"author":1,"featured_media":880,"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\/879"}],"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=879"}],"version-history":[{"count":0,"href":"https:\/\/ssdsunucum.com\/blog\/wp-json\/wp\/v2\/posts\/879\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/ssdsunucum.com\/blog\/wp-json\/wp\/v2\/media\/880"}],"wp:attachment":[{"href":"https:\/\/ssdsunucum.com\/blog\/wp-json\/wp\/v2\/media?parent=879"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/ssdsunucum.com\/blog\/wp-json\/wp\/v2\/categories?post=879"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/ssdsunucum.com\/blog\/wp-json\/wp\/v2\/tags?post=879"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}