Страница загрузки

Бинарные дистрибутивы для поддерживаемых платформ можно получить в репозитории QHB:

QHB для CentOS 7 и 8
QHB для РЕД ОС 7
QHB для Альт 8 СП
QHB для Альт Сервер 9
QHB для Fedora 36, 37, 38 и 39
QHB для Debian 10 и Astra Linux Special Edition 1.7
QHB для Ubuntu 18.04 и 22.04
QHB для openSUSE Leap 15.4
QHB в виде docker контейнера
Обновление уже установленных пакетов

QHB для CentOS 7 и 8

Примечание
Обратите внимание, что команды должны выполняться от пользователя с правами суперпользователя.

Установите утилиту config-manager для управления конфигурацией репозиториев:

dnf install dnf-plugin-config-manager

Установите репозиторий программного продукта СУБД «Квант-Гибрид» командой:

rpm --import https://repo.quantom.info/qhb/keys/RPM-GPG-KEY-qhb

Установите дополнительный репозиторий epel-release:

yum -y install epel-release

и далее выполните для CentOS 7:

dnf config-manager --add-repo https://repo.quantom.info/qhb/std-1/centos/7/x86_64/qhb.repo

Для установки qhb-patroni и postgis требуется добавить репозиторий postgresql:

 yum -y -q install https://download.postgresql.org/pub/repos/yum/reporpms/EL-7-x86_64/pgdg-redhat-repo-latest.noarch.rpm

Для CentOS 8 выполните:

dnf config-manager --add-repo https://repo.quantom.info/qhb/std-1/centos/8/x86_64/qhb.repo

Примечание
Для данной ОС могут быть проблемы с установкой СУБД «Квант-Гибрид» и его расширений из-за отсутствия доступных репозиториев. Поддержка данной ОС может быть исключена в следующем релизе.

Для установки qhb-patroni и postgis требуется добавить репозиторий postgresql:

 yum -y -q install https://download.postgresql.org/pub/repos/yum/reporpms/EL-8-x86_64/pgdg-redhat-repo-latest.noarch.rpm

Для CentOS 8 при необходимости установить расширение postgis требуются дополнительные репозитории:

dnf config-manager --add-repo https://repo.quantom.info/qhb/additional-package/centos/8/qhb-add.repo
dnf config-manager --set-enabled powertools

Установите бинарные пакеты командой:

dnf install qhb-core [qhb-contrib] [qcp] [qdl] [qdlm] [qbackup] [metricsd] [qhb-serial] [qhb-license-bin] [...]

Например:

dnf install qhb-core

В результате установки пакета ядра QHB будет создан пользователь qhb. Ядро QHB по умолчанию установится в каталог /usr/local/qhb. Многие утилиты QHB устанавливаются в каталог /usr/local/qhb/bin. Если этот каталог указать в переменной среды $PATH, это облегчит их запуск.

QHB для РЕД ОС 7

Примечание
Обратите внимание, что команды должны выполняться от пользователя с правами суперпользователя.

Установите утилиту config-manager для управления конфигурацией репозиториев:

dnf install dnf-plugin-config-manager

Установите репозиторий программного продукта СУБД «Квант-Гибрид» командой:

rpm --import https://repo.quantom.info/qhb/keys/RPM-GPG-KEY-qhb

и далее выполните для РЕД ОС 7:

dnf config-manager --add-repo https://repo.quantom.info/qhb/std-1/redos7/x86_64/qhb.repo

Установите бинарные пакеты командой:

dnf install qhb-core [qhb-contrib] [qcp] [qdl] [qdlm] [qbackup] [metricsd] [qhb-serial] [qhb-license-bin] [...]

Например:

dnf install qhb-core

QHB для Альт 8 СП

Примечание
Обратите внимание, что команды должны выполняться от пользователя с правами суперпользователя.

Примечание
СУБД QHB поддерживает ОС Альт 8 СП только версии ядра 5.10.

Для установки потребуются дополнительные библиотеки libicu и libgostcrypto. Также, возможно, потребуется установка или обновление библиотеки glibc до версии 2.34 или выше; заранее проверьте версию вашей библиотеки.

Скачайте библиотеку (подходит версия 60.3-2) в любую локальную папку:

wget -c http://mirror.centos.org/centos/8/BaseOS/x86_64/os/Packages/libicu-60.3-2.el8_1.x86_64.rpm

Скачайте библиотеку libgostcrypto:

wget -c -r -l1 -A '*.rpm' -nd -np https://repo.quantom.info/qhb/std-1/centos/8/x86_64/libgostcrypto.0.6-0.6.1-1.x86_64.rpm

ВНИМАНИЕ!
СУБД QHB для ОС Альт 8 СП поставляется на дисках. Для получения обратитесь по адресу qhb.support@quantom.info.

