Установка

Поддерживаемые платформы

Платформа, то есть комбинация архитектуры процессора и операционной системы, считается поддерживаемой сообществом разработчиков QHB.

Для QHB версии 1.5.0 поддерживаются:

  • Centos Linux 7, x86_64
  • Centos Linux 8, x86_64
  • Альт Сервер 9, x86_64
  • Fedora 33, x86_64
  • Fedora 34, x86_64
  • Linux Debian 9, x86_64
  • Astra Linux Special Edition, «Смоленск» 1.6, x86_64
  • в docker контейнере

Состав поставки

QHB поставляется в виде следующих пакетов

  • qhb-core - ядро QHB
  • qhb-contrib - расширения QHB
  • qcp - пулер соединений
  • qdl - средство быстрой загрузки
  • qbackup - инструмент резервного копирования
  • metricsd - сервер метрик

Установка из репозитория пакетов

Внимание!
Если вы обновляете версию QHB или мигрируете базы данных с других СУБД, обратитесь к разделу Установка с обновлением.

В этой главе описывается установка QHB из предварительно упакованного дистрибутива. Двоичные пакеты QHB для поддерживаемых платформ можно найти на Странице загрузки

Стандартная процедура установки QHB выглядит так:

Подключение репозитория и установка пакетов

Подключите репозиторий пакетов и установите пакеты для выбранной платформы со Страницы загрузки.

Инициализация кластера базы данных

Инициализируйте кластер базы данных при помощи утилиты initdb или qhb_bootstrap. В данном примере /opt/qhb/data — расположение каталога базы данных:

Внимание!
Запуск утилит необходимо производить из под пользователя qhb, владельца экземпляра.
Или предварять запуск командой sudo -u qhb .

/usr/local/qhb/bin/initdb -D /opt/qhb/data -U qhb

или

/usr/local/qhb/bin/qhb_bootstrap -D /opt/qhb/data -U qhb

Замечание.
Использование утилиты qhb_bootstrap предпочтительно.
Утилита initdb планируется к удалению в будущих версиях QHB.

Настройка сервиса

Если необходимо, настройте сервис базы данных, см. Настройка сервиса базы данных.

Создание базы данных и конфигурирование

Следуйте инструкция по созданию и настройке базы данных, см. Начало работы.

Установка с обновлением

Обновление версии QHB и миграция баз данных с других СУБД.

При переходе с одной версии QHB к другой, иногда происходят такие изменения в структурах данных каталога СУБД, которые делают невозможным функционирование новой версии без преобразования данных старой базы.

Для такого преобразования предусмотрена специальная утилита обновления экземпляра qhb_upgrade.

Некоторые обновления не требуют запуска qhb_upgrade:

  • обновление пакетов из репозитория, если база данных ещё не была создана или планируется создание новой, а старая не важна,
  • установка QHB впервые или
  • миграция базы с помощью утилит qhb_dump / qhb_dumpall.

Если же планируется перенос или миграция базы данных, перед обновлением нужно обратиться утилите qhb_upgrade. Утилита может обновлять данные не только при обновлении версии QHB, но даже при миграции с PostgreSQL некоторых версий.

Некоторые минорные обновления QHB не меняют структуру данных, и их установка не требуют каких-то специальных действий. В этом случае, утилита qhb_upgrade об этом сообщит.