Общие директивы MPM Apache

Директива CoreDumpDirectory

CoreDumpDirectory directory

See usage for the default setting

Эта директива задаёт каталог, в который Apache httpd пытается перейти перед созданием дампа памяти. Если операционная система настроена на создание файлов дампа в рабочем каталоге аварийно завершившегося процесса, необходимо использовать CoreDumpDirectory, чтобы изменить рабочий каталог с каталога ServerRoot по умолчанию, в который не должен иметь права записи пользователь, от имени которого работает сервер.

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

Директива EnableExceptionHook

EnableExceptionHook On|Off

EnableExceptionHook Off

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

Этим хуком уже пользуются два модуля: mod_whatkilledus и mod_backtrace. Дополнительную информацию о них можно найти на сайте EnableExceptionHook Джеффа Травика.

Директива GracefulShutdownTimeout

GracefulShutdownTimeout seconds

GracefulShutdownTimeout 0

Директива GracefulShutdownTimeout задаёт, сколько секунд после получения сигнала "graceful-stop" сервер должен продолжать работу, обслуживая существующие соединения.

Значение 0 означает, что сервер будет бесконечно ждать завершения обработки всех оставшихся запросов.

Директива Listen

Listen [IP-address:]portnumber [protocol]

Директива Listen указывает Apache httpd ожидать подключения только на определённых IP-адресах или портах; по умолчанию сервер отвечает на запросы, поступающие через все IP-интерфейсы. Теперь директива Listen обязательна. Если её нет в файле конфигурации, сервер не запустится. Это изменение по сравнению с предыдущими версиями Apache httpd.

Директива Listen указывает серверу принимать входящие запросы на заданном порту или сочетании адреса и порта. Если задан только номер порта, сервер ожидает подключения на этом порту через все интерфейсы. Если вместе с портом указан IP-адрес, сервер будет ожидать подключения на указанном порту и интерфейсе.

Для указания нескольких адресов и портов можно использовать несколько директив Listen. Сервер будет отвечать на запросы, поступающие с любого из перечисленных адресов и портов.

Например, чтобы сервер принимал подключения на портах 80 и 8000, используйте:

Listen 80
Listen 8000

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

Listen 192.170.2.1:80
Listen 192.170.2.5:8000

IPv6-адреса необходимо заключать в квадратные скобки, как в следующем примере:

Listen [2001:db8::a00:20ff:fea7:ccea]:80

Необязательный аргумент protocol в большинстве конфигураций не требуется. Если он не задан, по умолчанию для порта 443 используется https, а для всех остальных портов — http. Протокол используется для определения модуля, который должен обрабатывать запрос, а также для применения оптимизаций, специфичных для протокола, с помощью директивы AcceptFilter.

Указывать протокол нужно только при использовании нестандартных портов. Например, для сайта https на порту 8443:

Listen 192.170.2.1:8443 https

См. также

• Проблемы DNS
• Настройка используемых Apache HTTP Server адресов и портов
• Дополнительное обсуждение сообщения об ошибке Address already in use, включая другие возможные причины.

Директива ListenBackLog

ListenBackLog backlog

ListenBackLog 511

Максимальная длина очереди ожидающих подключений. Обычно настраивать этот параметр не нужно и не рекомендуется; однако в некоторых системах его следует увеличить при атаке типа TCP SYN flood. См. параметр backlog системного вызова listen(2).

Операционная система часто ограничивает это значение меньшим числом. Ограничения различаются в разных ОС. Кроме того, многие ОС используют не точное значение backlog, а значение, рассчитанное на его основе (обычно большее).

Директива ListenCoresBucketsRatio

ListenCoresBucketsRatio ratio

ListenCoresBucketsRatio 0 (disabled)

Соотношение ratio между количеством ядер ЦП (в сети) и числом корзин прослушивателей можно использовать, чтобы Apache HTTP Server создавал num_cpu_cores / ratio корзин ожидания подключений, каждая из которых содержит собственные сокеты Listen на тех же портах, а затем назначал каждому дочернему процессу одну корзину (корзины распределяются по кругу при создании дочерних процессов).

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

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

