/
/
Установка веб-сервера GWS для ispmanager 6

Установка веб-сервера 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

  1. Подключитесь к серверу по SSH под пользователем root;
  2. Скачайте архив с последней версией веб-сервера в директорию root:
    cd /root
    wget https://download.galews.com/gws-1.0.7-build5.tar.gz
    
  3. Распакуйте архив и перейдите в созданный каталог:
    tar -xzf gws-1.0.7-build5.tar.gz
    cd gws-1.0.7-build5
    
  4. Выполните проверку окружения:
    ./install --check
    
    На этом этапе установщик не вносит изменений в систему: убедитесь, что были верно определены версии ОС и панели ispmanager, а также проверены контрольные суммы.
  5. Запустите установщик:
    ./install
    
    Подтвердите установку, введя «y».

В процессе установки будут созданы скрипты, юниты 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».

Что будет выполнено в процессе переключения веб-сервером GWS
  • Найдены все сайты на 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.

Чтобы устранить ошибку, выполните следующее в настройках таки сайтов:

  1. Отключите обработчик сайта;
  2. Сохраните изменения;
  3. Включите обрабтчик, выбрав PHP;
  4. Выберите системную (нативную) версию PHP;
  5. Сохраните изменения.

Ошибка «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 необходимо направлять разработчику.