Обслуживание сервера HQbird
Обслуживание без ночных дежурств
Sweep, проверка базы, пересчёт статистики индексов, ваши SQL-скрипты и обновление Firebird идут ночью по расписанию. Групповой sweep, SQL-скрипты и обновление Firebird стартуют только в своём окне. Агент не мешает бэкапам и пользователям. Если что-то пошло не так, он сам возвращает прежнее состояние.
- 4 задания обслуживания
- 1 тяжёлая операция на базу
- 2 тяжёлые задачи на сервер
- 03:30–04:00 окно обновления Firebird
- авто-откат если проверка не прошла
Расписание по умолчанию
Ночь сервера
Обслуживание идёт ночью, каждое задание в своё время. Ниже — время и окна по умолчанию. Вы меняете их в редакторе конфигурации агента.
Sweep, проверка gfix, пересчёт индексов и SQL-скрипты по умолчанию выключены: вы включаете их для своих баз. Время считается в часовом поясе агента.
Воскресная ночь идёт в таком порядке: проверка gfix в 02:30, sweep в 03:00, пересчёт индексов в 04:00. Сначала проверка, затем уборка мусора, затем статистика по живым данным.
sweep · gfix · индексы · SQL
Четыре задания обслуживания
Каждое задание — это обычная команда Firebird. Агент добавляет к ней то, что DBA обычно делает руками: расписание, окно, блокировку базы, журнал и понятную причину ошибки.
| Задание | Что делает | Какие базы | По умолчанию |
|---|---|---|---|
| Sweep | gfix -sweep: убирает старые версии записей. | Явный список баз | вс 03:00 |
| Групповой sweep | Тот же sweep для всех баз в папках. Маски, исключения, глубина обхода. | Папки, маска *.fdb | 00:15–01:15 |
| Проверка gfix | gfix -v -full: проверка каждой страницы базы. | Только явный список | вс 02:30 |
| Пересчёт индексов | SET STATISTICS для пользовательских индексов. Отдельно находит неактивные индексы. | Список баз | вс 04:00 |
| SQL-скрипты | Ваши DDL и DML из папки входящих скриптов или из очереди. | Одна база на скрипт | 03:00–04:00 |
- Долгие транзакции перед sweepПо желанию агент отключает соединения с транзакциями старше 5 часов (порог настраивается). gbak, gfix, gstat и fbsvcmgr он не трогает.
- Группа не останавливаетсяОшибка на одной базе не прерывает обход остальных баз.
- Понятная причинаFirebird 3 и новее не даёт проверять базу, к которой подключены пользователи. Агент так и пишет, а не показывает только код ошибки.
- SQL: COMMIT ставит агентDDL — COMMIT после каждой команды, DML — после каждых 100 команд.
SET BAIL ON: первая ошибка останавливает скрипт. - Опасный SQL не выполняется
DROP DATABASE, пользователи и роли,GRANTиREVOKE,ALTER DATABASE: такой скрипт целиком уходит в карантин. - Журнал запусковКакая команда, когда и с каким результатом. Для sweep и проверки gfix агент хранит историю команд: до 50 на задание, две последние видны в редакторе. Пароль в журнал не попадает.
Окна · блокировки · слоты
Если сервер занят, задание ждёт или пропускает базу
Перед запуском агент проверяет несколько условий. Если условие не выполнено, задание ждёт или пропускает базу. Оно не прерывает чужую работу.
Включите условия слева и посмотрите, что агент сделает с базой sales.fdb при групповом sweep её папки.
| Правило | Что считается | Что делает агент |
|---|---|---|
| Окно обслуживания | Групповой sweep 00:15–01:15, SQL-скрипты 03:00–04:00, тест производительности сб 22:00 — вс 06:00. | Вне окна задание не стартует. Если до конца окна меньше минуты, тоже не стартует. |
| Одна тяжёлая операция на базу | Бэкап, sweep, проверка, пересчёт индексов, восстановление, SQL-скрипт берут блокировку базы. | Бэкап ждёт свободную базу до 60 минут. Sweep, проверка и пересчёт индексов пропускают занятую базу до следующего запуска по расписанию. Run now ждёт и пробует снова. |
| Не больше 2 тяжёлых задач на сервер | Бэкапы, восстановление, sweep, проверки, пересчёт индексов, SQL-скрипты, полный gstat, тест. Тяжёлая работа самого агента тоже занимает место: обработка трасс и логов. | Третья задача ждёт свободного места. Число меняется в настройках, новое значение действует после перезапуска агента. |
Файл .delta | Рядом с базой лежит файл .delta: базу держит nbackup. | Sweep пропускает такую базу. |
| Ошибка одной базы в группе | Sweep одной базы группы закончился ошибкой. | Групповой sweep продолжает со следующей базы. Если продолжение выключено, останавливается только это задание. Базы с ошибкой названы в итоге задания. |
Если gbak-бэкап и nbackup одной базы попали на одну минуту, gbak-бэкап сдвигается на 15 минут. Ручной запуск через Run now не сдвигается.
Одна кнопка
Run now: запустить сейчас
Нужен бэкап до обновления программы или sweep прямо сейчас? Кнопка «Запустить сейчас» (Run now) на строке задания запускает его один раз. Расписание не меняется.
Run now есть у бэкапов, восстановлений, sweep, пересчёта индексов и проверки gfix. Выключенное задание тоже можно запустить один раз: потом оно остаётся выключенным. Агент проверяет те же условия, что и для расписания, и показывает, чего ждёт.
- Видно, чего ждётБаза занята другой операцией, задание ждёт окна, мало места на диске.
- ОтменаПока запуск в очереди или ждёт, его можно отменить. Начатое задание не отменяется.
- Запрос живёт 60 минутЕсли агент не взял его за это время, запуск считается истёкшим, а не потерянным.
- Видно, какая база запуститсяОкно запуска начинается с поля базы. Для группового задания это флажки баз и строка «отмечено N из M».
- Отчёт производительности по запросуRun now строит отчёт за любой диапазон до 24 часов, с фильтрами по базе, длительности и программе. Это тот же запуск, что и кнопка «Build report…» на странице отчёта.
- Локально и из центраЛокальная консоль идёт прямо к агенту. Из центра запрос идёт через goafts. Агент берёт его при следующей синхронизации, примерно за минуту.
- Замена базы — отдельноВосстановление с заменой и цикл бэкап-рестор-замена: нужно ввести имя файла базы и иметь отдельное право. Удалённый запуск таких заданий на сервере по умолчанию выключен.
- Сразу после сохраненияRun now ждёт, пока агент примет новую конфигурацию, и только потом запускает задание.
Обновление движка
Новая сборка Firebird — обычная ночная операция
Агент сам скачивает новую сборку Firebird, ждёт окна обслуживания, ставит её и проверяет. Если проверка не прошла, агент возвращает прежнюю версию и больше не ставит эту сборку.
- ОкноПо умолчанию 03:30–04:00. Вне окна скачанная сборка ждёт начала окна. Если в окне обновление отложено, агент пробует снова через 10 минут. Новую сборку в центре агент находит примерно за час.
- Задания, которые нельзя оборватьИдёт gbak, nbackup, восстановление или SQL-скрипт — обновление откладывается до следующей проверки. Sweep, проверка gfix и gstat не мешают: их можно повторить.
- Один движок за разНа сервере с несколькими Firebird одновременно обновляется только один.
- Место и занятые файлыСвободное место и файлы, которые держит другая программа, проверяются до остановки Firebird. Если файл заменить нельзя, Firebird не останавливается.
- Ваши файлы остаютсяАгент заменяет только файлы дистрибутива. firebird.conf, databases.conf, replication.conf, база безопасности, UDF и чужие плагины остаются. В firebird.conf добавляются только недостающие обязательные параметры.
- ОткатЗаменённые файлы лежат в бэкапе обновления. Откат возвращает их на место. Хранятся 2 последних бэкапа.
- Блок версийСборка, после которой был откат, автоматический или ручной, блокируется. Снять блок — одна команда.
- Незаконченное обновлениеЕсли процесс прервался посередине, новое обновление не начнётся, пока администратор не откатит или не завершит прежнее.
Firebird, установленный из пакетов ОС (apt, dnf), агент не обновляет: файлами владеет менеджер пакетов. Как перевести такой сервер на HQbird — ниже.
Тест · databases.conf · переход
Инструменты администратора
Тест производительности сервера
Раз в неделю агент запускает тест IBSurgeon: INSERT, UPDATE и DELETE на миллион строк во временной базе. История тестов показывает, как сервер работал до и после смены железа, диска или настроек.
Тест нагружает диск, поэтому идёт только в своё окно. Временную базу удаляет сам Firebird. Если агент упал во время теста, файл удаляется при следующем старте.
| Окно | сб 22:00 — вс 06:00 |
|---|---|
| Запуск | вс 01:00 |
| Строк | 1 000 000 |
| Свободно на диске | около 7,2 ГиБ, иначе тест не стартует |
| История | 30 последних запусков |
| Одновременно | один тест; второй запуск пропускается |
Пользователи Firebird: Security.fdb/Users
Отдельная страница настроек показывает базы безопасности сервера: общую, приватные и встроенные в базу. Метки показывают проблему: нет логина для чтения, список не обновился, запись устарела.
Кнопка Create user создаёт пользователя Firebird через агента. В окне: имя, пароль дважды, плагин из настройки UserManager, признаки «активен» и «администратор». Права администратора подтверждаются вторым шагом. Перед выполнением виден текст команды, пароль в нём скрыт.
Создание работает с локальным агентом и не работает для Firebird 2.5.
Редактор databases.conf
Файл показан как список путей к базам. У каждого пути — его алиасы и блок параметров. В списке параметров только те, что эта версия Firebird принимает для отдельной базы. Рядом видно значение из firebird.conf.
Повтор алиаса и второй блок для одного пути — ошибки: сохранить такой файл нельзя. Опечатка в имени параметра получает подсказку. При сохранении агент проверяет файл ещё раз и оставляет рядом копию прежнего файла. Если файл изменили, пока вы его правили, агент откажет, а ваш текст останется в редакторе. Правка в форме не трогает комментарии в файле. Каждое сохранение пишется в журнал аудита.
Из центра файл доставляется через goafts. Агент применяет его примерно за минуту и сообщает результат: принято или отклонено.
Переход на HQbird и изменения настроек
FBDataGuard
Настройки старого HQbird переносятся сами
При первом старте агент находит конфигурацию FBDataGuard и переносит задания бэкапа, sweep и статистики индексов. Импорт идёт один раз. По умолчанию задания приходят выключенными. Если установщик отключает FBDataGuard, включаются те задания, которые FBDataGuard выполнял и которые импортированы без предупреждений. Так сервер не остаётся без бэкапов. Остальные задания остаются выключенными: проверьте их и включите сами. Старые бэкапы из журналов FBDataGuard агент берёт под свой учёт: хранение и восстановление видят их.
apt · dnf
Firebird из пакетов ОС
Установщик находит Firebird из пакетов и останавливается, ничего не меняя. Он печатает команды, которые удаляют пакет и сохраняют базу безопасности, databases.conf и базы. Затем установщик ставит HQbird и берёт пользователей и алиасы прежнего сервера. Проверено для Firebird 2.5, 3.0, 4.0 и 5.0.
без перезапуска
Новые настройки — с проверкой
Агент проверяет новую конфигурацию, делает копию старой и применяет новую без перезапуска. Если новая не загружается, агент возвращает прежнюю. Большинство настроек применяется без перезапуска. Перезапуск нужен для папки данных, журнала агента, Local API, связи с центром, Prometheus, кластера, лимитов нагрузки и часового пояса агента. Агент сообщает, какие изменения ждут перезапуска.
← Вернуться к обзору HQbird 2027 · Бэкапы подробно → · Состояние сервера →