Останов и перезапуск

Доступные языки: de | + en | + es | + ja | + ko | + ru | + tr

Этот перевод может быть устаревшим. Смотрите + английскую версию для ознакомления со всеми последними изменениями + в документе.

+ +

Этот документ рассматривает вопросы остановки и перезапуска Apache на + Unix-подобных системах. Пользователям Windows NT, 2000 и XP следует читать раздел + "Работа Apache как сервиса", + а пользователям Windows 9x и ME - "Работа + Apache как консольного приложения", для получения информации об + управлении сервером на этих платформах.

Введение
Немедленная остановка
Мягкий перезапуск
Немедленный перезапуск
Приложение: сигналы и ситуации гонки (race conditions)

См. также

httpd
apachectl

Введение

+ +

Для того, чтобы остановить или перезапустить Apache, необходимо послать + сигнал запущенным процессам httpd. Существует два способа + отправить подобные сигналы. Во-первых, вы можете послать сигналы непосредственно + процессам, используя команду unix kill. Обратите внимание, + что процессов httpd в системе выполняется несколько, + однако вы не должны отсылать сигналы ни одному из них, кроме родительского - + его pid (идентификатор процесса) записывается в файл, путь к которому задается + директивой PidFile. Существуют три + сигнала, которые вы можете отправить родительскому процессу: + TERM, + HUP, и + USR1 - их значение будет объяснено ниже.

+ +

Чтобы отправить сигнал родительскому процессу, вам следует набрать следующую команду:

+ +

kill -TERM `cat /usr/local/apache2/logs/httpd.pid`

+ +

Второй способ передать сигналы процессам httpd - это + использование опции -k в командной строке с аргументами: stop, + restart и graceful, как будет описано ниже. + Это параметры командной строки для исполняемого файла httpd, + однако мы рекомендуем передавать их, используя скрипт apachectl, + который передаст эти параметры программе httpd.

+ +

После того, как будут отправлены сигналы процессу httpd, вы можете + узнать о состоянии сервера, набрав:

+ +

tail -f /usr/local/apache2/logs/error_log

+ +

Внесите необходимые изменения в эти примеры с учётом + значения директив ServerRoot + и PidFile в конфигурации + Apache.

Немедленная остановка

+ +

Сигнал: TERM: apachectl -k stop

+ +

После получения сигнала TERM или stop, + родительский процесс пытается немедленно уничтожить все дочерние процессы. + Это может занять несколько секунд. Затем родительский процесс сам завершает работу, + при этом все текущие запросы прекращают обрабатываться, а новые запросы игнорируются.

+ +

Мягкий перезапуск

+ +

Сигнал: USR1: apachectl -k graceful

+ +

При получении сигнала USR1 или graceful, + родительский процесс призывает дочерние процессы к завершению работы + сразу же после обработки своего текущего запроса (или к незамедлительной остановке, + если дочерний процесс ничего не обрабатывает). Родительский процесс + перечитывает конфигурационные файлы, открывает заново log-файлы + (файлы, содержащие журнал работы сервера). После того, как какой-то из + дочерних процессов завершает работу, родительский процесс заменяет его + дочерним процессом нового поколения, т.е. с новой конфигурацией, + который начинает обрабатывать новые запросы незамедлительно.

+ +

На некоторых платформах, не поддерживающих передачу сигнала USR1 + как сигнала для инициации мягкого перезапуска, могут + использоваться другие сигналы (такие как WINCH). + Команда apachectl graceful отправит корректный сигнал + на любой платформе.

+ +

Программа разработана таким образом, что количество процессов и потоков, + определённое директивами МП-модуля (мульти-процессного модуля), + оставалось неизменным на протяжение всего процесса перезапуска. + Кроме того, для поддержания числа запущенных процессов, определённого + директивой StartServers, + используется следующий способ: если спустя одну секунду не было + создано по крайней мере такое количество дочерних процессов, какое + определено директивой StartServers, + тогда создаётся такое количество дочерних процессов, которое полностью + восполнило бы недостаток. Таким образом сервер пытается одновременно и сохранить + количество уже существующих дочерних процессов неизменным, и учесть ваши + требования, указанные в директиве StartServers.

+ +

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

+ +

Модуль mod_status также использует символ G, чтобы + обозначить те дочерние процессы, которые всё ещё обрабатывают запросы и которые были + созданы до сигнала к мягкому перезапуску.

+ +