Скопируйте с диска все бинарные пакеты в локальную папку и установите командой, например:

apt-get install *.rpm

Вы можете установить не все пакеты QHB, а только необходимые вам. В этом случае вы можете перечислить в команде нужные вам пакеты rpm через пробел. Выбирайте последние версии из rpm пакетов, которые скачались.

Библиотека libicu и пакет qhb-core — обязательны.

В результате установки пакета ядра QHB будет создан пользователь qhb, ядро СУБД QHB по умолчанию будет установлено в каталог /usr/local/qhb. Многие утилиты QHB устанавливаются в каталог /usr/local/qhb/bin. Если этот каталог указать в переменной среды $PATH, это облегчит их запуск.

QHB для Альт Сервер 9

Примечание
Обратите внимание, что для СУБД «Квант-Гибрид» версии 1.5.1 на сервере под управлением OS Alt Server 9 должна быть установлена библиотека GLIBC версии не ниже 2.28.

Примечание
Обратите внимание, что команды должны выполняться от пользователя с правами суперпользователя.

Для установки потребуется дополнительная библиотека libicu. Также, возможно, потребуется установка или обновление библиотеки glibc.

Скачайте библиотеку (подходит версия 60.3-2) в любую локальную папку:

wget -c http://mirror.centos.org/centos/8/BaseOS/x86_64/os/Packages/libicu-60.3-2.el8_1.x86_64.rpm

Скачайте в эту же папку пакеты программного продукта СУБД «Квант-Гибрид» из репозитория командой:

wget -c -r -l1 -A '*.rpm' -nd -np https://repo.quantom.info/qhb/std-1/centos/8/x86_64/

Обновите описания пакетов:

apt-get update

Находясь в этой же локальной папке, установите бинарные пакеты командой, например:

apt-get install *.rpm

Библиотека libicu и пакет qhb-core — обязательны.

В результате установки пакета ядра QHB будет создан пользователь qhb, ядро QHB по умолчанию установится в каталог /usr/local/qhb. Многие утилиты QHB устанавливаются в каталог /usr/local/qhb/bin. Если этот каталог указать в переменной среды $PATH, это облегчит их запуск.

QHB для Fedora 36, 37, 38 и 39

Примечание
Обратите внимание, что команды должны выполняться от пользователя с правами суперпользователя.

Установить утилиту config-manager для управления конфигурацией репозиториев:

dnf install dnf-plugin-config-manager

Установите репозиторий программного продукта СУБД «Квант-Гибрид» командой:

rpm --import https://repo.quantom.info/qhb/keys/RPM-GPG-KEY-qhb

и далее, для Fedora 36:

Примечание
Для данной ОС могут быть проблемы с установкой СУБД «Квант-Гибрид» и его расширений из-за отсутствия доступных репозиториев. Поддержка данной ОС может быть исключена в следующем релизе.

dnf config-manager --add-repo https://repo.quantom.info/qhb/std-1/fedora/36/x86_64/qhb.repo

для Fedora 37:

Примечание
Для данной ОС могут быть проблемы с установкой СУБД «Квант-Гибрид» и его расширений из-за отсутствия доступных репозиториев. Поддержка данной ОС может быть исключена в следующем релизе.

dnf config-manager --add-repo https://repo.quantom.info/qhb/std-1/fedora/37/x86_64/qhb.repo

для Fedora 38:

dnf config-manager --add-repo https://repo.quantom.info/qhb/std-1/fedora/38/x86_64/qhb.repo

или для Fedora 39:

dnf config-manager --add-repo https://repo.quantom.info/qhb/std-1/fedora/39/x86_64/qhb.repo

Установите бинарные пакеты командой:

dnf install qhb-core [qhb-contrib] [qcp] [qdl] [qdlm] [qbackup] [metricsd] [qhb-serial] [qhb-license-bin] [...]

Например:

dnf install qhb-core

QHB для Debian 10 и Astra Linux Special Edition 1.7

Примечание
Обратите внимание, что команды должны выполняться от пользователя с правами суперпользователя.

Для подключения к репозиторию выполните следующую команду:

apt install gnupg2 apt-transport-https wget

Для корректной работы репозитория СУБД «Квант-Гибрид» в файле конфигурации репозиториев /etc/apt/sources.list должна быть добавлена запись

для Debian 10

deb [arch=amd64] https://repo.quantom.info/qhb/std-1/debian/10 stretch main

для Astra Linux Special Edition «Смоленск» 1.7

deb [arch=amd64] https://repo.quantom.info/qhb/std-1/astra-smolensk/1.7/  stretch main

