Differences

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

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
Next revision Both sides next revision
litespeed_wiki:plesk:installation [2014/08/04 14:24]
Michael Armstrong [Install LSWS]
litespeed_wiki:plesk:installation [2015/09/04 21:26] (current)
Michael Alegre [Stop Nginx Reverse Proxy Before LiteSpeed Installation]
Line 1: Line 1:
 ====== Installing LSWS with Plesk ====== ====== 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.+
  
 ===== Prerequisites ===== ===== Prerequisites =====
  
-  - OSs: Linux, Solaris, FreeBSD, or MacOSX+  - OS: Linux, Solaris, FreeBSD, or MacOSX
   - A working Apache setup   - A working Apache setup
-  - Plesk 11 or up+  - Plesk 11.5 or higher
  
 ===== Install the Plesk Extension ===== ===== Install the Plesk Extension =====
Line 17: Line 15:
   wget http://​www.litespeedtech.com/​packages/​plesk/​litespeed-plesk.zip   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 ==== ==== Add the extension from Plesk ====
  
 Server Management > Extensions > Add Extension > litespeed-plesk.zip 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}}+
  
-=== Plesk 11Run the commands requested === +{{ :litespeed_wiki:plesk-extension-success.png?​direct 800px |}}
-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}}+=== Plesk 11.5Run the commands requested === 
 +Plesk 11.5 requires root level commands be run from the command line to finish LSWS installation.
  
-**Note:** Plesk 11 users will also see a warning that ''/​sbin/''​ is not used when installingThis is normal and appears because the extension is compatible with both Plesk 11 and 12.+{{ :litespeed_wiki:​plesk-11.5-install.png?direct 800px |}}
  
-===== Install LSWS from the Plesk Extension =====+Run the commands requested as root to complete the installation:​
  
-You can now access the LiteSpeed Plesk Extension under Server Management > Extensions > Module LiteSpeed.+  sh /​usr/​local/​psa/​admin/​plib/​modules/​litespeed/​scripts/​install_scripts 
 +  rm /​usr/​local/​psa/​admin/​plib/​modules/​litespeed/​scripts/​install_scripts
  
-==== Install LSWS ====+**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.
  
-Click "Install ​LiteSpeed Web Server"​.+===== Install ​LSWS from the Plesk Extension =====
  
-{{litespeed_wiki:​plesk:​plesk_fresh_install.png?700}}+You can now access the LiteSpeed Plesk Extension under Server Management > Extensions > LiteSpeed Extension.
  
-Check "I agree" and input your license'​s serial number or request a trial license.+==== Stop Nginx Reverse Proxy Before LiteSpeed Installation ====
  
-{{litespeed_wiki:​plesk:​plesk_request_trial.png?700}}+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.
  
-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.+If Nginx reverse proxy is not currently stopped, ​you will encounter the following message in the LiteSpeed extension:
  
-**Other installation settings**+{{:​litespeed_wiki:​plesk-nginx-error.png?​nolink|}}
  
-  ​Installation directory: Defines where LSWS will be installed. +** Stopping Nginx reverse proxy: **
-  ​Port offsetAllows 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. This setting must be enabled if you currently use suEXEC. +
-  ​Administrator email(s): Administrator emails.+
  
-When you're readyclick the "​Install"​ button at the bottom.+From the Plesk Admin Consolenavigate to...
  
-{{litespeed_wiki:​plesk:​plesk_installation_options.png?​700}}+Server Management -> Tools and Settings -> Server Management -> Services Management -> Reverse Proxy Server (nginx)
  
-{{litespeed_wiki:​plesk:​plesk_lsws_installed.png?700}}+...and click the stop button ​{{:litespeed_wiki:​plesk-stop-button.png}}.
  
-Nowstart LSWS by clicking "​Restart LiteSpeed"​.+Once it has stoppedyou should no longer see the message and can move on to installation.
  
-{{litespeed_wiki:​plesk:​plesk_start_lsws.png?​700}} +==== Install ​LSWS ====
-==== Build 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.)+Click "Install LiteSpeed Web Server".
  
-Access the WebAdmin console by clicking "​WebAdmin Console"​.+{{ :​litespeed_wiki:​plesk-fresh-install.png?direct 800px |}}
  
-{{litespeed_wiki:​plesk:​plesk_webadmin_console.png?700}}+After reading the License Agreement, check the "I agree" box and either input your license'​s serial number or request a trial license.
  
-Use the user name and password you set during installation to log in.+{{ :​litespeed_wiki:​plesk-request-trial.png?direct 800px |}}
  
-{{litespeed_wiki:​plesk:​plesk_webadmin_login.png?700}}+Scrolling down a little further will present you with "​Installation Options"​ and "​WebAdmin Console Login" sections.
  
-The Build PHP tool can be found under Actions > Compile PHP.+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_php_menu.png?700}}+{{ :litespeed_wiki:​plesk-installation-options.png?direct 800px |}}
  
-Select your PHP version number.+When you're ready, click the "​Install"​ button at the bottom.
  
-{{litespeed_wiki:​plesk:​plesk_php_version.png?700}}+{{ :litespeed_wiki:​plesk-lsws-installed.png?direct 800px |}}
  
-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.+Now, click "​Okay"​ at the bottom of the page and start LSWS by clicking "​Restart LiteSpeed"​.
  
-{{litespeed_wiki:​plesk:​plesk_php_configure.png?700}}+{{ :litespeed_wiki:​plesk-lsws-start.png?direct 800px |}}
  
-LSWS will prepare to build PHP. When it is doneclick "​Next"​.+If successfulyou should now a message similar to the following on your LiteSpeed Extension page:
  
-{{litespeed_wiki:​plesk:​plesk_php_prep.png?700}}+{{ :litespeed_wiki:​plesk-lsws-running.png?nolink |}} 
 +==== Get PHP for LSWS ====
  
-You will now be asked to run script as root to build PHP.+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 number of ways to get PHP with LSAPI
  
-{{litespeed_wiki:​plesk:plesk_php_build.png?700}}+  - 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.
  
-Because LSWS builds PHP from source code you may have to install some missing libraries to build PHP.+Once you have completed PHP installation,​ go to the next step: testing! 
 +==== Test your sites with a port offset ====
  
-Restart LSWS when the build is complete.+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_restart_lsws.png?700}}+{{ :litespeed_wiki:​plesk-port-offset.png?direct 800px |}}
  
-==== Test your sites with a port offset ==== +Once you're confident that your sites are running correctly with LSWS, it's time to switch to LSWS as your main web server.
-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 ==== ==== Switch to LSWS ====
 Click "​Switch to LiteSpeed"​. This will stop Apache and switch LSWS to your main server ports — 80 and 443. 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 serverCongratulations!
  
 +{{ :​litespeed_wiki:​plesk-sucessful-switch.png?​direct 800px |}}
 
litespeed_wiki/plesk/installation.1407162259.txt.gz · Last modified: 2014/08/04 14:24 by Michael Armstrong