Differences

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

--- litespeed_wiki:plesk:installation [2014/07/30 14:21]
Michael Armstrong [Add the extension from Plesk]
+++ litespeed_wiki:plesk:installation [2015/09/02 19:13]
Michael Alegre [Add the extension from Plesk]
@@ Line 1: / Line 1: @@
 ====== Installing LSWS with Plesk ======
-This wiki will cover how to install LiteSpeed Web Server (LSWS) and LiteSpeed's [[http://www.litespeedtech.com/products/control-panel-plugins/plesk-extension|Plesk Extension]] on a Plesk server. There are multiple ways to go about the installation. The wiki will only cover installing the Plesk Extension first and then installing LSWS from the extension.
+This wiki covers how to install LiteSpeed Web Server (LSWS) and LiteSpeed's [[http://www.litespeedtech.com/products/control-panel-plugins/plesk-extension|Plesk Extension]] on a Plesk server. We assume that you have a working Apache-Plesk setup. While there are multiple ways to go about the installation, this wiki will only cover installing the Plesk Extension first and then installing LSWS from the extension.
-This wiki assumes that you have a working Apache-Plesk setup.
+===== Stopping Nginx Reverse Proxy Before LiteSpeed Installation =====
+The latest version of Plesk may configure Nginx as a reverse proxy server that sits in between the Internet and Apache. Before installing LSWS, please turn off Nginx reverse proxy so that Apache is the only web server handling live traffic. Not stopping the Nginx reverse proxy will cause system errors and block the LiteSpeed process from being started.
+** Stopping Nginx reverse proxy: **
+From the Plesk Admin Console, navigate to...
+Server Management -> Tools and Settings -> Server Management -> Services Management -> Reverse Proxy Server (nginx)
+...and click the stop button {{:litespeed_wiki:plesk-stop-button.png}}.
+Verify that no nginx process is still running with the following command:
+  ps -ef | grep nginx | grep master
+If you do not see any output than the process has been stopped.\\
+If instead you see the following output:
+  root    16379    1  0 09:45 ?     00:00:00 nginx: master process /usr/sbin/nginx -c /etc/nginx/nginx.conf
+the Nginx reverse proxy has not yet been stopped and must still be stopped before attempting LiteSpeed installation.
 ===== Prerequisites =====
-  - OSs: Linux, Solaris, FreeBSD, or MacOSX
+  - OS: Linux, Solaris, FreeBSD, or MacOSX
   - A working Apache setup
-  - Plesk 11 or up
+  - Plesk 11.5 or higher
 ===== Install the Plesk Extension =====
@@ Line 17: / Line 37: @@
   wget http://www.litespeedtech.com/packages/plesk/litespeed-plesk.zip