Примечание
Обратите внимание, что для исключения из OS Astra Linux отозванных сертификатов безопасности следует выполнить очистку согласно инструкции по прекращению использования нежелательного сертификата.

Для Astra требуется установка корневых сертификатов. Установите их с помощью команды:

apt-get install ca-certificates

Установите репозиторий программного продукта СУБД «Квант-Гибрид» командой:

wget -qO - https://repo.quantom.info/qhb/keys/RPM-GPG-KEY-qhb --no-check-certificate | apt-key add -

Далее выполните команды:

для Debian 10

echo 'deb [arch=amd64] https://repo.quantom.info/qhb/std-1/debian/10 stretch main' >> /etc/apt/sources.list

для Astra Linux Special Edition «Смоленск» 1.7

echo 'deb [arch=amd64] https://repo.quantom.info/qhb/std-1/astra-smolensk/1.7/ stretch main' >> /etc/apt/sources.list

apt update

Примечание
В случае появления ошибки команды apt update репозитория QHB для Астры 1.7 Ошб:6 https://repo.quantom.info/qhb/std-1/debian stretch InRelease Следующие подписи не могут быть проверены, так как недоступен открытый ключ: NO_PUBKEY 67A97AD5112F6828 надо выполнить команду импорта ключа репозитория QHB для Астры 1.7 apt-key adv --keyserver https://repo.quantom.info/qhb/keys/RPM-GPG-KEY-qhb --recv-keys 67A97AD5112F6828

Установите бинарные пакеты командой:

apt install qhb-core [qhb-contrib] [qcp] [qdl] [qdlm] [qbackup] [metricsd] [qhb-serial] [qhb-license-bin] [...]

Например:

apt install qhb-core

QHB для Ubuntu 18.04 и 22.04

Примечание
Обратите внимание, что команды должны выполняться от пользователя с правами суперпользователя.

Для подключения к репозиторию выполните следующую команду:

apt install gnupg2 apt-transport-https wget

Для корректной работы репозитория СУБД «Квант-Гибрид» в файле конфигурации репозиториев /etc/apt/sources.list должна быть добавлена соответствующая запись.

для Ubuntu 18.04

echo 'deb https://repo.quantom.info/qhb/std-1/ubuntu/18 stretch main' >> /etc/apt/sources.list

для Ubuntu 22.04

echo 'deb https://repo.quantom.info/qhb/std-1/ubuntu/22 stretch main' >> /etc/apt/sources.list

Установите репозиторий программного продукта СУБД «Квант-Гибрид» командой:

wget -qO - https://repo.quantom.info/qhb/keys/RPM-GPG-KEY-qhb --no-check-certificate | apt-key add -

Далее выполните:

apt update

Установите бинарные пакеты командой:

apt install qhb-core [qhb-contrib] [qcp] [qdl] [qdlm] [qbackup] [metricsd] [qhb-serial] [qhb-license-bin] [...]

Например:

apt install qhb-core

QHB для openSUSE Leap 15.4

Примечание
Обратите внимание, что команды должны выполняться от пользователя с правами суперпользователя.

Установите репозиторий программного продукта СУБД «Квант-Гибрид» командами:

rpm --import https://repo.quantom.info/qhb/keys/RPM-GPG-KEY-qhb

zypper ar 'http://download.opensuse.org/distribution/leap/15.4/repo/oss/' openSuseMain
zypper --gpg-auto-import-keys addrepo -f https://repo.quantom.info/qhb/std-1/opensuse/15.4/x86_64 QHB-Repo

Для установки qhb-patroni и postgis требуются дополнительные репозитории:

zypper ar https://download.postgresql.org/pub/repos/zypp/repo/pgdg-sles-15-pg11.repo
zypper ar https://ftp.lysator.liu.se/pub/opensuse/repositories/science/openSUSE_Leap_15.3/ science15.3-x86_64
zypper ar https://ftp.lysator.liu.se/pub/opensuse/repositories/science/15.4/ science15.4-x86_64
zypper --releasever 15.5 --no-gpg-checks ref

Установку пакета qhb-patroni (и только qhb-patroni) необходимо выполнить командой с флагом:

zypper --releasever 15.5 -n install qhb-patroni

и далее:

zypper refresh

Установите бинарные пакеты командой:

zypper install qhb-core [qhb-contrib] [qcp] [qdl] [qdlm] [qbackup] [metricsd] [qhb-serial] [qhb-license-bin] [...]

Например:

zypper install qhb-core

QHB в виде docker контейнера

Предлагается конфигурация: сервер СУБД «Квант-Гибрид» с расширениями и пул соединений QCP.

Получение Dockerfile и конфигураций

Создайте локальный каталог и разверните в нем скрипты docker из репозитория СУБД «Квант-Гибрид»:

