Страница загрузки
Бинарные дистрибутивы для поддерживаемых платформ можно получить в репозитории QHB.
- QHB для CentOs 7 и 8
- QHB для Альт Сервер 9
- QHB для Fedora 32 и 33
- QHB для Debian 9 и Astra Linux Special Edition «Смоленск» 1.6
- QHB в виде docker контейнера
QHB для CentOs 7 и 8
Обратите внимание,
что команды должны выполняться от пользователя с правами суперпользователя.
Установите репозиторий QHB:
rpm --import https://repo.granit-concern.ru/qhb/keys/RPM-GPG-KEY-qhb
и далее, для CentOs 7:
yum-config-manager --add-repo https://repo.granit-concern.ru/qhb/std-1/centos/7/x86_64/qhb.repo
или для CentOs 8:
dnf config-manager --add-repo https://repo.granit-concern.ru/qhb/std-1/centos/8/x86_64/qhb.repo
Установите бинарные пакеты QHB (см. Состав поставки):
yum install qhb-core [ qhb-contrib ] [ qcp ] [ qdl ] [ qbackup ] [ metricsd ]
QHB для Альт Сервер 9
Обратите внимание,
что команды должны выполняться от пользователя с правами суперпользователя.
Для установки потребуется дополнительная библиотека libicu.
Скачайте библиотеку, подходит версия 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
Скачайте в эту же папку пакеты QHB, из репозитория командой:
wget -c -r -l1 -A '*.rpm' -nd -np https://repo.granit-concern.ru/qhb/std-1/centos/8/x86_64/
Обновите описания пакетов:
apt-get update
Находясь в этой же локальной папке, установите бинарные пакеты командой, например:
apt-get install *.rpm
Вы можете установить не все пакеты QHB, а только необходимые вам. В этом случае вы можете перечислить в команде нужные вам пакеты rpm через пробел. Выбирайте последние версии из rpm пакетов, которые скачались.
Библиотека libicu и пакет qhb-core - обязательны.
QHB для Fedora 32 и 33
Обратите внимание,
что команды должны выполняться от пользователя с правами суперпользователя.
Установите репозиторий QHB:
rpm --import https://repo.granit-concern.ru/qhb/keys/RPM-GPG-KEY-qhb
и далее, для Fedora 32:
dnf config-manager --add-repo https://repo.granit-concern.ru/qhb/std-1/fedora/32/x86_64/qhb.repo
для Fedora 33:
dnf config-manager --add-repo https://repo.granit-concern.ru/qhb/std-1/fedora/33/x86_64/qhb.repo
Установите бинарные пакеты QHB (см. Состав поставки):
yum install qhb-core [ qhb-contrib ] [ qcp ] [ qdl ] [ qbackup ] [ metricsd ]
QHB для Debian 9 и Astra Linux Special Edition «Смоленск» 1.6
Обратите внимание,
что команды должны выполняться от пользователя с правами суперпользователя.
Перед подключением к репозиторию выполните следующую команду:
apt install gnupg2 apt-transport-https wget
Замечание.
Для Astra требуется установка корневых сертификатов. Установите их с помощью команды:apt-get install ca-certificates
Установите репозиторий программного продукта QHB, командой:
wget -qO - https://repo.granit-concern.ru/qhb/keys/RPM-GPG-KEY-qhb | sudo apt-key add -
Далее выполните команды:
echo 'deb https://repo.granit-concern.ru/qhb/std-1/debian stretch main' >> /etc/apt/sources.list
и
apt update
Установите бинарные пакеты QHB (см. Состав поставки):
apt install qhb-core [ qhb-contrib ] [ qcp ] [ qdl ] [ qbackup ] [ metricsd ]
QHB в виде docker контейнера
Предлагается конфигурация: сервер QHB с расширениями и пул соединений QCP
Получение Dockerfile и конфигураций
Создайте локальный каталог и разверните в нём скрипты docker из репозитория QHB:
wget https://repo.granit-concern.ru/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
Запуск контейнера
Для запуска контейнеров QHB и 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 отключён.
Для его запуска необходимо убрать (закомментировать) запись
entrypoint: ["echo", "Service qcp disabled"]
из раздела services: -> qcp:
а также настроить сервис, в частности, параметры подключения к серверу
Настройка QCP осуществляется посредством редактирования файла ./qcp/config.yaml
.
Обязательно замените в разделе servers:
%USER%
- на имя пользователя, от имени которого запускается docker-compose
,
и
%DATABASE%
- на имя базы данных, в простейшем случае база создается с именем, совпадающим с именем пользователя.
В дальнейшем, если вы создадите другую базу данных, этот параметр может потребоваться изменить.
По умолчанию сервис QCP работает на порту 8080, при необходимости переопределите этот параметр.
Обратите внимание, что настройки применяются только при запуске.
Запуск docker контейнера QHB с существующей базой
Отредактируйте файл docker-compose.yaml
следующим образом:
-
В разделе
services: -> qhb: -> volumes:
замените
- ./qhb/pgdata:/qhb-data/
на
- /path/to/pgdata:/qhb-data/
,где
/path/to/pgdata
— абсолютный путь до каталога с существующей базой данных. -
В разделе
services: -> qhb: -> environment:
замените
- USER
на
- USER=USERNAME
,где
USERNAME
- имя пользователя, от которого будет стартовать сервер. Как правило, это пользовтаельqhb
. -
Запустите контейнер с помощью команды
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=pguser
volumes:
- /path/to/pgdata:/qhb-data/