path: root/docs/manual/install.xml.ru

<?xml version='1.0' encoding='KOI8-R' ?>
<!DOCTYPE manualpage SYSTEM "./style/manualpage.dtd">
<?xml-stylesheet type="text/xsl" href="./style/manual.ru.xsl"?>
<!-- English Revision: 421174 -->

<!--
 Licensed to the Apache Software Foundation (ASF) under one or more
 contributor license agreements.  See the NOTICE file distributed with
 this work for additional information regarding copyright ownership.
 The ASF licenses this file to You under the Apache License, Version 2.0
 (the "License"); you may not use this file except in compliance with
 the License.  You may obtain a copy of the License at

     http://www.apache.org/licenses/LICENSE-2.0

 Unless required by applicable law or agreed to in writing, software
 distributed under the License is distributed on an "AS IS" BASIS,
 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 See the License for the specific language governing permissions and
 limitations under the License.
-->

<!--***************************************************-->
<!-- Translator: Ilia Soldatenko (soldis@tversu.ru)    -->
<!-- Reviewers:                                        -->
<!--             Ivan Shvedov (ivan@tversu.ru)         -->
<!--             Arthur Reznikov (art@altair.tversu.ru)-->
<!--***************************************************-->

<manualpage metafile="install.xml.meta">

  <title>Компилирование и установка</title>

<summary>

    <p>Этот документ освещает вопросы компилирования и установки сервера
    Apache только на UNIX и UNIX-подобных системах. Если вы хотите установить
    сервер под Windows, то вам необходимо прочитать документ <a
    href="platform/windows.html">&#0171;Использование Apache под Microsoft Windows&#0187;</a>.
    Информация, касающаяся остальных платформ, содержится в документе
    <a href="platform/">&#0171;Платформы&#0187;</a>.</p>

    <p>Среда конфигурирования и установки сервера полностью отличается от той, которая была
    в Apache 1.3. Apache 1.3 использовал обычный набор скриптов, позволявший упростить
    процесс установки. Apache 2.0 теперь использует системы <code>libtool</code> и
    <code>autoconf</code>, что делает сервер похожим на другие программные продукты
    с открытым исходным кодом (Open Source projects).</p>
    
    <p>Если вы переходите от младшего релиза сервера к старшему внутри
    одной и той же ветки (например, от 2.0.50 к 2.0.51), то
    можете начать чтение с раздела <a href="#upgrading">апгрейд</a>.</p>

</summary>

<seealso><a href="programs/configure.html">Конфигурирование дерева исходных кодов</a></seealso>
<seealso><a href="invoking.html">Запуск сервера</a></seealso>
<seealso><a href="stopping.html">Остановка и перезапуск</a></seealso>

<section id="overview"><title>Краткий обзор &#0171;для нетерпеливых&#0187;</title>

    <table>
    <columnspec><column width=".13"/><column width=".80"/></columnspec>
      <tr>
        <td><a href="#download">Загрузка</a></td>

        <td><code>$ lynx http://httpd.apache.org/download.cgi</code>
        </td>
      </tr>

      <tr>
        <td><a href="#extract">Распаковка</a></td>

        <td><code>$ gzip -d httpd-2_0_<em>NN</em>.tar.gz<br />
         $ tar xvf httpd-2_0_<em>NN</em>.tar</code> </td>
      </tr>

      <tr>
        <td><a href="#configure">Конфигурирование</a></td>

        <td><code>$ ./configure --prefix=<em>PREFIX</em></code>
        </td>
      </tr>

      <tr>
        <td><a href="#compile">Компилирование</a></td>

        <td><code>$ make</code> </td>
      </tr>

      <tr>
        <td><a href="#install">Установка</a></td>

        <td><code>$ make install</code> </td>
      </tr>

      <tr>
        <td><a href="#customize">Настройка</a></td>

        <td><code>$ vi <em>PREFIX</em>/conf/httpd.conf</code> </td>
      </tr>

      <tr>
        <td><a href="#test">Пробный запуск</a></td>

        <td><code>$ <em>PREFIX</em>/bin/apachectl start</code>
        </td>
      </tr>
    </table>

    <p><em>NN</em> необходимо заменить на текущий младший номер версии,
    а вместо <em>PREFIX</em> надо указать путь, по
    которому должен быть установлен сервер. Если <em>PREFIX</em> не указан,
    то установка по умолчанию производится в каталог
    <code>/usr/local/apache2</code>.</p>

    <p>Более подробно все этапы компилирования и установки сервера рассмотрены
    ниже, причём начинается следующий раздел с описания системных требований,
    необходимых, для того чтобы установка прошла успешно.</p>
</section>

