Руководство по установке на Linux для digna Release 2026.06¶

Релиз: 2026.06

Последнее обновление: 5 сентября 2026

Содержание¶

1. Введение
2. Требования к системе
3. Подготовка к установке
4. Настройка PostgreSQL сервера
5. Настройка веб-сервера
6. Первоначальная установка
7. Конфигурация backend
8. Конфигурация Dashboard
9. Запуск digna как сервиса systemd
10. Обновление до новой версии

Введение¶

О digna¶

digna — это комплексная платформа на базе ИИ, разработанная для оптимизации управления качеством данных в различных средах, таких как хранилища данных (warehouses), озёра данных (lakes) и lakehouses. Платформа спроектирована для высокой масштабируемости и адаптируемости и решает современные задачи обработки данных с помощью автоматизации, мониторинга в реальном времени и обнаружения аномалий.

digna состоит из двух основных компонентов:

• digna: ядро приложения, отвечающее за обработку данных и выполнение проверок качества. Оно объединяет серверную часть и интерфейс командной строки в одном исполняемом файле, заменяя отдельные программы dignabackend и dignacli из прежних выпусков.
• dignadashboard: веб-интерфейс, размещаемый на веб-сервере, обеспечивающий удобный способ взаимодействия с платформой digna и визуализации метрик качества данных.

Что нового в Release 2026.06¶

В этом выпуске возможности наблюдаемости данных (data observability) интегрированы непосредственно в ваш код, что позволяет разработчикам отслеживать качество данных у источника. Полные подробности см. в примечаниях к выпуску.

Ищете Windows или macOS?¶

Это руководство охватывает Linux. Для других платформ см. руководство по установке на Windows или руководство по установке на macOS.

Какие дистрибутивы охватывает это руководство?¶

Инструкции написаны для двух наиболее распространённых семейств серверных дистрибутивов. Там, где они различаются, приводятся обе команды:

• Семейство Debian — Debian, Ubuntu. Менеджер пакетов: apt.
• Семейство RHEL — Red Hat Enterprise Linux, Rocky Linux, AlmaLinux, Fedora. Менеджер пакетов: dnf.

Подойдёт любой современный дистрибутив с systemd; меняются только имена пакетов и несколько путей к конфигурации.

Требования к системе¶

Перед началом установки убедитесь, что ваша система соответствует следующим минимальным требованиям:

Варианты установки базы данных¶

Если PostgreSQL уже установлен: Вы можете добавить новую базу данных для digna в ваш существующий сервер PostgreSQL.

Если вы устанавливаете PostgreSQL на той же машине, что и digna:

Как узнать дистрибутив и архитектуру¶

Некоторые команды в этом руководстве отличаются для семейств Debian и RHEL. Чтобы узнать, какое у вас семейство, выполните:

cat /etc/os-release
uname -m

• ID=ubuntu или ID=debian — используйте команды apt.
• ID=rhel, rocky, almalinux или fedora — используйте команды dnf.
• x86_64 или aarch64 — архитектура нужного вам установочного пакета.

Подготовка к установке¶

Перед установкой digna убедитесь, что выполнены два ключевых предварительных условия:

1. PostgreSQL Server – для хранения вычисляемых метрик и данных производительности
2. Веб-сервер – для размещения digna Dashboard

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

Обновление индекса пакетов¶

Перед установкой чего-либо обновите списки пакетов:

sudo apt update

sudo dnf check-update

Настройка PostgreSQL сервера¶

Если PostgreSQL уже установлен¶

Если PostgreSQL уже установлен и запущен на вашей локальной машине или вы используете управляемый удалённый сервер PostgreSQL, вы можете перейти к следующему разделу.

Установка PostgreSQL¶

Шаг 1: Установите пакет сервера¶

sudo apt install -y postgresql postgresql-contrib

sudo dnf install -y postgresql-server postgresql-contrib

Шаг 2: Инициализируйте кластер баз данных¶

