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

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

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 для 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-1.1.0.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 следующим образом:

  1. В разделе services: -> qhb: -> volumes:

    замените - ./qhb/pgdata:/qhb-data/

    на - /path/to/pgdata:/qhb-data/,

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

  2. В разделе services: -> qhb: -> environment:

    замените - USER

    на - USER=USERNAME,

    где USERNAME - имя пользователя, от которого будет стартовать сервер. Как правило, это пользовтаель qhb.

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

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/