HQCenter: парк серверов
Много серверов в одной консоли
HQCenter — один сервер Linux у клиента, к которому подключаются все его агенты. Агенты сами отправляют туда данные и сами забирают настройки, команды, лицензии и новые версии. Администратор видит весь парк в HQ Monitor и управляет им из браузера.
- 0 входящих портов для связи с центром
- mTLS сертификат у каждого агента
- 3 мин данные приходят в центр
- ~1 мин настройки доходят до агента
- с откатом обновления агентов и центра
Агент · nginx · goafts · fblogspacker · HQ Monitor
Связь без входящих портов
Все соединения открывает агент. HQCenter никогда не подключается к серверу БД. Поэтому для связи с центром на серверах Firebird не нужно открывать порты, а сервер в филиале за NAT работает так же, как сервер в соседней стойке.
На HQCenter работают три программы за nginx. goafts принимает архивы, выдаёт сертификаты и хранит настройки, команды, лицензии и новые версии. fblogspacker раскладывает архивы по папкам агентов. HQ Monitor показывает эти папки в браузере.
| Порт HQCenter | Кто приходит | Проверка |
|---|---|---|
:443 | Агенты: архивы, настройки, команды, лицензия, новые версии | TLS 1.3 и сертификат агента; отозванный сертификат не проходит |
:9443 | Новый агент при подключении и установщики | Без сертификата агента: заявка на сертификат по ключу из attach.json, отпечаток ключа центра, скачивание установщиков |
:8443 | Администратор и консоль: управление | Сертификат администратора и список разрешённых адресов |
:8085 | Браузер: консоль HQ Monitor | Список разрешённых адресов |
- Подключение одной командойЦентр выдаёт файл
attach.json: адрес, отпечаток ключа и срок. На сервере:fbagent --attach --file attach.json. Установщики HQbird 2027 делают это сами. Заявку с обычным ключом одобряет администратор в панели центра. Ключ лицензии одобряет заявку сам, пока в лицензии есть свободные места. - Имя агента — имя в сертификатеПод ним у агента папка с данными, настройки и строка в консоли. Установщик Windows спрашивает имя сервера; по умолчанию это имя компьютера. Сертификат выдаётся на год; отозванный сразу перестаёт работать.
- Ничего не теряетсяАрхив до 120 МиБ. При ошибке сети 3 попытки. Отправленный архив удаляется; неотправленный не удаляется никогда. Каждый агент отправляет со своим сдвигом до 150 с, поэтому агенты одного центра не приходят в одну секунду.
- Лицензии из центраНовую лицензию агент забирает примерно через минуту: о ней говорит ответ на опрос настроек. Кроме того, агент спрашивает лицензию при старте и раз в 6 часов. Проверяет он её сам, без сети. На странице Licenses видно состояние каждого сервера.
- Консоль не трогает базыHQ Monitor строит страницы из файлов агентов. К Firebird она не подключается и базы не нагружает.
- Один сервер LinuxUbuntu или AlmaLinux. Центр ставится одним скриптом; повторный запуск обновляет то, что есть, и сохраняет пароли и ключи.
К IBSurgeon уходят сводки: состояние серверов, список серверов, список бэкапов и восстановлений (без самих файлов), события и недельные отчёты, описания кластеров, лицензии. Логи, трассы, файлы бэкапов, пароли и журнал аудита остаются у клиента.
Редактор настроек · Run now · статус доставки
Настройки из центра
В центре лежит копия настроек каждого агента. Администратор меняет задания и настройки в том же редакторе, что и рядом с агентом, и нажимает Save and Send to agent. Агент забирает изменение примерно через минуту.
Агент не пишет новые настройки поверх рабочих. Он сначала проверяет кандидата. Плохой кандидат откладывается, рабочие настройки остаются, а консоль показывает причину отказа.
Статус на странице серверов
Для каждого сервера видно, как далеко прошло последнее изменение: значок статуса, время отправки (push) и время ответа агента (ack). Подсказка у значка показывает причину отказа агента и точное время.
Так за минуту видно, какие серверы приняли новое задание бэкапа, а какие нет и почему.
Уровень сервера в списке — это вывод агента о сервере целиком. Под значками стоит одна строка с главной находкой. Отдельный значок «Agent» появляется, только когда состояние самого агента хуже состояния сервера.
Сервер, который молчит больше 30 минут, получает серый значок «нет данных с …» и уходит в конец списка. Строка итога над списком считает серверы по уровням.
Агент бережёт сервер
Агент следит за своей памятью и CPU. Если задача агента берёт слишком много, агент ставит её на паузу, а запуск, который держит память, останавливает. Бэкапы и отправку данных он не трогает. Если память агента всё равно растёт, агент перезапускается сам. Задача, которую агент выключил, видна в отчёте о здоровье и в редакторе; включить её снова можно одной кнопкой.
Run now из центра
Бэкап, восстановление, sweep, проверку gfix или пересчёт индексов можно запустить сейчас, не дожидаясь расписания. Запрос идёт тем же путём: в goafts, затем агент забирает его при опросе и ставит в свою очередь, с обычными проверками.
- ЧерновикиИзменение можно сохранить в консоли и отправить позже. Видно состояние: not sent, sent, applied, superseded.
- Пароли не видны в центреКонсоль шифрует новый пароль открытым ключом агента. Расшифровать его может только агент на своём сервере.
- Копии настроекПеред каждой заменой агент сохраняет копию: 10 последних, не меньше 14 дней. Отклонённые кандидаты хранятся 90 дней.
- Только на сервереПроверку подписи релизов, лицензию, удалённые команды, пути программ и вход в консоль нельзя изменить из центра.
- Замена базы — с двух сторонВосстановление с заменой рабочей базы удалённо работает, только если это разрешено на самом сервере и у пользователя есть отдельное право. Перед запуском нужно ввести имя файла базы.
- databases.conf из центраФайл можно отправить одному агенту. goafts его только передаёт; проверяет и пишет файл агент, старый сохраняется рядом.
Подпись · точка отката · проверка
Обновления с откатом
Агенты берут новые версии у HQCenter, а не из интернета. Агент обновляет себя, HQ Monitor, программы кластера и Firebird. Каждое обновление идёт по одной схеме: проверить подпись, сохранить точку отката, поставить, проверить, что работает. Не работает — вернуть старое.
- 1Подписьрелиз подписан IBSurgeon
- 2Точка откатакопия текущей версии
- 3Установказамена файлов
- 4Проверкановая версия сама говорит «я работаю» и живёт 45 с
- 5Готовоновая версия работает
- ↺Откатвернуть копию из точки отката
- ✓Старая версия работаетпосле 2 откатов версия блокируется
| Что обновляется | Когда | Защита |
|---|---|---|
| Агент | сразу, когда ответ на опрос настроек сообщает новую версию, и раз в час; без такого ответа раз в 180 с | Подпись, 2 точки отката. Новая версия должна сама сообщить «я работаю» и проработать 45 с. После 2 откатов версия блокируется. |
| HQ Monitor | раз в час, пока опрос настроек работает; иначе раз в 180 с | Проверка работы консоли 30 с, копия старой версии. |
| Программы кластера | проверка раз в 180 с | Сначала реплика, потом мастер. |
| Firebird | только в окне, по умолчанию 03:30–04:00 | Ждёт конца бэкапов. Проверка после установки, при сбое откат. Откаченная сборка больше не ставится. |
| HQCenter | раз в 15 мин, если IBSurgeon включил обновление для этого центра; в окне, которое задаёт IBSurgeon, например 02:00–05:00 | По умолчанию выключено. Владелец центра может запретить обновление: STACK_UPDATE=off. Проверка подписи набора, затем до 5 минут проверки служб. Не прошли — ставится прошлый набор из кэша. |
- Сначала тест, потом всеIBSurgeon публикует релиз сначала в тестовой зоне, после проверки — в рабочих. HQCenter раз в час копирует релизы своей зоны.
- Подпись дваждыЦентр проверяет подпись до скачивания и ещё раз по записанным байтам. Агент проверяет её снова перед установкой.
- Не внизВерсию ниже текущей поставить нельзя, если это не разрешено на самом сервере.
- На Linux файлы меняет rootСлужба агента работает не от root и не может подменить доверенные файлы установки.
Наблюдение за статусом · почта · webhook
Письма о проблемах и недельный отчёт
HQCenter читает снимок состояния каждого агента. Новая проблема или проблема, ставшая серьёзнее, — это событие. Письмо или webhook отправляет сам центр. Раз в неделю центр готовит отчёт по всему парку.
Центр сам ничего не меняет. Если проблема висит неделями и это норма для сервера, центр предлагает новый порог. Применяет его только человек.
- 1Чтение статусакаждые 2 минуты, если файл агента изменился
- 2Событиеновая, стала серьёзнее, ушла, вернулась
- 3Письмоили webhook; повтор за 24 ч не шлётся
- 4Недельный отчётпо умолчанию в понедельник в 07:00
- 5✓ Предложениеновый порог; применяет администратор
Весь парк за 14 дней
Для каждого сервера: доля времени без проблем, сколько эпизодов в неделю и какие находки «застряли».
Не шум, а норма
Активна не меньше половины времени и одной полосой не меньше недели. Например, CPU сервера всегда около порога.
Порог по факту
Чуть дальше того, что показал сервер: на четверть выше максимума. Для нижнего порога, например свободного места, — на пятую часть ниже минимума. Можно изменить перед одобрением; действует 30 дней.
- Один хост — одно письмоЕсли на хосте несколько агентов, проблема с CPU, памятью или диском хоста считается один раз.
- Ушла или скрытаСобытие говорит, почему проблема ушла: исправлена, признана администратором или стала info.
- Одобрение — это новая версия настроекПорог уходит агенту обычной доставкой, от имени администратора. Каждое одобрение и отказ в журнале аудита.
- Ссылка в письмеПисьмо называет хост, даёт подсказку и ссылку на сервер в HQ Monitor.
Почту и webhook включает администратор центра. Пока они не настроены, письма не уходят. События и отчёты видны в панели центра и в его API.
Пользователи · права · аудит · языки
Пользователи и права
Каждый пользователь видит только свои серверы. Права на изменения выдаются отдельно, по одному.
Администратор видит все серверы и управляет пользователями. Обычный пользователь видит серверы из своего списка. Новое право или новый список действуют со следующей загрузки страницы; новый пароль выводит пользователя из всех браузеров.
| Право | Что разрешает |
|---|---|
| Отправлять настройки | Отправить изменённые настройки агенту через центр. |
| Запускать задания | Запустить и отменить бэкап, восстановление, sweep или пересчёт индексов (Run now). |
| Задания с заменой базы | Запустить восстановление, которое заменяет рабочую базу. Только вместе с правом запуска, и только если агент тоже это разрешает. |
- Журнал аудитаКаждое сохранение, отправка, смена пароля и запуск задания пишется с логином пользователя. В goafts журнал защищён цепочкой хешей.
- Журнал запросов агентаАгент сам пишет строку на каждый запрос, который меняет сервер, и на каждый отказ в доступе: Local API, команды из центра, Run now, смена настроек, обновления. Пароли и тела запросов в журнал не попадают. Файл уходит в центр вместе с логами.
- Вход в HQ MonitorСессия 7 дней. С одного адреса не больше 8 попыток входа за 15 минут.
- Панель администратора центраОтдельный вход, только с сертификатом администратора. Сессия 8 часов. После 5 неудачных попыток за 15 минут вход закрыт на 15 минут.
- До 2000 пользователейУ каждого свой пароль и свой список серверов; поиск по серверам при назначении.
- 5 языков интерфейсаEnglish, русский, Deutsch, português (Brasil), español. Отчёты статистики тоже на выбранном языке.
← Вернуться к обзору HQbird 2027 · Состояние сервера за минуту →