Actions

Help

Difference between revisions of "Repositories"

From OpenLiteSpeed Wiki

m (Marmstrong moved page Repositories to Help:Repositories: Should be under "Help" category)
 
(51 intermediate revisions by 6 users not shown)
Line 1: Line 1:
== CentOS 5, 6 & 7 ==
+
We offer repositories for CentOS 5, 6, 7, Debian 7, 8 & Ubuntu 12, 14, 16
 +
 
 +
__TOC__
 +
 
 +
== CentOS 5, 6 & 7 | Debian 7,8 | Ubuntu 12, 14,16 | Amazon Linux==
 +
 
 +
=== Add the Repository ===
  
 
Use the following commands to add our CentOS repositories:
 
Use the following commands to add our CentOS repositories:
Line 9: Line 15:
 
CentOS 7: <code>rpm -ivh http://rpms.litespeedtech.com/centos/litespeed-repo-1.1-1.el7.noarch.rpm</code>
 
CentOS 7: <code>rpm -ivh http://rpms.litespeedtech.com/centos/litespeed-repo-1.1-1.el7.noarch.rpm</code>
  
Once these repositories have been installed, you can use yum to install, update, or uninstall OpenLiteSpeed. <code>yum install openlitespeed</code> will install the latest version of OpenLiteSpeed. Using version numbers, for example <code>yum install openlitespeed-1.2.1</code>, will install older versions. 1.2.1 is the oldest version in the repository.
+
Debian 7, 8 & Ubuntu 12,14, 16: <code> wget -O - http://rpms.litespeedtech.com/debian/enable_lst_debain_repo.sh | bash </code>
 +
 
 +
Amazon Linux <code>wget http://rpms.litespeedtech.com/centos/litespeed.repo -P /etc/yum.repos.d/</code>
 +
 
 +
=== Install OpenLiteSpeed ===
 +
 
 +
<pre>For CentOS: yum install openlitespeed</pre>
 +
<pre>For Debian & Ubuntu: apt-get install openlitespeed</pre>
 +
 
 +
The above command installs the latest version of OpenLiteSpeed. You can also specify version numbers, for example <code>yum install openlitespeed-1.2.1</code>, will install older versions. 1.2.1 is the oldest version in the repository.
 +
 
 +
'''Note:''' The OpenLiteSpeed packages in our repositories have SPDY enabled. The binary also includes the OpenSSL library needed to run SPDY. You do not have to install OpenSSL 1.0.1 to use SPDY if you download the package from the repositories.
 +
 
 +
=== Install PHP ===
 +
 
 +
<pre>For CentOS:
 +
yum install lsphp56 lsphp56-common lsphp56-mysql lsphp56-gd lsphp56-process lsphp56-mbstring lsphp56-xml lsphp56-mcrypt lsphp56-pdo lsphp56-imap lsphp56-soap lsphp56-bcmath
 +
ln -sf /usr/local/lsws/lsphp54/bin/lsphp /usr/local/lsws/fcgi-bin/lsphp5</pre>
 +
 
 +
<pre>For Debian & Ubuntu:
 +
apt-get install lsphp56-*
 +
ln -sf /usr/local/lsws/lsphp56/bin/lsphp /usr/local/lsws/fcgi-bin/lsphp5</pre>
 +
 
 +
