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

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

Випуск: 2026.11

Останнє оновлення: 7 листопада 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.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 переконайтеся, що наявні дві ключові передумови:

  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]

Цей розділ налаштовує спільне використання ресурсів між джерелами (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, якщо ключа немає.

[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_DIR = "logs"
DIGNA_LOGGING_MAX_FILES = 30
Параметр Значення Примітки
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:

mkdir C:\path\to\digna\tmp

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


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

Перед ініціалізацією репозиторію переконайтеся, що config.toml повний і правильно сформований. У каталозі встановлення digna виконайте:

digna config check

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

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

Overall: OK

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

Крок 3: Ініціалізуйте репозиторій

  1. Відкрийте Command Prompt
  2. Перейдіть до каталогу встановлення digna (там, де розташовані config.toml і виконуваний файл digna)
  3. Запустіть перевірку підключення:
digna repo check

Для нової схеми команда підключається, а потім повідомляє, що репозиторій ще не встановлено:

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

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

Крок 4: Встановіть схему репозиторію

У тому самому каталозі виконайте:

digna repo upgrade

Ця команда встановлює необхідні таблиці у схемі репозиторію й завершується повідомленням:

✅ Repo schema 'dignarepo' is up to date.

repo upgrade встановлює та оновлює

Починаючи з Release 2026.11, repo upgrade встановлює новий репозиторій і оновлює наявний. repo install і далі працює як інша назва тієї самої команди.

Крок 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 сервера (за замовчуванням 127.0.0.1) - --port — порт сервера (за замовчуванням 8000)

Коли сервер запущено, він виводить адресу, яку прослуховує:

Server running on http://127.0.0.1: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 до 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 вашого поточного встановлення:

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

Служба залишається зареєстрованою. Новий виконуваний файл займає місце старого в тому самому каталозі, тож реєстрація й надалі вказує на правильний файл.

Якщо digna працює на передньому плані, натисніть Ctrl+C у її вікні Command Prompt.

Оновлення з випуску, старішого за 2026.06

Випуски до 2026.06 реєстрували службу за допомогою пакетних файлів. Зупиніть її та скасуйте реєстрацію пакетними файлами вашого поточного встановлення, перш ніж щось перейменовувати в кроці 2:

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

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

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

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

cd C:\path\to\digna
ren digna.exe digna_old.exe
ren dashboard dashboard_old

Зберігайте digna_old.exe, доки не перевірите оновлення, а dashboard_old — доки не відновите з неї свої файли конфігурації (див. крок 4). Після цього обидва можна видалити.

Оновлення з випуску, старішого за 2026.06

Перейменуйте теки dignabackend і dignacli замість виконуваного файлу: ren dignabackend dignabackend_old і ren dignacli dignacli_old. Release 2026.11 не використовує жодної з цих тек, як і теки bin із пакетними файлами.

Крок 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.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 повний:

digna config check

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

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

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

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

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

З попередньою ліцензією digna запускається, але digna Data Reconciliation і digna MCP Server залишаються вимкненими. Кожна команда, що перевіряє ліцензію, — user, inspection, repo — завершується, не торкаючись репозиторію, якщо перевірка не пройдена. Перевірте нову ліцензію, перш ніж продовжувати:

digna license check

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

У каталозі встановлення digna виконайте:

digna repo upgrade

Release 2026.11 керує схемою репозиторію за допомогою версійованих міграцій. Перше оновлення з попереднього випуску доводить схему до останньої версії попередньої системи, записує це як вихідну точку, а потім застосовує міграції Release 2026.11. Воно завершується так:

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

Усі наявні дані зберігаються. Щоб будь-коли побачити стан репозиторію, виконайте digna repo check: команда показує останню застосовану міграцію та всі ще не застосовані.

digna не запускається із застарілим репозиторієм

Починаючи з Release 2026.11, сервер відмовляється запускатися, доки репозиторій потребує оновлення, і повідомляє про це, наприклад:

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

Виконайте repo upgrade, перш ніж запускати сервер або службу.

Крок 9: Перезапустіть служби

Якщо digna працює як служба Windows, запустіть її знову:

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

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

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

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

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

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

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

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

  1. Перевірте випуск нового виконуваного файлу:

    digna version
    

    Перший рядок має бути Release: 2026.11.

  2. Відкрийте панель digna і переконайтеся, що інтерфейс завантажується коректно.

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

Щоб почати роботу з новими модулями, див. digna Data Reconciliation, Підключення AI-агента для digna MCP Server і Місце профілювання для digna Engine.