Differences
This shows you the differences between two versions of the page.
| Both sides previous revision Previous revision Next revision | Previous revision Next revision Both sides next revision | ||
|
litespeed_wiki:cpanel:whm-plugin-installer [2015/08/13 19:39] Michael Alegre [How to convert your cPanel server to LiteSpeed in 20 minutes] removed mention of cPanel not providing LiteSpeed support |
litespeed_wiki:cpanel:whm-plugin-installer [2016/08/03 17:59] Jackson Zhang [How to convert your cPanel server to LiteSpeed in 20 minutes (deprecated)] |
||
|---|---|---|---|
| Line 1: | Line 1: | ||
| - | ====== How to convert your cPanel server to LiteSpeed in 20 minutes ====== | + | ====== How to convert your cPanel server to LiteSpeed in 20 minutes (deprecated)====== |
| + | We recommend to install our WHM plugin and LSWS through [[litespeed_wiki:cpanel:auto-installer|one line auto installer]]. | ||
| + | |||
| + | The following wiki outline the steps to install whm plugin, then LSWS, then PHP, which is now deprecated. | ||
| This only works with LiteSpeed Enterprise Edition, you need a trial key or an Enterprise License serial number. | This only works with LiteSpeed Enterprise Edition, you need a trial key or an Enterprise License serial number. | ||
| Line 10: | Line 13: | ||
| cd /usr/src; curl http://www.litespeedtech.com/packages/cpanel/lsws_whm_plugin_install.sh | sh | 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:// | + | //Note: To uninstall WHM LiteSpeed plugin, run the following command:// |
| /usr/local/cpanel/whostmgr/docroot/cgi/lsws/lsws_whm_plugin_uninstall.sh | /usr/local/cpanel/whostmgr/docroot/cgi/lsws/lsws_whm_plugin_uninstall.sh | ||
| ===== Step 2: Install LiteSpeed Speed Web Server from within WHM ===== | ===== Step 2: Install LiteSpeed Speed Web Server from within WHM ===== | ||
| - | - click "LiteSpeed Web Server Plugin for WHM" in "Plugins" section of WHM. | + | - Click the "LiteSpeed Web Server" plugin. (In the "Plugins" section at the bottom of the scroll menu) |
| - | - click "Install LiteSpeed Web Server" | + | - Click "Install LiteSpeed Web Server" |
| - Fill in the form to sepecify | - Fill in the form to sepecify | ||
| * Trial license key or serial number | * Trial license key or serial number | ||
| * LiteSpeed target installation directory | * LiteSpeed target installation directory | ||
| - | * Port Offset ( set to 0 to replace Apache otherwise set a number like "2000" to try LiteSpeed on port 2080 ) | + | * Port Offset (set to 0 to replace Apache otherwise set a number like "2000" for example to try LiteSpeed on port 2080) |
| * Whether to enable PHP SuEXEC | * Whether to enable PHP SuEXEC | ||
| - | * Assign user name and password for LWSW web admin console | + | * Your Administrators email address. |
| - | * Your email address as the Administrators email. | + | * Username and password for LWSW WebAdmin Console |
| - Click "Next" to install LiteSpeed | - 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 ===== | + | ===== Step 3: Config PHP ===== |
| - | 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. | + | ==== For EA4, Plugin will handle it through script == |
| + | Our plugin will detect the right configuration and correct them when needed. You don't need to build matching PHP any more. | ||
| - | Then, click "Build Matching PHP binary" link. It is going take a while. | + | ==== For EA3, Build matching PHP binary ==== |
| + | LSWS comes with a pre-built PHP 4 binary. However, you should build your own PHP binary using configuration options matching those used by Apache mod_php. | ||
| - | **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. | + | Then, click "Build Matching LSPHP". This step will take a while. |
| - | <file> | + | **NOTE:**If you see one of the below error messages when running "Build Matching LSPHP", try increasing "Max cPanel process memory (minimum: 512)" in the side menu under Server Configuration >> Tweak Settings to at least 512MB. |
| - | Found Errors | + | |
| - | ERROR: /usr/local/bin/php -i returns 6 | ||
| - | You can try to build matching PHP from command line: | + | Found Errors |
| - | "/usr/local/cpanel/whostmgr/cgi/lsws/cmd_buildmatchingphp.sh" | + | |
| - | </file> | + | 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 | + | Or |
| - | <file> | ||
| - | Found Errors | ||
| - | ERROR: /usr/local/bin/php -i returns 134 | + | 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" | ||
| - | You can try to build matching PHP from command line: | ||
| - | "/usr/local/cpanel/whostmgr/cgi/lsws/cmd_buildmatchingphp.sh" | ||
| - | </file> | ||
| ===== Step 4: Start LiteSpeed again ===== | ===== Step 4: Start LiteSpeed again ===== | ||
| - | Just click "Restart LiteSpeed" | + | 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". | + | You can now verify if everything is working as expected. It should be! 8-) |
| - | That's it. | + | You can now replace Apache with LiteSpeed Web Server. Click "Change Port Offset" and set the value to 0 if you had not done so previously. Click "Switch to LiteSpeed" and that's it! |
| - | **WARNING:** Do **NOT** uncheck "httpd" service under WHM service manager, otherwise WHM wont restart LiteSpeed automatically when configuration has been changed. | + | **WARNING:** Do **NOT** uncheck the "Apache Web Server" (httpd) service under WHM's service manager. If you do this WHM will not restart LiteSpeed automatically when configuration changes have been made. |