Перейти до змісту

Посібник зі встановлення digna Release 2026.06 на Windows

Випуск: 2026.06

Останнє оновлення: 30 серпня 2026 р.


Зміст

  1. Вступ
  2. Системні вимоги
  3. Підготовка до встановлення
  4. Налаштування сервера PostgreSQL
  5. Налаштування веб‑сервера
  6. Початкове встановлення
  7. Налаштування серверної частини
  8. Налаштування панелі
  9. Запуск digna як служби Windows
  10. Оновлення до нового випуску

Вступ

Про digna

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

digna складається з двох основних компонентів:

  • digna: ядро застосунку, відповідальне за обробку даних і виконання перевірок якості. Воно поєднує серверну частину та інтерфейс командного рядка в одному виконуваному файлі, замінюючи окремі програми dignabackend і dignacli з попередніх випусків.
  • dignadashboard: веб‑інтерфейс, розміщений на веб‑сервері, що забезпечує зручний спосіб взаємодії з платформою digna та візуалізації метрик якості даних.

Що нового в Release 2026.06

Цей випуск вбудовує можливості спостереження за даними безпосередньо у ваш код, що дає змогу розробникам контролювати якість даних на джерелі. Повні відомості див. у примітках до випуску.

Шукаєте macOS або Linux?

Цей посібник охоплює Windows. Для інших платформ див. Посібник зі встановлення на macOS або Посібник зі встановлення на Linux.


Системні вимоги

Перш ніж почати встановлення, переконайтеся, що ваша система відповідає таким мінімальним вимогам:

Вимога Специфікація
Операційна система Windows Server або Windows 10/11
Пам'ять (мінімальна конфігурація) 16 GB RAM
Дисковий простір 10 GB вільного місця
База даних PostgreSQL Server 12 або новіший
Веб‑сервер IIS, Apache Tomcat або аналог

Варіанти встановлення бази даних

Якщо PostgreSQL уже встановлено: Ви можете додати нову базу даних для digna до наявного сервера PostgreSQL.

Якщо PostgreSQL встановлюється на тій самій машині, що й digna:

Рекомендовані характеристики

  • Пам'ять: 32 GB RAM (замість 16 GB)
  • Дисковий простір: 50 GB вільного місця (замість 10 GB)

Ці підвищені характеристики розраховані на одночасну роботу digna та бази даних PostgreSQL.


Підготовка до встановлення

Перед встановленням digna переконайтеся, що наявні дві ключові передумови:

  1. Сервер PostgreSQL – для зберігання обчислених метрик і даних про продуктивність
  2. Веб‑сервер – для розміщення панелі digna (digna Dashboard)

Якщо ці компоненти ще не налаштовано, скористайтеся наведеними нижче розділами, щоб установити та налаштувати їх.


Налаштування сервера PostgreSQL

Якщо у вас уже є PostgreSQL

Якщо PostgreSQL уже встановлено й запущено на вашій локальній машині або ви використовуєте керований віддалений сервер PostgreSQL, можете перейти до наступного розділу.

Встановлення PostgreSQL

Виконайте такі кроки, щоб установити PostgreSQL на Windows:

Крок 1: Завантажте PostgreSQL

  1. Перейдіть на сторінку завантажень PostgreSQL
  2. Виберіть Windows
  3. Завантажте найновіший інсталятор

Крок 2: Запустіть інсталятор

  1. Двічі клацніть завантажений файл інсталятора
  2. Дотримуйтеся підказок майстра встановлення

Крок 3: Виберіть каталог встановлення

Виберіть каталог, у який буде встановлено PostgreSQL. Розташування за замовчуванням зазвичай підходить.

Крок 4: Виберіть компоненти

Для стандартного налаштування залиште вибраними компоненти за замовчуванням.

Крок 5: Задайте пароль суперкористувача PostgreSQL

Введіть і підтвердьте пароль суперкористувача PostgreSQL (postgres). Надійно збережіть цей пароль — він знадобиться вам пізніше.

Крок 6: Налаштуйте номер порту

Стандартний порт PostgreSQL — 5432. Можете використати значення за замовчуванням або за потреби вказати інший порт.

Порада

Якщо порт 5432 уже зайнятий, виберіть інший порт і запишіть його для подальшого налаштування.

Крок 7: Виберіть локаль

Виберіть локаль для вашої бази даних. Значення за замовчуванням зазвичай підходить для більшості встановлень.