Эта директива влияет на вычисление нижних предельных значений MinSpareThreads и MaxSpareThreads. Для оптимального приёма подключений количество дочерних процессов должно быть кратно количеству корзин.

Директива MaxConnectionsPerChild

MaxConnectionsPerChild number

MaxConnectionsPerChild 0

Директива MaxConnectionsPerChild задаёт ограничение количества подключений, которые обработает отдельный дочерний процесс сервера. После MaxConnectionsPerChild подключений дочерний процесс завершится. Если MaxConnectionsPerChild равно 0, срок работы процесса не ограничен.

Установка ненулевого значения MaxConnectionsPerChild ограничивает объём памяти, который может потреблять процесс из-за (случайной) утечки памяти.

Директива MaxMemFree

MaxMemFree KBytes

MaxMemFree 2048

Директива MaxMemFree задаёт максимальное количество свободных килобайт, которое может удерживать каждый распределитель, не вызывая free(). В многопоточных MPM каждый поток имеет собственный распределитель. При значении 0 порог не ограничен.

Директива MaxRequestWorkers

MaxRequestWorkers number

See usage for details

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

Для непотоковых серверов (т. е. prefork) MaxRequestWorkers определяет максимальное количество дочерних процессов, запускаемых для обслуживания запросов. Значение по умолчанию — 256; чтобы увеличить его, необходимо также увеличить ServerLimit.

Для потоковых и гибридных серверов (например event или worker) MaxRequestWorkers ограничивает общее количество потоков, доступных для обслуживания клиентов. Для гибридных MPM значение по умолчанию равно 16 (ServerLimit), умноженному на значение 25 (ThreadsPerChild). Поэтому, чтобы увеличить MaxRequestWorkers до значения, требующего более 16 процессов, необходимо также увеличить ServerLimit.

До версии 2.3.13 директива MaxRequestWorkers называлась MaxClients. Старое имя по-прежнему поддерживается.

Директива MaxSpareThreads

MaxSpareThreads number

See usage for details

Максимальное количество простаивающих потоков. Разные MPM обрабатывают эту директиву по-разному.

Для worker и event значение по умолчанию — MaxSpareThreads 250. Эти MPM учитывают простаивающие потоки для всего сервера. Если на сервере слишком много простаивающих потоков, дочерние процессы завершаются, пока их количество не станет меньше этого значения. Если включена директива ListenCoresBucketsRatio, могут создаваться дополнительные процессы или потоки.

Для mpm_netware значение по умолчанию — MaxSpareThreads 100. Поскольку этот MPM работает в одном процессе, количество резервных потоков также учитывается для всего сервера.

mpmt_os2 работает аналогично mpm_netware. Для mpmt_os2 значение по умолчанию — 10.

См. также

• MinSpareThreads
• StartServers
• MaxSpareServers

Директива MinSpareThreads

MinSpareThreads number

See usage for details

Минимальное количество простаивающих потоков для обработки всплесков запросов. Разные MPM обрабатывают эту директиву по-разному.

Для worker и event значение по умолчанию равно MinSpareThreads 75; простаивающие потоки учитываются для всего сервера. Если на сервере недостаточно простаивающих потоков, создаются дочерние процессы, пока их количество не превысит number. Если включена директива ListenCoresBucketsRatio, могут создаваться дополнительные процессы или потоки.

Для mpm_netware значение по умолчанию равно MinSpareThreads 10. Поскольку это однопроцессный MPM, число потоков учитывается для всего сервера.

mpmt_os2 работает аналогично mpm_netware. Для mpmt_os2 значение по умолчанию — 5.

См. также

• MaxSpareThreads
• StartServers
• MinSpareServers

Директива PidFile

PidFile filename

PidFile logs/httpd.pid

Директива PidFile задаёт файл, в который сервер записывает идентификатор процесса демона. Если указано относительное имя файла, оно считается относительно ServerRoot.

PidFile /var/run/apache.pid

Часто бывает полезно иметь возможность отправить серверу сигнал, чтобы он закрыл, а затем повторно открыл свои ErrorLog и TransferLog и перечитал файлы конфигурации. Для этого процессу, идентификатор которого указан в PidFile, отправляют сигнал SIGHUP (kill -1).

