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.

Note: cPanel users, for support issues, please use LiteSpeed forum for free support. cPanel support will NOT handle issues related to LiteSpeed server.

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 command as follows:

/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/07/31 18:43
  • by Michael Alegre