If you're encountering issues when running bulk WordPress updates or backups using cPFence WP-AutoShield, this guide will help you troubleshoot the most common problems.
Common Error Messages
- "Invalid backup metadata"
- "Unable to retrieve the site URL or title"
Why These Errors Occur
These errors usually mean that the WordPress CLI (WP-CLI), which cPFence relies on, failed to access or fetch information about the website. This can happen if:
- A plugin or theme is broken
- File permissions are incorrect
- The site is incomplete or inaccessible
How to Troubleshoot
Follow these steps to isolate the issue:
- Log into the user container:
su - username - Navigate to the website folder:
cd /public_html - Test the following WP-CLI commands manually:
wp option get siteurl wp option get blogname wp core update wp plugin update --all wp theme update --all
If any command fails or returns an error, it may indicate a deeper issue with the WordPress site itself. The root cause is often a faulty plugin or missing WordPress files.
Check the Logs
You can always review these two logs for detailed information:
/var/log/wordpress-update-success.log/var/log/wordpress-update-error.log
These logs include output from every processed site and can help identify which step failed.
Important Note
cPFence performs these actions using WP-CLI and does not override plugin or theme errors. If issues are found within the WordPress site, they must be resolved manually.
