Руководство по установке на Windows для digna Release 2026.11¶
Релиз: 2026.11
Последнее обновление: 7 ноября 2026
Содержание¶
- Введение
- Требования к системе
- Подготовка к установке
- Настройка PostgreSQL сервера
- Настройка веб-сервера
- Первоначальная установка
- Конфигурация backend
- Конфигурация Dashboard
- Запуск digna как службы Windows
- Обновление до новой версии
Введение¶
О 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 убедитесь, что имеются две ключевые предпосылки:
- PostgreSQL Server — для хранения вычисленных метрик и данных о производительности
- Веб-сервер — для размещения digna Dashboard
Если эти компоненты ещё не настроены, следуйте разделам ниже, чтобы установить и сконфигурировать их.
Настройка PostgreSQL сервера¶
Если PostgreSQL уже установлен¶
Если PostgreSQL уже установлен и запущен на вашей локальной машине или если вы используете управляемый удалённый сервер PostgreSQL, вы можете перейти к следующему разделу — настройка веб-сервера.
Установка PostgreSQL¶
Выполните следующие шаги для установки PostgreSQL на Windows:
Шаг 1: Загрузите PostgreSQL¶
- Перейдите на страницу загрузок PostgreSQL
- Выберите Windows
- Скачайте последний установщик
Шаг 2: Запустите установщик¶
- Дважды щёлкните по загруженному файлу установщика
- Следуйте подсказкам мастера установки
Шаг 3: Выберите каталог установки¶
Выберите каталог, в который будет установлен PostgreSQL. Обычно местоположение по умолчанию подходит.
Шаг 4: Выберите компоненты¶
Для стандартной установки оставьте выбранными компоненты по умолчанию.
Шаг 5: Задайте пароль суперпользователя PostgreSQL¶
Введите и подтвердите пароль для суперпользователя PostgreSQL (postgres). Храните этот пароль в надёжном месте — он понадобится вам позже.
Шаг 6: Настройте номер порта¶
Порт PostgreSQL по умолчанию — 5432. Вы можете оставить значение по умолчанию или указать другой порт при необходимости.
Совет
Если порт 5432 уже занят, выберите альтернативный порт и запомните его для последующей конфигурации.
Шаг 7: Выберите локаль¶
Выберите локаль для вашей базы данных. Обычно значение по умолчанию подходит.
Шаг 8: Завершите установку¶
Нажимайте Далее до конца, затем Готово.
Шаг 9: Проверьте установку¶
Откройте Command Prompt и проверьте установку PostgreSQL:
Если установка прошла успешно, вы увидите версию PostgreSQL.
Настройка веб-сервера¶
digna требует веб-сервер для размещения dashboard. Выберите один из следующих вариантов:
Вам нужно установить и настроить только один из этих серверов.
Настройка IIS¶
Обзор¶
Internet Information Services (IIS) — веб-сервер Microsoft для размещения веб-сайтов и веб-приложений.
Включение IIS¶
- Откройте Панель управления
- Нажмите
Win + R -
Введите
controlи нажмите Enter -
Перейдите к компонентам Windows
- Нажмите Программы
-
Выберите Включение или отключение компонентов Windows
-
Включите Internet Information Services
- Пролистайте вниз и найдите Internet Information Services (IIS)
- Установите флажок для его включения
-
Нажмите +, чтобы развернуть и убедиться, что выбраны следующие подсистемы:
- Web Management Tools
- World Wide Web Services
-
Нажмите OK, чтобы применить изменения
-
Проверьте установку IIS
- Откройте браузер
- Перейдите по адресу
http://localhost - Вы должны увидеть страницу приветствия IIS
Требуется: модуль URL Rewrite¶
IIS требует компонента URL Rewrite. Скачайте и установите его с официальной страницы Microsoft.
Требуется: MIME-тип для файлов Markdown¶
Чтобы файлы Markdown (.md) корректно отдавались через IIS:
- Откройте IIS Manager (нажмите
Win + R, введитеinetmgr, нажмите Enter) - Перейдите к Ваш сайт > MIME Types
- Нажмите Add...
- Настройте:
- File name extension:
.md - MIME type:
text/markdown
Важно
Без этой настройки файлы .md могут не обслуживаться корректно.
Настройка Apache Tomcat¶
Обзор¶
Apache Tomcat — это open-source контейнер сервлетов Java и веб-сервер.
Установка¶
- Скачайте Apache Tomcat
- Перейдите на страницу загрузок Apache Tomcat
-
Скачайте ZIP-распространение для Windows
-
Распакуйте архив
- Распакуйте ZIP-файл в каталог на вашей системе
-
Пример:
C:\Program Files\Apache Tomcat -
Проверьте запуск Tomcat
- Откройте браузер
- Перейдите по адресу
http://localhost:8080 - Вы должны увидеть страницу приветствия Apache Tomcat
Совет
Apache Tomcat обычно запускается автоматически после установки. Если этого не произошло, перейдите в папку bin и запустите startup.bat.
Первоначальная установка¶
Шаг 1: Настройка репозитория digna¶
Репозиторий digna хранит все метрики, вычисляемые digna. Он служит центральной базой данных для аналитических и служебных данных.
Создание схемы репозитория и пользователя¶
Откройте ваш клиент PostgreSQL (pgAdmin, psql или аналогичный) и выполните следующие SQL-команды:
CREATE SCHEMA <digna_repo_schema>;
CREATE USER <digna_repo_user> WITH PASSWORD '<digna_repo_password>';
GRANT ALL PRIVILEGES ON SCHEMA <digna_repo_schema> TO <digna_repo_user>;
Замените следующие заполнители:
<digna_repo_schema>— желаемое имя схемы (например,dignarepo)<digna_repo_user>— желаемое имя пользователя (например,digna_user)<digna_repo_password>— надёжный пароль для этого пользователя
Пример:
CREATE SCHEMA dignarepo;
CREATE USER digna_user WITH PASSWORD 'YourSecurePassword123!';
GRANT ALL PRIVILEGES ON SCHEMA dignarepo TO digna_user;
Рекомендация
Используйте сложные пароли для пользователей базы данных. Избегайте легко угадываемых учётных данных.
Шаг 2: Распакуйте установочный пакет digna¶
- Найдите ZIP-файл установщика digna, предоставленный вам
- Распакуйте его в желаемый каталог установки
- После распаковки вы должны увидеть следующие элементы:
dashboard/— веб-интерфейсdigna— основной исполняемый файл (backend + CLI в одном)
Файлы конфигурации и лицензии не входят в пакет
Ни config.toml, ни dashboard/dashboard_config.toml не поставляются вместе с установкой — вы создаёте оба файла самостоятельно, в разделах Конфигурация backend и Конфигурация Dashboard. license.toml тоже не поставляется; digna предоставляет его отдельно, как описано в шаге 3.
Шаг 3: Установите файл лицензии¶
Важно
Файл лицензии не включён в установочный пакет и предоставляется отдельно компанией digna.
- Найдите предоставленный вам файл
license.toml - Скопируйте его в корневой каталог установки digna (где находятся
config.tomlи исполняемый файлdigna)
Почему это важно: Файл лицензии содержит информацию о заказчике, дате окончания лицензии и цифровую подпись. Не изменяйте этот файл — любые изменения сделают его недействительным.
Структура каталогов после настройки:
digna_installation/
├── config.toml (configuration file)
├── license.toml (YOUR LICENSE FILE - copy here)
├── digna (main executable)
└── dashboard/ (web interface)
└── (dashboard files)
Конфигурация 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, если ключ отсутствует.
| Параметр | Значение | Примечания |
|---|---|---|
DIGNA_ENCRYPTION_KEY | Ключ в кодировке Base64 | Шифрует конфиденциальные значения, хранящиеся в репозитории digna |
Защитите config.toml
Этот ключ — фиксированное значение, одинаковое во всех установках digna, и именно он расшифровывает конфиденциальные значения вашего репозитория. Ограничьте доступ к config.toml учётной записью, под которой работает digna, держите файл вне системы контроля версий и общих дисков и исключите его из любой резервной копии, которая хранится менее защищённо, чем сам репозиторий.
Раздел [logging]¶
Этот раздел настраивает поведение логирования:
| Параметр | Значение | Примечания |
|---|---|---|
DIGNA_LOGGING_MODE | INFO или DEBUG | INFO для production, DEBUG для отладки. Также принимаются TRACE, WARN и ERROR |
DIGNA_LOGGING_DIR | logs (по умолчанию) | Необязательно. Каталог для файлов логов с ротацией, относительно рабочего каталога |
DIGNA_LOGGING_MAX_FILES | 30 (по умолчанию) | Необязательно. Количество хранимых файлов логов после ротации |
Сохраняйте каталог логов при работе в качестве службы
У службы 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:
Этот раздел нужен, только если хотя бы одно подключение к базе данных использует digna Engine или проверка ссылочной целостности сравнивает источники данных на разных подключениях.
Шаг 2: Проверьте конфигурацию¶
Перед инициализацией репозитория убедитесь, что config.toml полон и корректно построен. В каталоге установки digna выполните:
Каждый раздел проверяется отдельно, поэтому одна ошибка не скрывает состояние остальных:
Configuration validation report (source: config.toml):
- App config: OK
- Repository config: OK
- Base config: OK
- Logging config: OK
- Encryption config: OK
- OIDC config(s): OK
- Template overrides: OK
- Unknown keys: OK
Overall: OK
Исправьте всё, о чём сообщено как FAILED, и выполните команду ещё раз, прежде чем продолжить. WARNING в пункте Unknown keys перечисляет ключи в config.toml, которые digna не считывает; они ни на что не влияют, поэтому удалите их или исправьте их написание. Полный список параметров приведён в справочнике CLI.
Шаг 3: Инициализируйте репозиторий¶
- Откройте Command Prompt
- Перейдите в каталог установки digna (где находятся
config.tomlи исполняемый файлdigna) - Проверьте подключение:
Для новой схемы команда подключается и затем сообщает, что репозиторий ещё не установлен:
На этом этапе это ожидаемый результат: он подтверждает, что digna достигает PostgreSQL и схемы. Ошибка подключения или аутентификации, напротив, указывает на раздел [repo] или на настройку PostgreSQL.
Шаг 4: Установите схему репозитория¶
В том же каталоге выполните:
Эта команда устанавливает необходимые таблицы в схеме репозитория и завершается сообщением:
repo upgrade устанавливает и обновляет
Начиная с Release 2026.11, repo upgrade устанавливает новый репозиторий и обновляет существующий. repo install по-прежнему работает как другое имя той же команды.
Шаг 5: Создайте пользователя с правами администратора¶
Пользователь-администратор создаётся непосредственно в схеме репозитория, поэтому сервер пока не обязательно запускать. В каталоге установки digna выполните:
Пример:
Это создаст пользователя с полными административными правами.
Рекомендация
Используйте надёжный пароль, содержащий большие и малые буквы, цифры и специальные символы.
Шаг 6: Запустите сервер digna¶
В каталоге установки digna запустите сервер:
Параметры: - --address — хостнейм/IP сервера (по умолчанию 127.0.0.1) - --port — порт сервера (по умолчанию 8000)
Когда сервер запущен, он выводит адрес, который прослушивает:
Сервер занимает терминал
serve выполняется на переднем плане и продолжает работать, пока вы не остановите его сочетанием Ctrl+C. Оставьте его работающим, пока завершаете настройку; чтобы вместо этого запускать его автоматически при загрузке, см. Запуск digna как службы Windows.
Конфигурация Dashboard¶
Шаг 1: Разверните Dashboard на веб-сервере¶
Dashboard digna считывает собственную конфигурацию из файла dashboard/dashboard_config.toml. Этот файл не поставляется вместе с установкой — вы создаёте его в каталоге dashboard/ рядом с файлами dashboard.
Его содержимое описано в разделе Единый вход (SSO), где этот файл и требуется: в нём задаются варианты входа, которые предлагает dashboard, а для мультиинстансных развертываний — подключение к backend.
Выберите ваш веб-сервер и выполните соответствующие шаги развертывания.
Развёртывание в IIS¶
- Откройте IIS Manager
-
Нажмите
Win + R, введитеinetmgr, нажмите Enter -
Создайте новый веб-сайт
- В левой панели правой кнопкой щёлкните Sites
-
Выберите Add Website...
-
Настройте сайт
- Site Name: Введите имя (например, "dignaDashboard")
- Physical Path: Нажмите Browse и выберите папку
dashboard -
Binding: Укажите IP-адрес и порт (по умолчанию 80 для HTTP, 443 для HTTPS)
-
Запустите сайт
- Нажмите OK, чтобы создать сайт
-
Правой кнопкой щёлкните новый сайт и выберите Start
-
Проверьте установку
- Откройте браузер
- Перейдите по
http://localhost(или по вашему URL) - Вы должны увидеть страницу входа в digna dashboard
Развёртывание в Apache Tomcat¶
- Скопируйте Dashboard в Tomcat
- Скопируйте папку
dashboardв директориюwebappsвашего Tomcat - При необходимости переименуйте (например, в
digna) -
Пример:
C:\Program Files\Apache Tomcat\webapps\digna -
Проверьте развёртывание
- Обновите или перезагрузите страницу управления Tomcat (http://localhost:8080)
-
Вы должны увидеть "digna" (или выбранное имя) в списке развернутых приложений
-
Доступ к Dashboard
- Откройте браузер
- Перейдите по адресу
http://localhost:8080/digna - Вы должны увидеть страницу входа в 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.
Установка службы¶
- Откройте Command Prompt от имени администратора
- Правой кнопкой щёлкните Command Prompt
-
Выберите "Запуск от имени администратора"
-
Перейдите в каталог установки digna
-
Зарегистрируйте службу
Укажите адрес и порт, если значения по умолчанию вам не подходят
install записывает адрес и порт в регистрацию службы, и служба привязывается именно к записанным значениям. По умолчанию это 127.0.0.1 и 8000, что допускает подключения только с самого компьютера. Dashboard на другом узле не сможет к нему подключиться, поэтому укажите адрес, на котором должен слушать backend:
Эти значения не считываются из config.toml. Чтобы изменить их позже, удалите службу и установите её заново с новыми значениями.
Служба регистрируется с автоматическим запуском, поэтому она будет запускаться вместе с Windows. Сразу после регистрации она не запускается — см. следующий раздел.
Параметры установки¶
| Параметр | По умолчанию | Назначение |
|---|---|---|
--name | digna | Имя, под которым регистрируется служба |
--display-name | digna | Имя, отображаемое в services.msc |
--description | digna data quality backend | Описание, отображаемое в services.msc |
--address | 127.0.0.1 | Адрес, к которому служба привязывает свой API |
--port | 8000 | Порт, к которому служба привязывает свой API |
--working-dir | каталог исполняемого файла digna | Каталог с файлами config.toml и license.toml, который служба делает своим рабочим каталогом |
--start-type | auto | auto — запуск вместе с Windows, manual — запуск только по запросу, disabled — служба зарегистрирована, но её запуск запрещён |
--account | LocalSystem | Учётная запись, от имени которой выполняется служба, например DOMAIN\user или .\user |
--password | Пароль учётной записи --account |
Запуск от имени доменной учётной записи
У LocalSystem нет сетевой идентичности, поэтому проверка подлинности Windows в SQL Server и любой доступ к сетевой папке завершатся ошибкой. Если службе нужен доступ к ресурсам от имени определённого пользователя, выполняйте установку с --account и --password.
Запуск и остановка службы¶
Чтобы запустить службу¶
Чтобы остановить службу¶
Совет
Всегда останавливайте службу перед обновлением файлов приложения.
Перенос службы в новый каталог¶
Если требуется переместить установку digna:
-
Остановите текущую службу и удалите её регистрацию
-
Переместите файлы приложения
-
Перенесите весь каталог установки digna в новое расположение
-
Зарегистрируйте службу заново из нового расположения
Повторите все значения --address, --port или --account, которые вы использовали в первый раз, — прежней регистрации больше нет.
- Запустите службу
Удаление службы¶
-
Остановите работающую службу
-
Удалите регистрацию службы
Сервер digna теперь удалён из списка служб Windows.
Обновление до новой версии¶
Этот раздел описывает обновление установки Release 2026.06 до Release 2026.11. Если ваша установка старше, сначала прочитайте раздел Обновление с выпуска старше 2026.06.
Перед обновлением¶
Обязательно создайте резервную копию репозитория digna
Перед обновлением выполните резервное копирование вашей базы данных (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 вашей текущей установки:
Служба остаётся зарегистрированной. Новый исполняемый файл занимает место старого в том же каталоге, поэтому регистрация по-прежнему указывает на правильный файл.
Если digna запущен на переднем плане, нажмите Ctrl+C в окне Command Prompt, где он работает.
Обновление с выпуска старше 2026.06
Выпуски до 2026.06 регистрировали службу с помощью batch-файлов. Остановите её и удалите регистрацию с помощью batch-файлов вашей текущей установки, прежде чем что-либо переименовывать в шаге 2:
Запишите учётную запись, от имени которой работала служба, а также адрес и порт, на которых она работала. В шаге 9 вы зарегистрируете службу заново.
Шаг 2: Резервное копирование текущей установки¶
В каталоге установки digna переименуйте исполняемый файл и папку dashboard текущей установки, чтобы новый выпуск можно было развернуть рядом с ними:
Сохраняйте digna_old.exe, пока не проверите обновление, а dashboard_old — пока не восстановите из неё свои файлы конфигурации (см. шаг 4). После этого оба можно удалить.
Обновление с выпуска старше 2026.06
Переименуйте папки dignabackend и dignacli вместо исполняемого файла: ren dignabackend dignabackend_old и ren dignacli dignacli_old. Release 2026.11 не использует ни одну из этих папок, как и папку bin с batch-файлами.
Шаг 3: Распакуйте и разверните новую версию¶
- Распакуйте новый ZIP-файл установки digna
- Скопируйте новый исполняемый файл
dignaи папкуdashboardв каталог установки
Важно
Ни config.toml, ни dashboard/dashboard_config.toml никогда не включаются в ZIP-архив установки — команда digna никогда не поставляет эти файлы. Поэтому обновление не затрагивает вашу существующую конфигурацию, а копии в переименованных папках *_old — единственные, которые у вас есть.
Шаг 4: Восстановите файлы конфигурации¶
Release 2026.11 не требует изменений в config.toml: файл, который работает с Release 2026.06, продолжает работать. Два изменения необязательны:
- Добавьте раздел
[duckdb], если подключения к базам данных должны использовать digna Engine, а его значения по умолчанию не подходят для вашего хоста. - Не указывайте раздел
[app], если обратный прокси обслуживает 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 полон:
Каждый раздел должен сообщить OK. Исправьте всё, о чём сообщено как FAILED, удалите ключи, перечисленные в пункте Unknown keys, и выполните команду ещё раз, прежде чем продолжить.
Шаг 7: Замените файл лицензии¶
Файл лицензии обычно переходит из одного выпуска в следующий. Release 2026.11 — исключение: он добавляет два лицензируемых модуля, digna Data Reconciliation и digna Agentic, а лицензия, выданная до 2026.11, их не содержит. Скопируйте license.toml, предоставленный командой digna для Release 2026.11, в каталог установки, заменив старый:
Не оставляйте прежнюю лицензию
С прежней лицензией digna запускается, но digna Data Reconciliation и digna MCP Server остаются отключёнными. Каждая команда, проверяющая лицензию, — user, inspection, repo — прерывается, не затрагивая репозиторий, если проверка не пройдена. Проверьте новую лицензию, прежде чем продолжить:
Шаг 8: Обновите схему репозитория¶
В каталоге установки digna выполните:
Release 2026.11 управляет схемой репозитория с помощью версионированных миграций. Первое обновление с прежнего выпуска приводит схему к последней версии прежней системы, записывает это как исходную точку, а затем применяет миграции Release 2026.11. Оно завершается так:
Все существующие данные сохраняются. Чтобы в любой момент увидеть состояние репозитория, выполните digna repo check: команда показывает последнюю применённую миграцию и все ожидающие применения.
digna не запускается с устаревшим репозиторием
Начиная с Release 2026.11, сервер отказывается запускаться, пока репозиторию требуется обновление, и сообщает об этом, например:
Выполните repo upgrade, прежде чем запускать сервер или службу.
Шаг 9: Перезапустите службы¶
Если digna работает как служба Windows, снова запустите её:
Если вы обновлялись с выпуска старше 2026.06 и удалили регистрацию службы в шаге 1, сначала зарегистрируйте её заново с помощью исполняемого файла digna:
Передайте в --address и --port значения, на которых работала старая служба, если только вам не нужны значения по умолчанию 127.0.0.1 и 8000. Добавьте --account и --password, если старая служба работала от имени доменной учётной записи. Полный список параметров см. в разделе Запуск digna как службы Windows.
Если вы запускаете вручную, перезапустите сервер:
Если вы используете IIS или Tomcat, перезапустите соответствующий веб-сервер.
Шаг 10: Проверьте корректность обновления¶
-
Проверьте выпуск нового исполняемого файла:
Первая строка должна быть
Release: 2026.11. -
Откройте digna dashboard и убедитесь, что интерфейс загружается корректно.
- Проверьте файлы в каталоге
logsкаталога установки на наличие ошибок. - Проверьте свои подключения к базам данных — см. Проверка подключения. После обновления с выпуска старше 2026.06 сначала переведите на ODBC каждое подключение, которое его ещё не использовало.
Чтобы начать работу с новыми модулями, см. digna Data Reconciliation, Подключение ИИ-агента для digna MCP Server и Место профилирования для digna Engine.