diff xml/ru/docs/install.xml @ 924:a2aea48ff155

New "installation" article. Old "installation" was renamed to "configure" and describes how to build nginx from sources.
author Ruslan Ermilov <ru@nginx.com>
date Fri, 31 May 2013 13:05:51 +0400
parents 65e75e59a714
children b93422ca9fe7
line wrap: on
line diff
--- a/xml/ru/docs/install.xml
+++ b/xml/ru/docs/install.xml
@@ -8,239 +8,52 @@
 <article name="Установка nginx"
          link="/ru/docs/install.html"
          lang="ru"
-         rev="3">
+         rev="1"
+         toc="no">
 
 <section>
 
 <para>
-Конфигурация сборки осуществляется командой <command>configure</command>.
-Она определяет особенности системы и, в частности, методы, которые nginx
-может использовать для обработки соединений.
-В конце концов она создаёт <path>Makefile</path>.
-Команда <command>configure</command> поддерживает следующие параметры:
-<list type="bullet">
-
-<listitem>
-<para>
-<literal>--prefix=<value>путь</value></literal>&mdash;задаёт каталог,
-в котором будут находиться файлы сервера.
-Этот же каталог будет использоваться для всех относительных путей,
-задаваемых <command>configure</command> (кроме путей к исходным текстам
-библиотек) и в конфигурационном файле <path>nginx.conf</path>.
-По умолчанию&mdash;каталог <path>/usr/local/nginx</path>.
-</para>
-</listitem>
-
-<listitem>
-<para>
-<literal>--sbin-path=<value>путь</value></literal>&mdash;задаёт
-имя исполняемого файла nginx.
-Это имя используется только на стадии установки.
-По умолчанию файл называется
-<path><value>префикс</value>/sbin/nginx</path>.
-</para>
-</listitem>
-
-<listitem>
-<para>
-<literal>--conf-path=<value>путь</value></literal>&mdash;задаёт
-имя конфигурационного файла <path>nginx.conf</path>.
-При желании nginx можно всегда запустить с другим конфигурационным файлом,
-указав его в параметре командной строки
-<nobr><literal>-c <value>файл</value></literal></nobr>.
-По умолчанию файл называется
-<path><value>префикс</value>/conf/nginx.conf</path>.
-</para>
-</listitem>
-
-<listitem>
-<para>
-<literal>--pid-path=<value>путь</value></literal>&mdash;задаёт
-имя файла nginx.pid, в котором будет храниться номер главного процесса.
-После установки имя файла можно всегда поменять в конфигурационном
-файле <path>nginx.conf</path> с помощью директивы
-<link doc="ngx_core_module.xml" id="pid"/>.
-По умолчанию имя
-файла&mdash;<path><value>префикс</value>/logs/nginx.pid</path>.
-</para>
-</listitem>
-
-<listitem>
-<para>
-<literal>--error-log-path=<value>путь</value></literal>&mdash;задаёт
-имя основного файла ошибок, предупреждений и диагностики.
-После установки имя файла можно всегда поменять в конфигурационном
-файле <path>nginx.conf</path> с помощью директивы
-<link doc="ngx_core_module.xml" id="error_log"/>.
-По умолчанию имя
-файла&mdash;<path><value>префикс</value>/logs/error.log</path>.
-</para>
-</listitem>
-
-<listitem>
-<para>
-<literal>--http-log-path=<value>путь</value></literal>&mdash;задаёт
-имя основного файла регистрации запросов HTTP-сервера.
-После установки имя файла можно всегда поменять в конфигурационном
-файле <path>nginx.conf</path> с помощью директивы
-<link doc="http/ngx_http_log_module.xml" id="access_log"/>.
-По умолчанию имя
-файла&mdash;<path><value>префикс</value>/logs/access.log</path>.
-</para>
-</listitem>
-
-<listitem>
-<para>
-<literal>--user=<value>имя</value></literal>&mdash;задаёт
-имя непривилегированного пользователя, с правами которого будут
-выполняться рабочие процессы.
-После установки это имя можно всегда поменять в конфигурационном
-файле <path>nginx.conf</path> с помощью директивы
-<link doc="ngx_core_module.xml" id="user"/>.
-По умолчанию имя пользователя nobody.
-</para>
-</listitem>
-
-<listitem>
-<para>
-<literal>--group=<value>имя</value></literal>&mdash;задаёт
-имя группы, с правами которой будут выполняться рабочие процессы.
-После установки это имя можно всегда поменять в конфигурационном
-файле <path>nginx.conf</path> с помощью директивы
-<link doc="ngx_core_module.xml" id="user"/>.
-По умолчанию группа совпадает с именем непривилегированного пользователя.
-</para>
-</listitem>
-
-<listitem>
-<para>
-<literal>--with-select_module</literal><br/>
-<literal>--without-select_module</literal>&mdash;разрешает или запрещает
-сборку модуля для работы сервера с помощью метода <c-func>select</c-func>.
-Этот модуль собирается автоматически, если на платформе не обнаружено
-более подходящего метода&mdash;kqueue, epoll, rtsig или /dev/poll.
+nginx устанавливается по-разному в зависимости от операционной системы.
 </para>
-</listitem>
 