В семействе Debian пакет создаёт и запускает кластер автоматически — перейдите к следующему шагу.

В семействе RHEL кластер нужно создать явно:

sudo postgresql-setup --initdb

Шаг 3: Запустите сервис и включите автозапуск¶

sudo systemctl enable --now postgresql

Эта команда запустит PostgreSQL немедленно и настроит его на автоматический запуск при загрузке системы.

Шаг 4: Проверьте установку¶

psql --version
sudo systemctl status postgresql

Вы должны увидеть версию PostgreSQL и сервис в состоянии active (running).

Шаг 5: Подключитесь к серверу¶

Пакет PostgreSQL для Linux создаёт системную учётную запись postgres, которой принадлежит кластер. Подключайтесь через неё:

sudo -u postgres psql

Шаг 6: Проверьте порт¶

Порт PostgreSQL по умолчанию — 5432. Чтобы подтвердить порт, на котором слушает сервер:

sudo -u postgres psql -c "SHOW port;"

Запомните значение — оно понадобится при настройке backend digna.

Шаг 7: Включите парольную аутентификацию для пользователя digna¶

digna подключается к PostgreSQL по TCP как digna_user, что требует парольной аутентификации, а не peer-аутентификации. Убедитесь, что ваш pg_hba.conf это разрешает.

Найдите файл:

sudo -u postgres psql -c "SHOW hba_file;"

Откройте его в редакторе и убедитесь, что в строках для локального TCP указан метод scram-sha-256 (или md5 на старых серверах), а не ident:

# TYPE  DATABASE  USER  ADDRESS         METHOD
host    all       all   127.0.0.1/32    scram-sha-256
host    all       all   ::1/128         scram-sha-256

После любого изменения перезагрузите конфигурацию PostgreSQL:

sudo systemctl reload postgresql

Шаг 8: Если PostgreSQL работает на другой машине¶

Чтобы принимать подключения с другого узла, задайте listen_addresses в postgresql.conf и добавьте соответствующую строку host для вашей сети в pg_hba.conf:

listen_addresses = '*'

Затем откройте порт в брандмауэре и перезапустите сервис:

sudo ufw allow 5432/tcp

sudo firewall-cmd --permanent --add-port=5432/tcp && sudo firewall-cmd --reload

sudo systemctl restart postgresql

Настройка веб-сервера¶

digna требует веб-сервера для размещения dashboard. Выберите один из следующих вариантов:

• nginx — лёгкий, рекомендуется
• Apache httpd — широко распространённая альтернатива

Требуется установить и настроить только один из этих серверов.

Оба раздела настраивают два требования, от которых зависит dashboard:

• Переадресация для single-page-приложения, чтобы обновление URL dashboard не приводило к 404
• MIME-тип для .md, чтобы Markdown-файлы отдавались корректно

Настройка nginx¶

Обзор¶

nginx — это лёгкий высокопроизводительный веб-сервер, хорошо подходящий для обслуживания статического dashboard digna.

Установка¶

sudo apt install -y nginx

sudo dnf install -y nginx

Запуск nginx¶

sudo systemctl enable --now nginx

Проверьте установку¶

1. Откройте браузер
2. Перейдите по адресу http://localhost
3. Вы должны увидеть страницу приветствия nginx

Открытие брандмауэра¶

Если к серверу обращаются с других машин, разрешите HTTP-трафик:

sudo ufw allow 'Nginx Full'

sudo firewall-cmd --permanent --add-service=http && sudo firewall-cmd --reload

Настройка сайта для dashboard¶

В обоих семействах дистрибутивов nginx подключает все файлы из своего каталога conf.d. Создайте там отдельный файл конфигурации для digna:

sudo nano /etc/nginx/conf.d/digna.conf

Вставьте следующее, заменив /opt/digna/dashboard на фактический путь к вашей распакованной папке dashboard:

