diff xml/en/linux_packages.xml @ 882:d1002c39ac0a

Linux packages related information moved to separate page. Documentation about packages for mainline version added.
author Sergey Budnevitch <sb@waeme.net>
date Tue, 02 Apr 2013 20:53:03 +0400
parents
children 893d36b6d013
line wrap: on
line diff
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/xml/en/linux_packages.xml	Tue Apr 02 20:53:03 2013 +0400
@@ -0,0 +1,266 @@
+<!--
+  Copyright (C) Nginx, Inc.
+  -->
+
+<!DOCTYPE article SYSTEM "../../dtd/article.dtd">
+
+<article name="nginx: Linux packages"
+         link="/en/linux_packages.html"
+         lang="en"
+         rev="1"
+         toc="no">
+
+<section id="distributions">
+
+<para>
+Currently, nginx packages are available for the following distributions and
+versions:
+</para>
+
+<para>
+RHEL/CentOS:
+
+<table note="yes">
+
+<tr>
+<td width="20%">Version</td>
+</tr>
+
+<tr>
+<td width="20%">5.x</td>
+</tr>
+
+<tr>
+<td width="20%">6.x</td>
+</tr>
+
+</table>
+</para>
+
+<para>
+Debian:
+
+<table note="yes">
+
+<tr>
+<td width="20%">Version</td>
+<td>Codename</td>
+</tr>
+
+<tr>
+<td width="20%">6.x</td>
+<td>squeeze</td>
+</tr>
+
+</table>
+</para>
+
+<para>
+Ubuntu:
+
+<table note="yes">
+
+<tr>
+<td width="20%">Version</td>
+<td>Codename</td>
+</tr>
+
+<tr>
+<td width="20%">10.04</td>
+<td>lucid</td>
+</tr>
+
+<tr>
+<td width="20%">11.10</td>
+<td>oneiric</td>
+</tr>
+
+<tr>
+<td width="20%">12.04</td>
+<td>precise</td>
+</tr>
+
+<tr>
+<td width="20%">12.10</td>
+<td>quantal</td>
+</tr>
+
+</table>
+</para>
+
+<para>
+To enable automatic updates of Linux packages
+set up the yum repository for the RHEL/CentOS distributions,
+or the apt repository for the Debian/Ubuntu distributions.
+</para>
+
+</section>
+
+
+<section name="Pre-Built Packages for Stable version" id="stable">
+
+<para>
+To set up the yum repository for RHEL/CentOS, choose the corresponding
+<literal>nginx-release</literal> package from the list:
+
+<list type="bullet">
+
+<listitem>
+<link url="http://nginx.org/packages/rhel/5/noarch/RPMS/nginx-release-rhel-5-0.el5.ngx.noarch.rpm">RHEL 5</link>
+</listitem>
+
+<listitem>
+<link url="http://nginx.org/packages/rhel/6/noarch/RPMS/nginx-release-rhel-6-0.el6.ngx.noarch.rpm">RHEL 6</link>
+</listitem>
+
+<listitem>
+<link url="http://nginx.org/packages/centos/5/noarch/RPMS/nginx-release-centos-5-0.el5.ngx.noarch.rpm">CentOS 5</link>
+</listitem>
+
+<listitem>
+<link url="http://nginx.org/packages/centos/6/noarch/RPMS/nginx-release-centos-6-0.el6.ngx.noarch.rpm">CentOS 6</link>
+</listitem>
+
+</list>
+
+This package contains yum configuration file
+and a public PGP key necessary to authenticate signed RPMs.
+Download and install it, then run the following:
+<programlisting>
+yum install nginx
+</programlisting>
+
+Alternatively, a repository configuration can be added manually
+without installing the <literal>nginx-release</literal> package.
+Create the file named <path>/etc/yum.repos.d/nginx.repo</path>
+with the following contents:
+
+<programlisting>
+[nginx]
+name=nginx repo
+baseurl=http://nginx.org/packages/OS/OSRELEASE/$basearch/
+gpgcheck=0
+enabled=1
+</programlisting>
+
+Replace “<literal>OS</literal>” with “<literal>rhel</literal>” or
+“<literal>centos</literal>”,
+depending on the distribution used, and “<literal>OSRELEASE</literal>”
+with “<literal>5</literal>” or “<literal>6</literal>”,
+for 5.x or 6.x versions, respectively.
+</para>
+
+<para>
+For Debian/Ubuntu, in order to authenticate the nginx repository signature
+and to eliminate warnings about missing gpg key during installation of the
+nginx package, it is necessary to add the key used to sign the nginx
+packages and repository to the <command>apt</command> program keyring.
+Please download <link url="http://nginx.org/keys/nginx_signing.key">this
+key</link> from our web site, and add it to the <command>apt</command>
+program keyring with the following command:
+<programlisting>
+sudo apt-key add nginx_signing.key
+</programlisting>
+</para>
+
+<para>
+For Debian replace <i>codename</i> with Debian distribution
+<link id="distributions">codename</link>, and append the following to
+the end of the <path>/etc/apt/sources.list</path> file:
+
+<programlisting>
+deb http://nginx.org/packages/debian/ <i>codename</i> nginx
+deb-src http://nginx.org/packages/debian/ <i>codename</i> nginx
+</programlisting>
+</para>
+
+<para>
+For Ubuntu replace <i>codename</i> with Ubuntu distribution
+<link id="distributions">codename</link>, and append the following to
+the end of the <path>/etc/apt/sources.list</path> file:
+
+<programlisting>
+deb http://nginx.org/packages/ubuntu/ <i>codename</i> nginx
+deb-src http://nginx.org/packages/ubuntu/ <i>codename</i> nginx
+</programlisting>
+</para>
+
+<para>
+For Debian/Ubuntu then run the following commands:
+<programlisting>
+apt-get update
+apt-get install nginx
+</programlisting>
+</para>
+
+</section>
+
+
+<section name="Pre-Built Packages for Mainline version" id="mainline">
+
+<para>
+To set up the yum repository for RHEL/CentOS, create the file named
+<path>/etc/yum.repos.d/nginx.repo</path>
+with the following contents:
+
+<programlisting>
+[nginx]
+name=nginx repo
+baseurl=http://nginx.org/packages/mainline/OS/OSRELEASE/$basearch/
+gpgcheck=0
+enabled=1
+</programlisting>
+
+Replace “<literal>OS</literal>” with “<literal>rhel</literal>” or
+“<literal>centos</literal>”,
+depending on the distribution used, and “<literal>OSRELEASE</literal>”
+with “<literal>5</literal>” or “<literal>6</literal>”,
+for 5.x or 6.x versions, respectively.
+</para>
+
+<para>
+For Debian/Ubuntu, in order to authenticate the nginx repository signature
+and to eliminate warnings about missing gpg key during installation of the
+nginx package, it is necessary to add the key used to sign the nginx
+packages and repository to the <command>apt</command> program keyring.
+Please download <link url="http://nginx.org/keys/nginx_signing.key">this
+key</link> from our web site, and add it to the <command>apt</command>
+program keyring with the following command:
+<programlisting>
+sudo apt-key add nginx_signing.key
+</programlisting>
+</para>
+
+<para>
+For Debian replace <i>codename</i> with Debian distribution
+<link id="distributions">codename</link>, and append the following to
+the end of the <path>/etc/apt/sources.list</path> file:
+
+<programlisting>
+deb http://nginx.org/packages/mainline/debian/ <i>codename</i> nginx
+deb-src http://nginx.org/packages/mainline/debian/ <i>codename</i> nginx
+</programlisting>
+</para>
+
+<para>
+For Ubuntu replace <i>codename</i> with Ubuntu distribution
+<link id="distributions">codename</link>, and append the following to
+the end of the <path>/etc/apt/sources.list</path> file:
+
+<programlisting>
+deb http://nginx.org/packages/mainline/ubuntu/ <i>codename</i> nginx
+deb-src http://nginx.org/packages/mainline/ubuntu/ <i>codename</i> nginx
+</programlisting>
+</para>
+
+<para>
+For Debian/Ubuntu then run the following commands:
+<programlisting>
+apt-get update
+apt-get install nginx
+</programlisting>
+</para>
+
+</section>
+
+</article>