Differences

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

--- litespeed_wiki:install:commandline [2014/06/27 18:50]
Michael Armstrong [Step 2: Unpack and Install]
+++ litespeed_wiki:install:commandline [2015/07/20 19:13]
Michael Alegre removed
@@ Line 1: / Line 1: @@
-====== How to Install LiteSpeed Web Server from the Command Line ======
+====== How to Set Up LiteSpeed Web Server from the Command Line ======
-Scope: Standard Edition and Enterprise Edition.
+This wiki covers how to set up LSWS (either Enterprise or Standard edition) from the command line on a server that already has a working Apache installation. This wiki guides the user through the steps necessary to install LSWS and build PHP. **This wiki assumes that the user already has a working Apache installation.** LSWS will automatically read and run off the Apache configs already on this server.
-Audience: Those familiar with the Unix/Linux console command line environment and see the GUI as a distraction and overhead.
+This wiki is meant for those familiar with the Unix/Linux console command line environment that see a GUI as a distraction and overhead.
+This wiki is not meant for users using [[litespeed_wiki:cpanel:auto-installer|cPanel/WHM]], [[litespeed_wiki:plesk:installation|Plesk]], or [[litespeed_wiki:directadmin:apache|DirectAdmin]]. Users using a control panel should use the guide associated with their control panel.
 ===== Step 1: Download the LSWS package =====
@@ Line 32: / Line 33: @@
 The installer will ask you a number of questions (covered in detail [[http://www.litespeedtech.com/docs/webserver/install|here]]).
-**Note:** It may be best to set Port Offset to a number other than "0". If Port Offset is set to "0", LSWS may stop Apache and start LSWS after a successful installation. This is not ideal, since we still need to build the PHP binary for LiteSpeed.
+**Note:** The installer will ask you to set a port offset. It may be best to set Port Offset to a number other than "0". If Port Offset is set to "0", LSWS may stop Apache and start LSWS after a successful installation. This is not ideal, since we still need to build the PHP binary for LiteSpeed.
-===== Step 3: Build matching PHP binary =====
+===== Step 3: Build matching PHP =====
-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.
-<del>If LiteSpeed is running, you should switch back to Apache temporarily by clicking "switch to Apache" link.</del>
+LSWS comes with a pre-built PHP 5 binary, but this only contains the barest of configurations and is not enough to run most websites. You should build your own PHP binary using configuration options to match those used by Apache.
-Then, click "Build Matching PHP binary" link. It is going 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 Settings) to at lease 512MB.
+You can build PHP in two ways:
-<file>
+  - Using the WebAdmin console. This is highly recommended, even for users who generally prefer the command line, as it combines steps. Simply access the WebAdmin through port 7080 and go to Actions > Compile PHP. There you will be guided through the steps to build PHP.
-Found Errors
+  - [[litespeed_wiki:php:lsapi|From the command line.]]
-ERROR: /usr/local/bin/php -i returns 134
+===== Step 4: Verify and switch ports =====
-You can try to build matching PHP from command line:
+Restart LSWS
-"/usr/local/cpanel/whostmgr/cgi/lsws/cmd_buildmatchingphp.sh"
-</file>
+  /usr/local/lsws/bin/lswsctrl restart
-===== Step 4: Start LiteSpeed again =====
+Now you can verify on the port you've chosen with you port offset that everything works as expected. It should! 8-)
-Just click "Restart LiteSpeed"
+Once you've verified, switch LSWS onto port 80.
-Then you can verify if everything works as expected. It should! 8-)
-If "Port Offset" is set to non-zero, you can now replace Apache with LiteSpeed Web Server. Just click "Switch to LiteSpeed".
 That's it.
-**WARNING:** Do **NOT** uncheck "httpd" service under WHM service manager, otherwise WHM wont restart LiteSpeed automatically when configuration has been changed.