Фальстарт

• Проекты
  • Пускач
    • Загрузка
    • Документация
      • Установка и администрирование
      • Конфигурационный файл
      • Nginx + FastCGI на Perl
      • Nginx + FastCGI на PHP
  • Менеджер горячих клавиш
• Библиотека
• Обратная связь

Установка и администрирование

1. Установка
2. Настройка web-сервера
3. Аргументы командной строки
4. Скрипты запуска и остановки
5. Ротация логов

Установка

Установка выполняется стандартно, как для большинства программ из исходных кодов под Unix. Домашняя директория по умолчанию — /usr/local/puskach.

1. [puskach-x.x.x]$ ./configure
2. [puskach-x.x.x]$ make
3. [puskach-x.x.x]$ make install

Настройка web-сервера

Пускач для web-сервера является одним FastCGI-приложением, которое обрабатывает все запросы. Для идентификации приложения, которому реально адресован запрос, сервер должен в каждом запросе передавать FastCGI-параметр SCRIPT_FILENAME. Пускач, как FastCGI-приложение, обладает следующими свойствами (определены в спецификации FastCGI):

• Не поддерживает мультиплексирование запросов в рамках одного соединенеия. Каждое соединение используется для обработки только одного запроса (FCGI_MPXS_CONNS).
• Максимальное число одновременно обслуживаемых запросов не ограничено (FCGI_MAX_REQS).
• Максимальное число транспортных соединений не ограничено (FCGI_MAX_CONNS).

Как правило, никакой особенно специфической настройки web-сервера для работы с Пускачом не требуется, так протестирована его работа с Nginx и Lighttpd при стандартных настройках FastCGI-интерфейса.

Аргументы командной строки

Параметры, специфичные для каждого FastCGI-приложения, Пускач получает из конфигуарционного файла, а общие настройки управления процессом через аргументы командной строки. Поддерживаются следующие аргументы (обязательные выделены жирным):

• -conf-path — путь к файлу конфигурации Пускача.
• -log-path — полное имя лог-файла.
• -log-level — уровень детализации логгирования, допустимые значения: 10 = TRACE, 20 = DEBUG, ..., 70 = DISABLE_LOGGING (по умолчанию TRACE).
• -pid-file — полное имя файла в который при старте записывается (PID) Пускача, используется для отправки сигналов управления.
• -srv-addr — адрес TCP/IP или Unix (файлового) сокета, который будет слушать Пускач на предмет входящих соединенеий от web-сервера, в формате хост:порт, либо путь к файлу соответственно.

В процессе работы Пускач генерирует диагностические и отладочные сообщения разного уровня значимости. Установка уровня логгинга - это ограничение сверху на минимальную значимость сообщений, которые должны попадать в лог-файл. Менее значимые сообщения игнорируются. При каждом следующем уровне выводится информация всех предыдущих плюс следующая дополнительная информация:

• FATAL — ошибки уровня Пускача
• ERROR — ошибки уровня FastCGI приложения: печать в STDERR, таймауты, ошибки ВВ
• WARN — ошибки, не приводящие к прерыванию процесса обработки запроса FastCGI приложением
• INFO — все существенные неошибочные события: перезапуск FastCGI-процессов, прерывание запросов сервером
• DEBUG — вывод информации о результатах обработки каждого запроса: время, общее число запросов на приложение / процесс
• TRACE — полная трассировка обработки запроса: прием соединения от web-сервера, передача данных к приложению и от приложения

Оптимальным для повседневной эксплуатации является уровень DEBUG, либо INFO, «глушить» сообщения не рекомендуется. В настройке других необязательных параметров, как правило, нет необходимости.

Скрипты запуска и остановки

Все работающие FastCGI-приложения выполняются с правами того же пользователя, что и рабочий процесс Пускача. Поэтому крайне желательно запускать Пускач под непривилегированным пользователем. Такую проверку следует предусмотреть в стартовом скрипте. Также стартовый скрипт может устанавливать переменные окружения, которые будут наследоваться FastCGI-приложениями. Приведем пример скриптов для пользователя site_user со следующей структурой каталогов в домашней директории:

1. [site_user@ /usr/home/site_user]$ ls -R
2. ./etc:
4. changelog.sh startpuskach.sh puskach.conf stoppuskach.sh
6. ./logs:
7. puskach.log
9. ./lib:

Стартовый скрипт startpuskach.sh будет иметь вид:

1. #!/bin/sh
3. curuser='site_user'
4. echo "#### Запускаем Пускач для $curuser #####"
6. if !(echo "$USER" | grep -x -q "$curuser"); then
7. echo "## Пробуем сменить пользователя ##"
8. su - $curuser \
9. -c "/usr/home/$curuser/etc/startpuskach.sh; exit 0"
10. exit 0
11. else
12. echo "## Пускач запускает владелец... ##"
13. fi
15. PUSKACH_PID_FILE="/tmp/puskach/puskach_$curuser.pid"
17. if [ -e "$PUSKACH_PID_FILE" ]; then
18. kill -s QUIT `cat "$PUSKACH_PID_FILE"`
19. echo "### Перезапускаем пускач ###"
20. fi
22. export PERL5LIB=$PERL5LIB:/usr/home/$curuser/lib;
24. /usr/local/puskach/bin/puskach \
25. -srv-addr "/tmp/puskach/puskach_$curuser.sock" \
26. -pid-file "/tmp/puskach/puskach_$curuser.pid" \
27. -conf-path "/usr/home/$curuser/etc/puskach.conf" \
28. -log-path "/usr/home/$curuser/logs/puskach.log" \
29. -log-level 20

Соотвественно скрипт остановки Пускача stoppuskach.sh:

1. #!/bin/sh
3. curuser='site_user'
4. PUSKACH_PID_FILE="/tmp/puskach/puskach_$curuser.pid"
6. if [ -e "$PUSKACH_PID_FILE" ]; then
7. kill -s QUIT `cat "$PUSKACH_PID_FILE"`
8. echo "### Останавливаем пускач... ###"
9. else
10. echo "### Пускач не был запущен! ###"
11. fi

Ротация логов

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