Differences
This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision Last revision Both sides next revision | ||
litespeed_wiki:cpanel:whm-plugin-installer [2015/08/13 19:47] Michael Alegre [Step 1: Install LiteSpeed WHM plugin] |
litespeed_wiki:cpanel:whm-plugin-installer [2017/05/12 13:19] Michael Alegre [Step 1: Install LiteSpeed WHM plugin] |
||
---|---|---|---|
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 8: | Line 11: | ||
Run the following commands from ssh as root | Run the following commands from ssh as root | ||
- | cd /usr/src; curl http://www.litespeedtech.com/packages/cpanel/lsws_whm_plugin_install.sh | sh | + | cd /usr/src; curl https://www.litespeedtech.com/packages/cpanel/lsws_whm_plugin_install.sh | sh |
//Note: To uninstall WHM LiteSpeed plugin, run the following command:// | //Note: To uninstall WHM LiteSpeed plugin, run the following command:// | ||
Line 14: | Line 17: | ||
===== 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: Config 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. | ||
- | ===== Step 3: Build matching PHP binary ===== | + | ==== For EA3, 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. | + | 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. |
- | Then, click "Build Matching PHP binary" link. It is going take a while. | + | Then, click "Build Matching LSPHP". This step will 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. | + | **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. |
- | <file> | ||
- | Found Errors | ||
- | ERROR: /usr/local/bin/php -i returns 6 | + | 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" | ||
- | You can try to build matching PHP from command line: | + | Or |
- | "/usr/local/cpanel/whostmgr/cgi/lsws/cmd_buildmatchingphp.sh" | + | |
- | </file> | + | |
- | or | ||
- | <file> | + | Found Errors |
- | 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" | ||
- | 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" | ||
- | </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-) | + | |
+ | You can now verify if everything is working as expected. It should be! 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 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! |
- | That's it. | + | **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. |
- | **WARNING:** Do **NOT** uncheck "httpd" service under WHM service manager, otherwise WHM wont restart LiteSpeed automatically when configuration has been changed. | + | ====== cPanel installation tips ====== |
+ | Please also refer to [[https://cpaneltips.com/install-litespeed-cpanel|cpanel installation tips]]. |