Differences
This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
litespeed_wiki:cpanel:auto-installer [2016/12/19 15:21] Johathan Kagan [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 ===== | ||
Line 71: | 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 84: | 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]]. |