1"use strict";(self.webpackChunkdocs=self.webpackChunkdocs||[]).push([["3372"],{1119(e,r,o){o.r(r),o.d(r,{metadata:()=>s,default:()=>h,frontMatter:()=>i,contentTitle:()=>l,toc:()=>d,assets:()=>a});var s=JSON.parse('{"id":"updraftplus/restoration/explanations/restoration-not-completing","title":"Why your WordPress restoration isn\u2019t completing","description":"Learn why a WordPress restore may not complete and how to troubleshoot common causes.","source":"@site/markdown/docs/updraftplus/restoration/explanations/restoration-not-completing.md","sourceDirName":"updraftplus/restoration/explanations","slug":"/updraftplus/restoration/explanations/restoration-not-completing","permalink":"/docs/updraftplus/restoration/explanations/restoration-not-completing","draft":false,"unlisted":false,"tags":[],"version":"current","frontMatter":{"title":"Why your WordPress restoration isn\u2019t completing","description":"Learn why a WordPress restore may not complete and how to troubleshoot common causes."},"sidebar":"updraftPlus","previous":{"title":"PCLZIP_ERR_BAD_FORMAT (-10) error explained","permalink":"/docs/updraftplus/restoration/explanations/pclzip-err-bad-format-error"},"next":{"title":"Restore WordPress core: should you include wp-config.php?","permalink":"/docs/updraftplus/restoration/explanations/restore-wp-config-php-with-wordpress-core"}}'),t=o(74848),n=o(28453);let i={title:"Why your WordPress restoration isn\u2019t completing",description:"Learn why a WordPress restore may not complete and how to troubleshoot common causes."},l="Why your restoration isn\u2019t completing",a={},d=[{value:"Why isn\u2019t my restoration working?",id:"why-isnt-my-restoration-working",level:2},{value:"Corrupted zip files",id:"corrupted-zip-files",level:2},{value:"1. Download your files",id:"1-download-your-files",level:3},{value:"2. Test them",id:"2-test-them",level:3},{value:"3. Remove the old files",id:"3-remove-the-old-files",level:3},{value:"4. Upload",id:"4-upload",level:3},{value:"5. Rescan local storage",id:"5-rescan-local-storage",level:3},{value:"6. Retry your restoration",id:"6-retry-your-restoration",level:3},{value:"Lack of memory",id:"lack-of-memory",level:2},{value:"1. Check your server memory limit",id:"1-check-your-server-memory-limit",level:3},{value:"2. Increase your WordPress memory limit",id:"2-increase-your-wordpress-memory-limit",level:3},{value:"3. Retry your restoration",id:"3-retry-your-restoration",level:3},{value:"Not enough storage space",id:"not-enough-storage-space",level:2},{value:"File permissions errors",id:"file-permissions-errors",level:2},{value:"There are no error messages in my log file",id:"there-are-no-error-messages-in-my-log-file",level:2},{value:"Use WordPress debugging",id:"use-wordpress-debugging",level:3},{value:"Use a plugin",id:"use-a-plugin",level:3},{value:"Do it manually",id:"do-it-manually",level:3},{value:"Are you using the Litespeed web server?",id:"are-you-using-the-litespeed-web-server",level:3},{value:"Need More Help?",id:"need-more-help",level:2}];function c(e){let r={a:"a",code:"code",h1:"h1",h2:"h2",h3:"h3",header:"header",p:"p",pre:"pre",strong:"strong",...(0,n.R)(),...e.components};return(0,t.jsxs)(t.Fragment,{children:[(0,t.jsx)(r.header,{children:(0,t.jsx)(r.h1,{id:"why-your-restoration-isnt-completing",children:"Why your restoration isn\u2019t completing"})}),"\n",(0,t.jsx)(r.h2,{id:"why-isnt-my-restoration-working",children:"Why isn\u2019t my restoration working?"}),"\n",(0,t.jsx)(r.p,{children:"While the restoration process typically runs smoothly, complications can sometimes occur.\xa0 This page outlines some common issues and their solutions."}),"\n",(0,t.jsxs)(r.p,{children:[(0,t.jsx)(r.strong,{children:"Note:"})," Some of the solutions require you to edit files within your WordPress installation.\xa0 If you are uncomfortable using S/FTP or your web hosting File Manager, we recommend using a free plugin such as ",(0,t.jsx)(r.a,{href:"https://wordpress.org/plugins/file-manager-advanced/",children:"Advanced File Manager"}),".\xa0 Please remember to make a backup of any files that you intend to change."]}),"\n",(0,t.jsx)(r.h2,{id:"corrupted-zip-files",children:"Corrupted zip files"}),"\n",(0,t.jsx)(r.p,{children:(0,t.jsx)(r.strong,{children:"Example error log message:"})}),"\n",(0,t.jsx)(r.pre,{children:(0,t.jsx)(r.code,{children:"PCLZIP_ERR_BAD_FORMAT (-10)\n"})}),"\n",(0,t.jsxs)(r.p,{children:[(0,t.jsx)(r.strong,{children:"Solution:"})," The files need to be downloaded again and then uploaded to replace the problematic version."]}),"\n",(0,t.jsx)(r.h3,{id:"1-download-your-files",children:"1. Download your files"}),"\n",(0,t.jsx)(r.p,{children:"Download the files from your storage provider directly to your computer."}),"\n",(0,t.jsx)(r.h3,{id:"2-test-them",children:"2. Test them"}),"\n",(0,t.jsx)(r.p,{children:"Unzip the files and test that they are not corrupted.\xa0 If this test is unsuccessful you will need to repair them with a suitable zip repair utility."}),"\n",(0,t.jsx)(r.h3,{id:"3-remove-the-old-files",children:"3. Remove the old files"}),"\n",(0,t.jsxs)(r.p,{children:["Next, delete the backup set that is causing the problem from ",(0,t.jsx)(r.strong,{children:"UpdraftPlus >> Backup / Restore >> Existing backups"}),".\xa0 Ensure the ",(0,t.jsx)(r.strong,{children:"\u2018also delete from remote storage\u2019"})," checkbox is unticked."]}),"\n",(0,t.jsx)(r.h3,{id:"4-upload",children:"4. Upload"}),"\n",(0,t.jsxs)(r.p,{children:["Connect to your site via S/FTP and upload the files into the ",(0,t.jsx)(r.strong,{children:"wp-content / updraft"})," folder."]}
1),"\n",(0,t.jsx)(r.h3,{id:"5-rescan-local-storage",children:"5. Rescan local storage"}),"\n",(0,t.jsxs)(r.p,{children:["Go back to ",(0,t.jsx)(r.strong,{children:"UpdraftPlus >> Backup / Restore >> Existing backups"})," and click ",(0,t.jsx)(r.strong,{children:"rescan local storage"})," ",(0,t.jsx)(r.strong,{children:"for new backup sets"}),"."]}),"\n",(0,t.jsx)(r.h3,{id:"6-retry-your-restoration",children:"6. Retry your restoration"}),"\n",(0,t.jsx)(r.p,{children:"Click the Restore button next to the backup set you have just uploaded and follow the process."}),"\n",(0,t.jsx)(r.h2,{id:"lack-of-memory",children:"Lack of memory"}),"\n",(0,t.jsx)(r.p,{children:(0,t.jsx)(r.strong,{children:"Example error log message:"})}),"\n",(0,t.jsx)(r.pre,{children:(0,t.jsx)(r.code,{children:"Allowed memory size of 268435456 bytes exhausted\n"})}),"\n",(0,t.jsxs)(r.p,{children:[(0,t.jsx)(r.strong,{children:"Solution:"})," Increase the amount of memory available to WordPress."]}),"\n",(0,t.jsx)(r.h3,{id:"1-check-your-server-memory-limit",children:"1. Check your server memory limit"}),"\n",(0,t.jsxs)(r.p,{children:["At the top of a backup or restoration log file, note the value next to the ",(0,t.jsx)(r.strong,{children:"memory_limit"})," directive.\xa0 This is the maximum amount of memory that is available to your server."]}),"\n",(0,t.jsx)(r.h3,{id:"2-increase-your-wordpress-memory-limit",children:"2. Increase your WordPress memory limit"}),"\n",(0,t.jsxs)(r.p,{children:["Your WordPress website has its own memory limit.\xa0 This can often be increased.\xa0 To do this, open your ",(0,t.jsx)(r.code,{children:"wp-config.php"})," file and search for ",(0,t.jsx)(r.code,{children:"WP_MEMORY_LIMIT"}),"."]}),"\n",(0,t.jsx)(r.p,{children:"If this definition is already present, you can edit the value to the same as the one for memory limit found in the previous step \u2013 if it is not present you can add it above the line that says:"}),"\n",(0,t.jsx)(r.pre,{children:(0,t.jsx)(r.code,{children:"/* That's all, stop editing! Happy blogging. */\n"})}),"\n",(0,t.jsx)(r.p,{children:(0,t.jsx)(r.strong,{children:"Example:"})}),"\n",(0,t.jsx)(r.pre,{children:(0,t.jsx)(r.code,{children:"define('WP_MEMORY_LIMIT', '512M'); \n"})}),"\n",(0,t.jsx)(r.p,{children:"This sets the WordPress memory limit to 512MB."}),"\n",(0,t.jsxs)(r.p,{children:[(0,t.jsx)(r.strong,{children:"Note:"})," If your WordPress memory limit is already the same as your server memory limit, you will need to contact your host for further advice."]}),"\n",(0,t.jsx)(r.h3,{id:"3-retry-your-restoration",children:"3. Retry your restoration"}),"\n",(0,t.jsx)(r.p,{children:"Click the Restore button next to the backup set you have just uploaded and follow the process."}),"\n",(0,t.jsx)(r.h2,{id:"not-enough-storage-space",children:"Not enough storage space"}),"\n",(0,t.jsx)(r.p,{children:(0,t.jsx)(r.strong,{children:"Example error log message:"})}),"\n",(0,t.jsx)(r.pre,{children:(0,t.jsx)(r.code,{children:"Disk quota exceeded\n"})}),"\n",(0,t.jsxs)(r.p,{children:[(0,t.jsx)(r.strong,{children:"Solution:"})," A lack of storage space is preventing the restoration from completing. To proceed, you\u2019ll need to free up disk space so that UpdraftPlus can create the required files."]}),"\n",(0,t.jsx)(r.h2,{id:"file-permissions-errors",children:"File permissions errors"}),"\n",(0,t.jsx)(r.p,{children:(0,t.jsx)(r.strong,{children:"Example error log message:"})}),"\n",(0,t.jsx)(r.pre,{children:(0,t.jsx)(r.code,{children:"Could not move the files into place\n"})}),"\n",(0,t.jsxs)(r.p,{children:[(0,t.jsx)(r.strong,{children:"Solution:"})," WordPress requires specific file and folder permissions to work correctly.\xa0 We recommend contacting your hosting company for assistance if you see this error."]}),"\n",(0,t.jsx)(r.h2,{id:"there-are-no-error-messages-in-my-log-file",children:"There are no error messages in my log file"}),"\n",(0,t.jsx)(r.h3,{id:"use-wordpress-debugging",children:"Use WordPress debugging"}),"\n",(0,t.jsx)(r.p,{children:"If your restoration fails without a clear reason, enabling WordPress debugging can help identify the issue."}),"\n",(0,t.jsx)(r.h3,{id:"use-a-plugin",children:"Use a plugin"}),"\n",(0,t.jsxs)(r.p,{children:["For a simpler approach, install the ",(0,t.jsx)(r.a,{href:"https://wordpress.org/plugins/debug-log-manager/",children:"Debug Log Manager"})," plugin from the WordPress Plugin Directory. Activate the plugin, retry your restoration, and then review the generated log file for error messages."]}),"\n",(0,t.jsx)(r.h3,{id:"do-it-manually",children:"Do it manually"}),"\n",(0,t.jsxs)(r.p,{children:["If you prefer to do this manually, follow the ",(0,t.jsx)(r.a,{href:"https://developer.wordpress.org/advanced-administration/debug/debug-wordpress/",children:"WordPress debugging instructions"})," to enable debugging. After enabling debugging, retry the restoration and check the debug log for error details."]}),"\n",(0,t.jsx)(r.h3,{id:"are-you-using-the-litespeed-web-server",children:"Are you using the Litespeed web server?"}),"\n",(0,t.jsxs)(r.p,{children:["If you are using Litespeed, edit your .htaccess file in the root directory and follow these instructions",":Find"," the line that says:"]}),"\n",(0,t.jsx)(r.pre,{children:(0,t.jsx)(r.code,{children:"# BEGIN WordPress\n"})}),"\n",(0,t.jsx)(r.p,{children:"and add this code above it:"}),"\n",(0,t.jsx)(r.pre,{children:(0,t.jsx)(r.code,{children:"# BEGIN LiteSpeed noabort\n<IfModule rewrite_module>\nRewriteEngine On\nRewriteRule .* - [E=noabort:1]\n</IfModule>\n# END liteSpeed noabort\n"})}),"\n",(0,t.jsx)(r.p,{children:"Save your changes and then retry your restoration."}),"\n",(0,t.jsx)(r.h2,{id:"need-more-help",children:"Need More Help?"}),"\n",(0,t.jsxs)(r.p,{children:["If you\u2019re unable to resolve the issue based on the debug error log information, ",(0,t.jsx)(r.a,{href:"https://teamupdraft.com/support/",children:"our support team is ready to assist you"}),"."]})]})}function h(e={}){let{wrapper:r}={...(0,n.R)(),...e.components};return r?(0,t.jsx)(r,{...e,children:(0,t.jsx)(c,{...e})}):c(e)}},28453(e,r,o){o.d(r,{R:()=>i,x:()=>l});var s=o(96540);let t={},n=s.createContext(t);function i(e){let r=s.useContext(n);return s.useMemo(function(){return"function"==typeof e?e(r):{...r,...e}},[r,e])}function l(e){let r;return r=e.disableParentContext?"function"==typeof e.components?e.components(t):e.components||t:i(e.components),s.createElement(n.Provider,{value:r},e.children)}}}]);
Line numbers count LF bytes from the start of the resource, as the search results do. Vendor segments are library code the classifier recognised; they are stored but not indexed. Bytes are shown as Latin1 characters, one per byte.