Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
Last 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:04]
Jackson Zhang
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.
  
-**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+=====  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.
  
-**Resolution:​** Confirm that this installation has 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! Error establishing ​database connection ===== 
 +  /​home/​user/​public_html ​Unexpected Error Encountered! Error establishing a database connection.
  
 +===== 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.
 +  ​
 ===== 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.
  • Admin
  • Last modified: 2019/05/09 13:07
  • by Jackson Zhang