Посібник зі встановлення digna Release 2026.06 на Windows¶
Випуск: 2026.06
Останнє оновлення: 30 серпня 2026 р.
Зміст¶
- Вступ
- Системні вимоги
- Підготовка до встановлення
- Налаштування сервера PostgreSQL
- Налаштування веб‑сервера
- Початкове встановлення
- Налаштування серверної частини
- Налаштування панелі
- Запуск digna як служби Windows
- Оновлення до нового випуску
Вступ¶
Про 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 переконайтеся, що наявні дві ключові передумови:
- Сервер PostgreSQL – для зберігання обчислених метрик і даних про продуктивність
- Веб‑сервер – для розміщення панелі digna (digna Dashboard)
Якщо ці компоненти ще не налаштовано, скористайтеся наведеними нижче розділами, щоб установити та налаштувати їх.
Налаштування сервера PostgreSQL¶
Якщо у вас уже є PostgreSQL¶
Якщо PostgreSQL уже встановлено й запущено на вашій локальній машині або ви використовуєте керований віддалений сервер PostgreSQL, можете перейти до наступного розділу.
Встановлення PostgreSQL¶
Виконайте такі кроки, щоб установити PostgreSQL на Windows:
Крок 1: Завантажте PostgreSQL¶
- Перейдіть на сторінку завантажень PostgreSQL
- Виберіть Windows
- Завантажте найновіший інсталятор
Крок 2: Запустіть інсталятор¶
- Двічі клацніть завантажений файл інсталятора
- Дотримуйтеся підказок майстра встановлення
Крок 3: Виберіть каталог встановлення¶
Виберіть каталог, у який буде встановлено PostgreSQL. Розташування за замовчуванням зазвичай підходить.
Крок 4: Виберіть компоненти¶
Для стандартного налаштування залиште вибраними компоненти за замовчуванням.
Крок 5: Задайте пароль суперкористувача PostgreSQL¶
Введіть і підтвердьте пароль суперкористувача PostgreSQL (postgres). Надійно збережіть цей пароль — він знадобиться вам пізніше.
Крок 6: Налаштуйте номер порту¶
Стандартний порт PostgreSQL — 5432. Можете використати значення за замовчуванням або за потреби вказати інший порт.
Порада
Якщо порт 5432 уже зайнятий, виберіть інший порт і запишіть його для подальшого налаштування.
Крок 7: Виберіть локаль¶
Виберіть локаль для вашої бази даних. Значення за замовчуванням зазвичай підходить для більшості встановлень.
Крок 8: Завершіть встановлення¶
Натискайте Next на решті кроків, а потім натисніть Finish.
Крок 9: Перевірте встановлення¶
Відкрийте Command Prompt і перевірте, що PostgreSQL встановлено:
Якщо встановлення пройшло успішно, ви побачите версію PostgreSQL.
Налаштування веб‑сервера¶
digna потребує веб‑сервера для розміщення панелі. Виберіть один із таких варіантів:
Потрібно встановити й налаштувати лише один із цих серверів.
Налаштування IIS¶
Огляд¶
Internet Information Services (IIS) — веб‑сервер Microsoft для розміщення вебсайтів і веб‑застосунків.
Увімкнення IIS¶
- Відкрийте Control Panel
- Натисніть
Win + R -
Введіть
controlі натисніть Enter -
Перейдіть до компонентів Windows
- Клацніть Programs
-
Виберіть Turn Windows features on or off
-
Увімкніть Internet Information Services
- Прокрутіть униз і знайдіть Internet Information Services (IIS)
- Позначте прапорець, щоб увімкнути його
-
Клацніть +, щоб розгорнути список, і переконайтеся, що вибрано такі підкомпоненти:
- Web Management Tools
- World Wide Web Services
-
Натисніть OK, щоб застосувати зміни
-
Перевірте встановлення IIS
- Відкрийте браузер
- Перейдіть за адресою
http://localhost - Ви повинні побачити сторінку привітання IIS
Обов'язково: модуль URL Rewrite¶
IIS потребує компонента URL Rewrite. Завантажте та встановіть його з офіційної сторінки Microsoft.
Обов'язково: тип MIME для файлів Markdown¶
Щоб IIS коректно віддавав файли Markdown (.md):
- Відкрийте IIS Manager (натисніть
Win + R, введітьinetmgr, натисніть Enter) - Перейдіть до Your Site > MIME Types
- Натисніть Add...
- Налаштуйте:
- File name extension:
.md - MIME type:
text/markdown
Важливо
Без цього налаштування файли .md можуть віддаватися некоректно.
Налаштування Apache Tomcat¶
Огляд¶
Apache Tomcat — контейнер Java‑сервлетів і веб‑сервер із відкритим кодом.
Встановлення¶
- Завантажте Apache Tomcat
- Перейдіть на сторінку Apache Tomcat Downloads
-
Завантажте ZIP‑дистрибутив для Windows
-
Розпакуйте архів
- Розпакуйте ZIP‑файл у каталог на вашій системі
-
Наприклад:
C:\Program Files\Apache Tomcat -
Перевірте, що Tomcat працює
- Відкрийте браузер
- Перейдіть за адресою
http://localhost:8080 - Ви повинні побачити сторінку привітання 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¶
- Знайдіть наданий вам ZIP‑файл інсталяції digna
- Розпакуйте його в бажане місце встановлення
- Після розпакування ви побачите такі елементи:
dashboard/— веб‑інтерфейс панеліdigna— основний виконуваний файл (серверна частина та CLI разом)
Файли конфігурації та ліцензії не входять до пакета
Ні config.toml, ні dashboard/dashboard_config.toml не постачаються разом зі встановленням — ви створюєте обидва файли самостійно, у розділах Налаштування серверної частини і Налаштування панелі. license.toml також не постачається; digna надає його окремо, як описано в кроці 3.
Крок 3: Встановіть файл ліцензії¶
Важливо
Файл ліцензії не входить до інсталяційного пакета й надається digna окремо.
- Знайдіть наданий вам файл
license.toml - Скопіюйте його в кореневий каталог встановлення 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, якщо ключа немає.
| Параметр | Значення | Примітки |
|---|---|---|
DIGNA_ENCRYPTION_KEY | Ключ у кодуванні Base64 | Шифрує конфіденційні значення, що зберігаються в репозиторії digna |
Захистіть config.toml
Цей ключ — фіксоване значення, однакове в усіх установленнях digna, і саме він розшифровує конфіденційні значення у вашому репозиторії. Обмежте доступ до config.toml обліковим записом, під яким працює digna, тримайте файл поза системою контролю версій і спільними дисками та виключіть його з будь-якої резервної копії, що зберігається менш захищено, ніж сам репозиторій.
Розділ [logging]¶
Цей розділ налаштовує поведінку журналювання:
| Параметр | Значення | Примітки |
|---|---|---|
digna_LOGGING_MODE | INFO або DEBUG | INFO — для production, DEBUG — для усунення несправностей |
digna_LOGGING_BACKUP_COUNT | 10 | Кількість щоденних резервних копій журналів, які зберігаються |
Крок 2: Перевірте конфігурацію¶
Перед ініціалізацією репозиторію переконайтеся, що config.toml повний і правильно сформований. У каталозі встановлення digna виконайте:
Кожен розділ перевіряється окремо, тож одна помилка не приховує стан решти:
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: Ініціалізуйте репозиторій¶
- Відкрийте Command Prompt
- Перейдіть до каталогу встановлення digna (там, де розташовані
config.tomlі виконуваний файлdigna) - Запустіть перевірку підключення:
Ви повинні побачити підтвердження, що з'єднання встановлено (сам репозиторій ще не ініціалізовано).
Крок 4: Встановіть схему репозиторію¶
У тому самому каталозі виконайте:
Ця команда встановлює необхідні таблиці та схему у вашій базі даних PostgreSQL.
Крок 5: Створіть користувача‑адміністратора¶
Користувач‑адміністратор створюється безпосередньо у схемі репозиторію, тож сервер поки що не мусить працювати. У каталозі встановлення digna виконайте:
Приклад:
Це створює користувача з повними адміністративними правами.
Найкраща практика
Використовуйте надійний пароль, що поєднує великі й малі літери, цифри та спеціальні символи.
Крок 6: Запустіть сервер digna¶
У каталозі встановлення digna запустіть сервер командою:
Параметри: - --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¶
- Відкрийте IIS Manager
-
Натисніть
Win + R, введітьinetmgr, натисніть Enter -
Створіть новий вебсайт
- На лівій панелі клацніть правою кнопкою миші Sites
-
Виберіть Add Website...
-
Налаштуйте вебсайт
- Site Name: введіть назву (наприклад, "dignaDashboard")
- Physical Path: натисніть Browse і виберіть теку
dashboard -
Binding: задайте IP‑адресу та порт (за замовчуванням порт 80 для HTTP, 443 для HTTPS)
-
Запустіть вебсайт
- Натисніть OK, щоб створити сайт
-
Клацніть правою кнопкою миші новий сайт і виберіть Start
-
Перевірте встановлення
- Відкрийте браузер
- Перейдіть за адресою
http://localhost(або за налаштованим вами URL) - Ви повинні побачити сторінку входу панелі digna
Розгортання в Apache Tomcat¶
- Скопіюйте панель до Tomcat
- Скопіюйте теку
dashboardдо каталогуwebappsвашого Tomcat - За потреби перейменуйте її (наприклад, на
digna) -
Приклад:
C:\Program Files\Apache Tomcat\webapps\digna -
Перевірте розгортання
- Оновіть або перезавантажте сторінку керування Tomcat (http://localhost:8080)
-
Ви повинні побачити "digna" (або вибрану вами назву) у списку розгорнутих застосунків
-
Відкрийте панель
- Відкрийте браузер
- Перейдіть за адресою
http://localhost:8080/digna - Ви повинні побачити сторінку входу панелі 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.
Встановлення служби¶
- Відкрийте Command Prompt від імені адміністратора
- Клацніть правою кнопкою миші Command Prompt
-
Виберіть "Run as Administrator"
-
Перейдіть до каталогу встановлення digna
-
Зареєструйте службу
Вкажіть адресу й порт, якщо значення за замовчуванням вам не підходять
install записує адресу й порт у реєстрацію служби, і служба прив'язується саме до записаних значень. За замовчуванням це 127.0.0.1 і 8000, які приймають з'єднання лише з самої машини. Панель на іншому хості не зможе до них достукатися, тож укажіть адресу, яку має прослуховувати серверна частина:
Ці значення не зчитуються з 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:
-
Зупиніть поточну службу та скасуйте її реєстрацію
-
Перемістіть файли застосунку
-
Перемістіть усю теку встановлення digna в нове розташування
-
Знову зареєструйте службу з нового розташування
Повторіть усі значення --address, --port або --account, які ви використали першого разу — попередньої реєстрації більше немає.
- Запустіть службу
Видалення служби¶
-
Зупиніть запущену службу
-
Скасуйте реєстрацію служби
Реєстрацію сервера 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 — автоматичного перетворення немає, тож сплануйте це до оновлення:
- Перегляньте кожне підключення до бази даних, визначене у вашому встановленні, і складіть список тих, що ще не використовують ODBC — кожне з них доведеться налаштувати заново.
- Встановіть відповідний драйвер ODBC на хості digna — підключення відкриваються із сервера, на якому працює серверна частина digna, а не з браузера. Див. Встановлення драйвера ODBC на хості digna.
- Підготуйте властивості ODBC для кожного зачепленого підключення. Посібники за технологіями наводять для кожного джерела перевірений набір властивостей.
Після оновлення переведіть кожне зачеплене підключення на ODBC і перевірте його з панелі — див. Створення підключення до бази даних та Перевірка підключення.
Підключення Databricks Legacy
Конектор Databricks Legacy вилучено в цьому випуску. Переведіть такі підключення на конектор Databricks.
Створення резервної копії репозиторію digna обов'язкове
Перед оновленням digna створіть резервну копію свого репозиторію (PostgreSQL), щоб захиститися від втрати даних. Резервна копія дає змогу відновитися, якщо під час оновлення виникнуть непередбачені проблеми.
Процес оновлення¶
Крок 1: Зупиніть стару службу та скасуйте її реєстрацію¶
Якщо digna працює як служба Windows, зупиніть її за допомогою пакетних файлів вашого поточного встановлення — команди digna windows належать новому випуску й поки що недоступні:
Потім скасуйте реєстрацію служби — знову за допомогою старого пакетного файлу. Реєстрація вказує на старий виконуваний файл і його скрипти, які це оновлення замінює, тож повторно використати її неможливо:
Скасуйте реєстрацію, перш ніж щось перейменовувати
uninstall_service.bat розташований у теці bin, яку ви збираєтеся перейменувати, і лише він може видалити створену ним реєстрацію. Запустіть його, поки старе встановлення ще на місці. Якщо теку вже перейменовано, поверніть їй попередню назву, скасуйте реєстрацію й лише тоді продовжуйте.
Запишіть обліковий запис, від імені якого працювала служба, а також адресу й порт, на яких вона працювала, — вони знадобляться вам у кроці 9.
Крок 2: Створіть резервну копію поточного встановлення¶
У каталозі встановлення digna перейменуйте теки поточного встановлення, щоб новий випуск можна було розгорнути поруч із ними:
dignabackend і dignacli більше не використовуються
Починаючи з Release 2026.06, dignabackend і dignacli замінено одним виконуваним файлом digna, що поєднує серверну частину та CLI. Зберігайте dignabackend_old і dignacli_old лише доти, доки не перевірите оновлення — після цього обидві теки можна видалити. Зберігайте dashboard_old, доки не відновите з неї свої файли конфігурації (див. крок 4). Теку bin також можна прибрати: її пакетні файли керували старою службою, а 2026.06 їх не постачає, тож після того, як у кроці 1 реєстрацію служби скасовано, вони лише вводять в оману.
Крок 3: Розпакуйте та розгорніть нову версію¶
- Розпакуйте ZIP‑файл нової інсталяції digna
- Скопіюйте новий виконуваний файл
dignaі текуdashboardдо свого каталогу встановлення
Важливо
Ні config.toml, ні dashboard/dashboard_config.toml ніколи не входять до інсталяційного ZIP‑файлу — команда digna ніколи не постачає жодного з цих файлів. Тож оновлення не зачіпає вашої наявної конфігурації, а копії в перейменованих теках *_old — це єдині копії, які у вас є.
Крок 4: Відновіть свої файли конфігурації¶
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 повний:
Кожен розділ має повідомити OK. Виправте все, про що повідомлено як FAILED, і виконайте команду ще раз, перш ніж продовжувати.
Крок 7: Замініть файл ліцензії¶
Кожен випуск ліцензується окремо. Скопіюйте license.toml, який команда digna надала для цього випуску, до каталогу встановлення, замінивши старий:
Не залишайте попередню ліцензію
license.toml, виданий для попереднього випуску, не поширюється на цей, і кожна команда, що перевіряє ліцензію, — user, inspection, repo — завершується, не торкаючись репозиторію, якщо перевірка не пройдена. Перевірте ліцензію, перш ніж продовжувати:
Крок 8: Оновіть схему репозиторію¶
Перейдіть до каталогу встановлення digna і виконайте:
Це оновлює схему PostgreSQL до найновішої версії, зберігаючи всі наявні дані.
Крок 9: Зареєструйте та запустіть службу¶
Стару реєстрацію видалено в кроці 1, тож службу реєструють знову — цього разу за допомогою виконуваного файлу digna, який не має пакетних файлів:
Задайте для --address і --port значення, на яких працювала стара служба, якщо тільки вам не потрібні нові значення за замовчуванням 127.0.0.1 і 8000; вони записуються в реєстрацію й більше не зчитуються з config.toml. Додайте --account і --password, якщо стара служба працювала від імені облікового запису домену. Повний перелік параметрів див. у розділі Запуск digna як служби Windows.
Якщо сервер запускається вручну, перезапустіть його:
Якщо використовуєте IIS або Tomcat, перезапустіть відповідний веб‑сервер.
Крок 10: Перевірте оновлення¶
- Відкрийте панель digna
- Переконайтеся, що інтерфейс завантажується коректно
- Перевірте журнали сервера на наявність помилок
- Переведіть на ODBC кожне підключення, яке його ще не використовувало, а потім перевірте всі підключення — див. Перевірка підключення