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

Релиз: 2026.11

Последнее обновление: 7 ноября 2026

Содержание¶

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

Введение¶

О digna¶

digna — это комплексная платформа на базе ИИ, разработанная для оптимизации управления качеством данных в различных средах, таких как хранилища данных (warehouses), озёра данных (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 и новый файл лицензии. Каждое из этих изменений описано в разделе об обновлении.

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

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

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

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

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

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

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

Как узнать архитектуру вашего компьютера¶

Некоторые пути в этом руководстве отличаются для Apple Silicon и Intel Mac. Чтобы узнать, какая у вас архитектура, откройте Terminal и выполните:

uname -m

• arm64 — Apple Silicon. Homebrew устанавливается в /opt/homebrew.
• x86_64 — Intel. Homebrew устанавливается в /usr/local.

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

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

1. Homebrew – менеджер пакетов, используемый для установки компонентов, описанных ниже
2. PostgreSQL Server – для хранения вычисляемых метрик и данных производительности
3. Web Server – для размещения digna Dashboard

Если эти компоненты ещё не установлены, следуйте разделам ниже, чтобы установить и настроить их.

Установка Homebrew¶

Homebrew — стандартный менеджер пакетов для macOS и используется в этом руководстве для установки PostgreSQL и nginx.

Шаг 1: Проверьте, установлен ли уже Homebrew¶

Откройте Terminal (нажмите Cmd + Space, введите Terminal, нажмите Enter) и выполните:

brew --version

Если возвращается номер версии, перейдите к разделу PostgreSQL Server Setup.

Шаг 2: Установите Homebrew¶

Если команда не найдена, установите Homebrew, следуя инструкциям на официальном сайте Homebrew. Установщик также установит Xcode Command Line Tools, если они ещё не установлены.

Шаг 3: Добавьте Homebrew в PATH¶

На Apple Silicon установщик выводит две команды для добавления Homebrew в окружение вашей оболочки. Выполните их, как указано, затем подтвердите:

brew --prefix

Это должно вывести /opt/homebrew на Apple Silicon или /usr/local на Intel.

Настройка PostgreSQL сервера¶

Если PostgreSQL уже установлен¶

Если PostgreSQL уже установлен и запущен на вашей локальной машине или вы используете управляемый удалённый сервер PostgreSQL, вы можете перейти к следующему разделу.

Варианты установки¶

macOS предлагает два простых способа установки PostgreSQL. Выберите один:

• Homebrew — установка через командную строку, рекомендуется для серверных развёртываний
• Postgres.app — графическая установка, удобная для локальной оценки

Установка PostgreSQL с помощью Homebrew¶

Шаг 1: Установите формулу PostgreSQL¶

brew install postgresql@16

Шаг 2: Добавьте PostgreSQL в PATH¶

Версионированные формулы PostgreSQL являются keg-only, что означает, что Homebrew не добавляет их команды в PATH автоматически. Добавьте их сами:

echo 'export PATH="'$(brew --prefix)'/opt/postgresql@16/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Шаг 3: Запустите сервис PostgreSQL¶

brew services start postgresql@16

Эта команда запустит PostgreSQL немедленно и настроит его на автоматический запуск при входе в систему.

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

psql --version

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

Шаг 5: Подключитесь к серверу¶

psql postgres

Шаг 6: Проверьте порт¶

Порт PostgreSQL по умолчанию — 5432. Чтобы подтвердить порт, на котором слушает сервер:

psql postgres -c "SHOW port;"

Запомните значение — оно понадобится при настройке backend digna.

Установка PostgreSQL с помощью Postgres.app¶

Если вы предпочитаете графическую установку:

1. Скачайте Postgres.app и перетащите его в папку Applications
2. Откройте приложение и нажмите Initialize, чтобы создать новый сервер
3. Следуйте инструкциям приложения, чтобы добавить его инструменты командной строки в PATH
4. Проверьте установку:

psql --version

Postgres.app также создаёт суперпользователя с именем вашей учётной записи macOS.

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

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

• nginx — устанавливается через Homebrew, рекомендуется
• Apache httpd — входит в состав macOS

Требуется установить и настроить только один из этих серверов.

Оба раздела настраивают два требования, от которых зависит dashboard:

• Переадресация для single-page-приложения, чтобы обновление URL dashboard не приводило к 404
• MIME-тип для .md, чтобы Markdown-файлы отдавались корректно

Настройка nginx¶

Обзор¶

nginx — это лёгкий высокопроизводительный веб-сервер, хорошо подходящий для обслуживания статического dashboard digna.

Установка¶

brew install nginx

Запуск nginx¶

brew services start nginx

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

1. Откройте браузер
2. Перейдите по адресу http://localhost:8080
3. Вы должны увидеть страницу приветствия nginx

Настройка сайта для dashboard¶

Конфигурация nginx от Homebrew включает все файлы в каталоге servers. Создайте отдельный файл конфигурации для digna там:

nano $(brew --prefix)/etc/nginx/servers/digna.conf

Вставьте следующее, заменив /path/to/digna/dashboard на фактический путь к вашей распакованной папке dashboard:

server {
    listen       8080;
    server_name  localhost;

    root   /path/to/digna/dashboard;
    index  index.html;

    # Serve Markdown files with the correct MIME type.
    types {
        text/markdown  md;
    }

    # Single-page-application fallback: unknown paths return index.html
    # instead of a 404, so dashboard routes survive a browser refresh.
    location / {
        try_files $uri $uri/ /index.html;
    }
}

Примените конфигурацию¶

Проверьте конфигурацию на синтаксические ошибки, затем перезапустите nginx:

nginx -t
brew services restart nginx

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

Обзор¶

macOS включает Apache httpd, поэтому установка не требуется. По умолчанию он отключён.

Запуск Apache¶

sudo apachectl start

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

1. Откройте браузер
2. Перейдите по адресу http://localhost
3. Вы должны увидеть сообщение "It works!"

Обязательно: включите mod_rewrite¶

Dashboard требует перенаправления URL. Откройте конфигурационный файл Apache:

sudo nano /etc/apache2/httpd.conf

Найдите следующую строку и уберите ведущий #, чтобы раскомментировать её:

LoadModule rewrite_module libexec/apache2/mod_rewrite.so

Обязательно: разрешите переопределения в .htaccess¶

В том же файле найдите блок <Directory "/Library/WebServer/Documents"> и измените:

AllowOverride None

на:

AllowOverride All

Обязательно: MIME-тип для файлов Markdown¶

Всё ещё в httpd.conf добавьте следующую строку, чтобы Markdown-файлы отдавались корректно:

AddType text/markdown .md

Примените конфигурацию¶

Проверьте конфигурацию на синтаксические ошибки, затем перезапустите Apache:

sudo apachectl configtest
sudo apachectl restart

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

Шаг 1: Настройка репозитория digna¶

Репозиторий digna хранит все метрики, вычисляемые digna. Он выступает в качестве центральной базы данных для аналитических и производительных данных.

Создание схемы репозитория и пользователя¶

Откройте ваш клиент PostgreSQL (psql, pgAdmin или аналогичный) и выполните следующие 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;

Чтобы выполнить эти команды из Terminal в один шаг:

psql postgres

Затем вставьте команды в приглашении postgres=# и введите \q для выхода.

Шаг 2: Распакуйте установочный пакет digna¶

1. Найдите ZIP-файл установки digna, предоставленный вам
2. Распакуйте его в желаемое место установки — например /opt/digna или ~/digna
3. После распаковки вы должны увидеть следующие элементы:
4. dashboard/ — веб-интерфейс dashboard
5. digna — основной исполняемый файл (backend + CLI в одном)

Чтобы распаковать через Terminal:

unzip digna-2026.11-macos.zip -d /opt/digna

Сделайте файл исполняемым¶

В зависимости от способа передачи архива, бит выполнения (executable bit) может не сохраниться при распаковке. Установите его явно:

cd /opt/digna
chmod +x digna

Если macOS блокирует приложение¶

Файлы, скачанные через браузер или почтовый клиент, помечаются атрибутом quarantine. Если macOS сообщает, что приложение "cannot be opened because the developer cannot be verified", снимите атрибут карантина с каталога установки:

xattr -dr com.apple.quarantine /opt/digna

Альтернативно, откройте System Settings → Privacy & Security, найдите заблокированный элемент в нижней части страницы и нажмите Open Anyway.

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

1. Найдите файл license.toml, предоставленный вам
2. Скопируйте его в корневой каталог установки digna (ту же папку, где находятся config.toml и исполняемый файл digna)

Почему это важно: Файл лицензии содержит информацию о заказчике, дату истечения лицензии и цифровую подпись. Не изменяйте этот файл — любые изменения аннулируют подпись и сделают файл недействительным.

Структура каталогов после настройки:

/opt/digna/
├── config.toml         (configuration file)
├── license.toml        (YOUR LICENSE FILE - copy here)
├── digna               (main executable)
├── bin/                (service management scripts)
└── dashboard/          (web interface)
    └── (dashboard files)

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

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

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

cd /opt/digna
mv config_template.toml config.toml

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

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

Раздел [app]¶

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

[app]
DIGNA_APP_CORS_ALLOW_ORIGINS = ["http://localhost:5173"]
DIGNA_APP_CORS_ALLOW_CREDENTIALS = true

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

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

Раздел [encryption]¶

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

[encryption]
DIGNA_ENCRYPTION_KEY = 'ycELf6IbcO55dYIZHpPv6kQv/bbnUXoIaHLh2bh1kMg='

Раздел [logging]¶

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

[logging]
DIGNA_LOGGING_MODE = "INFO"
DIGNA_LOGGING_DIR = "logs"
DIGNA_LOGGING_MAX_FILES = 30

Раздел [duckdb] (необязательный)¶

Новое в Release 2026.11. Этот раздел задаёт ресурсы digna Engine, который профилирует данные внутри digna для подключений к базам данных, местом профилирования которых является digna Engine, и выполняет проверки ссылочной целостности между источниками данных на разных подключениях к базам данных. См. Место профилирования.

Раздел необязателен. Без него действуют приведённые ниже значения по умолчанию.

[duckdb]
DIGNA_DUCKDB_MEMORY_LIMIT_MB = 1024
DIGNA_DUCKDB_TEMP_DIRECTORY = "/opt/digna/tmp"

mkdir -p /opt/digna/tmp

Шаг 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. Откройте Terminal
2. Перейдите в каталог установки digna (где находятся config.toml и исполняемый файл digna)
3. Выполните проверку подключения:

cd /opt/digna
./digna repo check

Для новой схемы команда подключается и затем сообщает, что репозиторий ещё не установлен:

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

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

echo 'export PATH="/opt/digna:$PATH"' >> ~/.zshrc
source ~/.zshrc

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

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

./digna repo upgrade

Эта команда устанавливает необходимые таблицы в схеме репозитория и завершается сообщением:

✅ Repo schema 'dignarepo' is up to date.

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

Пользователь-администратор создаётся непосредственно в схеме репозитория, поэтому сервер пока не обязательно запускать. В каталоге установки digna выполните:

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

Пример:

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

Это создаёт пользователя с адресом электронной почты admin@example.com и полными правами администратора.

Шаг 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

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

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

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

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

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

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

Если вы следовали разделу nginx Setup, блок сервера уже указывает на вашу папку dashboard и копирование не требуется.

1. Подтвердите путь
2. Откройте $(brew --prefix)/etc/nginx/servers/digna.conf

3. Убедитесь, что root указывает на распакованную папку dashboard

4. Убедитесь, что папка доступна для чтения

   chmod -R a+rX /opt/digna/dashboard
   

5. Перезагрузите nginx

   nginx -t
   brew services restart nginx
   

6. Проверьте установку

7. Откройте браузер
8. Перейдите по адресу http://localhost:8080 (или по вашему настроенному URL)
9. Вы должны увидеть страницу входа в digna dashboard

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

1. Скопируйте Dashboard в Document Root

   sudo cp -R /opt/digna/dashboard /Library/WebServer/Documents/digna
   

2. Добавьте правила переписывания (Rewrite Rules)

Создайте файл .htaccess внутри развернутой папки, чтобы маршруты dashboard не ломались при обновлении страницы:

sudo nano /Library/WebServer/Documents/digna/.htaccess

Вставьте следующее:

RewriteEngine On
RewriteBase /digna/

# Serve existing files and directories as-is.
RewriteCond %{REQUEST_FILENAME} -f [OR]
RewriteCond %{REQUEST_FILENAME} -d
RewriteRule ^ - [L]

# Everything else falls back to the single-page application entry point.
RewriteRule ^ index.html [L]

1. Перезапустите Apache

   sudo apachectl restart
   

2. Доступ к Dashboard

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

Запуск digna как фонового сервиса¶

Зачем запускать digna как сервис?¶

Запуск backend digna как фонового сервиса гарантирует, что он:

• Автоматически запускается при загрузке машины
• Работает в фоновом режиме без открытого окна Terminal
• Автоматически перезапускается при сбое
• Управляется через launchctl, менеджер сервисов macOS

Файлы управления сервисом¶

Все необходимые файлы находятся в каталоге установки digna в папке: bin/

Доступны следующие shell-скрипты:

• install_service.sh — регистрирует digna в launchd
• uninstall_service.sh — удаляет регистрацию сервиса
• start_service.sh — запускает зарегистрированный сервис
• stop_service.sh — останавливает запущенный сервис

Как сделать скрипты исполняемыми¶

При распаковке бит выполнения мог не сохраниться. Перед первым использованием:

cd /opt/digna/bin
chmod +x *.sh

Установка сервиса¶

1. Откройте Terminal

2. Перейдите в папку bin

   cd /opt/digna/bin
   

3. Запустите скрипт установки

   sudo ./install_service.sh
   

Сервис digna теперь зарегистрирован в launchd с включённым автоматическим запуском. Сервис не запускается сразу — см. следующий раздел для его запуска.

Запуск и остановка сервиса¶

Чтобы запустить сервис¶

1. Откройте Terminal
2. Перейдите в /opt/digna/bin
3. Выполните:

   sudo ./start_service.sh
   

Чтобы остановить сервис¶

1. Откройте Terminal
2. Перейдите в /opt/digna/bin
3. Выполните:

   sudo ./stop_service.sh
   

Проверка сервиса¶

Чтобы убедиться, что сервис зарегистрирован и запущен:

sudo launchctl list | grep digna

Строка, начинающаяся с идентификатора процесса, означает, что сервис запущен. - в первом столбце означает, что он зарегистрирован, но остановлен.

Перенос сервиса в новый каталог¶

launchd хранит абсолютный путь к исполняемому файлу, поэтому при переносе установки требуется повторная регистрация сервиса:

1. Удалите текущий сервис

   cd /old/path/digna/bin
   sudo ./uninstall_service.sh
   

2. Переместите файлы приложения

   sudo mv /old/path/digna /new/path/digna
   

3. Переустановите сервис

   cd /new/path/digna/bin
   sudo ./install_service.sh
   

4. Запустите сервис

   sudo ./start_service.sh
   

Удаление сервиса¶

1. Остановите запущенный сервис

   cd /opt/digna/bin
   sudo ./stop_service.sh
   

2. Удалите регистрацию сервиса

   sudo ./uninstall_service.sh
   

Сервис digna теперь удалён из launchd.

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

Этот раздел описывает обновление установки Release 2026.06 до Release 2026.11. Если ваша установка старше, сначала прочитайте раздел Обновление с выпуска старше 2026.06.

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

Создание резервной копии репозитория digna обязательно

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

Чтобы создать резервную копию из Terminal:

pg_dump -h localhost -p 5432 -U digna_user -n dignarepo postgres > digna_repo_backup.sql

Запрос файла лицензии для 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¶

Если digna запущен как фоновый сервис, сначала остановите его:

cd /opt/digna/bin
sudo ./stop_service.sh

Если digna запущен на переднем плане, нажмите Ctrl+C в окне Terminal, где он работает.

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

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

cd /opt/digna
mv digna digna_old
mv dashboard dashboard_old

Сохраняйте digna_old, пока не проверите обновление, а dashboard_old — пока не восстановите из неё свои файлы конфигурации (см. шаг 4). После этого оба можно удалить.

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

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

chmod +x /opt/digna/digna
xattr -dr com.apple.quarantine /opt/digna

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

cp dashboard_old/dashboard_config.toml dashboard/dashboard_config.toml

Release 2026.11 не требует изменений в config.toml: файл, который работает с Release 2026.06, продолжает работать. Два изменения необязательны:

• Добавьте раздел [duckdb], если подключения к базам данных должны использовать digna Engine, а его значения по умолчанию не подходят для вашего хоста.
• Не указывайте раздел [app], если обратный прокси обслуживает dashboard и backend под одним origin.

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

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

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

Шаг 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, в каталог установки, заменив старый:

cp /path/to/new/license.toml /opt/digna/license.toml

./digna license check

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

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

cd /opt/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: команда показывает последнюю применённую миграцию и все ожидающие применения.

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

Шаг 9: Перезапустите сервисы¶

Если вы используете фоновые сервисы:

cd /opt/digna/bin
sudo ./start_service.sh

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

cd /opt/digna
./digna serve --address <address> --port <port>

Если используется nginx или Apache, перезапустите соответствующий веб-сервер:

brew services restart nginx

sudo apachectl restart

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

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

   ./digna version
   

   Первая строка должна быть Release: 2026.11.

2. Откройте digna dashboard и убедитесь, что интерфейс загружается корректно.

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

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