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

Релиз: 2026.06

Последнее обновление: 30 августа 2026

Содержание¶

1. Введение
2. Требования к системе
3. Подготовка к установке
4. Настройка PostgreSQL сервера
5. Настройка веб-сервера
6. Первоначальная установка
7. Конфигурация backend
8. Конфигурация Dashboard
9. Запуск digna как службы Windows
10. Обновление до новой версии

Введение¶

О digna¶

digna — это полнофункциональная платформа с поддержкой ИИ, разработанная для оптимизации управления качеством данных в различных средах хранения данных, таких как хранилища, data lakes и lakehouses. Платформа создана с учетом масштабируемости и адаптируемости и решает современные задачи с помощью автоматизации, мониторинга в реальном времени и обнаружения аномалий.

digna состоит из двух основных компонентов:

• digna: ядро приложения, отвечающее за обработку данных и выполнение проверок качества. Оно объединяет серверную часть и интерфейс командной строки в одном исполняемом файле, заменяя отдельные программы dignabackend и dignacli из прежних выпусков.
• dignadashboard: веб-интерфейс, размещаемый на веб-сервере, обеспечивающий удобный способ взаимодействия с платформой digna и визуализации метрик качества данных.

Что нового в Release 2026.06¶

В этом релизе возможности наблюдаемости данных (data observability) интегрированы непосредственно в ваш код, что позволяет разработчикам отслеживать качество данных у источника. См. заметки к выпуску для полного списка изменений.

Ищете macOS или Linux?¶

Это руководство охватывает Windows. Для других платформ смотрите Руководство по установке для macOS или Руководство по установке для Linux.

Требования к системе¶

Перед началом установки убедитесь, что ваша система соответствует следующим минимальным требованиям:

Варианты установки базы данных¶

Если PostgreSQL уже установлен: Вы можете добавить новую базу данных для digna в ваш существующий сервер PostgreSQL.

Если вы устанавливаете PostgreSQL на той же машине, что и digna:

Подготовка к установке¶

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

1. PostgreSQL Server — для хранения вычисленных метрик и данных о производительности
2. Веб-сервер — для размещения 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. Вы можете оставить значение по умолчанию или указать другой порт при необходимости.

Шаг 7: Выберите локаль¶

Выберите локаль для вашей базы данных. Обычно значение по умолчанию подходит.

Шаг 8: Завершите установку¶

Нажимайте Далее до конца, затем Готово.

Шаг 9: Проверьте установку¶

Откройте Command Prompt и проверьте установку PostgreSQL:

psql --version

Если установка прошла успешно, вы увидите версию PostgreSQL.

Настройка веб-сервера¶

digna требует веб-сервер для размещения dashboard. Выберите один из следующих вариантов:

• Internet Information Services (IIS)
• Apache Tomcat

Вам нужно установить и настроить только один из этих серверов.

Настройка IIS¶

Обзор¶

Internet Information Services (IIS) — веб-сервер Microsoft для размещения веб-сайтов и веб-приложений.

Включение IIS¶

1. Откройте Панель управления
2. Нажмите Win + R

3. Введите control и нажмите Enter

4. Перейдите к компонентам Windows

5. Нажмите Программы

6. Выберите Включение или отключение компонентов Windows

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¶

Чтобы файлы Markdown (.md) корректно отдавались через IIS:

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

Настройка Apache Tomcat¶

Обзор¶

Apache Tomcat — это open-source контейнер сервлетов Java и веб-сервер.

Установка¶

1. Скачайте Apache Tomcat
2. Перейдите на страницу загрузок Apache Tomcat

3. Скачайте ZIP-распространение для Windows

4. Распакуйте архив

5. Распакуйте ZIP-файл в каталог на вашей системе

6. Пример: C:\Program Files\Apache Tomcat

7. Проверьте запуск Tomcat

8. Откройте браузер
9. Перейдите по адресу http://localhost:8080
10. Вы должны увидеть страницу приветствия Apache Tomcat

Первоначальная установка¶

Шаг 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 — основной исполняемый файл (backend + CLI в одном)

Шаг 3: Установите файл лицензии¶

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)

Конфигурация backend¶

Шаг 1: Создание и редактирование файла конфигурации¶

Файл config_template.toml поставляется в каталоге установки digna. Вам нужно переименовать его в config.toml.

