Differences
This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision Next revision Both sides next revision | ||
litespeed_wiki:cpanel:whm-plugin-cache-manager-error-status [2018/03/29 15:39] Lisa Clarke [Could Not Match WordPress siteURL To A Known cPanel Docroot] Reformatting |
litespeed_wiki:cpanel:whm-plugin-cache-manager-error-status [2019/05/09 13:07] Jackson Zhang [Detected WordPress version as x.x. Version 4.0 required at minimum] |
||
---|---|---|---|
Line 3: | Line 3: | ||
While using the Web Cache Management feature of our WHM plugin, you might occasionally see an installation listed with an "Error" status. | While using the Web Cache Management feature of our WHM plugin, you might occasionally see an installation listed with an "Error" status. | ||
- | [IMG] | + | {{ :litespeed_wiki:cpanel:whm-err-status-example.png?direct |}} |
By hovering over the "Error" text, a small explanation as to the cause of the error will be displayed. Here we will list out and explain these possible errors and what can be done to fix them. | By hovering over the "Error" text, a small explanation as to the cause of the error will be displayed. Here we will list out and explain these possible errors and what can be done to fix them. | ||
Line 16: | Line 16: | ||
**Resolution:** Most of the time these installations can be ignored without issue. In the rare case where an installation is working as expected but is still detected with this error, please [[#still_need_help|contact our support team]] for further investigation. | **Resolution:** Most of the time these installations can be ignored without issue. In the rare case where an installation is working as expected but is still detected with this error, please [[#still_need_help|contact our support team]] for further investigation. | ||
+ | ===== Timeout Occurred During Action Execution ===== | ||
+ | |||
+ | This message indicates that PHP timed out while loading the WordPress environment and trying to perform some action. | ||
+ | |||
+ | ** Cause:** This error is most commonly caused by custom code added in a user's wp-config.php file. If the code runs into some issue when executed by our script call, it may hang. | ||
+ | |||
+ | **Resolution:** If the installation is working as expected, you may try to manually locate the code which is causing the error and fix/remove it. If you are in need of assistance you may [[#still_need_help|contact our support team]] for further investigation. Just be aware that this issue likely falls outside of free support. | ||
===== Could Not Retrieve WordPress siteURL ===== | ===== Could Not Retrieve WordPress siteURL ===== | ||
- | This message indicates that the installation was successfully discovered as a valid WP installation, but ''siteUrl'' could not be retrieved from WordPress. | + | This message indicates that the installation was successfully discovered as a valid WP installation, but siteUrl could not be retrieved from WordPress. |
- | **Cause:** WordPress' ''get_option()'' function failed to retrieve a ''siteUrl''. | + | **Cause:** WordPress' ''get_option()'' function failed to retrieve a siteUrl. |
**Resolution:** Since this error usually indicates some kind of database issue with WordPress, please [[#still_need_help|contact our support team]] for further investigation, if you know this to be a working WordPress site. | **Resolution:** Since this error usually indicates some kind of database issue with WordPress, please [[#still_need_help|contact our support team]] for further investigation, if you know this to be a working WordPress site. | ||
Line 43: | Line 50: | ||
===== Could Not Find A Valid wp-config.php File ===== | ===== Could Not Find A Valid wp-config.php File ===== | ||
- | This message indicates that we could not find a possible wp-config.php file for that specific installation. | + | This message indicates that we could not find a possible ''wp-config.php'' file for that specific installation. |
+ | |||
+ | **Cause:** When looking for an installation's ''wp-config.php'' file, the installation's root directory and parent directory are both checked for a valid copy. If one cannot be found, or the discovered ''wp-config.php'' file is believed to belong to a different WordPress installation (i.e. it is discovered in a parent directory also containing a ''wp-settings.php'' file), then this error is set. | ||
+ | |||
+ | **Resolution:** Confirm that this installation has a valid ''wp-config.php'' file. If the ''wp-config.php'' file is kept more than 1 directory above the root installation using symbolic links, it will need to be moved to the installation root or parent directory. | ||
+ | |||
+ | ===== Unexpected Error Encountered! See webcachemgr.log for more information ===== | ||
+ | |||
+ | After migrating all cPanel WordPress accounts to another server,and then scanning to manage with LiteSpeed, the following error was noticed on almost all accounts: | ||
+ | |||
+ | /home/user1/public_html - Install skipped due to Error status. Please Refresh Status before trying again. | ||
+ | |||
+ | After refreshing the status, the error changed to the following, still on nearly all accounts: | ||
+ | |||
+ | /home/user1/public_html - Unexpected Error Encountered! See webcachemgr.log for more information. | ||
+ | /home/user2/public_html - Unexpected Error Encountered! See webcachemgr.log for more information. | ||
+ | /home/user3/public_html - Unexpected Error Encountered! See webcachemgr.log for more information. | ||
+ | ... | ||
+ | |||
+ | ''/usr/local/lsws/logs/webcachemgr.log'' showed the following: | ||
+ | |||
+ | 2019-02-04 17:30:07 [ERROR] /home/user1/public_html - Your PHP installation appears to be missing the MySQL extension which is required by WordPress. | ||
+ | 2019-02-04 17:30:07 [ERROR] /home/user2/public_html - Your PHP installation appears to be missing the MySQL extension which is required by WordPress. | ||
+ | 2019-02-04 17:30:07 [ERROR] /home/user3/public_html - Your PHP installation appears to be missing the MySQL extension which is required by WordPress. | ||
+ | |||
+ | It looked like the PHP configuration was wrong and was missing the MySQL module. | ||
+ | |||
+ | The cPanel MultiPHP Manager showed PHP 7.2 (alt-php72) was set to the system default PHP version, and all accounts inherited it. It appeared something was wrong with alt-PHP72 in this case. Changing the default to ea-php72 solved the problem, and all LiteSpeed Cache enabling errors disappeared. | ||
+ | ===== Could not include missing file ===== | ||
+ | /home/user/public_html - Could not include missing file /home/user/public_html/wp-load.php. | ||
+ | |||
+ | ===== Could not find matching document root ===== | ||
+ | /home/user/public_html/blog_old - /home/user/public_html/blog_old - Could not find matching document root for WP siteurl/servername example.com. | ||
- | **Cause:** When looking for an installation's wp-config.php file, the installations root directory and parent directory are both checked for a valid wp-config.php file. If one cannot be found, or the discovered wp-config.php file is believed to belong to a different WordPress installation (discovered in parent directory also containing a wp-settings.php file), this error is set. | + | ===== Unexpected Error Encountered! Error establishing a database connection ===== |
+ | /home/user/public_html - Unexpected Error Encountered! Error establishing a database connection. | ||
- | **Resolution:** Confirm that this installation has a valid wp-config.php file. If the wp-config.php file is kept more than 1 directory above the root installation using symbolic links, it will need to be moved to the installation root or parent directory. | + | ===== Detected WordPress version as x.x. Version 4.0 required at minimum ===== |
+ | /home/user/public_html/example.com - Detected WordPress version as 3.4. Version 4.0 required at minimum. | ||
+ | ===== Undefined variable: wp_version ===== | ||
+ | /home/user/public_html/__MACOSX - Notice: Undefined variable: wp_version in /usr/local/lsws/add-ons/webcachemgr/src/WPCaller.php on line 1145 Notice: Undefined variable: wp_version in /usr/local/lsws/add-ons/webcachemgr/src/WPCaller.php on line 1146 Detected WordPress version as . Version 4.0 required at minimum | ||
===== Still Need Help? ===== | ===== Still Need Help? ===== | ||
If you are still running into issues after learning about the cases above, please [[https://www.litespeedtech.com/support|contact our support team]] for further assistance. | If you are still running into issues after learning about the cases above, please [[https://www.litespeedtech.com/support|contact our support team]] for further assistance. |