Apache: Компиляция и установка Apache

RU EN

Пункт 6. Компиляция и установка Apache

Этот документ описывает компиляцию и установку HTTP-сервера Apache только в Unix и Unix-подобных системах. Сведения о компиляции и установке в Windows см. в разделах Использование HTTP-сервера Apache с Microsoft Windows и Компиляция Apache для Microsoft Windows. Для других платформ см. документацию по платформе.

Apache httpd использует libtool и autoconf для создания среды сборки, похожей на многие другие проекты с открытым исходным кодом.

Если вы выполняете обновление с одной дополнительной версии на другую (например, с 2.4.9 на 2.4.10), перейдите к разделу обновления.

Обзор для нетерпеливых

Скачать	Загрузите последнюю версию с http://httpd.apache.org/download.cgi.
Извлекать	`$ gzip -d httpd-NN.tar.gz $ tar xvf httpd-NN.tar $ cd httpd-NN`
Настроить	`$ ./configure --prefix=PREFIX`
Компиляция	`$ make`
Установить	`$ make install`
Настроить	`$ vi PREFIX/conf/apache2.conf`
Тест	`$ PREFIX/bin/apache2ctl -k start`

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

Каждый раздел процесса компиляции и установки более подробно описан ниже, начиная с требований для компиляции и установки Apache httpd.

Требования

Для сборки Apache httpd существуют следующие требования:

АПР и АПР-Утил: Убедитесь, что в вашей системе уже установлены APR и APR-Util. Если вы не используете или предпочитаете не использовать системные версии, загрузите последние версии APR и APR-Util из Apache APR, распакуйте их в папку и (убедитесь, что в именах каталогов нет номеров версий /httpd_source_tree_root/srclib/apr ; /httpd_source_tree_root/srclib/apr-util например , дистрибутив APR должен находиться в папке /httpd_source_tree_root/srclib/apr/) и использовать параметр ./configure 's . --with-included-apr На некоторых платформах вам, возможно, придется установить соответствующие -dev пакеты, чтобы разрешить сборку httpd с вашей установленной копией APR и APR-Util.
Perl-совместимая библиотека регулярных выражений (PCRE): Эта библиотека необходима, но больше не входит в состав httpd. Загрузите исходный код с http://www.pcre.org или установите порт или пакет. Если ваша система сборки не может найти скрипт pcre-config, установленный сборкой PCRE, укажите на него с помощью параметра --with-pcre . На некоторых платформах вам, возможно, придется установить соответствующий -dev пакет, чтобы разрешить сборку httpd с вашей установленной копией PCRE.
Дисковое пространство: Убедитесь, что у вас есть не менее 50 МБ временного свободного места на диске. После установки сервер занимает около 10 МБ дискового пространства. Фактические требования к дисковому пространству будут значительно различаться в зависимости от выбранных вами параметров конфигурации, любых сторонних модулей и, конечно же, размера веб-сайта или сайтов, которые у вас есть на сервере.
Компилятор ANSI-C и система сборки: Убедитесь, что у вас установлен компилятор ANSI-C. Рекомендуется компилятор GNU C (GCC) от Free Software Foundation (FSF). Если у вас нет GCC, по крайней мере, убедитесь, что компилятор вашего поставщика совместим с ANSI. Кроме того, вы PATH должны содержать базовые инструменты сборки, такие как файлы make .
Точное ведение времени: Элементы протокола HTTP выражаются в виде времени суток. Итак, пришло время исследовать настройку некоторых средств синхронизации времени в вашей системе. Обычно для этой цели используются программы ntpdate или xntpd , основанные на протоколе сетевого времени (NTP). См. домашнюю страницу NTP для получения более подробной информации о программном обеспечении NTP и общедоступных серверах времени.
Перл 5 [ДОПОЛНИТЕЛЬНО]: Для некоторых вспомогательных скриптов, таких как apxs или dbmmanage (которые написаны на Perl), требуется интерпретатор Perl 5 (достаточно версии 5.003 или новее). Если сценарий не найдет интерпретатор Perl 5 configure , вы не сможете использовать затронутые сценарии поддержки. Конечно, вы по-прежнему сможете собирать и использовать Apache httpd.

Скачать

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

После загрузки важно убедиться, что у вас есть полная и неизмененная версия HTTP-сервера Apache. Этого можно добиться, проверив загруженный tar-архив на наличие подписи PGP. Подробная информация о том, как это сделать, доступна на странице загрузки, а также доступен расширенный пример, описывающий использование PGP.

Извлекать

Извлечение исходного кода из tar-архива HTTP-сервера Apache — это просто распаковка, а затем распаковка:

$ gzip -d httpd-NN.tar.gz $ tar xvf httpd-NN.tar

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

Настройка исходного дерева

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

Чтобы настроить исходное дерево, используя все параметры по умолчанию, просто введите ./configure . Чтобы изменить параметры по умолчанию, configure принимает множество переменных и параметров командной строки.

Наиболее важным параметром является место --prefix , где впоследствии будет установлен Apache, потому что Apache необходимо настроить для правильной работы этого места. Более точное управление расположением файлов возможно с дополнительными параметрами конфигурации.

