Differences

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

--- litespeed_wiki:plesk:installation [2015/08/31 21:15]
Michael Alegre [Install LSWS]
+++ litespeed_wiki:plesk:installation [2015/09/04 21:26] (current)
Michael Alegre [Stop Nginx Reverse Proxy Before LiteSpeed Installation]
@@ Line 3: / Line 3: @@
 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.
-===== 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 =====
   - OS: Linux, Solaris, FreeBSD, or MacOSX
   - A working Apache setup
-  - Plesk 11 or higher
+  - Plesk 11.5 or higher
 ===== Install the Plesk Extension =====
@@ Line 39: / Line 17: @@
 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 our Plesk Extension in the Plesk Extension catalog as LiteSpeed Extension 1.2.x.
+**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 > LiteSpeed Extension.
+==== Stop 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, you must stop Nginx reverse proxy so that Apache is the only web server handling live traffic or the LiteSpeed process will be blocked from being started.
+If Nginx reverse proxy is not currently stopped, you will encounter the following message in the LiteSpeed extension:
+{{:litespeed_wiki:plesk-nginx-error.png?nolink|}}
+** 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}}.
+Once it has stopped, you should no longer see the message and can move on to installation.
 ==== Install LSWS ====
@@ Line 64: / Line 64: @@
 Click "Install LiteSpeed Web Server".
-{{litespeed_wiki:plesk:plesk_fresh_install.png?700}}
+{{ :litespeed_wiki:plesk-fresh-install.png?direct 800px |}}
 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 |}}
 Scrolling down a little further will present you with "Installation Options" and "WebAdmin Console Login" sections.
-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, you are also able to specify your desired PHP version from our available RPMs under the "After Installation Notes" section.
+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.
-{{litespeed_wiki:plesk:plesk_installation_options.png?700}}
+{{ :litespeed_wiki:plesk-installation-options.png?direct 800px |}}
 When you're ready, click the "Install" button at the bottom.
-{{litespeed_wiki:plesk:plesk_lsws_installed.png?700}}
+{{ :litespeed_wiki:plesk-lsws-installed.png?direct 800px |}}
 Now, click "Okay" at the bottom of the page and start LSWS by clicking "Restart LiteSpeed".
-{{litespeed_wiki:plesk:plesk_start_lsws.png?700}}
+{{ :litespeed_wiki:plesk-lsws-start.png?direct 800px |}}
 If successful, you should now a message similar to the following on your LiteSpeed Extension page:
-PIC
+{{ :litespeed_wiki:plesk-lsws-running.png?nolink |}}
 ==== Get PHP for LSWS ====
-LSWS requires PHP built with LSAPI. There are a number of ways to get PHP 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.
-  - 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]]. Follow our [[litespeed_wiki:php:rpm|Installing LSPHP via RPM]] guide for these steps.
+  - 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 WebAdmin console or through the command line. Building PHP yourself is covered in our [[litespeed_wiki:php:lsapi|Compile PHP for LSWS]] 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.
-Once you have completed PHP installation, go to the next step: testing your sites.
+Once you have completed PHP installation, go to the next step: testing!
 ==== 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.
+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_port_offset.png?700}}
+{{ :litespeed_wiki:plesk-port-offset.png?direct 800px |}}
-Once you're confident that your sites are running correctly with LSWS, it's time to switch to LSWS as your main server.
+Once you're confident that your sites are running correctly with LSWS, it's time to switch to LSWS as your main web 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 is now running as your main web server. Congratulations!
-{{litespeed_wiki:plesk:plesk_lsws_running.png?700}}
+{{ :litespeed_wiki:plesk-sucessful-switch.png?direct 800px |}}