For CentOS: The above commands will install PHP 5.6 for OpenLiteSpeed from [[Help:PHP_via_RPM#LiteSpeed_Repository|our repository]] with all commonly used packages and direct OpenLiteSpeed to use this PHP. This build of PHP should be enough to support most commonly used web applications.
 +
 
 +
For Debian & Ubuntu: The above commands will install PHP 5.6 with all commonly used packages for OpenLiteSpeed from our Debian Repo, and direct OpenLiteSpeed to use this PHP. This build of PHP should be enough to support most commonly used web applications.
 +
 
 +
To use a custom PHP build, see our wikis on [[Help:PHP_via_RPM|PHP via RPM]] and [[Help:Build_Custom_PHP|building a custom PHP from source]].
 +
 
 +
=== Getting Started ===
 +
 
 +
* The default installation directory is /usr/local/lsws.
 +
 
 +
* For detailed information on controlling the server processes, please see the [[Help:Administration|administration guide]].
 +
: '''To start the server''', simply run <code>/usr/local/lsws/bin/lswsctrl start</code>. (To stop it, run <code>/usr/local/lsws/bin/lswsctrl stop</code>.)
 +
 
 +
* A sample site should be running on the server.
 +
: To access your site, point your browser to http://[address]:8088/, [address] being the IP address or domain name of your web server machine. Use "localhost" if the server is on the machine you are using. By default, OpenLiteSpeed runs on port "8088".
 +
: A congratulations page linked to other testing pages should load into the browser when pointed to the above address. If not, try testing the WebAdmin interface.
  
'''Note:''' The OpenLiteSpeed packages in our repositories have SPDY enabled. The binary also includes the OpenSSL library needed to run SPDY. This means that you don't have to install OpenSSL 1.0.1 to use SPDY if you download the package from the repositories, making the repositories the way to go if you're using CentOS and want SPDY.
+
* The default port for the WebAdmin console is 7080.
 +
: Plug https://[address]:7080/, into your browser to go to the WebAdmin interface.
 +
: Remember the "https://" and that for [address] you can use "localhost" if you're currently using the machine the server is on.
 +
: A login page should load. The defaults for the administrator's user name and password are "admin" and "123456".
 +
: For detailed information regarding configuration, please refer to our Configuration Guide, or click the "Help" link at the top of each page.
  
'''Note:''' To prevent users from mistakenly upgrading to a beta version, OpenLiteSpeed 1.4 is not yet in our repository. It will be added when it is no longer beta.
+
* If your server uses a firewall, please make sure that localhost is trusted.
 +
: For instance, Linux with IPTables should include a rule ALLOW INPUT from LO.
  
== Debian Wheezy ==
+
* If your website and the WebAdmin console are inaccessible, please take a look at the error log <code>/usr/local/lsws/logs/error.log</code>.
 +
: If there is a TCP port conflict with other server applications, you will need to stop the application currently running on port 7080. The following command can be used to check port 7080: <code>netstat -an | grep 7080</code>. If the port is available, the command will produce no output.
 +
: If the swapping directory is not writable, you can either grant writing permission for the swapping directory to the user whom the web server is running as, or change the swapping directory's configurations manually. The swapping directory is configured in the server's XML configuration file: <code>/usr/local/lsws/conf/httpd_config.xml</code>. Search the XML file for "swappingDir". The default location for the swapping directory is <code>/tmp/lshttpd/swap</code>.
 +
: If you still have problems with installation, please check the [https://groups.google.com/forum/#!forum/openlitespeed-development OpenLiteSpeed Development Group].
  
Stefano Balocco has created a Debian Wheezy package of OpenLiteSpeed in [http://apt.balocco.name/ his repository]. You are welcome to try it out. We make no guarantees about its efficacy or safety, but thanks, Stefano!
+
[[Category:Installation]]

Latest revision as of 20:53, 31 January 2018

We offer repositories for CentOS 5, 6, 7, Debian 7, 8 & Ubuntu 12, 14, 16

CentOS 5, 6 & 7 | Debian 7,8 | Ubuntu 12, 14,16 | Amazon Linux

Add the Repository

Use the following commands to add our CentOS repositories:

CentOS 5: rpm -ivh http://rpms.litespeedtech.com/centos/litespeed-repo-1.1-1.el5.noarch.rpm

CentOS 6: rpm -ivh http://rpms.litespeedtech.com/centos/litespeed-repo-1.1-1.el6.noarch.rpm

CentOS 7: rpm -ivh http://rpms.litespeedtech.com/centos/litespeed-repo-1.1-1.el7.noarch.rpm

Debian 7, 8 & Ubuntu 12,14, 16: wget -O - http://rpms.litespeedtech.com/debian/enable_lst_debain_repo.sh | bash

Amazon Linux wget http://rpms.litespeedtech.com/centos/litespeed.repo -P /etc/yum.repos.d/

Install OpenLiteSpeed

For CentOS: yum install openlitespeed
For Debian & Ubuntu: apt-get install openlitespeed

The above command installs the latest version of OpenLiteSpeed. You can also specify version numbers, for example yum install openlitespeed-1.2.1, will install older versions. 1.2.1 is the oldest version in the repository.

Note: The OpenLiteSpeed packages in our repositories have SPDY enabled. The binary also includes the OpenSSL library needed to run SPDY. You do not have to install OpenSSL 1.0.1 to use SPDY if you download the package from the repositories.

Install PHP

For CentOS:
yum install lsphp56 lsphp56-common lsphp56-mysql lsphp56-gd lsphp56-process lsphp56-mbstring lsphp56-xml lsphp56-mcrypt lsphp56-pdo lsphp56-imap lsphp56-soap lsphp56-bcmath
ln -sf /usr/local/lsws/lsphp54/bin/lsphp /usr/local/lsws/fcgi-bin/lsphp5
For Debian & Ubuntu:
apt-get install lsphp56-* 
ln -sf /usr/local/lsws/lsphp56/bin/lsphp /usr/local/lsws/fcgi-bin/lsphp5

For CentOS: The above commands will install PHP 5.6 for OpenLiteSpeed from our repository with all commonly used packages and direct OpenLiteSpeed to use this PHP. This build of PHP should be enough to support most commonly used web applications.

For Debian & Ubuntu: The above commands will install PHP 5.6 with all commonly used packages for OpenLiteSpeed from our Debian Repo, and direct OpenLiteSpeed to use this PHP. This build of PHP should be enough to support most commonly used web applications.

To use a custom PHP build, see our wikis on PHP via RPM and building a custom PHP from source.

Getting Started

  • The default installation directory is /usr/local/lsws.
To start the server, simply run /usr/local/lsws/bin/lswsctrl start. (To stop it, run /usr/local/lsws/bin/lswsctrl stop.)
  • A sample site should be running on the server.
To access your site, point your browser to http://[address]:8088/, [address] being the IP address or domain name of your web server machine. Use "localhost" if the server is on the machine you are using. By default, OpenLiteSpeed runs on port "8088".
A congratulations page linked to other testing pages should load into the browser when pointed to the above address. If not, try testing the WebAdmin interface.
  • The default port for the WebAdmin console is 7080.
Plug https://[address]:7080/, into your browser to go to the WebAdmin interface.
Remember the "https://" and that for [address] you can use "localhost" if you're currently using the machine the server is on.
A login page should load. The defaults for the administrator's user name and password are "admin" and "123456".
For detailed information regarding configuration, please refer to our Configuration Guide, or click the "Help" link at the top of each page.
  • If your server uses a firewall, please make sure that localhost is trusted.
For instance, Linux with IPTables should include a rule ALLOW INPUT from LO.
  • If your website and the WebAdmin console are inaccessible, please take a look at the error log /usr/local/lsws/logs/error.log.
If there is a TCP port conflict with other server applications, you will need to stop the application currently running on port 7080. The following command can be used to check port 7080: netstat -an | grep 7080. If the port is available, the command will produce no output.
If the swapping directory is not writable, you can either grant writing permission for the swapping directory to the user whom the web server is running as, or change the swapping directory's configurations manually. The swapping directory is configured in the server's XML configuration file: /usr/local/lsws/conf/httpd_config.xml. Search the XML file for "swappingDir". The default location for the swapping directory is /tmp/lshttpd/swap.
If you still have problems with installation, please check the OpenLiteSpeed Development Group.