<section id="requirements"><title>Требования</title>

    <p>Требования, необходимые для успешной сборки сервера:</p>

    <dl>
      <dt>Дисковое пространство</dt>
      <dd>Убедитесь, что на диске есть как мининимум 50 MB
      свободного места для временных файлов. После установки
      Apache занимает приблизительно 10 MB. Точный размер занимаемого
      места будет зависеть в основном от выбранной конфигурации и
      дополнительно устанавливаемых модулей, не входящих в дистрибутив
      Apache.</dd>

      <dt>ANSI-C компилятор и необходимая среда сборки</dt>
      <dd>Убедитесь, что в вашей системе установлен ANSI-C
      компилятор. Рекомендуется использовать <a
      href="http://www.gnu.org/software/gcc/gcc.html">GNU C
      компилятор (GCC)</a> от <a
      href="http://www.gnu.org/">Free Software Foundation (FSF)</a>
      (версии 2.7.2 вполне достаточно). Если у вас другой компилятор,
      то выясните, поддерживает ли он стандарт ANSI. Проверьте также,
      чтобы в переменной окружения <code>PATH</code> был указан каталог,
      содержащий основные утилиты, необходимые для сборки (<code>make</code> и другие).</dd>

      <dt>Синхронизация времени</dt>
      <dd>В некоторых заголовках HTTP протокола указывается время.
      Поэтому вам необходимо выяснить, как можно установить в вашей
      системе средство синхронизации времени. Обычно для этих целей
      используются программы <code>ntpdate</code> или <code>xntpd</code>,
      основанные на сетевом протоколе синхронизации времени
      (Network Time Protocol - NTP). Для получения более подробной информации
      об NTP и серверах синхронизации времени, обратитесь в группу новостей Usenet <a
      href="news:comp.protocols.time.ntp">comp.protocols.time.ntp</a>,
      а также посетите <a href="http://www.ntp.org">домашнюю страницу NTP</a>.</dd>

      <dt><a href="http://www.perl.org/">Perl 5</a>
      [ОПЦИОНАЛЬНО]</dt>
      <dd>Для выполнения некоторых вспомогательных скриптов, таких как
      <program>apxs</program> или <program>dbmmanage</program>
      (которые написаны на Perl), необходим интерпретатор с языка Perl
      (версии 5.003 или выше достаточно).
      Если в вашей
      системе установлено несколько интерпретаторов с языка Perl (например Perl 4 и Perl 5),
      то для того чтобы скрипт <program>configure</program> выбрал нужный, выполните
      его с опцией <code>--with-perl</code> (описание смотрите ниже).
      Если конфигурационный скрипт
      <program>configure</program> не найдёт его в вашей системе, то вы всё равно
      сможете собрать и установить Apache 2.0 - в этом случае не будут
      работать только перечисленные выше вспомогательные скрипты.
      </dd>
    </dl>
</section>

<section id="download"><title>Загрузка</title>

    <p>Apache можно загрузить со <a
    href="http://httpd.apache.org/download.cgi">страницы загрузки Apache HTTP Software
    Foundation</a>, на которой также приводится список некоторых зеркальных серверов.
    Пользователям, работающим на unix-подобных системах, рекомендуется
    собирать Apache из исходных кодов. Процесс сборки (описанный ниже)
    достаточно прост и позволяет настроить сервер под ваши нужды.
    К тому же зачастую бинарные пакеты содержат устаревшую версию сервера.
    Если же вы всё-таки загрузили бинарный пакет, то следуйте инструкциям,
    находящимся в файле <code>INSTALL.bindist</code> из дистрибутива.</p>

    <p>После загрузки дистрибутива, необходимо убедиться, что у вас в руках полная,
    неизменённая версия HTTP сервера Apache. Это можно сделать
    тестированием архива (tarball) на соответствие PGP подписи.
    Процедура проверки детально описана на <a
    href="http://httpd.apache.org/download.cgi#verify">странице
	загрузки</a>. Также вы можете посмотреть <a
    href="http://httpd.apache.org/dev/verification.html">подробный
	пример использования PGP</a>.</p>

</section>

<section id="extract"><title>Распаковка</title>

    <p>Распаковка архива исходных кодов Apache
    заключается в его непосредственной распаковке и
    разархивировании (untarring):</p>

<example>
$ gzip -d httpd-2_0_<em>NN</em>.tar.gz<br />
$ tar xvf httpd-2_0_<em>NN</em>.tar
</example>

    <p>После выполнения этих команд будет создан новый каталог
    с исходными кодами сервера. Вы должны зайти
    в этот каталог, прежде чем начнёте компилировать сервер.</p>
</section>

