Посібник зі встановлення digna Release 2026.11 на Windows¶
Випуск: 2026.11
Останнє оновлення: 7 листопада 2026 р.
Зміст¶
- Вступ
- Системні вимоги
- Підготовка до встановлення
- Налаштування сервера PostgreSQL
- Налаштування веб‑сервера
- Початкове встановлення
- Налаштування серверної частини
- Налаштування панелі
- Запуск digna як служби Windows
- Оновлення до нового випуску
Вступ¶
Про digna¶
digna — це комплексна платформа на основі AI, призначена для оптимізації управління якістю даних у різних середовищах даних, таких як сховища даних (warehouses), озера даних (lakes) і lakehouses. Побудована з розрахунком на високу масштабованість та адаптивність, digna вирішує сучасні завдання роботи з даними завдяки автоматизації, моніторингу в реальному часі та виявленню аномалій.
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 і новий файл ліцензії. Кожну з цих змін описано в розділі про оновлення.
Шукаєте macOS або Linux?¶
Цей посібник охоплює Windows. Для інших платформ див. Посібник зі встановлення на macOS або Посібник зі встановлення на Linux.
Системні вимоги¶
Перш ніж почати встановлення, переконайтеся, що ваша система відповідає таким мінімальним вимогам:
| Вимога | Специфікація |
|---|---|
| Операційна система | Windows Server або Windows 10/11 |
| Пам'ять (мінімальна конфігурація) | 16 GB RAM |
| Дисковий простір | 10 GB вільного місця |
| База даних | PostgreSQL Server 12 або новіший |
| Веб‑сервер | IIS, Apache Tomcat або аналог |
digna Engine
Підключення до баз даних, які використовують digna Engine як місце профілювання, профілюються на самому хості digna. Заплануйте для них додаткові пам'ять і дисковий простір, див. розділ [duckdb].
Варіанти встановлення бази даних¶
Якщо 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]¶
Цей розділ налаштовує спільне використання ресурсів між джерелами (CORS) для панелі та серверної частини:
[app]
DIGNA_APP_CORS_ALLOW_ORIGINS = ["http://localhost:5173"]
DIGNA_APP_CORS_ALLOW_CREDENTIALS = true
| Параметр | Значення | Примітки |
|---|---|---|
DIGNA_APP_CORS_ALLOW_ORIGINS | URL панелі | URL, з яких віддається панель. Запити браузера з будь-якого іншого джерела відхиляються |
DIGNA_APP_CORS_ALLOW_CREDENTIALS | true | Обов'язково, щоб браузер надсилав cookie сесії з кожним запитом |
Розділ [app] необов'язковий
Починаючи з Release 2026.11, обидва ключі, а також увесь розділ [app], можна не вказувати. Це правильне налаштування, коли зворотний проксі віддає панель і серверну частину з одного джерела: тоді браузер не робить запитів між джерелами, і за замовчуванням жоден такий запит не дозволено.
Розділ [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
| Параметр | Значення | Примітки |
|---|---|---|
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 | Ваш пароль | Пароль, заданий під час створення схеми |
DIGNA_REPO_SSLMODE | prefer (за замовчуванням) | Необов'язково. Режим SSL для PostgreSQL: disable, allow, prefer, require, verify-ca або verify-full |
DIGNA_REPO_NUM_CONNS | 16 (за замовчуванням) | Необов'язково. Кількість підключень до репозиторію, які digna тримає відкритими |
Розділ [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
| Параметр | Значення | Примітки |
|---|---|---|
DIGNA_FERNET_KEY | Значення, наведене вище | Ключ шифрування, яке використовували попередні випуски. Він має бути присутнім; залиште наведене значення |
DIGNA_COOKIE_DOMAIN | localhost | Хост, за яким відкривається панель. "" не задає домену — це правильно за проксі, який віддає панель і серверну частину з одного джерела |
DIGNA_COOKIE_SECURE | false (HTTP) / true (HTTPS) | Має бути true щоразу, коли digna працює через HTTPS |
DIGNA_COOKIE_HTTPONLY | true | Робить cookie сесії недоступним для скриптів |
DIGNA_TOKEN_EXPIRES_IN | 86400 (24 години) | Тайм‑аут сесії в секундах |
DIGNA_MAX_WORKERS | Кількість ядер CPU - 1 | Кількість інспекцій, які можуть виконуватися одночасно |
DIGNA_FRONTEND_BASEURL | URL панелі | Обов'язково. Використовується для посилань у сповіщеннях, тож це має бути URL, який одержувачі можуть відкрити |
DIGNA_SOURCE_QUERY_TIMEOUT_SEC | 3600 (за замовчуванням) | Необов'язково. Скільки секунд може виконуватися один запит до вихідної бази даних, перш ніж його буде перервано; 0 вимикає тайм‑аут |
DIGNA_SOURCE_LOGIN_TIMEOUT_SEC | 30 (за замовчуванням) | Необов'язково. Скільки секунд чекати на підключення до вихідної бази даних; 0 — чекати без обмежень |
Розділ [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 — для усунення несправностей. Також приймаються TRACE, WARN і ERROR |
DIGNA_LOGGING_DIR | logs (за замовчуванням) | Необов'язково. Каталог для файлів журналу з ротацією, відносно робочого каталогу |
DIGNA_LOGGING_MAX_FILES | 30 (за замовчуванням) | Необов'язково. Кількість файлів журналу після ротації, які зберігаються |
Збережіть каталог журналів, коли digna працює як служба
Служба Windows не має консолі, тож файли журналу — єдиний запис того, що робить служба. Не задавайте для DIGNA_LOGGING_DIR порожній рядок — це вимикає файли журналу.
Розділ [duckdb] (необов'язковий)¶
Нове в Release 2026.11. Цей розділ задає ресурси digna Engine, який профілює дані всередині digna для підключень до баз даних, місцем профілювання яких є digna Engine, і виконує перевірки референтної цілісності між джерелами даних на різних підключеннях до баз даних. Див. Місце профілювання.
Розділ необов'язковий. Без нього діють наведені нижче значення за замовчуванням.
[duckdb]
DIGNA_DUCKDB_MEMORY_LIMIT_MB = 1024
DIGNA_DUCKDB_TEMP_DIRECTORY = "C:\\path\\to\\digna\\tmp"
| Параметр | Значення | Примітки |
|---|---|---|
DIGNA_DUCKDB_MEMORY_LIMIT_MB | 1024 (за замовчуванням) | Пам'ять у MB, яку може використовувати один запуск digna Engine. Одночасно можуть бути активними до DIGNA_MAX_WORKERS запусків |
DIGNA_DUCKDB_TEMP_DIRECTORY | За замовчуванням: тимчасовий каталог облікового запису, під яким працює digna (%TEMP%) | Каталог для тимчасових файлів, коли дані не вміщаються в пам'ять |
Розрахунок ресурсів для digna Engine
Заплануйте до DIGNA_MAX_WORKERS × DIGNA_DUCKDB_MEMORY_LIMIT_MB пам'яті на хості digna понад те, що використовує сама digna, а також достатньо вільного місця на диску в тимчасовому каталозі, щоб умістити дані найбільшої інспектованої дати джерел даних, які використовують digna Engine. Спрямуйте DIGNA_DUCKDB_TEMP_DIRECTORY на диск із таким обсягом вільного місця, доступний для запису обліковому запису, під яким працює digna:
Цей розділ потрібен, лише якщо принаймні одне підключення до бази даних використовує digna Engine або перевірка референтної цілісності порівнює джерела даних на різних підключеннях.
Крок 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
- Template overrides: OK
- Unknown keys: OK
Overall: OK
Виправте все, про що повідомлено як FAILED, і виконайте команду ще раз, перш ніж продовжувати. WARNING у пункті Unknown keys перелічує ключі в config.toml, які digna не зчитує; вони ні на що не впливають, тож вилучіть їх або виправте їхнє написання. Повний перелік параметрів наведено в довіднику CLI.
Крок 3: Ініціалізуйте репозиторій¶
- Відкрийте Command Prompt
- Перейдіть до каталогу встановлення digna (там, де розташовані
config.tomlі виконуваний файлdigna) - Запустіть перевірку підключення:
Для нової схеми команда підключається, а потім повідомляє, що репозиторій ще не встановлено:
На цьому етапі це очікуваний результат: він підтверджує, що digna дістається до PostgreSQL і схеми. Натомість помилка підключення чи автентифікації вказує на розділ [repo] або на налаштування PostgreSQL.
Крок 4: Встановіть схему репозиторію¶
У тому самому каталозі виконайте:
Ця команда встановлює необхідні таблиці у схемі репозиторію й завершується повідомленням:
repo upgrade встановлює та оновлює
Починаючи з Release 2026.11, repo upgrade встановлює новий репозиторій і оновлює наявний. repo install і далі працює як інша назва тієї самої команди.
Крок 5: Створіть користувача‑адміністратора¶
Користувач‑адміністратор створюється безпосередньо у схемі репозиторію, тож сервер поки що не мусить працювати. У каталозі встановлення digna виконайте:
Приклад:
Це створює користувача з повними адміністративними правами.
Найкраща практика
Використовуйте надійний пароль, що поєднує великі й малі літери, цифри та спеціальні символи.
Крок 6: Запустіть сервер digna¶
У каталозі встановлення digna запустіть сервер командою:
Параметри: - --address — ім'я хоста / IP сервера (за замовчуванням 127.0.0.1) - --port — порт сервера (за замовчуванням 8000)
Коли сервер запущено, він виводить адресу, яку прослуховує:
Сервер займає термінал
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 до Release 2026.11. Якщо ваше встановлення старіше, спершу прочитайте розділ Оновлення з випуску, старішого за 2026.06.
Перед оновленням¶
Створення резервної копії репозиторію digna обов'язкове
Перед оновленням digna створіть резервну копію свого репозиторію (PostgreSQL), щоб захиститися від втрати даних. Резервна копія дає змогу відновитися, якщо під час оновлення виникнуть непередбачені проблеми.
Запит файлу ліцензії для 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. Порівняйте свій файл із розділом Налаштування серверної частини.
Наведені нижче кроки вказують, де старіше встановлення потребує інших дій. Оновлення репозиторію в кроці 8 переводить репозиторій будь-якого попереднього випуску одразу до 2026.11.
Процес оновлення¶
Крок 1: Зупиніть службу digna¶
Відкрийте Command Prompt від імені адміністратора й зупиніть службу за допомогою виконуваного файлу digna вашого поточного встановлення:
Служба залишається зареєстрованою. Новий виконуваний файл займає місце старого в тому самому каталозі, тож реєстрація й надалі вказує на правильний файл.
Якщо digna працює на передньому плані, натисніть Ctrl+C у її вікні Command Prompt.
Оновлення з випуску, старішого за 2026.06
Випуски до 2026.06 реєстрували службу за допомогою пакетних файлів. Зупиніть її та скасуйте реєстрацію пакетними файлами вашого поточного встановлення, перш ніж щось перейменовувати в кроці 2:
Запишіть обліковий запис, від імені якого працювала служба, а також адресу й порт, на яких вона працювала. У кроці 9 ви зареєструєте службу знову.
Крок 2: Створіть резервну копію поточного встановлення¶
У каталозі встановлення digna перейменуйте виконуваний файл і теку панелі поточного встановлення, щоб новий випуск можна було розгорнути поруч із ними:
Зберігайте digna_old.exe, доки не перевірите оновлення, а dashboard_old — доки не відновите з неї свої файли конфігурації (див. крок 4). Після цього обидва можна видалити.
Оновлення з випуску, старішого за 2026.06
Перейменуйте теки dignabackend і dignacli замість виконуваного файлу: ren dignabackend dignabackend_old і ren dignacli dignacli_old. Release 2026.11 не використовує жодної з цих тек, як і теки bin із пакетними файлами.
Крок 3: Розпакуйте та розгорніть нову версію¶
- Розпакуйте ZIP‑файл нової інсталяції digna
- Скопіюйте новий виконуваний файл
dignaі текуdashboardдо свого каталогу встановлення
Важливо
Ні config.toml, ні dashboard/dashboard_config.toml ніколи не входять до інсталяційного ZIP‑файлу — команда digna ніколи не постачає жодного з цих файлів. Тож оновлення не зачіпає вашої наявної конфігурації, а копії в перейменованих теках *_old — це єдині копії, які у вас є.
Крок 4: Відновіть свої файли конфігурації¶
Release 2026.11 не потребує змін у config.toml: файл, який працює з Release 2026.06, і далі працюватиме. Дві зміни необов'язкові:
- Додайте розділ
[duckdb], якщо підключення до баз даних мають використовувати digna Engine, а його значення за замовчуванням не підходять для вашого хоста. - Не вказуйте розділ
[app], якщо зворотний проксі віддає панель і серверну частину з одного джерела.
Параметри, які digna не зчитує
Попередні версії цього посібника наводили деякі параметри, які digna не зчитує. Вони ні на що не впливають, а config check у кроці 6 перелічує їх у пункті Unknown keys. Вилучіть або виправте їх:
DIGNA_SCHEDULER_MAX_DELAY,DIGNA_CLEANUP_TIME,digna_COOKIE_PATH,digna_COOKIE_SAME_SITE,digna_APP_CORS_ALLOW_METHODS,digna_APP_CORS_ALLOW_HEADERSіdigna_LOGGING_BACKUP_COUNTне існують. Вилучіть їх.- Назви параметрів чутливі до регістру. digna зчитує
DIGNA_REPO_HOST, а неdigna_REPO_HOST. Пишіть кожну назву великими літерами, як у розділі Налаштування серверної частини.
Єдиний вхід: залиште [[oidc_clients]]
digna зчитує постачальників єдиного входу як список записів [[oidc_clients]], кожен із власним DIGNA_OIDC_KEY. Якщо ви змінили своїх постачальників на розділи [oidc_clients.<key>], як показувала попередня версія цього посібника, поверніть попередню форму. config check повідомляє про OIDC config(s) як FAILED, доки діє така форма:
[[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'
Повторіть запис для кожного постачальника і стежте, щоб кожен DIGNA_OIDC_KEY збігався з key у dashboard_config.toml. Це стосується лише встановлень, що використовують єдиний вхід.
Крок 5: Перезавантажте веб‑сервер¶
Панель — це набір статичних файлів, тож ваш веб‑сервер — і браузер — можуть досі віддавати попередню версію. Перезавантажте або перезапустіть веб‑сервер, на якому розміщено теку dashboard, а потім перезавантажте сторінку з примусовим оновленням (Ctrl+F5).
Крок 6: Перевірте конфігурацію¶
Перш ніж торкатися репозиторію, переконайтеся, що config.toml повний:
Кожен розділ має повідомити OK. Виправте все, про що повідомлено як FAILED, вилучіть ключі, перелічені в пункті Unknown keys, і виконайте команду ще раз, перш ніж продовжувати.
Крок 7: Замініть файл ліцензії¶
Файл ліцензії зазвичай переходить з одного випуску в наступний. Release 2026.11 — виняток: він додає два ліцензовані модулі, digna Data Reconciliation і digna Agentic, а ліцензія, видана до 2026.11, їх не містить. Скопіюйте license.toml, який команда digna надала для Release 2026.11, до каталогу встановлення, замінивши старий:
Не залишайте попередню ліцензію
З попередньою ліцензією digna запускається, але digna Data Reconciliation і digna MCP Server залишаються вимкненими. Кожна команда, що перевіряє ліцензію, — user, inspection, repo — завершується, не торкаючись репозиторію, якщо перевірка не пройдена. Перевірте нову ліцензію, перш ніж продовжувати:
Крок 8: Оновіть схему репозиторію¶
У каталозі встановлення digna виконайте:
Release 2026.11 керує схемою репозиторію за допомогою версійованих міграцій. Перше оновлення з попереднього випуску доводить схему до останньої версії попередньої системи, записує це як вихідну точку, а потім застосовує міграції Release 2026.11. Воно завершується так:
Усі наявні дані зберігаються. Щоб будь-коли побачити стан репозиторію, виконайте digna repo check: команда показує останню застосовану міграцію та всі ще не застосовані.
digna не запускається із застарілим репозиторієм
Починаючи з Release 2026.11, сервер відмовляється запускатися, доки репозиторій потребує оновлення, і повідомляє про це, наприклад:
Виконайте repo upgrade, перш ніж запускати сервер або службу.
Крок 9: Перезапустіть служби¶
Якщо digna працює як служба Windows, запустіть її знову:
Якщо ви оновлювалися з випуску, старішого за 2026.06, і скасували реєстрацію служби в кроці 1, спершу зареєструйте її знову за допомогою виконуваного файлу digna:
Задайте для --address і --port значення, на яких працювала стара служба, якщо тільки вам не потрібні значення за замовчуванням 127.0.0.1 і 8000. Додайте --account і --password, якщо стара служба працювала від імені облікового запису домену. Повний перелік параметрів див. у розділі Запуск digna як служби Windows.
Якщо сервер запускається вручну, перезапустіть його:
Якщо використовуєте IIS або Tomcat, перезапустіть відповідний веб‑сервер.
Крок 10: Перевірте оновлення¶
-
Перевірте випуск нового виконуваного файлу:
Перший рядок має бути
Release: 2026.11. -
Відкрийте панель digna і переконайтеся, що інтерфейс завантажується коректно.
- Перевірте файли в каталозі
logsу каталозі встановлення на наявність помилок. - Перевірте свої підключення до баз даних — див. Перевірка підключення. Після оновлення з випуску, старішого за 2026.06, спершу переведіть на ODBC кожне підключення, яке його ще не використовувало.
Щоб почати роботу з новими модулями, див. digna Data Reconciliation, Підключення AI-агента для digna MCP Server і Місце профілювання для digna Engine.