Расположение: digna_installation/config.toml

Откройте config.toml в текстовом редакторе и настройте каждый из разделов ниже.

Раздел [app]¶

Этот раздел настраивает параметры приложения backend 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 = ["*"]

Раздел [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!"

Раздел [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"

Раздел [encryption]¶

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

[encryption]
DIGNA_ENCRYPTION_KEY = 'ycELf6IbcO55dYIZHpPv6kQv/bbnUXoIaHLh2bh1kMg='

Раздел [logging]¶

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

[logging]
digna_LOGGING_MODE = "INFO"
digna_LOGGING_BACKUP_COUNT = 10

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

Перед инициализацией репозитория убедитесь, что config.toml полон и корректно построен. В каталоге установки digna выполните:

digna config check

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

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

Overall: OK

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

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

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

digna repo check

Вы должны увидеть подтверждение того, что подключение установлено (сам репозиторий ещё не инициализирован).

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

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

digna repo install

Эта команда создаст необходимые таблицы и схему в вашей базе данных PostgreSQL.

Шаг 5: Создайте пользователя с правами администратора¶

1. Откройте новое окно Command Prompt
2. Перейдите в каталог установки digna
3. Выполните команду для создания администратора:

digna user add <email> <password> "<display_name>" --admin

Пример:

digna user add admin@example.com "AdminPassword123!" "Admin User" --admin

Это создаст пользователя с полными административными правами.

Шаг 6: Запустите сервер digna¶

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

digna serve --address <host> --port <port>

Параметры: - --address — имя хоста или IP сервера - --port — порт сервера

Вы должны увидеть сообщения при старте, подтверждающие запуск сервера:

INFO:     Started server process [1234]
INFO:     Waiting for application startup.
INFO:     Application startup complete
INFO:     Uvicorn running on http://localhost:8082

Конфигурация Dashboard¶

Шаг 1: Разверните Dashboard на веб-сервере¶

Dashboard digna считывает собственную конфигурацию из файла dashboard/dashboard_config.toml. Этот файл не поставляется вместе с установкой — вы создаёте его в каталоге dashboard/ рядом с файлами dashboard.

Его содержимое описано в разделе Единый вход (SSO), где этот файл и требуется: в нём задаются варианты входа, которые предлагает dashboard, а для мультиинстансных развертываний — подключение к backend.

Выберите ваш веб-сервер и выполните соответствующие шаги развертывания.

Развёртывание в 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 dashboard

Развёртывание в Apache Tomcat¶

1. Скопируйте Dashboard в Tomcat
2. Скопируйте папку dashboard в директорию webapps вашего Tomcat
3. При необходимости переименуйте (например, в digna)

4. Пример: C:\Program Files\Apache Tomcat\webapps\digna

5. Проверьте развёртывание

6. Обновите или перезагрузите страницу управления Tomcat (http://localhost:8080)

7. Вы должны увидеть "digna" (или выбранное имя) в списке развернутых приложений

8. Доступ к Dashboard

9. Откройте браузер
10. Перейдите по адресу http://localhost:8080/digna
11. Вы должны увидеть страницу входа в digna dashboard

Запуск digna как службы Windows¶

Почему использовать службу Windows?¶

Запуск backend digna как службы Windows обеспечивает: - Автоматический старт при загрузке сервера - Фоновый режим работы без открытого окна командной строки - Автоматический перезапуск при падении - Управление через оснастку Windows Services

Команды windows¶

Службой управляет сам исполняемый файл digna с помощью подкоманд digna windows. Запускать batch-файлы не нужно.

Каждая команда принимает --name, чтобы обращаться к службе, зарегистрированной под нестандартным именем. Полный список параметров приведён в справочнике CLI.

Установка службы¶

1. Откройте Command Prompt от имени администратора
2. Правой кнопкой щёлкните Command Prompt

3. Выберите "Запуск от имени администратора"

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

   cd C:\path\to\digna
   

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

   digna windows install
   

digna windows install --address 0.0.0.0 --port 8082

Служба регистрируется с автоматическим запуском, поэтому она будет запускаться вместе с Windows. Сразу после регистрации она не запускается — см. следующий раздел.

Параметры установки¶

Запуск и остановка службы¶

Чтобы запустить службу¶

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.

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

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

Сначала проверьте все подключения к базам данных

Начиная с выпуска 2026.06 digna обращается к каждой исходной технологии через ODBC. Прежние выпуски предлагали выбор между отдельным драйвером для каждой технологии и ODBC, задаваемый переключателем Use ODBC. Команда digna решила опираться только на ODBC, потому что единый стандартный интерфейс даёт больше, чем набор драйверов, написанных под заказ:

• Аутентификация — аутентификация является частью ODBC, поэтому подключение может использовать всё, что поддерживает его драйвер: пароли, токены и PAT, Kerberos и Active Directory, MFA и единый вход через браузер, облачные удостоверения, клиентские сертификаты и TLS. Новые методы появляются вместе с обновлением драйвера, а не после ожидания выпуска digna.
• Драйверы, поддерживаемые производителями баз данных — собственный драйвер производителя отслеживает новые версии сервера и исправления безопасности, и вы можете обновлять его в своём темпе, независимо от digna.
• Единый способ настроить всё — каждая технология — это список свойств «ключ/значение» с одним и тем же интерфейсом, одинаковым шифрованием конфиденциальных значений и одинаковой диагностикой, вместо разного набора полей для каждого источника.
• Тонкая настройка и охват — параметры драйвера, такие как тайм-ауты, настройки TLS, прокси-серверы и размеры выборки, доступны для любого источника, а подключить можно любую технологию с совместимым драйвером ODBC, в том числе те, для которых digna не публикует отдельного руководства.

На практике это означает, что переключателя Use ODBC и отдельных полей узла, порта, базы данных, пользователя и пароля больше нет. Каждое подключение, ещё не использующее ODBC, должно быть переведено на ODBC — автоматического преобразования нет, поэтому спланируйте это до обновления:

1. Просмотрите каждое подключение к базе данных, определённое в вашей установке, и отметьте те, которые ещё не используют ODBC — каждое из них придётся настроить заново.
2. Установите соответствующий драйвер ODBC на узле digna — подключения открываются с сервера, на котором работает серверная часть digna, а не из браузера. См. Установка драйвера ODBC на узле digna.
3. Подготовьте свойства ODBC для каждого затронутого подключения. Руководства по технологиям приводят для каждого источника проверенный набор свойств.

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

Обязательно создайте резервную копию репозитория digna

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

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

Шаг 1: Остановите старую службу и удалите её регистрацию¶

Если digna работает как служба Windows, остановите её с помощью batch-файлов вашей текущей установки — команды digna windows относятся к новому выпуску и пока недоступны:

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

Затем удалите регистрацию службы, снова с помощью старого batch-файла. Регистрация указывает на старый исполняемый файл и его скрипты, которые это обновление заменяет, поэтому повторно использовать её нельзя:

uninstall_service.bat

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

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

# Rename the folder containing dignabackend
ren dignabackend dignabackend_old

# Rename the folder containing dignacli
ren dignacli dignacli_old

# Rename dashboard
ren dashboard dashboard_old

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

1. Распакуйте новый ZIP-файл установки digna
2. Скопируйте новый исполняемый файл digna и папку dashboard в каталог установки

Шаг 4: Восстановите файлы конфигурации¶

copy dashboard_old\dashboard_config.toml dashboard\dashboard_config.toml

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

[encryption]
DIGNA_ENCRYPTION_KEY = 'ycELf6IbcO55dYIZHpPv6kQv/bbnUXoIaHLh2bh1kMg='

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

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

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

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

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

digna config check

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

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

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

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

digna license check

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

Перейдите в каталог установки digna и выполните:

digna repo upgrade

Эта команда обновит схему PostgreSQL до последней версии, сохранив все существующие данные.

Шаг 9: Зарегистрируйте и запустите службу¶

Старая регистрация была удалена в шаге 1, поэтому службу нужно зарегистрировать заново — на этот раз с помощью исполняемого файла digna, у которого нет batch-файлов:

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

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

Если вы запускаете вручную, перезапустите сервер:

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

Если вы используете IIS или Tomcat, перезапустите соответствующий веб-сервер.

Шаг 10: Проверьте корректность обновления¶

1. Откройте digna dashboard
2. Убедитесь, что интерфейс загружается корректно
3. Проверьте логи сервера на наличие ошибок
4. Переведите на ODBC каждое подключение, которое его ещё не использовало, затем проверьте все подключения — см. Проверка подключения