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

Релиз: 2026.11

Последнее обновление: 7 ноября 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.11¶

В этом выпуске появились digna Data Reconciliation, digna Agentic с digna MCP Server, а также digna Engine, который может профилировать данные внутри digna и проверять ссылочную целостность между разными технологиями баз данных. Полные подробности см. в примечаниях к выпуску.

Для установки выпуск приносит новый механизм миграции репозитория, необязательный раздел [duckdb] в config.toml для digna Engine и новый файл лицензии. Каждое из этих изменений описано в разделе об обновлении.

Ищете 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.11-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]¶

Этот раздел настраивает совместное использование ресурсов между источниками (CORS) для dashboard и backend:

[app]
DIGNA_APP_CORS_ALLOW_ORIGINS = ["http://localhost:5173"]
DIGNA_APP_CORS_ALLOW_CREDENTIALS = true

Раздел [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!"
DIGNA_REPO_SSLMODE = "prefer"
DIGNA_REPO_NUM_CONNS = 16

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_SECURE = false
DIGNA_COOKIE_HTTPONLY = true
DIGNA_TOKEN_EXPIRES_IN = 86400
DIGNA_MAX_WORKERS = 4
DIGNA_FRONTEND_BASEURL = "http://localhost/"
DIGNA_SOURCE_QUERY_TIMEOUT_SEC = 3600
DIGNA_SOURCE_LOGIN_TIMEOUT_SEC = 30

Раздел [encryption]¶

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

[encryption]
DIGNA_ENCRYPTION_KEY = 'ycELf6IbcO55dYIZHpPv6kQv/bbnUXoIaHLh2bh1kMg='

Раздел [logging]¶

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

[logging]
DIGNA_LOGGING_MODE = "INFO"
DIGNA_LOGGING_DIR = "logs"
DIGNA_LOGGING_MAX_FILES = 30

Раздел [duckdb] (необязательный)¶

Новое в Release 2026.11. Этот раздел задаёт ресурсы digna Engine, который профилирует данные внутри digna для подключений к базам данных, местом профилирования которых является digna Engine, и выполняет проверки ссылочной целостности между источниками данных на разных подключениях к базам данных. См. Место профилирования.

Раздел необязателен. Без него действуют приведённые ниже значения по умолчанию.

[duckdb]
DIGNA_DUCKDB_MEMORY_LIMIT_MB = 1024
DIGNA_DUCKDB_TEMP_DIRECTORY = "/opt/digna/tmp"

sudo mkdir -p /opt/digna/tmp
sudo chown digna:digna /opt/digna/tmp

Шаг 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
 - Template overrides: OK
 - Unknown keys: OK

Overall: OK

Исправьте всё, о чём сообщено как FAILED, и выполните команду ещё раз, прежде чем продолжить. WARNING в пункте Unknown keys перечисляет ключи в config.toml, которые digna не считывает; они ни на что не влияют, поэтому удалите их или исправьте их написание. Полный список параметров приведён в справочнике CLI.

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

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

cd /opt/digna
./digna repo check

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

Error: No repo installed. Use the 'digna repo upgrade' command to install it.

На этом этапе это ожидаемый результат: он подтверждает, что digna достигает PostgreSQL и схемы. Ошибка подключения или аутентификации, напротив, указывает на раздел [repo] или на настройку PostgreSQL.

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

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

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

./digna repo upgrade

Эта команда устанавливает необходимые таблицы в схеме репозитория и завершается сообщением:

✅ Repo schema 'dignarepo' is up to date.

Шаг 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 сервера (по умолчанию 127.0.0.1) - --port — порт сервера (по умолчанию 8000)

Когда сервер запущен, он выводит адрес, который прослушивает:

Server running on http://127.0.0.1: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.

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

Этот раздел описывает обновление установки Release 2026.06 до Release 2026.11. Если ваша установка старше, сначала прочитайте раздел Обновление с выпуска старше 2026.06.

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

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

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

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

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

Запрос файла лицензии для Release 2026.11

Release 2026.11 требует нового license.toml. Запросите его у команды digna до начала обновления и держите его наготове для шага 7.

Обновление с выпуска старше 2026.06¶

Release 2026.06 принёс три изменения, которые по-прежнему действуют, когда вы обновляете более старую установку сразу до 2026.11:

• Только ODBC. digna обращается к каждой технологии-источнику через ODBC. Каждое подключение к базе данных, которое ещё не использует ODBC, после обновления нужно перевести на ODBC; автоматического преобразования нет. Заранее установите драйверы ODBC на хосте digna, см. Установка драйвера ODBC на узле digna, и подготовьте свойства каждого подключения по руководствам по технологиям. Коннектора Databricks Legacy больше нет; переведите такие подключения на коннектор Databricks.
• Один исполняемый файл. dignabackend и dignacli заменены одним исполняемым файлом digna, который объединяет серверную часть и CLI.
• config.toml. Раздел [encryption] обязателен, а DIGNA_APP_HOST и DIGNA_APP_PORT больше не считываются: адрес и порт сервер берёт из digna serve. Сравните свой файл с разделом Конфигурация backend.

Приведённые ниже шаги указывают, где более старой установке нужны другие действия. Обновление репозитория в шаге 8 переводит репозиторий любого прежнего выпуска сразу на 2026.11.

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

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

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

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

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

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

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

cd /opt/digna
sudo mv digna digna_old
sudo mv dashboard dashboard_old

Сохраняйте digna_old, пока не проверите обновление, а dashboard_old — пока не восстановите из неё свои файлы конфигурации (см. шаг 4). После этого оба можно удалить.

Шаг 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

Release 2026.11 не требует изменений в config.toml: файл, который работает с Release 2026.06, продолжает работать. Два изменения необязательны:

• Добавьте раздел [duckdb], если подключения к базам данных должны использовать digna Engine, а его значения по умолчанию не подходят для вашего хоста.
• Не указывайте раздел [app], если обратный прокси обслуживает dashboard и backend под одним origin.

[[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'

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

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

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

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

./digna config check

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

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

Файл лицензии обычно переходит из одного выпуска в следующий. Release 2026.11 — исключение: он добавляет два лицензируемых модуля, digna Data Reconciliation и digna Agentic, а лицензия, выданная до 2026.11, их не содержит. Скопируйте license.toml, предоставленный командой digna для Release 2026.11, в каталог установки, заменив старый:

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

./digna license check

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

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

cd /opt/digna
./digna repo upgrade

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

✅ Baseline migration recorded as applied.
✅ Repo schema 'dignarepo' is up to date.

Все существующие данные сохраняются. Чтобы в любой момент увидеть состояние репозитория, выполните ./digna repo check: команда показывает последнюю применённую миграцию и все ожидающие применения.

Error: Legacy repo version 3.0.2 installed. Use the 'digna repo upgrade' command to upgrade it.

Шаг 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 version
   

   Первая строка должна быть Release: 2026.11.

2. Откройте digna dashboard и убедитесь, что интерфейс загружается корректно.

3. Проверьте журналы сервера на наличие ошибок:

   sudo journalctl -u digna -n 100
   

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

Чтобы начать работу с новыми модулями, см. digna Data Reconciliation, Подключение ИИ-агента для digna MCP Server и Место профилирования для digna Engine.