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/11/14 19:58]
Jackson Zhang [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 38: Line 48:
   * **(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).   * **(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 0 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 0 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 64: Line 81:
 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. 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 the LiteSpeed 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. ​+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 the switching script from the command line: You can also do so by running the switching script from the command line:
Line 77: Line 94:
 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. 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 solutions to 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/11/14 19:58
  • by Jackson Zhang