Также на этом этапе вы можете указать, какие функции вы хотите включить в Apache, включив и отключив модули. Apache поставляется с широким набором модулей, включенных по умолчанию. Они будут скомпилированы как общие объекты (DSO), которые можно загружать или выгружать во время выполнения. Вы также можете выбрать статическую компиляцию модулей, используя опцию . --enable-module=static

Дополнительные модули включаются с помощью опции, где модуль — это имя модуля с удаленной строкой и преобразованием любого подчеркивания в тире. Точно так же вы можете отключить модули с опцией. Будьте осторожны при использовании этих опций, так как не может предупредить вас, если указанный вами модуль не существует; он просто проигнорирует эту опцию. --enable-module mod_ --disable-module configure

Кроме того, иногда необходимо предоставить configure скрипту дополнительную информацию о расположении вашего компилятора, библиотек или заголовочных файлов. Это делается путем передачи либо переменных среды, либо параметров командной строки в configure . Для получения дополнительной информации см. configure страницу руководства. Или вызвать configure с помощью --help опции.

Для краткого представления о том, какие у вас есть возможности, вот типичный пример, который компилирует Apache для дерева установки /sw/pkg/apache с определенным компилятором и флагами, а также двумя дополнительными модулями mod_ldap и mod_lua :

$ CC="pgcc" CFLAGS="-O2" \ ./configure --prefix=/sw/pkg/apache \ --enable-ldap=shared \ --enable-lua=shared

При configure запуске потребуется несколько минут, чтобы проверить наличие функций в вашей системе и создать файлы Makefile, которые позже будут использоваться для компиляции сервера.

Подробная информация обо всех различных configure параметрах доступна на configure странице руководства.

Строить

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

$ make

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

Установить

Теперь пришло время установить пакет под настроенным установочным ПРЕФИКСОМ (см. --prefix вариант выше), выполнив:

$ make install

Этот шаг обычно требует привилегий root, поскольку PREFIX обычно является каталогом с ограниченными правами на запись.

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

Настроить

Затем вы можете настроить свой HTTP-сервер Apache, отредактировав файлы конфигурации в разделе PREFIX/conf/ .

$ vi PREFIX/conf/apache2.conf

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

Тест

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

$ PREFIX/bin/apache2ctl -k start

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

$ PREFIX/bin/apache2ctl -k stop

Обновление

Первым шагом в обновлении является чтение объявления о выпуске и файла CHANGES в исходном дистрибутиве, чтобы найти любые изменения, которые могут повлиять на ваш сайт. При переходе между основными выпусками (например, с 2.0 на 2.2 или с 2.2 на 2.4), скорее всего, будут большие различия в конфигурации времени компиляции и времени выполнения, которые потребуют ручной корректировки. Все модули также необходимо будет обновить, чтобы учесть изменения в API модуля.

Обновление с одной минорной версии на другую (например, с 2.2.55 на 2.2.57) проще. Этот make install процесс не перезапишет существующие документы, файлы журналов или файлы конфигурации. Кроме того, разработчики прилагают все усилия, чтобы избежать несовместимых изменений в configure параметрах, конфигурации времени выполнения или API модуля между младшими версиями. В большинстве случаев вы сможете использовать идентичную configure командную строку, идентичный файл конфигурации, и все ваши модули должны продолжать работать.

Чтобы обновить младшие версии, начните с поиска файла config.nice в build каталоге вашего установленного сервера или в корне исходного дерева для вашей старой установки. Он будет содержать точную configure командную строку, которую вы использовали для настройки исходного дерева. Затем, чтобы перейти с одной версии на другую, вам нужно только скопировать файл config.nice в исходное дерево новой версии, отредактировать его, чтобы внести необходимые изменения, а затем запустить:

$ ./config.nice $ make $ make install $ PREFIX/bin/apache2ctl -k graceful-stop $ PREFIX/bin/apache2ctl -k start

Вы всегда должны тестировать любую новую версию в своей среде, прежде чем запускать ее в производство. Например, вы можете установить и запустить новую версию вместе со старой, используя другой --prefix и другой порт (путем настройки Listen директивы) для проверки любых несовместимостей перед выполнением окончательного обновления.

Вы можете передать дополнительные аргументы config.nice , которые будут добавлены к исходным configure параметрам:

$ ./config.nice --prefix=/home/test/apache --with-port=90

Сторонние пакеты

Большое количество третьих сторон предоставляют свои собственные упакованные дистрибутивы HTTP-сервера Apache для установки на определенных платформах. Сюда входят различные дистрибутивы Linux, различные сторонние пакеты Windows, Mac OS X, Solaris и многие другие.

Наша лицензия на программное обеспечение не только разрешает, но и поощряет такое распространение. Однако это приводит к ситуации, когда макет конфигурации и значения по умолчанию для вашей установки сервера могут отличаться от указанных в документации. К сожалению, эта ситуация вряд ли изменится в ближайшее время.

Описание этих сторонних дистрибутивов поддерживается в вики HTTP-сервера и должно отражать текущее состояние этих сторонних дистрибутивов. Однако вам необходимо ознакомиться с процедурами управления пакетами и их установки на вашей конкретной платформе.