<section id="configure"><title>Конфигурирование дерева исходных кодов</title>

    <p>Следующий шаг заключается в конфигурировании дерева исходных
    кодов в соответствии с той системой, на которую вы устанавливаете
    сервер, и вашими собственными нуждами. Это делается при помощи
    скрипта <program>configure</program>, расположенного в корневом каталоге
    дистрибутива. (Разработчики, загружающие дерево исходных кодов посредством
    CVS, должны установить в своей системе утилиты <code>autoconf</code>
    и <code>libtool</code> и выполнить программу <code>buildconf</code>, прежде
    чем они смогут продолжнить установку. В официальных выпусках сервера
    этого делать не требуется.)</p>

    <p>Для конфигурирования дерева исходных кодов с использованием
    значений всех опций по умолчанию, просто выполните скрипт <code>./configure</code>
    без параметров. Для изменения значений опций, скрипт <program>configure</program>
    предлагает широкий набор переменных и опций командной строки.</p>
    
    <p>Наиболее важная опция здесь - это префикс каталога
    установки (<code>--prefix</code>), то есть тот путь, по которому
    впоследствии будет установлен Apache.
    Возможен более гибкий контроль над тем, куда будут установлены
    файлы сервера, осуществляемый дополнительными  <a
    href="programs/configure.html#installationdirectories">опциями
	конфигурации</a>.</p>
	
	<p>Также сейчас самое время решить, какой <a
    href="programs/configure.html#optionalfeatures">функциональностью</a>
	вы хотите наделить ваш веб-сервер путём включения и отключения
	соответствующих <a href="mod/">модулей</a>. По умолчанию,
	Apache компилируется с <a
    href="mod/module-dict.html#Status">базовым</a> набором модулей.
    Все остальные модули подключаются при помощи опции
    <code>--enable-<var>module</var></code>, где <code>module</code> -
    это название модуля, из которого убран префикс <code>mod_</code>
    и все символы подчёркивания заменены на символы тире.
    Вы также можете скомпилировать модули как <a
    href="dso.html">динамически подключаемые объекты (DSO)</a> --
    они могут быть загружены и выгружены из сервера во время
    его работы -- в этом случае используйте опцию
    <code>--enable-<var>module</var>=shared</code>. Отключение
    базового модуля производится при помощи опции
    <code>--disable-<var>module</var></code>. Используйте данные
    опции с осторожностью, так как <program>configure</program>
    не сможет предупредить вас в том случае, если модуля, который
    вы указали, нет; он просто проигнорирует соответствующую опцию.</p>
    
    <p>Наконец, иногда бывает необходимо предоставить скрипту
    <program>configure</program> дополнительную информацию о
    расположении вашего компилятора, библиотек или заголовочных файлов.
    Это можно сделать либо при помощи переменных окружения, либо
    при помощи опций командной строки скрипта <program>configure</program>.
    За более подробной информацией обращайтесь к справочному руководству
    скрипта <program>configure</program>.</p>

    <p>Для того чтобы получить представление о гибкости процесса конфигурирования Apache,
    рассмотрите приведённый ниже типичный пример запуска скрипта <code>./configure</code>.
    Такая конфигурация позволяет скомпилировать
    сервер для последующей установки
    в каталог <code>/sw/pkg/apache</code>, используя указанный компилятор с
	несколькими предназначенными для него опциями командной строки, и установить
	ещё два добавочных модуля <module>mod_rewrite</module> и <module>mod_speling</module>,
    которые можно будет потом использовать посредством механизма DSO.</p>

<example>
      $ CC="pgcc" CFLAGS="-O2" \<br />
       ./configure --prefix=/sw/pkg/apache \<br />
       --enable-rewrite=shared \<br />
       --enable-speling=shared
</example>

    <p>При выполнении, скрипт <program>configure</program> проверяет, установлено ли в вашей системе
    всё необходимое, а затем создает Make-файлы, которые будут затем использованы
    для компилирования сервера.</p>
    
    <p>Подробное описание всех возможных опций скрипта
    <program>configure</program> приведено в справочном руководстве
    <program>configure</program>.</p>
</section>


<section id="compile"><title>Сборка</title>

    <p>Теперь вы можете скомпилировать и собрать сервер Apache,
    выполнив следующую команду:</p>

<example>$ make</example>

    <p>Наберитесь терпения - компилирование сервера с базовой конфигурацией
    (конфигурацией по умолчанию) занимает приблизительно три минуты
    на такой системе, как Pentium III/Linux 2.2. Реальное время сборки
    будет зависеть от вашего аппаратного обеспечения и от количества
    модулей, которые вы решили компилировать вместе с сервером.</p>
</section>

<section id="install"><title>Установка</title>

    <p>Теперь настало время для установки сервера в каталог
    <em>PREFIX</em>, который был указан при конфигурировании Apache
    (смотрите выше опцию <code>--prefix</code>), выполнив:</p>

