Установка веб-сервера GWS для ispmanager 6
В данной статье описаны установка, настройка и особенности работы с веб-сервером GWS на сервере с панелью ispmanager 6, который работает на Apache, со связкой Nginx+Apache или с LiteSpeed.
Для активации веб-сервера необходимо приобрести лицензию.
Требования и особенности
Работа веб-сервера GWS официально поддерживается в следующих ОС:
- AlmaLinux 8, 9;
- RockuLinux 8;
- CloudLinux 7, 8, 9.
На сервере с панелью работа GWS поддерживается при соблюдении условий:
- Версия GWS 1.0.5 и выше;
- Панель должна использовать веб-сервер Apache, связку Nginx+Apache или веб-сервер LiteSpeed - конфигурация GWS формируется путем трансляции файла
httpd.conf.
Важно понимать, что PHP на веб-сервере GWS работает через LSAPI внезависимости от обработчика, который выбран в панели - это повлияет на сайты, использующие альтернативные версии PHP в режиме «модуль Apache».
Подготовка к установке GWS
Смена версии PHP для сайтов в режиме «модуль Apache»
Поскольку работа GWS влияет на альтернативные версии PHP в режиме «модуль Apache», необходимо перевести такие сайты на системную версию PHP (в панели такая версия отмечена как «native») или изменить режим работы PHP на CGI.
При изменении версии PHP или его режима работы, индивидуальные настройки PHP для сайта будут сброшены к глобальным - предупредите администраторов таких сайтов!
Сайты, где PHP работает в режиме PHP-FPM, не будут затронуты, поскольку в этом случае обработчик работает на Nginx.
Отключение инстансов Apache
Для корректной работы веб-сервера GWS необходимо отключить возможность Apache создавать отдельные инстансы для каждого сайта, добавив в конфигурационный файл панели /usr/local/mgr5/etc/ispmgr.conf строку:
Option DisableApachePerSite
После добавления директивы, убедитесь что в панели не осталось сайтов, которые используют альтернативные версии PHP в режиме «модуль Apache».
Перезапустите панель командой:
pkill core
Установка GWS
- Подключитесь к серверу по SSH под пользователем root;
- Скачайте архив с последней версией веб-сервера в директорию root:
cd /root wget https://download.galews.com/gws-1.0.7-build5.tar.gz - Распакуйте архив и перейдите в созданный каталог:
tar -xzf gws-1.0.7-build5.tar.gz cd gws-1.0.7-build5 - Выполните проверку окружения:
На этом этапе установщик не вносит изменений в систему: убедитесь, что были верно определены версии ОС и панели ispmanager, а также проверены контрольные суммы../install --check - Запустите установщик:
Подтвердите установку, введя «y»../install
В процессе установки будут созданы скрипты, юниты systemd и платформенные программы, настроена конфигурация, подключены консоль и панель.
После установки GWS не будет автоматически запущен и не займет порты - текущий веб-сервер продолжит обслуживать сайты.
По окончанию установки будет выведен логин admin и пароль для доступа к веб-консоли GWS, который генерируется установщиком - сохраните этот пароль. При необходимости, пароль можно найти в файле /etc/gws/console.users.
Собственный пароль можно установить с помощью команды:
gwscctl console password
Подготовка к переключению на GWS
Проверка работы веб-сервера
Убедитесь, что служба веб-сервера запущена, но не обслуживает слот:
gwsctl status
# gwsctl status
slot: Apache (unmodified)
serving: apach
Проверьте синтаксис конфигурации веб-сервера:
gwsctl test
# gwsctl test
gws: the configuration file /usr/local/gws/conf/gws.conf syntax is ok
gws: configuration file /usr/local/gws/conf/gws.conf test is successfu
Лицензирование
Новому серверу, на котором ранее не было активирована лицензия, при установке автоматически выдается пробная лицензия на 30 дней.
Лицензия на веб-сервер привязывается к конкретному серверу и его IP-адресу. Проверка наличия лицензии выполняется раз в 24 часа.
При истечении срока действия лицензии, GWS автоматически возвращает в работу ранее используемый веб-сервер - не удаляйте Apache или LiteSpeed после переключения!
Для активации веб-сервера приобретенной лицензией, выполните команду:
gwsctl licence activate <ключ_активации>
Проверить информацию о подключенной лицензии можно командой:
gwsctl licence
Тестовые включения
Первым необходимо проверить возможность корректной трансляции файла конфигурации httpd.conf с помощью команды:
gwsctl switch preflight
Команда проверяет, что файл транслируется и валидируется, все интерпретаторы PHP доступны и запускаются от имени аккаунтов. В случае успеха, в выводе команды в последней строке будет написано «ready to switch».
Следующим шагом необходимо проверить работу одного из реальных сайтов на тестовом порту, например 8081:
gwsctl vhost <имя_сайта> 8081
Когда сайт будет запущен, проверьте ответ от него с помощью cURL:
curl -I -H 'Host: <имя_сайта>' http://127.0.0.1:8081/
Убедитесь, что сайт отвечает (код 200) и в заголовке Server указан gws.
# curl -I -H 'Host:<имя_сайта>' http://127.0.0.1:8081/
HTTP/1.1 200 OK
Date: Mon, 01 Dec 2020 12:00:00 GMT
Content-Type: text/html
Content-Length: 12105
Last-Modified: Mon, 01 Dec 2020 11:30:00 GMT
Connection: keep-alive
Vary: Accept-Encoding
ETag: "6aedd28d-2f99"
Server: gws
Accept-Ranges: bytes
Завершите тестовый процесс:
kill $(cat /tmp/gws-vhosttest.*/gws.pid)
Дополнительная настройка
Настройка watchdog
Рекомендуется настроить watchdog, внести изменения в файл /etc/gws/watchdog.conf, например:
IP=10.0.1.27
CANARY1=example.com
CANARY2=
NEEDED=3
TRIES=3
GAP=3
TIMEOUT=10
IP— IP-адрес назначения HTTP-запроса на порт 80;CANARY1иCANARY2— значения заголовкаHostдля контрольных доменов, находящихся на этом сервере (см. документацию Gale Web Server);TRIES— максимальное количество попыток для каждого из контрольных доменов за один запуск watchdog;GAP— пауза между попытками в секундах;TIMEOUT— максимальное время одного запроса в секундах;NEEDED— количество последовательных не успешных запусков проверки, после которых будет выведено критическое уведомление.
Настройка доступа к консоли GWS
Консоль веб-сервера доступна по HTTPS по имени сервера и порту 7080, например https://myserver.local:7080/.
По умолчанию доступ к интерфейсу не ограничивается. Если необходимо установить собственные ограничения и доступы для определенных подсетей и IP-адресов, создайте файл /etc/gws/console-access.conf и добавьте в него правила deny и allow соответственно. Например, чтобы запретить доступ со всех адресов, кроме подсети 10.0.1.0/24, добавьте следующую строку:
allow 10.0.1.0/24,; deny all;
После внесения изменений, перезагрузите веб-сервер GWS:
systemctl gws restart (?)
Также можно настроить только локальный доступ, установив 127.0.0.1 в качестве адреса прослуишвания в /etc/gws/console.conf:
listen 127.0.0.1:7080 ssl;
В этом случае необходимо подключаться через SSH-туннель, выполнив команду на вашем устройстве:
ssh -L 7080:127.0.0.1:7080 root@<ip-адрес_сервера>
При таком подключении панель веб-сервера будет доступна по адресу https://127.0.0.1:7080/.
Переключение на GWS
После установки, проведения проверок и выполнения необходимо настроек, можно приступать к переключению сервера на работу с GWS: текущий веб-сервер Apache или LiteSpeed буду остановлены, а GWS займет их слот; Nginx продолжит свою работу в штатном режиме.
Для фактического переключения на GWS, выполните команду:
gwsctl switch on
Подтвердите действие, введя «yes».
- Найдены все сайты на PHP и проверены ответы от них;
- Зафиксированы эталонные ответы от сайтов через Apache;
- Остановлен текущий веб-сервер Apache или LiteSpeed;
- Запущен GWS на слоте Apache;
- Запрос ответов от сайтов на PHP и сверка текущих ответов с зафиксированными.
Проверьте статус переключения с помощью команды:
gwsctl switch status
В выводе команды должны присутствовать строки «httpd slot: gws» и «serving now: gws».
В завершение, проверьте фактическое состояние ваших сайтов в браузере или с помощью cURL:
curl -I http://<имя_сайта>
В заголовке Server должен быть указан «gws».
Обновление GWS
Проверить наличие обновлений можно с помощью команды:
gwscctl update
Установить обновления можно командой:
gwscctl update apply
Переключение на предыдущий веб-сервер
Перед переключением с GWS обратно на Apache или LiteSpeed, выполните проверку предыдущего веб-сервера:
gwsctl switch check apache
gwsctl switch check litespeed
Для фактического возвращения к предыдущему веб-серверу, выполните команду:
gwsctl switch off
Особенности работы с GWS
- Панель ispmanager 6 обращается к службе httpd или lshttpd: это ожидаемое поведение, поскольку GWS подхватывает такие обращения на себя.
- Долгое применение изменений в конфигурации: поскольку GWS выполняет пересборку конфигурационного файла в фоновом режиме при отправке панелью команды
apache graceful, процесс применения изменений может затянуться до 30 секунд. - В информации о PHP присутствует LiteSpeed: при использовании GWS, PHP всегда работает через LSAPI, поэтому при получении информации через функцию
phpinfo()в Server API упоминается LiteSpeed. - Настройки PHP сайта сбрасываются при смене версии: одной из особенностей GWS является сброс настроек PHP к глобальным при смене версий PHP.
- Сохранение Apache/LiteSpeed: поскольку GWS позволяет вернуться к прежнему веб-серверу, оставить на сервере Apache или LiteSpeed - критически важно.
Известные проблемы
Плагин «GWS Web Server» не отображается в ispmanager
Если после установки GWS, в панели в разделе Веб-сервер не появился пункт GWS Web Server, примените патч и перезапустите панель, выполнив следующую команду:
sed -i -E 's#<(htmldata|textdata) name="report"( type="data")?( html="yes")?/>#<textdata name="report" type="data" html="yes"/>#' /usr/local/mgr5/etc/xml/ispmgr_mod_gws.xml; pkill core
Ошибка Nginx «"proxy_pass" directive is duplicate» при изменении альтернативной версии PHP
Такая ошибка возникает, если до переключения на веб-сервер GWS сайты с альтернативными версиями PHP в режиме «модуль Apache» не были переведены на работу с системной (нативной) версией PHP.
Чтобы устранить ошибку, выполните следующее в настройках таки сайтов:
- Отключите обработчик сайта;
- Сохраните изменения;
- Включите обрабтчик, выбрав PHP;
- Выберите системную (нативную) версию PHP;
- Сохраните изменения.
Ошибка «bind() to 0.0.0.0:80 failed» при запуске службы httpd для конкретной версии PHP
Данная ошибка возникает, если не была отключена возможность Apache создавать отдельные инстансы для каждого сайта.
Добавьте в конфигурационный файл панели /usr/local/mgr5/etc/ispmgr.conf строку:
Option DisableApachePerSite
После переключения не добавляйте новые сайты, работающих на альтернативных версиях PHP в режиме «модуль Apache»!
Используйте нативную версию PHP для режима «модуль Apache», режим CGI или PHP-FPM.
Поддержка GWS
Разработкой и поддержкой веб-сервера занимается компания Galews - все вопросы и предложения по работе веб-сервера GWS необходимо направлять разработчику.