server {
    listen       80 default_server;
    listen       [::]:80 default_server;
    server_name  _;

    root   /opt/digna/dashboard;
    index  index.html;

    # Serve Markdown files with the correct MIME type.
    types {
        text/markdown  md;
    }

    # Single-page-application fallback: unknown paths return index.html
    # instead of a 404, so dashboard routes survive a browser refresh.
    location / {
        try_files $uri $uri/ /index.html;
    }
}

Отключите сайт по умолчанию¶

Только один блок server может быть default_server для порта. В семействе Debian удалите сайт по умолчанию из пакета, чтобы он не конфликтовал:

sudo rm /etc/nginx/sites-enabled/default

В семействе RHEL закомментируйте или удалите блок server { ... } в файле /etc/nginx/nginx.conf.

Примените конфигурацию¶

Проверьте конфигурацию на синтаксические ошибки, затем перезагрузите nginx:

sudo nginx -t
sudo systemctl reload nginx

Настройка Apache httpd¶

Обзор¶

Apache httpd доступен в стандартных репозиториях всех поддерживаемых дистрибутивов. В семействе Debian пакет называется apache2, в семействе RHEL — httpd.

Установка¶

sudo apt install -y apache2

sudo dnf install -y httpd

Запуск Apache¶

sudo systemctl enable --now apache2

sudo systemctl enable --now httpd

Проверьте установку¶

1. Откройте браузер
2. Перейдите по адресу http://localhost
3. Вы должны увидеть стандартную страницу Apache вашего дистрибутива

Обязательно: включите mod_rewrite¶

Dashboard требует перенаправления URL.

В семействе Debian включите модуль и перезапустите сервер:

sudo a2enmod rewrite
sudo systemctl restart apache2

В семействе RHEL mod_rewrite загружается по умолчанию. Убедитесь в этом:

httpd -M | grep rewrite

Обязательно: разрешите переопределения в .htaccess¶

Откройте конфигурационный файл для вашего корневого каталога документов:

sudo nano /etc/apache2/apache2.conf

sudo nano /etc/httpd/conf/httpd.conf

Найдите блок <Directory>, относящийся к корневому каталогу документов (/var/www/html в обоих семействах), и измените:

AllowOverride None

на:

AllowOverride All

Обязательно: MIME-тип для файлов Markdown¶

В том же файле добавьте следующую строку, чтобы Markdown-файлы отдавались корректно:

AddType text/markdown .md

Примените конфигурацию¶

Проверьте конфигурацию на синтаксические ошибки, затем перезапустите Apache:

sudo apachectl configtest
sudo systemctl restart apache2

sudo apachectl configtest
sudo systemctl restart httpd

Первоначальная установка¶

Шаг 1: Настройка репозитория digna¶

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

Создание схемы репозитория и пользователя¶

Откройте ваш клиент PostgreSQL (psql, pgAdmin или аналогичный) и выполните следующие SQL-команды:

CREATE SCHEMA <digna_repo_schema>;

CREATE USER <digna_repo_user> WITH PASSWORD '<digna_repo_password>';

GRANT ALL PRIVILEGES ON SCHEMA <digna_repo_schema> TO <digna_repo_user>;

Замените следующие заполнители:

• <digna_repo_schema> — имя схемы по вашему выбору (например, dignarepo)
• <digna_repo_user> — имя пользователя по вашему выбору (например, digna_user)
• <digna_repo_password> — безопасный пароль для этого пользователя

Пример:

CREATE SCHEMA dignarepo;

CREATE USER digna_user WITH PASSWORD 'YourSecurePassword123!';

GRANT ALL PRIVILEGES ON SCHEMA dignarepo TO digna_user;

Чтобы выполнить эти команды из оболочки в один шаг:

sudo -u postgres psql

Затем вставьте команды в приглашении postgres=# и введите \q для выхода.

Шаг 2: Распакуйте установочный пакет digna¶

1. Найдите ZIP-файл установки digna, предоставленный вам
2. Распакуйте его в желаемое место установки — например /opt/digna
3. После распаковки вы должны увидеть следующие элементы:
4. dashboard/ — веб-интерфейс dashboard
5. digna — основной исполняемый файл (backend + CLI в одном)