-<listitem>
-<para>
-<literal>--with-poll_module</literal><br/>
-<literal>--without-poll_module</literal>&mdash;разрешает или запрещает
-сборку модуля для работы сервера с помощью метода <c-func>poll</c-func>.
-Этот модуль собирается автоматически, если на платформе не обнаружено
-более подходящего метода&mdash;kqueue, epoll, rtsig или /dev/poll.
-</para>
-</listitem>
-
-<listitem>
-<para>
-<literal>--without-http_gzip_module</literal>&mdash;запрещает сборку модуля
-<link doc="http/ngx_http_gzip_module.xml">сжатия ответов</link> HTTP-сервера.
-Для сборки и работы этого модуля нужна библиотека zlib.
-</para>
-</listitem>
+</section>
 
-<listitem>
-<para>
-<literal>--without-http_rewrite_module</literal>&mdash;запрещает сборку модуля
-HTTP-сервера, позволяющего <link doc="http/ngx_http_rewrite_module.xml">делать
-перенаправления и менять URI запросов</link>.
-Для сборки и работы этого модуля нужна библиотека PCRE.
-</para>
-</listitem>
 
-<listitem>
-<para>
-<literal>--without-http_proxy_module</literal>&mdash;запрещает сборку
-<link doc="http/ngx_http_proxy_module.xml">проксирующего модуля</link>
-HTTP-сервера.
-<!--
-Для сборки и работы этого модуля нужна библиотека md5.
--->
-</para>
-</listitem>
+<section id="linux" name="Установка на Linux">
 
-<listitem>
-<para>
-<literal>--with-http_ssl_module</literal>&mdash;разрешает сборку модуля
-для работы HTTP-сервера по <link doc="http/ngx_http_ssl_module.xml">протоколу
-HTTPS</link>.
-По умолчанию модуль не собирается.
-Для сборки и работы этого модуля нужна библиотека OpenSSL.
-</para>
-</listitem>
-
-<listitem>
 <para>
-<literal>--with-pcre=<value>путь</value></literal>&mdash;задаёт
-путь к исходным текстам библиотеки PCRE.
-Дистрибутив библиотеки (версию
-4.4&mdash;8.32) нужно взять на сайте <link url="http://www.pcre.org">PCRE</link>
-и распаковать.
-Всё остальное сделают ./configure nginx’а и make.
-Библиотека нужна для использования регулярных выражений в директиве
-<link doc="http/ngx_http_core_module.xml" id="location"/>
-и для модуля
-<link doc="http/ngx_http_rewrite_module.xml">ngx_http_rewrite_module</link>.
-</para>
-</listitem>
-
-<listitem>
-<para>
-<literal>--with-pcre-jit</literal>&mdash;собирает библиотеку PCRE с
-поддержкой JIT-компиляции (1.1.12, директива
-<link doc="ngx_core_module.xml" id="pcre_jit"/>).
-</para>
-</listitem>
-
-<listitem>
-<para>
-<literal>--with-zlib=<value>путь</value></literal>&mdash;задаёт
-путь к исходным текстам библиотеки zlib. Дистрибутив библиотеки (версию
-1.1.3&mdash;1.2.7) нужно взять на сайте
-<link url="http://zlib.net">zlib</link> и распаковать.
-Всё остальное сделают ./configure nginx’а и make.
-Библиотека нужна для модуля
-<link doc="http/ngx_http_gzip_module.xml">ngx_http_gzip_module</link>.
-</para>
-</listitem>
-
-<listitem>
-<para>
-<literal>--with-cc-opt=<value>параметры</value></literal>&mdash;задаёт
-дополнительные параметры, которые будут добавлены к переменной CFLAGS.
-При использовании системной библиотеки PCRE во FreeBSD, нужно указать
-<literal>--with-cc-opt="-I /usr/local/include"</literal>.
-Если нужно увеличить число файлов, с которыми может работать
-<c-func>select</c-func>, то это тоже можно задать здесь же:
-<literal>--with-cc-opt="-D FD_SETSIZE=2048"</literal>.
-</para>
-</listitem>
-
-<listitem>
-<para>
-<literal>--with-ld-opt=<value>параметры</value></literal>&mdash;задаёт
-дополнительные параметры, которые будут использованы при линковке.
-При использовании системной библиотеки PCRE во FreeBSD, нужно указать
-<literal>--with-ld-opt="-L /usr/local/lib"</literal>.
-</para>
-</listitem>
-
-</list>
-
+Для установки nginx на Linux могут быть использованы
+<link doc="../linux_packages.xml">пакеты</link> с nginx.org.
 </para>
 
+</section>
+
+
+<section id="freebsd" name="Установка на FreeBSD">
+
 <para>
-Пример использования параметров (всё это нужно набрать в одной строке):
-<programlisting>
-./configure
-    --sbin-path=/usr/local/nginx/nginx
-    --conf-path=/usr/local/nginx/nginx.conf
-    --pid-path=/usr/local/nginx/nginx.pid
-    --with-http_ssl_module
-    --with-pcre=../pcre-4.4
-    --with-zlib=../zlib-1.1.3
-</programlisting>
+На FreeBSD можно установить nginx либо из
+<link
+url="http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/packages-using.html">
+пакетов</link>, либо с помощью системы
+<link url="http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/ports-using.html">
+портов</link>.
+Система портов даёт большую гибкость, позволяя выбирать из широкого
+набора настроек.
+Порт скомпилирует nginx с выбранными опциями и установит.
+</para>
+
+</section>
+
+
+<section id="source_install" name="Сборка из исходных файлов">
+
+<para>
+Если необходима специфическая функциональность, недоступная из пакетов или
+портов, можно скомпилировать nginx из исходного кода.
+Будучи наиболее гибким, этот подход может быть сложным для начинающего.
+<link doc="configure.xml"/> освещает этот вопрос более подробно.
 </para>
 
 </section>