Обслуживание без ночных дежурств

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 обычно делает руками: расписание, окно, блокировку базы, журнал и понятную причину ошибки.

ЗаданиеЧто делаетКакие базыПо умолчанию
Sweepgfix -sweep: убирает старые версии записей.Явный список базвс 03:00
Групповой sweepТот же sweep для всех баз в папках. Маски, исключения, глубина обхода.Папки, маска *.fdb00:15–01:15
Проверка gfixgfix -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. Агент применяет его примерно за минуту и сообщает результат: принято или отклонено.

    Редактор databases.conf. Слева пути и алиасы, справа алиасы и параметры выбранного пути. Колонка firebird.conf показывает значение сервера.
    История конфигов. Агент сохраняет копию databases.conf, firebird.conf и replication.conf при каждом изменении. Видно, что и когда поменялось.

    Переход на 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 · Бэкапы подробно → · Состояние сервера →