К PidFile применяются те же предостережения, что и к размещению файлов журналов, а также рекомендации по безопасности.

Директива ReceiveBufferSize

ReceiveBufferSize bytes

ReceiveBufferSize 0

Сервер установит размер буфера приёма TCP, равный указанному количеству байт.

Если задано значение 0, сервер будет использовать значение по умолчанию для ОС.

Директива ScoreBoardFile

ScoreBoardFile file-path

ScoreBoardFile logs/apache_runtime_status

Apache HTTP Server использует scoreboard для обмена данными между родительскими и дочерними процессами. В некоторых архитектурах для этого требуется файл. Если файл не указан, Apache httpd сначала пытается создать scoreboard целиком в памяти (используя анонимную разделяемую память), а если это не удаётся — пытается создать файл на диске (используя разделяемую память на основе файлов). При указании этой директивы Apache httpd всегда создаёт файл на диске.

ScoreBoardFile /var/run/apache_runtime_status

Разделяемая память на основе файлов полезна для сторонних приложений, которым необходим прямой доступ к scoreboard.

Если вы используете ScoreBoardFile, его размещение на RAM-диске может повысить скорость работы. При этом учитывайте те же предостережения, что и при размещении файлов журналов, а также рекомендации по безопасности.

См. также

• Остановка и перезапуск Apache HTTP Server

Директива SendBufferSize

SendBufferSize bytes

SendBufferSize 0

Задаёт размер буфера отправки TCP сервера в указанном количестве байт. Для высокоскоростных соединений с большой задержкой (например, около 100 мс, как у быстрых трансконтинентальных каналов) часто полезно задать значение выше стандартного значения ОС.

Если задано значение 0, сервер будет использовать значение по умолчанию, предоставляемое ОС.

Для повышения производительности высокоскоростных соединений с большой задержкой может потребоваться дополнительная настройка операционной системы.

Директива ServerLimit

ServerLimit number

See usage for details

Для MPM prefork эта директива задаёт максимальное настраиваемое значение MaxRequestWorkers на всё время работы процесса Apache httpd. Для MPM worker и event эта директива вместе с ThreadLimit задаёт максимальное настраиваемое значение MaxRequestWorkers на всё время работы процесса Apache httpd. Для MPM event эта директива также определяет, сколько старых процессов сервера могут продолжать работу и завершать обработку открытых подключений. Попытки изменить эту директиву при перезапуске будут проигнорированы, но MaxRequestWorkers можно изменить во время перезапуска.

При использовании этой директивы требуется особая осторожность. Если для ServerLimit задано значение, значительно превышающее необходимое, будет выделена лишняя неиспользуемая разделяемая память. Если для ServerLimit и MaxRequestWorkers заданы значения, превышающие возможности системы, Apache httpd может не запуститься или работа системы может стать нестабильной.

Для MPM prefork используйте эту директиву, только если необходимо задать для MaxRequestWorkers значение выше 256 (значение по умолчанию). Не задавайте для этой директивы значение выше того, которое вы планируете установить для MaxRequestWorkers.

Для worker используйте эту директиву, только если значения MaxRequestWorkers и ThreadsPerChild требуют более 16 процессов сервера (значение по умолчанию). Не задавайте для этой директивы значение выше количества процессов сервера, необходимого для заданных вами значений MaxRequestWorkers и ThreadsPerChild.

Для event увеличьте значение этой директивы, если количество процессов, заданное параметрами MaxRequestWorkers и ThreadsPerChild, вместе с количеством корректно завершающих работу процессов превышает 16 (значение по умолчанию).

См. также

• Остановка и перезапуск Apache HTTP Server

Директива StartServers

StartServers number

See usage for details

Директива StartServers задаёт количество дочерних процессов сервера, создаваемых при запуске. Поскольку количество процессов динамически регулируется в зависимости от нагрузки (см. MinSpareThreads, MaxSpareThreads, MinSpareServers, MaxSpareServers), обычно нет необходимости изменять этот параметр.

Значение по умолчанию зависит от MPM. Для worker и event по умолчанию используется StartServers 3; для prefork — 5; для mpmt_os2 — 2.

Директива StartThreads

StartThreads number

See usage for details