Крок 8: Завершіть встановлення

Натискайте Next на решті кроків, а потім натисніть Finish.

Крок 9: Перевірте встановлення

Відкрийте Command Prompt і перевірте, що PostgreSQL встановлено:

psql --version

Якщо встановлення пройшло успішно, ви побачите версію PostgreSQL.


Налаштування веб‑сервера

digna потребує веб‑сервера для розміщення панелі. Виберіть один із таких варіантів:

Потрібно встановити й налаштувати лише один із цих серверів.

Налаштування IIS

Огляд

Internet Information Services (IIS) — веб‑сервер Microsoft для розміщення вебсайтів і веб‑застосунків.

Увімкнення IIS

  1. Відкрийте Control Panel
  2. Натисніть Win + R
  3. Введіть control і натисніть Enter

  4. Перейдіть до компонентів Windows

  5. Клацніть Programs
  6. Виберіть Turn Windows features on or off

  7. Увімкніть Internet Information Services

  8. Прокрутіть униз і знайдіть Internet Information Services (IIS)
  9. Позначте прапорець, щоб увімкнути його
  10. Клацніть +, щоб розгорнути список, і переконайтеся, що вибрано такі підкомпоненти:

    • Web Management Tools
    • World Wide Web Services
  11. Натисніть OK, щоб застосувати зміни

  12. Перевірте встановлення IIS

  13. Відкрийте браузер
  14. Перейдіть за адресою http://localhost
  15. Ви повинні побачити сторінку привітання IIS

Обов'язково: модуль URL Rewrite

IIS потребує компонента URL Rewrite. Завантажте та встановіть його з офіційної сторінки Microsoft.

Обов'язково: тип MIME для файлів Markdown

Щоб IIS коректно віддавав файли Markdown (.md):

  1. Відкрийте IIS Manager (натисніть Win + R, введіть inetmgr, натисніть Enter)
  2. Перейдіть до Your Site > MIME Types
  3. Натисніть Add...
  4. Налаштуйте:
  5. File name extension: .md
  6. MIME type: text/markdown

Важливо

Без цього налаштування файли .md можуть віддаватися некоректно.


Налаштування Apache Tomcat

Огляд

Apache Tomcat — контейнер Java‑сервлетів і веб‑сервер із відкритим кодом.

Встановлення

  1. Завантажте Apache Tomcat
  2. Перейдіть на сторінку Apache Tomcat Downloads
  3. Завантажте ZIP‑дистрибутив для Windows

  4. Розпакуйте архів

  5. Розпакуйте ZIP‑файл у каталог на вашій системі
  6. Наприклад: C:\Program Files\Apache Tomcat

  7. Перевірте, що Tomcat працює

  8. Відкрийте браузер
  9. Перейдіть за адресою http://localhost:8080
  10. Ви повинні побачити сторінку привітання Apache Tomcat

Порада

Зазвичай Apache Tomcat запускається автоматично після встановлення. Якщо цього не сталося, перейдіть до теки bin і запустіть startup.bat.


Початкове встановлення

Крок 1: Налаштуйте репозиторій digna

Репозиторій digna зберігає всі метрики, обчислені digna. Він слугує центральною базою даних для аналітичних даних і даних про продуктивність.

Створіть схему репозиторію та користувача

Відкрийте свій клієнт PostgreSQL (pgAdmin, psql або подібний) і виконайте такі 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;

Найкраща практика

Використовуйте надійні, складні паролі для користувачів бази даних. Уникайте облікових даних, які легко вгадати.


Крок 2: Розпакуйте інсталяційний пакет digna

  1. Знайдіть наданий вам ZIP‑файл інсталяції digna
  2. Розпакуйте його в бажане місце встановлення
  3. Після розпакування ви побачите такі елементи:
  4. dashboard/ — веб‑інтерфейс панелі
  5. digna — основний виконуваний файл (серверна частина та CLI разом)

Файли конфігурації та ліцензії не входять до пакета

Ні config.toml, ні dashboard/dashboard_config.toml не постачаються разом зі встановленням — ви створюєте обидва файли самостійно, у розділах Налаштування серверної частини і Налаштування панелі. license.toml також не постачається; digna надає його окремо, як описано в кроці 3.

Крок 3: Встановіть файл ліцензії

Важливо