В настоящее время нет способа определить, + что все дочерние процессы закончили запись в старый log-файл (т.е. + log-файл, в который производилась запись до перезапуска). Мы + предлагаем вам подождать некоторое время, после того как будет + послан сигнал USR1, прежде чем делать что-либо + со старым log-файлом. Например, если на выполнение запросов + пользователей, подключённых через очень медленный канал, уходит + не более 10 минут, тогда логично будет подождать 15 минут, прежде чем + делать что-либо со старым log-файлом.

+ +

Если Ваш конфигурационный файл содержит ошибки, то попытка + перезапустить сервер вызовет немедленное прекращение работы родительского + процесса с сообщением об ошибке. В случае мягкого перезапуска + дочерние процессы продолжают обрабатывать свои запросы, после чего + они завершат свою работу. Это может вызвать проблемы, + так как сервер не будет в состоянии установить соединение с необходимыми + портами. Перед выполнением перезапуска, вы должны + проверить синтаксис конфигурационных файлов с помощью параметра + -t командной строки (см. описание httpd). + Однако это всё ещё не гарантирует, что сервер перезапустится корректно. + Чтобы проверить семантику конфигурационных файлов, равно как и их синтаксис, + вы можете попробовать запустить httpd, будучи непривилегированным пользователем. + Если ошибки отсутствуют, то httpd попытается открыть + сокеты и log-файлы, но не сможет этого сделать, потому что у него отсутствуют + необходимые для этого права (или потому что в текущее время работающий httpd уже + установил соединение с нужными портами, заняв их). Если сбой + происходит по любой другой причине - значит, скорее всего, + существует ошибка в конфигурационном файле, которая должна быть + исправлена перед началом мягкого перезапуска.

Немедленный перезапуск

+ +

Сигнал: HUP: apachectl -k restart

+ +

Отправленный родительскому процессу сигнал HUP + или restart вызывает немедленное уничтожение + всех дочерних процессов, также как и при обработке сигнала + TERM, однако родительский процесс не завершает работу. + Он перечитывает конфигурационные файлы и открывает заново log-файлы + (файлы, содержащие журнал работы сервера). Затем он порождает + новых потомков и продолжает обработку запросов.

+ +

Пользователи, использующие модуль mod_status, + могут обратить внимание, что статистика сервера при получении сигнала + HUP полностью обнуляется.

+ +

Если Ваш конфигурационный файл содержит ошибки, то попытка +перезапустить сервер вызовет немедленное прекращение его работы +с сообщением об ошибке. Способы избежать этого смотрите выше. +

Приложение: сигналы и ситуации гонки (race conditions)

+ +

В Apache до версии 1.2b9 существовало несколько ситуаций гонки, + возникающих при получении сигналов к перезапуску или останову + (проще говоря, ситуация гонки - чувствительная ко времени проблема, + возникающая, + когда что-то происходит в неподходящее время или в неправильном порядке. + Если то же самое происходит в подходящее время, никаких проблем не возникает). + Для компьютеров с архитектурами, имеющими "правильный", "хороший" набор + возможностей, подобные проблемы были устранены везде, где это возможно. + Однако следует помнить, что на компьютерах с некоторыми архитектурами + всё ещё существует возможность возникновения ситуаций гонки.

+ +

Компьютеры с архитектурами, на которых таблица статистики хранится + в файле, заданном директивой ScoreBoardFile, + имеют потенциальную возможность повреждения их таблиц статистики. + Это может вызвать ошибку "bind: Address already in use" + (после сигнала HUP) + или "long lost child came home!" + (после сигнала USR1). Последнее сообщение - фатальная ошибка, + в то время как предыдущее сигнализирует только о потере связи с таблицей статистики. + Поэтому можно порекомендовать использовать мягкий перезапуск, и лишь время от времени + делать жесткий перезапуск. С этими проблемами очень сложно бороться, + однако, к счастью, большинство архитектур не требуют хранить таблицу статистики + на диске. Смотрите документацию к директиве ScoreBoardFile, чтобы узнать, на каких архитектурах + используется этот файл.

+ +

Во всех архитектурах существуют небольшие ситуации гонки + в каждом дочернем процессе, начиная со второго запроса при постоянном + HTTP соединении (KeepAlive). Процесс может завершиться после чтения + строки запроса, но перед чтением заголовков запроса. Исправление + появилось позже выпуска версии 1.2, а потому не включено в него. Теоретически это + не проблема, потому что KeepAlive-клиент должен ожидать таких событий + из-за задержек сети и времени ожидания сервера. Практически + складывается впечатление, что это также не оказывает никакого + влияния - во время тестов сервер перезапускался с частотой 20 раз + в секунду, а клиенты успешно просматривали сайт, не получая + пустых документов и повреждённых картинок.