apachectl — интерфейс управления сервером Apache HTTP Server

apachectl — это интерфейс для сервера Apache HyperText Transfer Protocol (HTTP). Он предназначен для помощи администратору в управлении работой демона Apache httpd.

Сценарий apachectl может работать в двух режимах. Во-первых, он может выступать в качестве простого интерфейса для команды httpd: устанавливать необходимые переменные окружения, а затем запускать httpd, передавая ему все аргументы командной строки. Во-вторых, apachectl может работать как сценарий инициализации SysV, принимая простые однословные аргументы, например start, restart и stop, и преобразуя их в соответствующие сигналы для httpd.

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

При успешном завершении сценарий apachectl возвращает код выхода 0, а при возникновении ошибки — значение >0. Дополнительные сведения см. в комментариях к сценарию.

Краткое описание

В режиме передачи команд apachectl принимает все аргументы, доступные для двоичного файла httpd.

apachectl [ httpd-argument ]

В режиме инициализации SysV apachectl принимает простые однословные команды, перечисленные ниже.

apachectl command

Параметры

Здесь описаны только параметры в стиле инициализации SysV. Описание остальных аргументов приведено на справочной странице httpd.

start

Запускает демон Apache httpd. Если он уже запущен, выводится сообщение об ошибке. Эквивалентно команде apachectl -k start.

stop

Останавливает демон Apache httpd. Эквивалентно команде apachectl -k stop.

restart

Перезапускает демон Apache httpd. Если демон не запущен, он запускается. Перед началом перезапуска эта команда автоматически проверяет файлы конфигурации, как и configtest, чтобы убедиться, что демон не завершится с ошибкой. Эквивалентно команде apachectl -k restart.

fullstatus

Выводит полный отчёт о состоянии от mod_status. Для этого на сервере должен быть включён mod_status, а в системе должен быть доступен текстовый браузер, например lynx. URL для доступа к отчёту о состоянии можно задать, отредактировав переменную STATUSURL в сценарии.

status

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

graceful

Выполняет корректный перезапуск демона Apache httpd. Если демон не запущен, он запускается. В отличие от обычного перезапуска, текущие открытые соединения не прерываются. Побочным эффектом является то, что старые файлы журналов не закрываются немедленно. Поэтому при использовании этой команды в сценарии ротации журналов может потребоваться значительная задержка, чтобы старые файлы журналов успели закрыться до их обработки. Перед началом перезапуска эта команда автоматически проверяет файлы конфигурации, как и configtest, чтобы убедиться, что Apache не завершится с ошибкой. Эквивалентно команде apachectl -k graceful.

graceful-stop

Выполняет корректную остановку демона Apache httpd. В отличие от обычной остановки, текущие открытые соединения не прерываются. Побочным эффектом является то, что старые файлы журналов не закрываются немедленно. Эквивалентно команде apachectl -k graceful-stop.

configtest

Проверяет синтаксис файла конфигурации. Анализирует файлы конфигурации и выводит либо Syntax Ok, либо подробные сведения о конкретной синтаксической ошибке. Эквивалентно команде apachectl -t.

Следующий параметр был доступен в предыдущих версиях, но был удалён.

startssl

Чтобы запустить httpd с поддержкой SSL, отредактируйте файл конфигурации, добавив соответствующие директивы, а затем используйте обычный apachectl start.