Differences
This shows you the differences between two versions of the page.
| Both sides previous revision Previous revision Next revision | Previous revision | ||
|
litespeed_wiki:cpanel_troubleshooting [2014/08/05 21:19] Michael Armstrong |
— (current) | ||
|---|---|---|---|
| Line 1: | Line 1: | ||
| - | ====== Troubleshooting LiteSpeed Web Server with cPanel/WHM ====== | ||
| - | This wiki will address problems that may occur on a LiteSpeed Web Server/WHM installation. The installation process is covered in our [[litespeed_wiki:cpanel:auto-installer|Auto-Installer wiki]]. | ||
| - | |||
| - | **Note:** For free support of LSWS please use the [[http://www.litespeedtech.com/support/forum/|LiteSpeed forum]]. If you have an issue with cPanel (even while using LSWS) please contact cPanel support. They are fully trained to handle LiteSpeed Web Server. | ||
| - | |||
| - | ===== Insufficient Process Memory ===== | ||
| - | |||
| - | Insufficient process memory may result in the following error messages (when you try to build matching PHP): | ||
| - | |||
| - | <file> | ||
| - | Found Errors | ||
| - | |||
| - | ERROR: /usr/local/bin/php -i returns 6 | ||
| - | |||
| - | You can try to build matching PHP from command line: | ||
| - | "/usr/local/cpanel/whostmgr/cgi/lsws/cmd_buildmatchingphp.sh" | ||
| - | </file> | ||
| - | |||
| - | or | ||
| - | |||
| - | <file> | ||
| - | Found Errors | ||
| - | |||
| - | ERROR: /usr/local/bin/php -i returns 134 | ||
| - | |||
| - | You can try to build matching PHP from command line: | ||
| - | "/usr/local/cpanel/whostmgr/cgi/lsws/cmd_buildmatchingphp.sh" | ||
| - | </file> | ||
| - | |||
| - | To fix this, try increasing the "Max cPanel process memory (Minimum: 512)" in WHM > Server Configuration > Tweak Settings. | ||
| - | |||
| - | ===== LiteSpeed Does Not Restart When Configuration Changes ===== | ||
| - | |||
| - | In order for configuration changes to take effect, LiteSpeed Web Server should restart automatically. Do **NOT** uncheck the "httpd" service under WHM > Service Configuration > Service Manager. If unchecked, WHM will not restart LiteSpeed automatically when configurations have been changed. | ||
| - | |||
| - | ===== Incorrect gcc Permissions ===== | ||
| - | |||
| - | cPanel may set permissions for /usr/bin/gcc to 0700. This will break our PHP build script. To fix this, change the permissions for the directory: | ||
| - | |||
| - | chmod 0755 /usr/bin/gcc | ||
| - | |||
| - | After finishing your PHP build, you can change permissions back: | ||
| - | |||
| - | chmod 0700 /usr/bin/gcc | ||
| - | |||
| - | ===== mod_ruid2 Incompatibility ===== | ||
| - | |||
| - | LSWS is not compatible with mod_ruid2 because LSWS does not the process user to change mid-process. Make sure that mod_ruid2 is disabled in your WHM settings when using LSWS. LSWS is compatible with Apache prefork or event MPM. | ||
| - | |||
| - | If mod_ruid2 is enabled, a variety of functionality may be disrupted due to WHM creating files that the web server user cannot access. | ||