Файл ліцензії не входить до інсталяційного пакета й надається digna окремо.

  1. Знайдіть наданий вам файл license.toml
  2. Скопіюйте його в кореневий каталог встановлення digna (там, де розташовані config.toml і виконуваний файл digna)

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

Структура каталогу після налаштування:

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

Налаштування серверної частини

Крок 1: Створіть і відредагуйте файл конфігурації

Файл config_template.toml постачається у вашому каталозі встановлення digna. Потрібно лише перейменувати його на config.toml.

Розташування: digna_installation/config.toml

Відкрийте config.toml у текстовому редакторі й налаштуйте кожен із наведених нижче розділів.

Розділ [app]

Цей розділ налаштовує параметри серверного застосунку digna:

[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 = ["*"]
Параметр Значення Примітки
digna_APP_CORS_ALLOW_ORIGINS URL frontend Якщо панель розміщено на іншому сервері, додайте її URL
digna_APP_CORS_ALLOW_CREDENTIALS true Потрібно для CORS з обліковими даними
digna_APP_CORS_ALLOW_METHODS ["*"] Дозволити всі методи HTTP
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!"
Параметр Значення Примітки
digna_REPO_HOST localhost або IP Ім'я хоста / IP сервера PostgreSQL
digna_REPO_PORT 5432 (за замовчуванням) Порт PostgreSQL
digna_REPO_DB postgres Назва бази даних
digna_REPO_SCHEMA dignarepo Схема, створена раніше
digna_REPO_USER digna_user Користувач, створений під час налаштування PostgreSQL
digna_REPO_PASSWORD Ваш пароль Пароль, заданий під час створення схеми

Розділ [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"
Параметр Значення Примітки
DIGNA_FERNET_KEY Ключ шифрування Використовується для шифрування токенів і cookie (можливий ключ за замовчуванням)
digna_COOKIE_DOMAIN localhost Має відповідати домену frontend
digna_COOKIE_SECURE false (локально) / true (production) Використовуйте true для з'єднань HTTPS
digna_COOKIE_HTTPONLY true Завжди ввімкнено з міркувань безпеки
digna_COOKIE_SAME_SITE lax Запобігає атакам CSRF
digna_TOKEN_EXPIRES_IN 86400 (24 години) Тайм‑аут сесії в секундах
digna_MAX_WORKERS Кількість ядер CPU - 1 Кількість паралельних завдань інспекції
DIGNA_SCHEDULER_MAX_DELAY 100 Максимальна затримка в секундах, яку планувальник може додати перед запуском завдання, термін якого настав
DIGNA_CLEANUP_TIME "12:00" Час доби (24-годинний формат HH:MM), коли починається щоденне очищення

Розділ [encryption]

Цей розділ містить ключ, яким шифруються конфіденційні значення, що зберігаються в репозиторії. Він обов'язковий — config check повідомляє про розділ [encryption] як FAILED, якщо ключа немає.

[encryption]
DIGNA_ENCRYPTION_KEY = 'ycELf6IbcO55dYIZHpPv6kQv/bbnUXoIaHLh2bh1kMg='
Параметр Значення Примітки
DIGNA_ENCRYPTION_KEY Ключ у кодуванні Base64 Шифрує конфіденційні значення, що зберігаються в репозиторії digna

Захистіть config.toml

Цей ключ — фіксоване значення, однакове в усіх установленнях digna, і саме він розшифровує конфіденційні значення у вашому репозиторії. Обмежте доступ до config.toml обліковим записом, під яким працює digna, тримайте файл поза системою контролю версій і спільними дисками та виключіть його з будь-якої резервної копії, що зберігається менш захищено, ніж сам репозиторій.

Розділ [logging]

Цей розділ налаштовує поведінку журналювання:

[logging]
digna_LOGGING_MODE = "INFO"
digna_LOGGING_BACKUP_COUNT = 10
Параметр Значення Примітки
digna_LOGGING_MODE INFO або DEBUG INFO — для production, DEBUG — для усунення несправностей
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. Відкрийте Command Prompt
  2. Перейдіть до каталогу встановлення digna (там, де розташовані config.toml і виконуваний файл digna)
  3. Запустіть перевірку підключення:
digna repo check

Ви повинні побачити підтвердження, що з'єднання встановлено (сам репозиторій ще не ініціалізовано).

Крок 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

Це створює користувача з повними адміністративними правами.

Найкраща практика

Використовуйте надійний пароль, що поєднує великі й малі літери, цифри та спеціальні символи.

Крок 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

Сервер займає термінал

serve виконується на передньому плані й працює, доки ви не зупините його комбінацією Ctrl+C. Залиште його працювати, доки завершуєте налаштування; щоб натомість запускати його автоматично під час завантаження системи, див. Запуск digna як служби Windows.


Налаштування панелі

Крок 1: Розгорніть панель на веб‑сервері

Панель digna зчитує власну конфігурацію з dashboard/dashboard_config.toml. Цей файл не постачається разом зі встановленням — ви створюєте його в каталозі dashboard/ поруч із файлами панелі.

Його вміст описано в розділі Single Sign-On, і саме там цей файл і потрібен: він містить варіанти входу, які пропонує панель, а для розгортань із кількома екземплярами — підключення до серверної частини.

Виберіть свій веб‑сервер і виконайте відповідні кроки розгортання.

Розгортання в IIS

  1. Відкрийте IIS Manager
  2. Натисніть Win + R, введіть inetmgr, натисніть Enter

  3. Створіть новий вебсайт

  4. На лівій панелі клацніть правою кнопкою миші Sites
  5. Виберіть Add Website...

  6. Налаштуйте вебсайт

  7. Site Name: введіть назву (наприклад, "dignaDashboard")
  8. Physical Path: натисніть Browse і виберіть теку dashboard
  9. Binding: задайте IP‑адресу та порт (за замовчуванням порт 80 для HTTP, 443 для HTTPS)

  10. Запустіть вебсайт

  11. Натисніть OK, щоб створити сайт
  12. Клацніть правою кнопкою миші новий сайт і виберіть Start

  13. Перевірте встановлення

  14. Відкрийте браузер
  15. Перейдіть за адресою http://localhost (або за налаштованим вами URL)
  16. Ви повинні побачити сторінку входу панелі digna

Розгортання в Apache Tomcat

  1. Скопіюйте панель до Tomcat
  2. Скопіюйте теку dashboard до каталогу webapps вашого Tomcat
  3. За потреби перейменуйте її (наприклад, на digna)
  4. Приклад: C:\Program Files\Apache Tomcat\webapps\digna

  5. Перевірте розгортання

  6. Оновіть або перезавантажте сторінку керування Tomcat (http://localhost:8080)
  7. Ви повинні побачити "digna" (або вибрану вами назву) у списку розгорнутих застосунків

  8. Відкрийте панель

  9. Відкрийте браузер
  10. Перейдіть за адресою http://localhost:8080/digna
  11. Ви повинні побачити сторінку входу панелі digna

Запуск digna як служби Windows

Навіщо використовувати службу Windows?

Запуск серверної частини digna як служби Windows гарантує, що вона: - Автоматично запускається під час завантаження сервера - Працює у фоновому режимі без відкритого Command Prompt - Автоматично перезапускається в разі збою - Керується через Windows Services

Команди windows

Службою керує сам виконуваний файл digna за допомогою підкоманд digna windows. Жодних пакетних файлів запускати не потрібно.

Команда Призначення
digna windows install Реєструє digna як службу Windows
digna windows start Запускає зареєстровану службу
digna windows stop Зупиняє запущену службу
digna windows uninstall Скасовує реєстрацію служби

Потрібні права адміністратора

Усі чотири команди потрібно запускати з Command Prompt, відкритого від імені адміністратора.

Кожна команда приймає --name, щоб звернутися до служби, зареєстрованої під нестандартною назвою. Повний перелік параметрів наведено в довіднику CLI.

Встановлення служби

  1. Відкрийте Command Prompt від імені адміністратора
  2. Клацніть правою кнопкою миші Command Prompt
  3. Виберіть "Run as Administrator"

  4. Перейдіть до каталогу встановлення digna

    cd C:\path\to\digna
    

  5. Зареєструйте службу

    digna windows install
    

Вкажіть адресу й порт, якщо значення за замовчуванням вам не підходять

install записує адресу й порт у реєстрацію служби, і служба прив'язується саме до записаних значень. За замовчуванням це 127.0.0.1 і 8000, які приймають з'єднання лише з самої машини. Панель на іншому хості не зможе до них достукатися, тож укажіть адресу, яку має прослуховувати серверна частина:

digna windows install --address 0.0.0.0 --port 8082

Ці значення не зчитуються з config.toml. Щоб змінити їх згодом, видаліть службу й установіть її знову з новими значеннями.

Службу зареєстровано з автоматичним запуском, тож вона запускатиметься разом із Windows. Одразу вона не запускається — див. наступний розділ.

Параметри встановлення

Параметр За замовчуванням Призначення
--name digna Назва, під якою реєструється служба
--display-name digna Назва, що відображається в services.msc
--description digna data quality backend Опис, що відображається в services.msc
--address 127.0.0.1 Адреса, до якої служба прив'язує свій API
--port 8000 Порт, до якого служба прив'язує свій API
--working-dir каталог виконуваного файлу digna Каталог із config.toml і license.toml, який служба робить своїм робочим каталогом
--start-type auto auto — запуск разом із Windows, manual — запуск лише на запит, disabled — служба реєструється, але її запуск заборонено
--account LocalSystem Обліковий запис, від імені якого працює служба, наприклад DOMAIN\user або .\user
--password Пароль облікового запису --account

Запуск від імені облікового запису домену

LocalSystem не має мережевої ідентичності, тож автентифікація Windows у SQL Server і будь-який доступ до мережевого ресурсу не спрацюють. Установлюйте службу з --account і --password, якщо їй потрібен доступ до ресурсів від імені певного користувача.

Запуск і зупинка служби

Щоб запустити службу

digna windows start

Щоб зупинити службу

digna windows stop

Порада

Завжди зупиняйте службу перед оновленням файлів застосунку.

Перенесення служби до нового каталогу

Якщо потрібно перенести встановлення digna:

  1. Зупиніть поточну службу та скасуйте її реєстрацію

    cd C:\old\path\digna
    digna windows stop
    digna windows uninstall
    

  2. Перемістіть файли застосунку

  3. Перемістіть усю теку встановлення digna в нове розташування

  4. Знову зареєструйте службу з нового розташування

    cd C:\new\path\digna
    digna windows install
    

Повторіть усі значення --address, --port або --account, які ви використали першого разу — попередньої реєстрації більше немає.

  1. Запустіть службу
    digna windows start
    

Видалення служби

  1. Зупиніть запущену службу

    cd C:\path\to\digna
    digna windows stop
    

  2. Скасуйте реєстрацію служби

    digna windows uninstall
    

Реєстрацію сервера digna як служби Windows скасовано.


Оновлення до нового випуску

Перед оновленням

Спершу перевірте всі підключення до баз даних

Починаючи з Release 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 і перевірте його з панелі — див. Створення підключення до бази даних та Перевірка підключення.

Підключення Databricks Legacy

Конектор Databricks Legacy вилучено в цьому випуску. Переведіть такі підключення на конектор Databricks.

Створення резервної копії репозиторію digna обов'язкове

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

Процес оновлення

Крок 1: Зупиніть стару службу та скасуйте її реєстрацію

Якщо digna працює як служба Windows, зупиніть її за допомогою пакетних файлів вашого поточного встановлення — команди digna windows належать новому випуску й поки що недоступні:

cd C:\path\to\digna\bin
stop_service.bat

Потім скасуйте реєстрацію служби — знову за допомогою старого пакетного файлу. Реєстрація вказує на старий виконуваний файл і його скрипти, які це оновлення замінює, тож повторно використати її неможливо:

uninstall_service.bat

Скасуйте реєстрацію, перш ніж щось перейменовувати

uninstall_service.bat розташований у теці bin, яку ви збираєтеся перейменувати, і лише він може видалити створену ним реєстрацію. Запустіть його, поки старе встановлення ще на місці. Якщо теку вже перейменовано, поверніть їй попередню назву, скасуйте реєстрацію й лише тоді продовжуйте.

Запишіть обліковий запис, від імені якого працювала служба, а також адресу й порт, на яких вона працювала, — вони знадобляться вам у кроці 9.

Крок 2: Створіть резервну копію поточного встановлення

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

# Rename the folder containing dignabackend
ren dignabackend dignabackend_old
# Rename the folder containing dignacli
ren dignacli dignacli_old
# Rename dashboard
ren dashboard dashboard_old

dignabackend і dignacli більше не використовуються

Починаючи з Release 2026.06, dignabackend і dignacli замінено одним виконуваним файлом digna, що поєднує серверну частину та CLI. Зберігайте dignabackend_old і dignacli_old лише доти, доки не перевірите оновлення — після цього обидві теки можна видалити. Зберігайте dashboard_old, доки не відновите з неї свої файли конфігурації (див. крок 4). Теку bin також можна прибрати: її пакетні файли керували старою службою, а 2026.06 їх не постачає, тож після того, як у кроці 1 реєстрацію служби скасовано, вони лише вводять в оману.

Крок 3: Розпакуйте та розгорніть нову версію

  1. Розпакуйте ZIP‑файл нової інсталяції digna
  2. Скопіюйте новий виконуваний файл digna і теку dashboard до свого каталогу встановлення

Важливо

Ні config.toml, ні dashboard/dashboard_config.toml ніколи не входять до інсталяційного ZIP‑файлу — команда digna ніколи не постачає жодного з цих файлів. Тож оновлення не зачіпає вашої наявної конфігурації, а копії в перейменованих теках *_old — це єдині копії, які у вас є.

Крок 4: Відновіть свої файли конфігурації

copy dashboard_old\dashboard_config.toml dashboard\dashboard_config.toml

Release 2026.06 змінює config.toml

Три параметри нові й обов'язкові, а два більше не використовуються. config.toml, перенесений із попереднього випуску, нових параметрів не містить, і digna не запуститься, доки їх бракує. Додайте до наявного config.toml таке:

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

[encryption]
DIGNA_ENCRYPTION_KEY = 'ycELf6IbcO55dYIZHpPv6kQv/bbnUXoIaHLh2bh1kMg='

Додайте два ключі [base] до наявного розділу [base] і додайте [encryption] як новий розділ. Потім вилучіть із [app] два параметри, які більше не використовуються: digna_APP_HOST і digna_APP_PORT — адресу та порт сервер тепер бере з digna serve.

Призначення кожного параметра описано в розділі Налаштування серверної частини.

Єдиний вхід: формат [oidc_clients] змінився

У Release 2026.06 масив таблиць замінено окремою таблицею для кожного постачальника, названою за ключем постачальника. DIGNA_OIDC_KEY більше немає — ключ тепер є частиною заголовка розділу.

Було:

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

Повторіть розділ для кожного постачальника і стежте, щоб кожен ключ збігався з key у dashboard_config.toml. digna config check повідомляє про oidc_clients як FAILED, доки лишається попередня форма. Це стосується лише встановлень, що використовують єдиний вхід.

Крок 5: Перезавантажте веб‑сервер

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

Крок 6: Перевірте конфігурацію

Перш ніж торкатися репозиторію, переконайтеся, що оновлений config.toml повний:

digna config check

Кожен розділ має повідомити OK. Виправте все, про що повідомлено як FAILED, і виконайте команду ще раз, перш ніж продовжувати.

Крок 7: Замініть файл ліцензії

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

copy /Y C:\path\to\new\license.toml license.toml

Не залишайте попередню ліцензію

license.toml, виданий для попереднього випуску, не поширюється на цей, і кожна команда, що перевіряє ліцензію, — user, inspection, repo — завершується, не торкаючись репозиторію, якщо перевірка не пройдена. Перевірте ліцензію, перш ніж продовжувати:

digna license check

Крок 8: Оновіть схему репозиторію

Перейдіть до каталогу встановлення digna і виконайте:

digna repo upgrade

Це оновлює схему PostgreSQL до найновішої версії, зберігаючи всі наявні дані.

Крок 9: Зареєструйте та запустіть службу

Стару реєстрацію видалено в кроці 1, тож службу реєструють знову — цього разу за допомогою виконуваного файлу digna, який не має пакетних файлів:

cd C:\path\to\digna
digna windows install --address <address> --port <port>
digna windows start

Задайте для --address і --port значення, на яких працювала стара служба, якщо тільки вам не потрібні нові значення за замовчуванням 127.0.0.1 і 8000; вони записуються в реєстрацію й більше не зчитуються з config.toml. Додайте --account і --password, якщо стара служба працювала від імені облікового запису домену. Повний перелік параметрів див. у розділі Запуск digna як служби Windows.

Якщо сервер запускається вручну, перезапустіть його:

cd C:\path\to\digna
digna serve --address <address> --port <port>

Якщо використовуєте IIS або Tomcat, перезапустіть відповідний веб‑сервер.

Крок 10: Перевірте оновлення

  1. Відкрийте панель digna
  2. Переконайтеся, що інтерфейс завантажується коректно
  3. Перевірте журнали сервера на наявність помилок
  4. Переведіть на ODBC кожне підключення, яке його ще не використовувало, а потім перевірте всі підключення — див. Перевірка підключення