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 Auto-Installer wiki.

Note: For free support of LSWS please use the 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):

Found Errors

ERROR: /usr/local/bin/php -i returns 6 

You can try to build matching PHP from command line: 


Found Errors

ERROR: /usr/local/bin/php -i returns 134

You can try to build matching PHP from command line: 

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 allow 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.

However, starting in October 2014, there's been a new version of the WHM Plugin that automatically checks to see if mod_ruid2 is enabled. The Plugin now automatically removes the cPanel “fileprotect” file if it finds mod_ruid2 enabled. This should change the permissions to make them compatible with LSWS.

litespeed_wiki/cpanel/troubleshooting.txt · Last modified: 2017/08/03 18:21 by Michael Alegre