Количество потоков, создаваемых при запуске. Поскольку количество потоков динамически регулируется в зависимости от нагрузки (см. MinSpareThreads, MaxSpareThreads, MinSpareServers, MaxSpareServers), обычно нет необходимости изменять этот параметр.

Для mpm_netware значение по умолчанию равно StartThreads 50. Поскольку процесс только один, это общее количество потоков, создаваемых при запуске для обслуживания запросов.

Директива ThreadLimit

ThreadLimit number

See usage for details

Эта директива задает максимальное значение, которое можно установить для ThreadsPerChild в течение всего времени работы процесса Apache httpd. Любые попытки изменить эту директиву при перезапуске будут проигнорированы, но ThreadsPerChild можно изменить при перезапуске в пределах значения этой директивы.

При использовании этой директивы следует соблюдать особую осторожность. Если ThreadLimit задано значение, значительно превышающее ThreadsPerChild, будет выделена дополнительная неиспользуемая общая память. Если для ThreadLimit и ThreadsPerChild заданы значения, превышающие возможности системы, Apache httpd может не запуститься или система может стать нестабильной. Не задавайте для этой директивы значение выше наибольшего прогнозируемого значения ThreadsPerChild для текущего запуска Apache httpd.

Значение по умолчанию для ThreadLimit составляет 1920 при использовании с mpm_winnt и 64 при использовании с остальными модулями.

Директива ThreadsPerChild

ThreadsPerChild number

See usage for details

Эта директива задает количество потоков, создаваемых каждым дочерним процессом. Дочерний процесс создает эти потоки при запуске и больше никогда их не создает. При использовании MPM, например mpm_winnt, в котором имеется только один дочерний процесс, это число должно быть достаточно большим, чтобы справляться со всей нагрузкой сервера. При использовании MPM, например worker, в котором имеется несколько дочерних процессов, общее количество потоков должно быть достаточно большим, чтобы справляться с обычной нагрузкой сервера.

Значение по умолчанию для ThreadsPerChild составляет 64 при использовании с mpm_winnt и 25 при использовании с остальными модулями.

Значение ThreadsPerChild не может превышать значение ThreadLimit. Если задано большее значение, оно будет автоматически уменьшено при запуске, и в журнал будет записано предупреждение. Взаимосвязь между этими двумя директивами объясняется в ThreadLimit.

Директива ThreadStackSize

ThreadStackSize size

65536 on NetWare; varies on other operating systems

Директива ThreadStackSize задает размер стека (для автоданных) потоков, которые обрабатывают подключения клиентов и вызывают модули для обработки этих подключений. В большинстве случаев размер стека, заданный по умолчанию в операционной системе, является подходящим, однако в некоторых ситуациях его может потребоваться изменить:

• На платформах с относительно небольшим размером стека потоков по умолчанию (например, HP-UX) Apache httpd может аварийно завершить работу при использовании некоторых сторонних модулей, которые используют сравнительно большой объем хранилища автоданных. Те же модули могут нормально работать на других платформах, где размер стека потоков по умолчанию больше. Такую аварию можно устранить, задав для ThreadStackSize значение выше установленного по умолчанию в операционной системе. Такая настройка требуется только в том случае, если поставщик стороннего модуля указывает на ее необходимость или диагностика аварийного завершения Apache httpd показывает, что размер стека потоков был слишком мал.
• На платформах, где размер стека потоков по умолчанию значительно превышает необходимый для конфигурации веб-сервера, можно увеличить количество потоков на дочерний процесс, задав для ThreadStackSize значение ниже установленного по умолчанию в операционной системе. Такую настройку следует выполнять только в тестовой среде, позволяющей проверить весь набор операций веб-сервера, поскольку могут возникать редкие запросы, для обработки которых требуется больше стека. Минимальный необходимый размер стека сильно зависит от используемых модулей, однако любое изменение конфигурации веб-сервера может сделать текущую настройку ThreadStackSize недействительной.
• В Linux эту директиву можно использовать только для увеличения размера стека по умолчанию, поскольку лежащий в основе системный вызов использует это значение как минимальный размер стека. В качестве размера стека по умолчанию используется (часто большой) мягкий лимит для ulimit -s (8 МБ, если лимит не установлен).