-Or simply visit our [[http://www.litespeedtech.com/products/control-panel-plugins/download|control panel plugin download page]] and download it to your PC.
+Or simply visit our [[http://www.litespeedtech.com/products/control-panel-plugins/download|control panel plugin download page]] and download it to your machine.
-**Note:** Plesk 12 users can also find the Plesk Extension in the Plesk Extension catalog.
+**Note:** Plesk 12 users can also find our Plesk Extension in the Plesk Extension catalog as "LiteSpeed Extension 1.2.x".
 ==== Add the extension from Plesk ====
 Server Management > Extensions > Add Extension > litespeed-plesk.zip
-{{litespeed_wiki:plesk:plesk_upload_extension.png?700}}
+{{ :litespeed_wiki:plesk-extension-upload.png?direct 800px |}}
-{{litespeed_wiki:plesk:plesk_install_success.png?700}}
+{{ :litespeed_wiki:plesk-extension-success.png?direct 800px |}}
+=== Plesk 11.5: Run the commands requested ===
+Plesk 11.5 requires root level commands be run from the command line to finish LSWS installation.
+{{ :litespeed_wiki:plesk-11.5-install.png?direct 800px |}}
+Run the commands requested as root to complete the installation:
-=== Plesk 11: Run the commands requested ===
-Plesk 11 requires root level commands be run from the command line. To finish the installation, run the commands requested as root:
   sh /usr/local/psa/admin/plib/modules/litespeed/scripts/install_scripts
   rm /usr/local/psa/admin/plib/modules/litespeed/scripts/install_scripts
-{{litespeed_wiki:plesk:plesk_install_commands2.png?700}}
+**Note:** Plesk 11.5 users will also see a warning that ''/sbin/'' is not used when installing. This is normal and appears because the extension is compatible with both Plesk 11.5 and 12.
-**Note:** Plesk 11 users will also see a warning that ''/sbin/'' is not used when installing. This is normal and appears because the extension is compatible with both Plesk 11 and 12.
 ===== Install LSWS from the Plesk Extension =====
-You can now access the LiteSpeed Plesk Extension under Server Management > Extensions > Module LiteSpeed.
+You can now access the LiteSpeed Plesk Extension under Server Management > Extensions > LiteSpeed Extension.
 ==== Install LSWS ====
@@ Line 44: / Line 68: @@
 Click "Install LiteSpeed Web Server".
-{{litespeed_wiki:plesk:plesk_fresh_install.png?700}}
+{{ :litespeed_wiki:plesk-fresh-install.png?direct 800px |}}
-Check "I agree" and input your license's serial number or request a trial license.
+After reading the License Agreement, check the "I agree" box and either input your license's serial number or request a trial license.
-{{litespeed_wiki:plesk:plesk_request_trial.png?700}}
+{{ :litespeed_wiki:plesk-request-trial.png?direct 800px |}}
-You must also set a password for LSWS's WebAdmin console. Other settings are optional, though it is recommended you install the first time with a port offset.
+Scrolling down a little further will present you with "Installation Options" and "WebAdmin Console Login" sections.
-**Other installation settings**
+The default values for the "Installation Options" section should be acceptable, though it is recommended that you set a non-zero "Port offset" for first time installations. For the "WebAdmin Console Login" section, you are only required to enter a password, but it is recommended to use a username other than the default for security reasons. As of version 1.2.3, CentOS users are also able to specify their desired PHP version from our available RPMs under the "After Installation Notes" section.
-  * Installation directory: Defines where LSWS will be installed.
+{{ :litespeed_wiki:plesk-installation-options.png?direct 800px |}}
-  * Port offset: Allows running LSWS in parallel with Apache for testing purposes. The number in the port offset will be added to Apache port numbers to determine what port LSWS runs on. (For example, if the port offset is 1000, LSWS will serve sites on ports 1080 and 1443.)
-  * Enable PHP suEXEC: Enables or disables suEXEC. suEXEC must be enabled through the LSWS settings if it is to be used.
-  * Administrator email(s): Administrator emails.
 When you're ready, click the "Install" button at the bottom.
-{{litespeed_wiki:plesk:plesk_installation_options.png?700}}
+{{ :litespeed_wiki:plesk-lsws-installed.png?direct 800px |}}
-{{litespeed_wiki:plesk:plesk_lsws_installed.png?700}}
+Now, click "Okay" at the bottom of the page and start LSWS by clicking "Restart LiteSpeed".
-Now, start LSWS by clicking "Restart LiteSpeed".
+{{ :litespeed_wiki:plesk-lsws-start.png?direct 800px |}}
-{{litespeed_wiki:plesk:plesk_start_lsws.png?700}}
+If successful, you should now a message similar to the following on your LiteSpeed Extension page:
-==== Build PHP for LSWS ====
+{{ :litespeed_wiki:plesk-lsws-running.png?nolink |}}
+==== Get PHP for LSWS ====
-LSWS requires PHP built with LSAPI. We will be building PHP through the WebAdmin console, but PHP can also be built through the command line. (When building from the command line, simply add the %%"--with-litespeed"%% option to have it built with LSAPI.)
+LSWS requires PHP built with LSAPI. If you are using CentOS and have already selected a PHP version during installation, you can skip this step. There are a number of ways to get PHP with LSAPI.
-Access the WebAdmin console by clicking "WebAdmin Console".
+  - Many Plesk users may find it easiest to get PHP for LSWS through the [[http://www.litespeedtech.com/support/wiki/doku.php?id=litespeed_wiki:php:rpm#installing_php_from_the_litespeed_repository|Litespeed Repository]] or [[http://rpms.famillecollet.com/|Remi Repository]].For instructions on how to do this, follow our [[litespeed_wiki:php:rpm|Installing LSPHP via RPM]] guide.
+  - You can also build PHP through the LSWS WebAdmin Console or through the command line. Building PHP yourself is covered in our [[litespeed_wiki:php:lsapi|Compile PHP for LSWS]] guide.
-{{litespeed_wiki:plesk:plesk_webadmin_console.png?700}}
+Once you have completed PHP installation, go to the next step: testing!
+==== Test your sites with a port offset ====
-Use the user name and password you set during installation to log in.
+The beauty of the port offset is that you can run LSWS and Apache in parallel. This means you can test out hosting your sites on LSWS to make sure they work before actually turning off Apache. In this setup, I have set the port offset to 1000. If I want to test any sites, I can do so on ports 1080 and 1443 for HTTP and SSL requests respectively.
-{{litespeed_wiki:plesk:plesk_webadmin_login.png?700}}
+{{ :litespeed_wiki:plesk-port-offset.png?direct 800px |}}
-The Build PHP tool can be found under Actions > Compile PHP.
+Once you're confident that your sites are running correctly with LSWS, it's time to switch to LSWS as your main web server.
-{{litespeed_wiki:plesk:plesk_php_menu.png?700}}
-Select your PHP version number.
-{{litespeed_wiki:plesk:plesk_php_version.png?700}}
-Configure your PHP with the options you want. Pay special attention to the Configure Parameters field. These parameters must mirror the PHP options you have with Apache for LSWS to serve your PHP sites correctly.
-{{litespeed_wiki:plesk:plesk_php_configure.png?700}}
-LSWS will prepare to build PHP. When it is done, click "Next".
-{{litespeed_wiki:plesk:plesk_php_prep.png?700}}
-You will now be asked to run a script as root to build PHP.
-{{litespeed_wiki:plesk:plesk_php_build.png?700}}
-Because LSWS builds PHP from source code you may have to install some missing libraries to build PHP.
-Restart LSWS when the build is complete.
-{{litespeed_wiki:plesk:plesk_restart_lsws.png?700}}
-==== Test your sites with a port offset ====
-The beauty of the port offset is that you can run LSWS and Apache in parallel. This means you can try out your sites with LSWS to make sure they work before atually turning off Apache. In our setup, I have set the port offset to 1000. If I want to check any sites, I can do so on ports 1080 and 1443.
-{{litespeed_wiki:plesk:plesk_port_offset.png?700}}
-Once you're confident that your sites are running correctly with LSWS, it's time to switch to LSWS as your main server.
 ==== Switch to LSWS ====
 Click "Switch to LiteSpeed". This will stop Apache and switch LSWS to your main server ports — 80 and 443.
-{{litespeed_wiki:plesk:plesk_lsws_switch.png?700}}
+{{ :litespeed_wiki:plesk-switch-to-lsws.png?direct 800px |}}
-And now you're running LiteSpeed!
-{{litespeed_wiki:plesk:plesk_lsws_running.png?700}}
+LiteSpeed is now running as your main web server. Congratulations!
+{{ :litespeed_wiki:plesk-sucessful-switch.png?direct 800px |}}