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 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: 
"/usr/local/cpanel/whostmgr/cgi/lsws/cmd_buildmatchingphp.sh"

or

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"

To fix this, try increasing the “Max cPanel process memory (Minimum: 512)” in WHM > Server Configuration > Tweak Settings.

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.

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

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.