Differences

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

--- litespeed_wiki:cpanel:auto-installer [2016/10/13 20:51]
Rob Holda
+++ litespeed_wiki:cpanel:auto-installer [2019/01/25 21:37]
Jackson Zhang [Auto-Installer (for cPanel/WHM installations)]
@@ Line 1: / Line 1: @@
 ====== Auto-Installer (for cPanel/WHM installations) ======
+Auto-installer used to be preferred way to install LSWS on cpanel. However we have introduce a new way to install LSWS on cpanel through ''get.litespeed.sh'' with an optional ''lsws.options'' for quick/automatic installation:
+  bash <( curl https://get.litespeed.sh ) your_serial_no
+Please check [[https://docs.litespeedtech.com/LSWS/cpanel/|this doc]] for details.
+If you still prefer an auto-installer way to install LSWS, the following are detailed steps.
 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 16: @@
 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 =====
@@ Line 17: / Line 25: @@
 ===== 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
 ===== 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:
@@ Line 38: / Line 46: @@
   * **(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 0 admin 123456 root@localhost 1 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 0 smith testpw
@@ Line 64: / Line 79: @@
 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 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:
@@ Line 77: / Line 92: @@
 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 =====
 For solutions to common errors, see our [[litespeed_wiki:cpanel:troubleshooting|cPanel troubleshooting guide]].