This is an old revision of the document!


How to convert your cPanel server to LiteSpeed in 20 minutes

This only works with LiteSpeed Enterprise Edition, you need a trial key or an Enterprise License serial number.

Run the following commands from ssh as root

cd /usr/src; curl http://www.litespeedtech.com/packages/cpanel/lsws_whm_plugin_install.sh | sh

Note: To uninstall WHM LiteSpeed plugin, run the following command:

/usr/local/cpanel/whostmgr/docroot/cgi/lsws/lsws_whm_plugin_uninstall.sh
  1. click “LiteSpeed Web Server Plugin for WHM” in “Plugins” section of WHM.
  2. click “Install LiteSpeed Web Server”
  3. Fill in the form to sepecify
    • Trial license key or serial number
    • LiteSpeed target installation directory
    • Port Offset ( set to 0 to replace Apache otherwise set a number like “2000” to try LiteSpeed on port 2080 )
    • Whether to enable PHP SuEXEC
    • Assign user name and password for LWSW web admin console
    • Your email address as the Administrators email.
  4. Click “Next” to install LiteSpeed

If you set Port Offset to “0”, it may stop Apache and start LiteSpeed after a successful installation, you may want to switch back to Apache temporarily as we still need to build PHP binary for LiteSpeed.

There is a pre-built PHP 4 binary coming with LSWS, however, you should build your own PHP binary using matching configuration options used by Apache mod_php.

Then, click “Build Matching PHP binary” link. It is going take a while.

NOTE:If you see below error message when Build Matching PHP, try increase “Max cPanel process memory (minimum: 256)” in cPanel (Main » Server Configuration » Tweak Settings) to at lease 512MB.

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"

Just click “Restart LiteSpeed” Then you can verify if everything works as expected. It should! 8-)

If “Port Offset” is set to non-zero, you can now replace Apache with LiteSpeed Web Server. Just click “Switch to LiteSpeed”.

That's it.

WARNING: Do NOT uncheck “httpd” service under WHM service manager, otherwise WHM wont restart LiteSpeed automatically when configuration has been changed.

  • Admin
  • Last modified: 2015/08/13 19:47
  • by Michael Alegre