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

Релиз: 2026.06

Последнее обновление: 5 сентября 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.06¶

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

Ищете 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.06-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]¶

Этот раздел настраивает параметры приложения digna backend:

[app]
digna_APP_CORS_ALLOW_ORIGINS = ["http://localhost:5173"]
digna_APP_CORS_ALLOW_CREDENTIALS = true
digna_APP_CORS_ALLOW_METHODS = ["*"]
digna_APP_CORS_ALLOW_HEADERS = ["*"]

Раздел [repo]¶

Этот раздел настраивает подключение к базе данных PostgreSQL:

[repo]
digna_REPO_HOST = "localhost"
digna_REPO_PORT = 5432
digna_REPO_DB = "postgres"
digna_REPO_SCHEMA = "dignarepo"
digna_REPO_USER = "digna_user"
digna_REPO_PASSWORD = "YourSecurePassword123!"

Раздел [base]¶

Этот раздел содержит параметры безопасности и cookie:

[base]
DIGNA_FERNET_KEY = "DU4a0yJ-OqvbKCL4hNQn_CsknH-V1vWmHZqBUl-AY44="
digna_COOKIE_DOMAIN = "localhost"
digna_COOKIE_PATH = "/"
digna_COOKIE_SECURE = false
digna_COOKIE_HTTPONLY = true
digna_COOKIE_SAME_SITE = "lax"
digna_TOKEN_EXPIRES_IN = 86400
digna_MAX_WORKERS = 4
DIGNA_SCHEDULER_MAX_DELAY = 100
DIGNA_CLEANUP_TIME = "12:00"

Раздел [encryption]¶

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

[encryption]
DIGNA_ENCRYPTION_KEY = 'ycELf6IbcO55dYIZHpPv6kQv/bbnUXoIaHLh2bh1kMg='

Раздел [logging]¶

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

[logging]
digna_LOGGING_MODE = "INFO"
digna_LOGGING_BACKUP_COUNT = 10

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

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

digna config check

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

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

Overall: OK

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

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

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

cd /opt/digna
./digna repo check

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

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

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

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

./digna repo install

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

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

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

./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 сервера - --port — порт сервера

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Шаг 1: Остановите сервис digna¶

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

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

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

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

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

cd /opt/digna
mv dignabackend dignabackend_old

mv dignacli dignacli_old

mv dashboard dashboard_old

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

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

[encryption]
DIGNA_ENCRYPTION_KEY = 'ycELf6IbcO55dYIZHpPv6kQv/bbnUXoIaHLh2bh1kMg='

[[oidc_clients]]
DIGNA_OIDC_KEY = 'microsoft'
DIGNA_OIDC_CLIENT_ID = '<client_id>'
DIGNA_OIDC_CLIENT_SECRET = '<client_secret>'
DIGNA_OIDC_REDIRECT_URI = 'http://localhost:3000/oidc/callback'
DIGNA_OIDC_CONFIGURATION_URL = 'https://login.microsoftonline.com/<tenant_id>/v2.0/.well-known/openid-configuration'

[oidc_clients.microsoft]
DIGNA_OIDC_CLIENT_ID = '<client_id>'
DIGNA_OIDC_CLIENT_SECRET = '<client_secret>'
DIGNA_OIDC_REDIRECT_URI = 'http://localhost:3000/oidc/callback'
DIGNA_OIDC_CONFIGURATION_URL = 'https://login.microsoftonline.com/<tenant_id>/v2.0/.well-known/openid-configuration'

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

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

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

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

./digna config check

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

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

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

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

./digna license check

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

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

cd /opt/digna
./digna repo upgrade

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

Шаг 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 dashboard
2. Убедитесь, что интерфейс загружается корректно
3. Проверьте журналы сервера на наличие ошибок
4. Переведите на ODBC каждое подключение, которое его ещё не использовало, затем проверьте все подключения — см. Проверка подключения