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.
Step 1: Install LiteSpeed WHM plugin
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
Step 2: Install LiteSpeed Speed Web Server from within WHM
- click “LiteSpeed Web Server Plugin for WHM” in “Plugins” section of WHM.
- click “Install LiteSpeed Web Server”
- 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.
- 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.
Step 3: Build matching PHP binary
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.
If LiteSpeed is running, you should switch back to Apache temporarily by clicking “switch to Apache” link.
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"
Step 4: Start LiteSpeed again
Just click “Restart LiteSpeed”
Then you can verify if everything works as expected. It should!
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.