<example>$ make install</example>

    <p>Если устанавливать Apache поверх предыдущей версии сервера, то
    старые конфигурационные файлы и документы будут оставлены без изменений.</p>
</section>

<section id="customize"><title>Настройка</title>

    <p>Далее вы можете настроить ваш HTTP сервер Apache посредством редактирования
    <a href="configuring.html">конфигурационных файлов</a> в каталоге
    <code><em>PREFIX</em>/conf/</code>.</p>

<example>$ vi <em>PREFIX</em>/conf/httpd.conf</example>

    <p>Руководство по использованию Apache вы можете найти либо по локальному
    адресу у себя на сервере <a href="./">docs/manual/</a>, либо на официальном
    сайте Apache <a
    href="http://httpd.apache.org/docs/&httpd.docs;/">http://httpd.apache.org/docs/&httpd.docs;/</a>,
    где опубликована самая последняя версия документации и вся необходимая справочная информация
    по всем возможным <a href="mod/directives.html">конфигурационным директивам</a>.</p>
</section>

<section id="test"><title>Тестирование</title>

    <p>Теперь вы можете <a href="invoking.html">запустить</a> свой HTTP сервер Apache,
    выполнив следующую команду:</p>

<example>$ <em>PREFIX</em>/bin/apachectl start</example>

    <p>и если всё прошло успешно, то вы сможете запросить свой первый документ
    по адресу <code>http://localhost/</code>. Веб-страница, которую вы увидете,
    находится в каталоге <directive module="core">DocumentRoot</directive> - по умолчанию,
    это <code><em>PREFIX</em>/htdocs/</code>. Затем <a href="stopping.html">остановите</a>
    сервер следующей командой:</p>

<example>$ <em>PREFIX</em>/bin/apachectl stop</example>
</section>

<section id="upgrading"><title>Апгрейд</title>
	
	<p>Первым шагом при апгрейде является чтение информации о релизе
	и файла <code>CHANGES</code>, находящегося в дереве исходных
	кодов - это поможет вам понять, каким образом апгрейд повлияет
	на ваш текущий веб-сервер. При переходе между разными ветками
	сервера (например, с 1.3 на 2.0, или с 2.0 на 2.2), скорее всего
	появятся существенные нововведения в конфигурировании процесса сборки
	или работы сервера, которые потребуют анализа и ручной настройки.
	Все модули также необходимо будет проапгрейдить, для того чтобы
	они могли соответствовать изменениям в API модулей.</p>
	
	<p>Апгрейд, осуществляемый внутри одной ветки сервера
	(например, с 2.0.55 на 2.0.57) существенно проще.
	Выполнение команды <code>make install</code> не перезапишет
	никакие существующие документы, файлы логов или конфигурационные файлы.
	В дополнение к этому, разработчики сервера делают всё возможное,
	чтобы избежать несовместимости в опциях скрипта <program>configure</program>,
	рабочей конфигурации сервера и API модулей для разных
	младших релизов внутри одной ветки. В большинстве случаев вы
	можете использовать идентичную строку запуска скрипта
	<program>configure</program>, тот же самый конфигурационный файл
	и быть уверенными, что все ваши модули продолжат работать.
	(Это верно только для версий сервера, начиная с 2.0.41; предыдущие
	версии имеют несовместимые изменения.)</p>
	
	<p>Для апгрейда с одного младшего релиза на другой, начните
	с поиска файла <code>config.nice</code>, который должен находиться
	либо в каталоге <code>build</code> сервера, либо
	в корне дерева исходных кодов рабочего сервера. Этот файл
	содержит в себе точную копию строки запуска скрипта
	<program>configure</program>, которую вы использовали
	при конфигурировании дерева исходных кодов. Затем, чтобы
	осуществить апгрейд, скопируйте файл <code>config.nice</code>
	в дерево исходных кодов новой версии сервера, внесите в него
	все необходимые изменения, а затем выполните:</p>
	
	<example>
    $ ./config.nice<br />
    $ make<br />
    $ make install<br />
    $ <em>PREFIX</em>/bin/apachectl stop<br />
    $ <em>PREFIX</em>/bin/apachectl start<br />
    </example>
    
    <note type="warning">Всегда тестируйте новую версию сервера
    прежде, чем запускать её в работу. Например, вы можете
    установить и запустить новую версию сервера рядом с текущей, используя
    другой префикс установки <code>--prefix</code> и другой
    номер порта (путём изменения значения директивы <directive
    module="mpm_common">Listen</directive>), для того чтобы
    протестировать сервер на совместимость с рабочей конфигурацией,
    прежде чем делать финальный апгрейд.</note>

</section>

</manualpage>