wget https://repo.quantom.info/qhb/std-1/docker/qhb-docker-image.tar.gz -O - | tar -xz

Создание образов

ВНИМАНИЕ!
Потребуется docker-compose. Здесь и далее запускать docker-compose следует из-под обычного пользователя (не root). Возможно, для этого понадобится выполнить рекомендации по настройке docker.

Как правило, не требуется вручную создавать образ, т. к. он автоматически создается при первом запуске. Однако это можно сделать и явным образом:

docker-compose build

Примечание
Если возникают проблемы с построением образа, связанные с недоступностью репозитория centos, нужно проверить сетевые разрешения. Иногда, перед построением, просто помогает выполнение следующих команд:
sudo firewall-cmd --zone=public --add-masquerade --permanent
sudo firewall-cmd --reload

Запуск контейнера

Для запуска контейнеров СУБД «Квант-Гибрид» и QCP с настройками по умолчанию выполните в текущем каталоге:

docker-compose up

Прервать выполнение можно с помощью Ctrl+C или же выполнив из другой консоли в текущем каталоге:

docker-compose down

Для запуска контейнеров в режиме «демона» выполните:

docker-compose up -d

При первом запуске база данных будет автоматически инициализирована.

Посмотреть записи журнала можно с помощью команды:

docker-compose logs

По умолчанию база данных сохраняется на диске в каталоге qhb/pgdata.

Остановка контейнеров

Если контейнеры были запущены посредством docker-compose up, то для остановки достаточно нажать Ctrl+C. Если же контейнеры были запущены в режиме «демона», т. е. посредством docker-compose up -d, то для их остановки выполните (из любой консоли) в текущем каталоге docker-compose down. Эту команду также можно выполнять и при остановленных контейнерах.

Настройка QCP

По умолчанию сервис QCP выключен. Для его запуска необходимо в файле docker-compose.yaml убрать (закомментировать) запись

entrypoint: ["echo", "Service qcp disabled"]

из раздела services: -> qcp:, а также настроить сервис, в частности, параметры подключения к серверу.

Настройка QCP осуществляется посредством редактирования файла ./qcp/config.yaml.

Обязательно замените в разделе servers:

%USER% — на имя пользователя, от имени которого запускается docker-compose
%DATABASE% — на имя базы данных; в простейшем случае база создается с именем, совпадающим с именем пользователя.

В дальнейшем, если вы создадите другую базу данных, возможно, этот параметр потребуется изменить. По умолчанию сервис QCP работает на порту 8080, при необходимости переопределите этот параметр. Обратите внимание, что настройки применяются только при запуске.

Отредактируйте файл docker-compose.yaml следующим образом:

В разделе services: -> qhb: -> volumes: замените

- ./qhb/pgdata:/qhb-data/

на

- /путь/до/pgdata:/qhb-data/

где /путь/до/pgdata — абсолютный путь до каталога базы данных с существующей базой данных.

В разделе services: -> qhb: -> environment: замените - USER на - USER=USERNAME.

Запустите контейнер с помощью команды

docker-compose -e USER="USERNAME" up

где USERNAME — имя пользователя, владеющего каталогом /путь/до/pgdata.

Пример отредактированного файла docker-compose.yaml:

version: "3.3"
services:
  qhb:
    build: qhb
    image: qhb
    network_mode: "host"
    environment:
      - USER=qhb
    volumes:
      - ./qhb/pgdata:/qhb-data/

  qcp:
    build: qcp
    image: qcp
    network_mode: "host"
    entrypoint: ["echo", "Service qcp disabled"]  # Закомментируйте эту строку, если будете использовать QCP
    volumes:
      - ./qcp/config.yaml:/config.yaml:ro

Обновление уже установленных пакетов

ВНИМАНИЕ!
Следует заметить, что при обновлении версии QHB необходимо позаботиться о миграции имеющихся баз данных, поскольку при смене версии может также меняться формат файлов базы данных. Обратитесь к разделу Установка с обновлением. О том, что в новой версии QHB происходит изменение формата файлов базы данных, можно узнать в разделе документации Замечания к релизу.

Если QHB уже установлена, ее обновления можно устанавливать с помощью пакетных менеджеров, имеющихся в ваших дистрибутивах операционных систем.

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

Как правило, для этого достаточно выполнить команду:

(на примере Fedora)

Примечание
Обратите внимание, что команды должны выполняться от пользователя с правами суперпользователя.

dnf update

В этом случае обновятся все пакеты.

Или с указанием конкретных пакетов:

dnf update qhb-core qhb-contrib qcp qdl qdlm qbackup metricsd qhb-serial qhb-license-bin

Иногда для обновления метаданных полезно обновить информацию о пакетах:

dnf clean all