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

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

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 будет создан пользователь qhb. Ядро QHB, по умолчанию, установится в каталог /usr/local/qhb.

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

QHB для ROSA Enterprise Linux Server (RELS) 7

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

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

dnf install dnf-plugin-config-manager

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

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

и далее:

dnf config-manager --add-repo https://repo.quantom.info/qhb/std-1/rosa/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 будет создан пользователь qhb. Ядро QHB, по умолчанию, установится в каталог /usr/local/qhb.

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

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

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

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

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

QHB для Fedora 33, 34 и 35

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

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

dnf install dnf-plugin-config-manager

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

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

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

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

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

для Fedora 34:

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

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

или для Fedora 35:

dnf config-manager --add-repo https://repo.quantom.info/qhb/std-1/fedora/35/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 будет создан пользователь qhb. Ядро QHB, по умолчанию, установится в каталог /usr/local/qhb.

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

QHB для Debian 9, 10 и Astra Linux Special Edition «Смоленск» 1.6, 1.7

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

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

apt install gnupg2 apt-transport-https wget

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

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

  • для Debian 9
deb [arch=amd64] https://repo.quantom.info/qhb/std-1/debian/9 stretch main
  • для Debian 10
deb [arch=amd64] https://repo.quantom.info/qhb/std-1/debian/10 stretch main
  • для Astra Linux Special Edition «Смоленск» 1.6, 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 9
echo 'deb [arch=amd64] https://repo.quantom.info/qhb/std-1/debian/9 stretch main' >> /etc/apt/sources.list
  • для 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.6, 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 будет создан пользователь qhb. Ядро QHB, по умолчанию, установится в каталог /usr/local/qhb.

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

QHB для Ubuntu 18.04 и 22.04

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

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

apt install gnupg2 apt-transport-https wget

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

  • для Ubuntu 18.04
ubuntu  [arch=amd64] https://repo.quantom.info/qhb/std-1/ubuntu/18/ stretch main
  • для Ubuntu 22.04
ubuntu  [arch=amd64] https://repo.quantom.info/qhb/std-1/ubuntu/22/ stretch main

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

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

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

  • для Ubuntu 18.04
echo 'ubuntu https://repo.quantom.info/qhb/std-1/ubuntu/18 stretch main' >> /etc/apt/sources.list
  • для Ubuntu 22.04
echo 'ubuntu https://repo.quantom.info/qhb/std-1/ubuntu/22 stretch main' >> /etc/apt/sources.list

и

apt update

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

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

Например:

apt install qhb-core

В результате установки пакета ядра QHB будет создан пользователь qhb. Ядро QHB, по умолчанию, установится в каталог /usr/local/qhb.

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

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-pg14.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 refresh

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

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

Например:

zypper install qhb-core

В результате установки пакета ядра QHB будет создан пользователь qhb. Ядро QHB, по умолчанию, установится в каталог /usr/local/qhb.

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

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/

на

- /path/to/pgdata:/qhb-data/

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

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

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

docker-compose -e USER="USERNAME" up

где USERNAME — имя пользователя, владеющего каталогом /path/to/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"]  # Comment this line if will use 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

Copyright © KVANTOM LLC, 2019-2023