HTTP сервер Apache версии 2.0
Этот документ освещает вопросы компилирования и установки сервера Apache только на UNIX и UNIX-подобных системах. Если вы хотите установить сервер под Windows, то вам необходимо прочитать документ «Использование Apache под Microsoft Windows». Информация, касающаяся остальных платформ, содержится в документе «Платформы».
Среда конфигурирования и установки сервера полностью отличается от той, которая была в Apache 1.3. Apache 1.3 использовал обычный набор скриптов, позволявший упростить процесс установки. Apache 2.0 теперь использует системы libtool
и autoconf
, что делает сервер похожим на другие программные продукты с открытым исходным кодом (Open Source projects).
Если вы переходите от младшего релиза сервера к старшему внутри одной и той же ветки (например, от 2.0.50 к 2.0.51), то можете начать чтение с раздела апгрейд.
Загрузка | $ lynx http://httpd.apache.org/download.cgi |
Распаковка | $ gzip -d httpd-2_0_NN.tar.gz |
Конфигурирование | $ ./configure --prefix=PREFIX |
Компилирование | $ make |
Установка | $ make install |
Настройка | $ vi PREFIX/conf/httpd.conf |
Пробный запуск | $ PREFIX/bin/apachectl start |
NN необходимо заменить на текущий младший номер версии, а вместо PREFIX надо указать путь, по которому должен быть установлен сервер. Если PREFIX не указан, то установка по умолчанию производится в каталог /usr/local/apache2
.
Более подробно все этапы компилирования и установки сервера рассмотрены ниже, причём начинается следующий раздел с описания системных требований, необходимых, для того чтобы установка прошла успешно.
Требования, необходимые для успешной сборки сервера:
PATH
был указан каталог, содержащий основные утилиты, необходимые для сборки (make
и другие).ntpdate
или xntpd
, основанные на сетевом протоколе синхронизации времени (Network Time Protocol - NTP). Для получения более подробной информации об NTP и серверах синхронизации времени, обратитесь в группу новостей Usenet comp.protocols.time.ntp, а также посетите домашнюю страницу NTP.apxs
или dbmmanage
(которые написаны на Perl), необходим интерпретатор с языка Perl (версии 5.003 или выше достаточно). Если в вашей системе установлено несколько интерпретаторов с языка Perl (например Perl 4 и Perl 5), то для того чтобы скрипт configure
выбрал нужный, выполните его с опцией --with-perl
(описание смотрите ниже). Если конфигурационный скрипт configure
не найдёт его в вашей системе, то вы всё равно сможете собрать и установить Apache 2.0 - в этом случае не будут работать только перечисленные выше вспомогательные скрипты.Apache можно загрузить со страницы загрузки Apache HTTP Software Foundation, на которой также приводится список некоторых зеркальных серверов. Пользователям, работающим на unix-подобных системах, рекомендуется собирать Apache из исходных кодов. Процесс сборки (описанный ниже) достаточно прост и позволяет настроить сервер под ваши нужды. К тому же зачастую бинарные пакеты содержат устаревшую версию сервера. Если же вы всё-таки загрузили бинарный пакет, то следуйте инструкциям, находящимся в файле INSTALL.bindist
из дистрибутива.
После загрузки дистрибутива, необходимо убедиться, что у вас в руках полная, неизменённая версия HTTP сервера Apache. Это можно сделать тестированием архива (tarball) на соответствие PGP подписи. Процедура проверки детально описана на странице загрузки. Также вы можете посмотреть подробный пример использования PGP.
Распаковка архива исходных кодов Apache заключается в его непосредственной распаковке и разархивировании (untarring):
$ gzip -d httpd-2_0_NN.tar.gz
$ tar xvf httpd-2_0_NN.tar
После выполнения этих команд будет создан новый каталог с исходными кодами сервера. Вы должны зайти в этот каталог, прежде чем начнёте компилировать сервер.
Следующий шаг заключается в конфигурировании дерева исходных кодов в соответствии с той системой, на которую вы устанавливаете сервер, и вашими собственными нуждами. Это делается при помощи скрипта configure
, расположенного в корневом каталоге дистрибутива. (Разработчики, загружающие дерево исходных кодов посредством CVS, должны установить в своей системе утилиты autoconf
и libtool
и выполнить программу buildconf
, прежде чем они смогут продолжнить установку. В официальных выпусках сервера этого делать не требуется.)
Для конфигурирования дерева исходных кодов с использованием значений всех опций по умолчанию, просто выполните скрипт ./configure
без параметров. Для изменения значений опций, скрипт configure
предлагает широкий набор переменных и опций командной строки.
Наиболее важная опция здесь - это префикс каталога установки (--prefix
), то есть тот путь, по которому впоследствии будет установлен Apache. Возможен более гибкий контроль над тем, куда будут установлены файлы сервера, осуществляемый дополнительными опциями конфигурации.
Также сейчас самое время решить, какой функциональностью вы хотите наделить ваш веб-сервер путём включения и отключения соответствующих модулей. По умолчанию, Apache компилируется с базовым набором модулей. Все остальные модули подключаются при помощи опции --enable-module
, где module
- это название модуля, из которого убран префикс mod_
и все символы подчёркивания заменены на символы тире. Вы также можете скомпилировать модули как динамически подключаемые объекты (DSO) -- они могут быть загружены и выгружены из сервера во время его работы -- в этом случае используйте опцию --enable-module=shared
. Отключение базового модуля производится при помощи опции --disable-module
. Используйте данные опции с осторожностью, так как configure
не сможет предупредить вас в том случае, если модуля, который вы указали, нет; он просто проигнорирует соответствующую опцию.
Наконец, иногда бывает необходимо предоставить скрипту configure
дополнительную информацию о расположении вашего компилятора, библиотек или заголовочных файлов. Это можно сделать либо при помощи переменных окружения, либо при помощи опций командной строки скрипта configure
. За более подробной информацией обращайтесь к справочному руководству скрипта configure
.
Для того чтобы получить представление о гибкости процесса конфигурирования Apache, рассмотрите приведённый ниже типичный пример запуска скрипта ./configure
. Такая конфигурация позволяет скомпилировать сервер для последующей установки в каталог /sw/pkg/apache
, используя указанный компилятор с несколькими предназначенными для него опциями командной строки, и установить ещё два добавочных модуля mod_rewrite
и mod_speling
, которые можно будет потом использовать посредством механизма DSO.
$ CC="pgcc" CFLAGS="-O2" \
./configure --prefix=/sw/pkg/apache \
--enable-rewrite=shared \
--enable-speling=shared
При выполнении, скрипт configure
проверяет, установлено ли в вашей системе всё необходимое, а затем создает Make-файлы, которые будут затем использованы для компилирования сервера.
Подробное описание всех возможных опций скрипта configure
приведено в справочном руководстве configure
.
Теперь вы можете скомпилировать и собрать сервер Apache, выполнив следующую команду:
$ make
Наберитесь терпения - компилирование сервера с базовой конфигурацией (конфигурацией по умолчанию) занимает приблизительно три минуты на такой системе, как Pentium III/Linux 2.2. Реальное время сборки будет зависеть от вашего аппаратного обеспечения и от количества модулей, которые вы решили компилировать вместе с сервером.
Теперь настало время для установки сервера в каталог PREFIX, который был указан при конфигурировании Apache (смотрите выше опцию --prefix
), выполнив:
$ make install
Если устанавливать Apache поверх предыдущей версии сервера, то старые конфигурационные файлы и документы будут оставлены без изменений.
Далее вы можете настроить ваш HTTP сервер Apache посредством редактирования конфигурационных файлов в каталоге PREFIX/conf/
.
$ vi PREFIX/conf/httpd.conf
Руководство по использованию Apache вы можете найти либо по локальному адресу у себя на сервере docs/manual/, либо на официальном сайте Apache http://httpd.apache.org/docs/2.0/, где опубликована самая последняя версия документации и вся необходимая справочная информация по всем возможным конфигурационным директивам.
Теперь вы можете запустить свой HTTP сервер Apache, выполнив следующую команду:
$ PREFIX/bin/apachectl start
и если всё прошло успешно, то вы сможете запросить свой первый документ по адресу http://localhost/
. Веб-страница, которую вы увидете, находится в каталоге DocumentRoot
- по умолчанию, это PREFIX/htdocs/
. Затем остановите сервер следующей командой:
$ PREFIX/bin/apachectl stop
Первым шагом при апгрейде является чтение информации о релизе и файла CHANGES
, находящегося в дереве исходных кодов - это поможет вам понять, каким образом апгрейд повлияет на ваш текущий веб-сервер. При переходе между разными ветками сервера (например, с 1.3 на 2.0, или с 2.0 на 2.2), скорее всего появятся существенные нововведения в конфигурировании процесса сборки или работы сервера, которые потребуют анализа и ручной настройки. Все модули также необходимо будет проапгрейдить, для того чтобы они могли соответствовать изменениям в API модулей.
Апгрейд, осуществляемый внутри одной ветки сервера (например, с 2.0.55 на 2.0.57) существенно проще. Выполнение команды make install
не перезапишет никакие существующие документы, файлы логов или конфигурационные файлы. В дополнение к этому, разработчики сервера делают всё возможное, чтобы избежать несовместимости в опциях скрипта configure
, рабочей конфигурации сервера и API модулей для разных младших релизов внутри одной ветки. В большинстве случаев вы можете использовать идентичную строку запуска скрипта configure
, тот же самый конфигурационный файл и быть уверенными, что все ваши модули продолжат работать. (Это верно только для версий сервера, начиная с 2.0.41; предыдущие версии имеют несовместимые изменения.)
Для апгрейда с одного младшего релиза на другой, начните с поиска файла config.nice
, который должен находиться либо в каталоге build
сервера, либо в корне дерева исходных кодов рабочего сервера. Этот файл содержит в себе точную копию строки запуска скрипта configure
, которую вы использовали при конфигурировании дерева исходных кодов. Затем, чтобы осуществить апгрейд, скопируйте файл config.nice
в дерево исходных кодов новой версии сервера, внесите в него все необходимые изменения, а затем выполните:
$ ./config.nice
$ make
$ make install
$ PREFIX/bin/apachectl stop
$ PREFIX/bin/apachectl start
--prefix
и другой номер порта (путём изменения значения директивы Listen
), для того чтобы протестировать сервер на совместимость с рабочей конфигурацией, прежде чем делать финальный апгрейд.