Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Next revision
Previous revision
Last revision Both sides next revision
litespeed_wiki:cpanel:whm-plugin-installer [2015/07/31 18:43]
Michael Alegre created
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.
- 
-**Note: cPanel users**, for support issues, please use LiteSpeed forum for free support. cPanel support will **NOT** handle issues related to LiteSpeed server. 
  
  
Line 10: 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 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: 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" ​linkIt 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 Settingsto 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]].
  • Admin
  • Last modified: 2017/08/16 12:32
  • by Eric Leu