Чтобы распаковать из оболочки:

sudo mkdir -p /opt/digna
sudo unzip digna-2026.06-linux-x86_64.zip -d /opt/digna

Сделайте файл исполняемым¶

В зависимости от способа передачи архива, бит выполнения (executable bit) может не сохраниться при распаковке. Установите его явно:

cd /opt/digna
sudo chmod +x digna

Создайте служебную учётную запись¶

Для производственных развёртываний рекомендуется запускать backend от имени отдельного непривилегированного пользователя:

sudo useradd --system --no-create-home --shell /usr/sbin/nologin digna
sudo chown -R digna:digna /opt/digna

Шаг 3: Установите файл лицензии¶

1. Найдите файл license.toml, предоставленный вам
2. Скопируйте его в корневой каталог установки digna (ту же папку, где находятся config.toml и исполняемый файл digna)

Почему это важно: Файл лицензии содержит информацию о заказчике, дату истечения лицензии и цифровую подпись. Не изменяйте этот файл — любые изменения сделают его недействительным.

Структура каталогов после настройки:

/opt/digna/
├── config.toml         (configuration file)
├── license.toml        (YOUR LICENSE FILE - copy here)
├── digna               (main executable)
├── bin/                (service management scripts)
└── dashboard/          (web interface)
    └── (dashboard files)

Конфигурация backend¶

Шаг 1: Создание и редактирование файла конфигурации¶

Файл config_template.toml предоставлен в каталоге установки digna. Вам нужно только переименовать его в config.toml.

cd /opt/digna
sudo mv config_template.toml config.toml

Расположение: /opt/digna/config.toml

Откройте config.toml в текстовом редакторе и настройте каждый раздел ниже.

Раздел [app]¶

Этот раздел настраивает параметры приложения digna backend:

[app]
digna_APP_CORS_ALLOW_ORIGINS = ["http://localhost:5173"]
digna_APP_CORS_ALLOW_CREDENTIALS = true
digna_APP_CORS_ALLOW_METHODS = ["*"]
digna_APP_CORS_ALLOW_HEADERS = ["*"]

Раздел [repo]¶

Этот раздел настраивает подключение к базе данных PostgreSQL:

[repo]
digna_REPO_HOST = "localhost"
digna_REPO_PORT = 5432
digna_REPO_DB = "postgres"
digna_REPO_SCHEMA = "dignarepo"
digna_REPO_USER = "digna_user"
digna_REPO_PASSWORD = "YourSecurePassword123!"

sudo chown digna:digna /opt/digna/config.toml
sudo chmod 600 /opt/digna/config.toml

Раздел [base]¶

Этот раздел содержит параметры безопасности и cookie:

[base]
DIGNA_FERNET_KEY = "DU4a0yJ-OqvbKCL4hNQn_CsknH-V1vWmHZqBUl-AY44="
digna_COOKIE_DOMAIN = "localhost"
digna_COOKIE_PATH = "/"
digna_COOKIE_SECURE = false
digna_COOKIE_HTTPONLY = true
digna_COOKIE_SAME_SITE = "lax"
digna_TOKEN_EXPIRES_IN = 86400
digna_MAX_WORKERS = 4
DIGNA_SCHEDULER_MAX_DELAY = 100
DIGNA_CLEANUP_TIME = "12:00"

Раздел [encryption]¶

Этот раздел содержит ключ, которым шифруются конфиденциальные значения, хранящиеся в репозитории. Он обязателен — config check сообщает о разделе [encryption] как FAILED, если ключ отсутствует.

[encryption]
DIGNA_ENCRYPTION_KEY = 'ycELf6IbcO55dYIZHpPv6kQv/bbnUXoIaHLh2bh1kMg='

Раздел [logging]¶

Этот раздел настраивает поведение логирования:

