Перейти к содержанию

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

Релиз: 2026.11

Последнее обновление: 7 ноября 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.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 ГБ ОЗУ
Место на диске 10 ГБ свободного пространства
База данных PostgreSQL Server 12 или выше
Веб-сервер IIS, Apache Tomcat или эквивалент

digna Engine

Подключения к базам данных, использующие digna Engine в качестве места профилирования, профилируются на самом хосте digna. Запланируйте для них дополнительную память и место на диске, см. раздел [duckdb].

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

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

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

Рекомендуемые характеристики

  • Память: 32 ГБ ОЗУ (вместо 16 ГБ)
  • Место на диске: 50 ГБ свободного пространства (вместо 10 ГБ)

Эти увеличенные характеристики учитывают одновременную работу digna и сервера PostgreSQL.


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

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

Совет

Если порт 5432 уже занят, выберите альтернативный порт и запомните его для последующей конфигурации.

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

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

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

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

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

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

psql --version

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


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

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

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

Настройка 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

Важно

Без этой настройки файлы .md могут не обслуживаться корректно.


Настройка 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

Совет

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

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

Ни config.toml, ни dashboard/dashboard_config.toml не поставляются вместе с установкой — вы создаёте оба файла самостоятельно, в разделах Конфигурация backend и Конфигурация Dashboard. 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)

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

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

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

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

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

Раздел [app]

Этот раздел настраивает совместное использование ресурсов между источниками (CORS) для dashboard и backend:

[app]
DIGNA_APP_CORS_ALLOW_ORIGINS = ["http://localhost:5173"]
DIGNA_APP_CORS_ALLOW_CREDENTIALS = true
Параметр Значение Примечания
DIGNA_APP_CORS_ALLOW_ORIGINS URL dashboard URL, с которых обслуживается dashboard. Запросы браузера с любого другого origin отклоняются
DIGNA_APP_CORS_ALLOW_CREDENTIALS true Обязательно, чтобы браузер отправлял cookie сессии с каждым запросом

Раздел [app] необязателен

Начиная с Release 2026.11, оба ключа, а также весь раздел [app], можно не указывать. Это правильная настройка, когда обратный прокси обслуживает dashboard и backend под одним origin: тогда браузер не выполняет запросов между источниками, и по умолчанию ни один такой запрос не разрешён.

Раздел [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 Хост PostgreSQL / IP-адрес
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 Хост, по которому открывается dashboard. "" не задаёт домен — это правильно за прокси, который обслуживает dashboard и backend под одним origin
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 dashboard Обязательно. Используется для ссылок в уведомлениях, поэтому это должен быть 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 (по умолчанию) Необязательно. Количество хранимых файлов логов после ротации

Сохраняйте каталог логов при работе в качестве службы

У службы 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 (по умолчанию) Память в МБ, которую может использовать один запуск 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.


Конфигурация 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-файлы не нужно.

Команда Назначение
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. Выберите "Запуск от имени администратора"

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

    cd C:\path\to\digna
    

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

    digna windows install
    

Укажите адрес и порт, если значения по умолчанию вам не подходят

install записывает адрес и порт в регистрацию службы, и служба привязывается именно к записанным значениям. По умолчанию это 127.0.0.1 и 8000, что допускает подключения только с самого компьютера. Dashboard на другом узле не сможет к нему подключиться, поэтому укажите адрес, на котором должен слушать backend:

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

Перед обновлением выполните резервное копирование вашей базы данных (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. Сравните свой файл с разделом Конфигурация backend.

Приведённые ниже шаги указывают, где более старой установке нужны другие действия. Обновление репозитория в шаге 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 регистрировали службу с помощью batch-файлов. Остановите её и удалите регистрацию с помощью batch-файлов вашей текущей установки, прежде чем что-либо переименовывать в шаге 2:

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

Запишите учётную запись, от имени которой работала служба, а также адрес и порт, на которых она работала. В шаге 9 вы зарегистрируете службу заново.

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

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

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 с batch-файлами.

Шаг 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], если обратный прокси обслуживает dashboard и backend под одним origin.

Параметры, которые 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. Пишите каждое имя прописными буквами, как в разделе Конфигурация backend.

Единый вход: сохраните [[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 — это набор статических файлов, поэтому ваш веб-сервер, а также браузер, могут по-прежнему отдавать предыдущую версию. Перезагрузите или перезапустите веб-сервер, на котором размещена папка 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 dashboard и убедитесь, что интерфейс загружается корректно.

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

Чтобы начать работу с новыми модулями, см. digna Data Reconciliation, Подключение ИИ-агента для digna MCP Server и Место профилирования для digna Engine.