<-
Главная > Документация

Компилирование и установка

Этот документ освещает вопросы компилирования и установки сервера 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), то можете начать чтение с раздела апгрейд.

См. также

top

Краткий обзор «для нетерпеливых»

Загрузка $ lynx http://httpd.apache.org/download.cgi
Распаковка $ gzip -d httpd-2_0_NN.tar.gz
$ tar xvf httpd-2_0_NN.tar
Конфигурирование $ ./configure --prefix=PREFIX
Компилирование $ make
Установка $ make install
Настройка $ vi PREFIX/conf/httpd.conf
Пробный запуск $ PREFIX/bin/apachectl start

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

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

top

Требования

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

Дисковое пространство
Убедитесь, что на диске есть как мининимум 50 MB свободного места для временных файлов. После установки Apache занимает приблизительно 10 MB. Точный размер занимаемого места будет зависеть в основном от выбранной конфигурации и дополнительно устанавливаемых модулей, не входящих в дистрибутив Apache.
ANSI-C компилятор и необходимая среда сборки
Убедитесь, что в вашей системе установлен ANSI-C компилятор. Рекомендуется использовать GNU C компилятор (GCC) от Free Software Foundation (FSF) (версии 2.7.2 вполне достаточно). Если у вас другой компилятор, то выясните, поддерживает ли он стандарт ANSI. Проверьте также, чтобы в переменной окружения PATH был указан каталог, содержащий основные утилиты, необходимые для сборки (make и другие).
Синхронизация времени
В некоторых заголовках HTTP протокола указывается время. Поэтому вам необходимо выяснить, как можно установить в вашей системе средство синхронизации времени. Обычно для этих целей используются программы ntpdate или xntpd, основанные на сетевом протоколе синхронизации времени (Network Time Protocol - NTP). Для получения более подробной информации об NTP и серверах синхронизации времени, обратитесь в группу новостей Usenet comp.protocols.time.ntp, а также посетите домашнюю страницу NTP.
Perl 5 [ОПЦИОНАЛЬНО]
Для выполнения некоторых вспомогательных скриптов, таких как apxs или dbmmanage (которые написаны на Perl), необходим интерпретатор с языка Perl (версии 5.003 или выше достаточно). Если в вашей системе установлено несколько интерпретаторов с языка Perl (например Perl 4 и Perl 5), то для того чтобы скрипт configure выбрал нужный, выполните его с опцией --with-perl (описание смотрите ниже). Если конфигурационный скрипт configure не найдёт его в вашей системе, то вы всё равно сможете собрать и установить Apache 2.0 - в этом случае не будут работать только перечисленные выше вспомогательные скрипты.
top

Загрузка

Apache можно загрузить со страницы загрузки Apache HTTP Software Foundation, на которой также приводится список некоторых зеркальных серверов. Пользователям, работающим на unix-подобных системах, рекомендуется собирать Apache из исходных кодов. Процесс сборки (описанный ниже) достаточно прост и позволяет настроить сервер под ваши нужды. К тому же зачастую бинарные пакеты содержат устаревшую версию сервера. Если же вы всё-таки загрузили бинарный пакет, то следуйте инструкциям, находящимся в файле INSTALL.bindist из дистрибутива.

После загрузки дистрибутива, необходимо убедиться, что у вас в руках полная, неизменённая версия HTTP сервера Apache. Это можно сделать тестированием архива (tarball) на соответствие PGP подписи. Процедура проверки детально описана на странице загрузки. Также вы можете посмотреть подробный пример использования PGP.

top

Распаковка

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

$ gzip -d httpd-2_0_NN.tar.gz
$ tar xvf httpd-2_0_NN.tar

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

top

Конфигурирование дерева исходных кодов

Следующий шаг заключается в конфигурировании дерева исходных кодов в соответствии с той системой, на которую вы устанавливаете сервер, и вашими собственными нуждами. Это делается при помощи скрипта 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.

top

Сборка

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

$ make

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

top

Установка

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

$ make install

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

top

Настройка

Далее вы можете настроить ваш HTTP сервер Apache посредством редактирования конфигурационных файлов в каталоге PREFIX/conf/.

$ vi PREFIX/conf/httpd.conf

Руководство по использованию Apache вы можете найти либо по локальному адресу у себя на сервере docs/manual/, либо на официальном сайте Apache http://httpd.apache.org/docs/2.0/, где опубликована самая последняя версия документации и вся необходимая справочная информация по всем возможным конфигурационным директивам.

top

Тестирование

Теперь вы можете запустить свой HTTP сервер Apache, выполнив следующую команду:

$ PREFIX/bin/apachectl start

и если всё прошло успешно, то вы сможете запросить свой первый документ по адресу http://localhost/. Веб-страница, которую вы увидете, находится в каталоге DocumentRoot - по умолчанию, это PREFIX/htdocs/. Затем остановите сервер следующей командой:

$ PREFIX/bin/apachectl stop

top

Апгрейд

Первым шагом при апгрейде является чтение информации о релизе и файла 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), для того чтобы протестировать сервер на совместимость с рабочей конфигурацией, прежде чем делать финальный апгрейд.