[logging]
digna_LOGGING_MODE = "INFO"
digna_LOGGING_BACKUP_COUNT = 10

Шаг 2: Проверьте конфигурацию¶

Перед инициализацией репозитория убедитесь, что config.toml полон и корректно построен. В каталоге установки digna выполните:

./digna config check

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

Configuration validation report (source: config.toml):
 - App config: OK
 - Repository config: OK
 - Base config: OK
 - Logging config: OK
 - Encryption config: OK
 - OIDC config(s): OK

Overall: OK

Исправьте всё, о чём сообщено как FAILED, и выполните команду ещё раз, прежде чем продолжить. Полный список параметров приведён в справочнике CLI.

Шаг 3: Инициализируйте репозиторий¶

1. Откройте терминал
2. Перейдите в каталог установки digna (где находятся config.toml и исполняемый файл digna)
3. Выполните проверку подключения:

cd /opt/digna
./digna repo check

Вы должны увидеть подтверждение установления соединения (сам репозиторий ещё не инициализирован).

sudo ln -s /opt/digna/digna /usr/local/bin/digna

Шаг 4: Установите схему репозитория¶

В том же каталоге выполните:

./digna repo install

Эта команда установит необходимые таблицы и схему в вашей базе данных PostgreSQL.

Шаг 5: Создайте пользователя с правами администратора¶

Пользователь-администратор создаётся непосредственно в схеме репозитория, поэтому сервер пока не обязательно запускать. В каталоге установки digna выполните:

./digna user add <email> <password> "<display_name>" --admin

Пример:

./digna user add admin@example.com 'AdminPassword123!' "Admin User" --admin

Это создаёт пользователя с адресом электронной почты admin@example.com и полными правами администратора.

Шаг 6: Запустите сервер digna¶

В каталоге установки digna запустите сервер:

./digna serve --address <host> --port <port>

Параметры: - --address — хостнейм/IP сервера - --port — порт сервера

Вы должны увидеть сообщения при запуске, подтверждающие, что сервер работает:

INFO:     Started server process [1234]
INFO:     Waiting for application startup.
INFO:     Application startup complete
INFO:     Uvicorn running on http://localhost:8082

sudo ufw allow 8082/tcp

sudo firewall-cmd --permanent --add-port=8082/tcp && sudo firewall-cmd --reload

Конфигурация Dashboard¶

Шаг 1: Разверните Dashboard на веб-сервере¶

Dashboard digna считывает собственную конфигурацию из файла dashboard/dashboard_config.toml. Этот файл не поставляется вместе с установкой — вы создаёте его в каталоге dashboard/ рядом с файлами dashboard.

Его содержимое описано в разделе Единый вход (SSO), где этот файл и требуется: в нём задаются варианты входа, которые предлагает dashboard, а для мульти-инстансных развёртываний — подключение к backend.

Выберите ваш веб-сервер и следуйте соответствующим шагам развертывания.

Развёртывание в nginx¶

Если вы следовали разделу Настройка nginx, блок server уже указывает на вашу папку dashboard и копирование не требуется.

1. Подтвердите путь
2. Откройте /etc/nginx/conf.d/digna.conf

3. Убедитесь, что root указывает на распакованную папку dashboard

4. Убедитесь, что папка доступна для чтения

   sudo chmod -R a+rX /opt/digna/dashboard
   

5. Перезагрузите nginx

   sudo nginx -t
   sudo systemctl reload nginx
   

6. Проверьте установку

7. Откройте браузер
8. Перейдите по адресу http://localhost (или по вашему настроенному URL)
9. Вы должны увидеть страницу входа в digna dashboard

Развёртывание в Apache httpd¶

1. Скопируйте Dashboard в корневой каталог документов

   sudo cp -R /opt/digna/dashboard /var/www/html/digna
   

2. Добавьте правила переписывания (Rewrite Rules)

Создайте файл .htaccess внутри развёрнутой папки, чтобы маршруты dashboard не ломались при обновлении страницы:

