Differences

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

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
litespeed_wiki:cpanel:auto-installer [2016/10/13 20:32]
Rob Holda [Switching to LiteSpeed after Installation]
litespeed_wiki:cpanel:auto-installer [2019/01/28 17:03] (current)
Lisa Clarke Copyediting
Line 1: Line 1:
-====== Auto-Installer (for cPanel/​WHM ​installations) ======+====== Auto-Installer (for cPanel/​WHM ​Installations) ====== 
 +===== Alternative Method: get.litespeed.sh ===== 
 +LiteSpeed'​s auto-installer used to be the preferred way to install LSWS on cPanel. However, **we have introduced a better way**. Now you can install LSWS on cPanel through ''​get.litespeed.sh''​ for quick/​automatic installation. Use an optional ''​lsws.options''​ file to predefine your desired settings. ​
  
 +  bash <( curl https://​get.litespeed.sh ) your_serial_no
 +
 +For more information about how this works, please see [[https://​docs.litespeedtech.com/​LSWS/​cpanel/​|the full documentation]]. ​
 +
 +If you still prefer to use the auto-installer,​ continue reading.
 +
 +===== Introduction =====
 Our auto-installer allows you to install LiteSpeed Web Server for use with cPanel/WHM with just one script. The auto-installation script installs LSWS and our WHM Plugin, registers your license (or requests a trial license), and builds PHP with LSAPI to match the current EasyApache-built PHP. This leaves you with a ready-to-use LSWS installation. Our auto-installer allows you to install LiteSpeed Web Server for use with cPanel/WHM with just one script. The auto-installation script installs LSWS and our WHM Plugin, registers your license (or requests a trial license), and builds PHP with LSAPI to match the current EasyApache-built PHP. This leaves you with a ready-to-use LSWS installation.
  
Line 9: Line 18:
 This wiki will guide you through the parameters available with the auto-installer and how to switch to LSWS after it has been installed using the auto-installer. This wiki will guide you through the parameters available with the auto-installer and how to switch to LSWS after it has been installed using the auto-installer.
  
 +Please uninstall any Varnish/​nginx proxies that are in use in front of cPanel Apache before installing LSWS. Such proxies include Engintron, cPnginx, Cachewall(xVarnish) etc.
 ===== Prerequisites ===== ===== Prerequisites =====
  
Line 17: Line 27:
 ===== Download ===== ===== Download =====
  
-The auto-installer script can be downloaded from the [[http://​www.litespeedtech.com/​products/​control-panel-plugins/​download|control panel plugins download]] page or with the following commands:+The auto-installer script can be downloaded from the [[https://​www.litespeedtech.com/​products/​litespeed-web-server/​control-panel-plugins/​download|control panel plugins download]] page or with the following commands:
  
-  wget http://​www.litespeedtech.com/​packages/​cpanel/​lsws_whm_autoinstaller.sh+  wget https://​www.litespeedtech.com/​packages/​cpanel/​lsws_whm_autoinstaller.sh
   chmod a+x lsws_whm_autoinstaller.sh   chmod a+x lsws_whm_autoinstaller.sh
 ===== Installation ===== ===== Installation =====
  
-Run the auto-installer ​script using the following command syntax:+The following command is just to explain all the parameters that can be set during the installation process. If you would like a list of example commands please click [[litespeed_wiki:​cpanel:​auto-installer#​examples|here]].
  
-  ./​lsws_whm_autoinstaller.sh SERIAL_NO PHP_SUEXEC port_offset admin_user admin_pass admin_email easyapache_integration auto_switch_to_lsws+  ./​lsws_whm_autoinstaller.sh SERIAL_NO ​[PHP_SUEXEC] [port_offset] [admin_user] [admin_pass] [admin_email] [easyapache_integration] [auto_switch_to_lsws]
  
 Where all optional parameters have default values for convenience,​ but, for security reasons, we strongly recommend using your own values for all parameters. These parameters can be set as follows: Where all optional parameters have default values for convenience,​ but, for security reasons, we strongly recommend using your own values for all parameters. These parameters can be set as follows:
Line 36: Line 46:
   * **(Optional) admin_email:​** Admin email. This email address will receive important server notices, such as license expiration and server core dumps. Default value is ''​root@localhost''​.   * **(Optional) admin_email:​** Admin email. This email address will receive important server notices, such as license expiration and server core dumps. Default value is ''​root@localhost''​.
   * **(Optional) easyapache_integration:​** EasyApache Integration,​ which is applied to EasyApache 3 only and is no longer applicable for EasyApache 4 as there is no need to "build a matching PHP" on EA4. For EasyApache 4, use the EA4 PHP rpms instead. Both ''​0''​ and ''​1''​ are valid values for EasyApache 4 LSWS installations. For EasyApache 3, easyapache_integration automatically rebuilds matching a PHP for LiteSpeed when you update EasyApache. Available values are ''​1''​ (enable) and ''​0''​ (disable). Default value is ''​1''​.   * **(Optional) easyapache_integration:​** EasyApache Integration,​ which is applied to EasyApache 3 only and is no longer applicable for EasyApache 4 as there is no need to "build a matching PHP" on EA4. For EasyApache 4, use the EA4 PHP rpms instead. Both ''​0''​ and ''​1''​ are valid values for EasyApache 4 LSWS installations. For EasyApache 3, easyapache_integration automatically rebuilds matching a PHP for LiteSpeed when you update EasyApache. Available values are ''​1''​ (enable) and ''​0''​ (disable). Default value is ''​1''​.
-  * **(Optional) auto_switch_to_lsws:​** Automatically switch to LiteSpeed ​WebServer ​at the end of the installation. This setting will only take effect if the port offset is set to ''​0''​. Available values are ''​1''​ (enable) and ''​0''​ (disable). Most users will need to test and verify before they switch, so the default value is ''​0''​ (disabled).+  * **(Optional) auto_switch_to_lsws:​** Automatically switch to LiteSpeed ​Web Server ​at the end of the installation. This setting will only take effect if the port offset is set to ''​0''​. Available values are ''​1''​ (enable) and ''​0''​ (disable). Most users will need to test and verify before they switch, so the default value is ''​0''​ (disabled).
  
-Sample input:+=== Examples ===
  
-  ​./​lsws_whm_autoinstaller.sh TRIAL 2 1000 admin a1234567 ​root@localhost 1 0+The following commands is with trial only and will use all the default settings: 
 +  ./​lsws_whm_autoinstaller.sh TRIAL 
 +If you have a License key and want the default values: 
 +  ./​lsws_whm_autoinstaller.sh SERIAL-KEY-HERE 
 +If you want to set specific paramters ( Replace TRIAL with your serial key if you have one ): 
 +  ​./​lsws_whm_autoinstaller.sh TRIAL 2 admin 123456 ​root@localhost 1 
 +If you just want to specify username and password ( Replace TRIAL with your serial key if you have one ): 
 +  ./​lsws_whm_autoinstaller.sh TRIAL 2 smith testpw
  
  
Line 52: Line 69:
 ===== Switching to LiteSpeed after Installation ===== ===== Switching to LiteSpeed after Installation =====
  
-If you did not set the Auto-Installer to automatically switch to LSWS (''​port_offset''​ set to ''​0''​ and ''​auto_switch_to_lsws''​ set to ''​1''​),​ the Auto-Installer will not start LSWS or switch out Apache. To switch to LiteSpeed, open our WHM LiteSpeed ​WebServer ​plugin and follow the steps below:+If you did not set the Auto-Installer to automatically switch to LSWS (''​port_offset''​ set to ''​0''​ and ''​auto_switch_to_lsws''​ set to ''​1''​),​ the Auto-Installer will not start LSWS or switch out Apache. To switch to LiteSpeed, open our WHM LiteSpeed ​Web Server ​plugin and follow the steps below:
  
 === If you set port_offset to > 0 === === If you set port_offset to > 0 ===
Line 62: Line 79:
 === If you set port_offset to 0 === === If you set port_offset to 0 ===
  
-LiteSpeed ​WebServer ​is ready and waiting to be your main web server. Clicking ​on the ''​Switch to LiteSpeed''​ button will stop Apache and start LSWS as your main web server.+LiteSpeed ​Web Server ​is ready and waiting to be your main web server. Clicking the ''​Switch to LiteSpeed''​ button will stop Apache and start LSWS as your main web server.
 ===== Switching between LiteSpeed and Apache ===== ===== Switching between LiteSpeed and Apache =====
-Switching between LiteSpeed and apache ​should be done through LiteSpeed ​plug in instead of "service httpd start" ​or "service lsws start" ​from command line. Plug in will run a series of commands ​during the switchingwhich are far beyond ​"service start/stop" ​commands. ​+Switching between LiteSpeed and Apache ​should be done through ​the LiteSpeed ​WHM plugin ​instead of ''​service httpd start'' ​or ''​service lsws start'' ​from the command line. The plugin ​will run a series of commands ​while switching which are far beyond ​the ''​service start/stop'' ​commands. ​
  
-You can also do so by running switching script from command line:+You can also do so by running ​the switching script from the command line:
  
   /​usr/​local/​lsws/​admin/​misc/​cp_switch_ws.sh apache   /​usr/​local/​lsws/​admin/​misc/​cp_switch_ws.sh apache
   /​usr/​local/​lsws/​admin/​misc/​cp_switch_ws.sh lsws    ​   /​usr/​local/​lsws/​admin/​misc/​cp_switch_ws.sh lsws    ​
 +  ​
 ===== Enable web server service monitoring ===== ===== Enable web server service monitoring =====
  
-cPanel can monitor Apache/​LiteSpeed service and restart it when needed.+cPanel can monitor ​the Apache/​LiteSpeed service and restart it when needed.
  
-Go to cPanel Service Manager and make sure "Enabled" ​and "Monitor" ​boxes are ticked for "Apache Web Server". cPanel will monitor LiteSpeed ​web server ​process ​as well, though it says "Apache". This configuration is to ensure web server ​restart ​when it is accidentally stopped.+Go to the cPanel Service Manager and make sure the ''​Enabled'' ​and ''​Monitor'' ​boxes are ticked for ''​Apache Web Server''​. cPanel will also monitor ​the LiteSpeed ​Web Server ​process ​even though it says ''​Apache''​. This configuration is to ensure ​your web server ​restarts ​when it is accidentally stopped.
  
 +{{ :​litespeed_wiki:​cpanel:​cpanel-apache-service-monitoring.png?​600 |}}
 ===== Troubleshooting ===== ===== Troubleshooting =====
  
-For common errors, see our [[litespeed_wiki:​cpanel:​troubleshooting|cPanel troubleshooting guide]].+For solutions to common errors, see our [[litespeed_wiki:​cpanel:​troubleshooting|cPanel troubleshooting guide]].
  • Admin
  • Last modified: 2016/10/13 20:32
  • by Rob Holda