sudo nano /var/www/html/digna/.htaccess

Вставьте следующее:

RewriteEngine On
RewriteBase /digna/

# Serve existing files and directories as-is.
RewriteCond %{REQUEST_FILENAME} -f [OR]
RewriteCond %{REQUEST_FILENAME} -d
RewriteRule ^ - [L]

# Everything else falls back to the single-page application entry point.
RewriteRule ^ index.html [L]

1. Перезапустите Apache

   sudo systemctl restart apache2
   

   sudo systemctl restart httpd
   

2. Доступ к Dashboard

3. Откройте браузер
4. Перейдите по адресу http://localhost/digna
5. Вы должны увидеть страницу входа в digna dashboard

Шаг 2: SELinux (только семейство RHEL)¶

В RHEL, Rocky, AlmaLinux и Fedora SELinux по умолчанию работает в принудительном режиме (enforcing) и не позволяет веб-серверу читать файлы за пределами ожидаемых расположений. Проверьте, активен ли он:

getenforce

Если результат — Enforcing и вы обслуживаете dashboard из /opt/digna/dashboard, назначьте каталогу метку, чтобы веб-сервер мог его читать:

sudo semanage fcontext -a -t httpd_sys_content_t "/opt/digna/dashboard(/.*)?"
sudo restorecon -Rv /opt/digna/dashboard

Запуск digna как сервиса systemd¶

Зачем запускать digna как сервис?¶

Запуск backend digna как сервиса systemd гарантирует, что он:

• Автоматически запускается при загрузке машины
• Работает в фоновом режиме без открытого окна терминала
• Автоматически перезапускается при сбое
• Управляется через systemctl, стандартный менеджер сервисов Linux

Файлы управления сервисом¶

Все необходимые файлы находятся в каталоге установки digna в папке: bin/

Доступны следующие shell-скрипты:

• install_service.sh — регистрирует digna в systemd
• uninstall_service.sh — удаляет регистрацию сервиса
• start_service.sh — запускает зарегистрированный сервис
• stop_service.sh — останавливает запущенный сервис

Как сделать скрипты исполняемыми¶

При распаковке бит выполнения мог не сохраниться. Перед первым использованием:

cd /opt/digna/bin
sudo chmod +x *.sh

Установка сервиса¶

1. Откройте терминал

2. Перейдите в папку bin

   cd /opt/digna/bin
   

3. Запустите скрипт установки

   sudo ./install_service.sh
   

Сервер digna теперь зарегистрирован в systemd с включённым автоматическим запуском. Сервис не запускается сразу — см. следующий раздел для его запуска.

Запуск и остановка сервиса¶

Чтобы запустить сервис¶

1. Откройте терминал
2. Перейдите в /opt/digna/bin
3. Выполните:

   sudo ./start_service.sh
   

Чтобы остановить сервис¶

1. Откройте терминал
2. Перейдите в /opt/digna/bin
3. Выполните:

   sudo ./stop_service.sh
   

Управление сервисом с помощью systemctl¶

После регистрации сервисом также можно управлять стандартными командами systemd из любого каталога:

sudo systemctl start digna
sudo systemctl stop digna
sudo systemctl restart digna
sudo systemctl status digna

Проверка сервиса¶

Чтобы убедиться, что сервис зарегистрирован и запущен:

systemctl is-enabled digna
systemctl is-active digna

enabled означает, что сервис запускается при загрузке; active — что он работает сейчас.

Просмотр журналов сервиса¶

systemd перехватывает всё, что backend выводит в консоль. Чтобы прочитать эти записи:

sudo journalctl -u digna -n 100

Чтобы следить за журналом в реальном времени, воспроизводя проблему:

sudo journalctl -u digna -f

Перенос сервиса в новый каталог¶

Unit-файл хранит абсолютный путь к исполняемому файлу, поэтому при переносе установки требуется повторная регистрация сервиса:

1. Удалите текущий сервис

   cd /old/path/digna/bin
   sudo ./uninstall_service.sh
   

2. Переместите файлы приложения

   sudo mv /old/path/digna /new/path/digna
   

3. Переустановите сервис

   cd /new/path/digna/bin
   sudo ./install_service.sh
   

4. Запустите сервис

   sudo ./start_service.sh
   

Удаление сервиса¶

1. Остановите запущенный сервис

   cd /opt/digna/bin
   sudo ./stop_service.sh
   

2. Удалите сервис

   sudo ./uninstall_service.sh
   

Сервер digna теперь удалён из systemd.

Обновление до новой версии¶

Перед обновлением¶

Сначала проверьте все подключения к базам данных

Начиная с выпуска 2026.06 digna обращается к каждой исходной технологии через ODBC. Прежние выпуски предлагали выбор между отдельным драйвером для каждой технологии и ODBC, задаваемый переключателем Use ODBC. Команда digna решила опираться только на ODBC, потому что единый стандартный интерфейс даёт больше, чем набор драйверов, написанных под заказ:

• Аутентификация — аутентификация является частью ODBC, поэтому подключение может использовать всё, что поддерживает его драйвер: пароли, токены и PAT, Kerberos и Active Directory, MFA и единый вход через браузер, облачные удостоверения, клиентские сертификаты и TLS. Новые методы появляются вместе с обновлением драйвера, а не после ожидания выпуска digna.
• Драйверы, поддерживаемые производителями баз данных — собственный драйвер производителя отслеживает новые версии сервера и исправления безопасности, и вы можете обновлять его в своём темпе, независимо от digna.
• Единый способ настроить всё — каждая технология — это список свойств «ключ/значение» с одним и тем же интерфейсом, одинаковым шифрованием конфиденциальных значений и одинаковой диагностикой, вместо разного набора полей для каждого источника.
• Тонкая настройка и охват — параметры драйвера, такие как тайм-ауты, настройки TLS, прокси-серверы и размеры выборки, доступны для любого источника, а подключить можно любую технологию с совместимым драйвером ODBC, в том числе те, для которых digna не публикует отдельного руководства.

На практике это означает, что переключателя Use ODBC и отдельных полей узла, порта, базы данных, пользователя и пароля больше нет. Каждое подключение, ещё не использующее ODBC, должно быть переведено на ODBC — автоматического преобразования нет, поэтому спланируйте это до обновления:

1. Просмотрите каждое подключение к базе данных, определённое в вашей установке, и отметьте те, которые ещё не используют ODBC — каждое из них придётся настроить заново.
2. Установите соответствующий драйвер ODBC на узле digna — подключения открываются с сервера, на котором работает серверная часть digna, а не из браузера. См. Установка драйвера ODBC на узле digna.
3. Подготовьте свойства ODBC для каждого затронутого подключения. Руководства по технологиям приводят для каждого источника проверенный набор свойств.

После обновления переведите каждое затронутое подключение на ODBC и проверьте его из панели управления — см. Создание подключения к базе данных и Проверка подключения.

Создание резервной копии репозитория digna обязательно

Перед обновлением digna сделайте резервную копию вашего репозитория (PostgreSQL), чтобы защититься от потери данных. Резервная копия позволит восстановиться в случае непредвиденных проблем при обновлении.

Чтобы создать резервную копию из оболочки:

pg_dump -h localhost -p 5432 -U digna_user -n dignarepo postgres > digna_repo_backup.sql

Процесс обновления¶

Шаг 1: Остановите сервис digna¶

Если digna запущен как сервис systemd, сначала остановите его:

cd /opt/digna/bin
sudo ./stop_service.sh

Если digna запущен на переднем плане, нажмите Ctrl + C в окне терминала, где он работает.

Шаг 2: Резервное копирование текущей установки¶

В каталоге установки digna переименуйте папки текущей установки, чтобы новый выпуск можно было развернуть рядом с ними:

cd /opt/digna
sudo mv dignabackend dignabackend_old

sudo mv dignacli dignacli_old

sudo mv dashboard dashboard_old

Шаг 3: Распакуйте и разверните новую версию¶

1. Распакуйте новый ZIP-файл установки digna
2. Скопируйте новый исполняемый файл digna и папку dashboard в каталог установки
3. Восстановите бит выполнения и владельца — служебную учётную запись:

sudo chmod +x /opt/digna/digna
sudo chown -R digna:digna /opt/digna

Шаг 4: Восстановите файлы конфигурации¶

sudo cp dashboard_old/dashboard_config.toml dashboard/dashboard_config.toml

[base]
DIGNA_SCHEDULER_MAX_DELAY = 100
DIGNA_CLEANUP_TIME = "12:00"

[encryption]
DIGNA_ENCRYPTION_KEY = 'ycELf6IbcO55dYIZHpPv6kQv/bbnUXoIaHLh2bh1kMg='

[[oidc_clients]]
DIGNA_OIDC_KEY = 'microsoft'
DIGNA_OIDC_CLIENT_ID = '<client_id>'
DIGNA_OIDC_CLIENT_SECRET = '<client_secret>'
DIGNA_OIDC_REDIRECT_URI = 'http://localhost:3000/oidc/callback'
DIGNA_OIDC_CONFIGURATION_URL = 'https://login.microsoftonline.com/<tenant_id>/v2.0/.well-known/openid-configuration'

[oidc_clients.microsoft]
DIGNA_OIDC_CLIENT_ID = '<client_id>'
DIGNA_OIDC_CLIENT_SECRET = '<client_secret>'
DIGNA_OIDC_REDIRECT_URI = 'http://localhost:3000/oidc/callback'
DIGNA_OIDC_CONFIGURATION_URL = 'https://login.microsoftonline.com/<tenant_id>/v2.0/.well-known/openid-configuration'

Шаг 5: Перезагрузите веб-сервер¶

Dashboard — это набор статических файлов, поэтому ваш веб-сервер, а также браузер, могут по-прежнему отдавать предыдущую версию. Перезагрузите или перезапустите веб-сервер, на котором размещена папка dashboard, затем обновите страницу с полной перезагрузкой (Ctrl+F5).

Шаг 6: Проверьте конфигурацию¶

Прежде чем трогать репозиторий, убедитесь, что обновлённый config.toml полон:

./digna config check

Каждый раздел должен сообщить OK. Исправьте всё, о чём сообщено как FAILED, и выполните команду ещё раз, прежде чем продолжить.

Шаг 7: Замените файл лицензии¶

Каждый выпуск лицензируется отдельно. Скопируйте license.toml, предоставленный командой digna для этого выпуска, в каталог установки, заменив старый:

sudo cp /path/to/new/license.toml /opt/digna/license.toml

./digna license check

Шаг 8: Обновите схему репозитория¶

Перейдите в каталог установки digna и выполните:

cd /opt/digna
./digna repo upgrade

Это обновит схему PostgreSQL до последней версии, сохранив все существующие данные.

Шаг 9: Перезапустите сервисы¶

Если вы используете сервис systemd:

cd /opt/digna/bin
sudo ./start_service.sh

Если запускаете вручную, перезапустите сервер:

cd /opt/digna
./digna serve --address <address> --port <port>

Если используется nginx или Apache, перезагрузите соответствующий веб-сервер:

sudo systemctl reload nginx

sudo systemctl restart apache2

В семействе RHEL повторно примените метки SELinux, если каталог dashboard был заменён:

sudo restorecon -Rv /opt/digna/dashboard

Шаг 10: Проверьте корректность обновления¶

1. Откройте интерфейс digna dashboard
2. Убедитесь, что интерфейс загружается корректно
3. Проверьте журналы сервера на наличие ошибок
4. Переведите на ODBC каждое подключение, которое его ещё не использовало, затем проверьте все подключения — см. Проверка подключения:

sudo journalctl -u digna -n 100