Посібник зі встановлення digna Release 2026.06 на macOS¶

Випуск: 2026.06

Останнє оновлення: 5 вересня 2026 р.

Зміст¶

1. Вступ
2. Системні вимоги
3. Підготовка до встановлення
4. Налаштування сервера PostgreSQL
5. Налаштування веб‑сервера
6. Початкове встановлення
7. Налаштування серверної частини
8. Налаштування панелі
9. Запуск digna як фонової служби
10. Оновлення до нового випуску

Вступ¶

Про digna¶

digna — це комплексна платформа на основі AI, призначена для оптимізації управління якістю даних у різних середовищах даних, таких як сховища даних (warehouses), озера даних (lakes) і lakehouses. Побудована з розрахунком на високу масштабованість та адаптивність, digna вирішує сучасні завдання роботи з даними завдяки автоматизації, моніторингу в реальному часі та виявленню аномалій.

digna складається з двох основних компонентів:

• digna: ядро застосунку, відповідальне за обробку даних і виконання перевірок якості. Воно поєднує серверну частину та інтерфейс командного рядка в одному виконуваному файлі, замінюючи окремі програми dignabackend і dignacli з попередніх випусків.
• dignadashboard: веб‑інтерфейс, розміщений на веб‑сервері, що забезпечує зручний спосіб взаємодії з платформою digna та візуалізації метрик якості даних.

Що нового в Release 2026.06¶

Цей випуск вбудовує можливості спостереження за даними безпосередньо у ваш код, що дає змогу розробникам контролювати якість даних на джерелі. Повні відомості див. у примітках до випуску.

Шукаєте Windows або Linux?¶

Цей посібник охоплює macOS. Для інших платформ див. Посібник зі встановлення на Windows або Посібник зі встановлення на Linux.

Системні вимоги¶

Перш ніж почати встановлення, переконайтеся, що ваша система відповідає таким мінімальним вимогам:

Варіанти встановлення бази даних¶

Якщо PostgreSQL уже встановлено: Ви можете додати нову базу даних для digna до наявного сервера PostgreSQL.

Якщо PostgreSQL встановлюється на тій самій машині, що й digna:

Перевірка архітектури¶

Кілька шляхів у цьому посібнику відрізняються для Mac з Apple Silicon і з Intel. Щоб перевірити, який у вас, відкрийте Terminal і виконайте:

uname -m

• arm64 — Apple Silicon. Homebrew встановлюється до /opt/homebrew.
• x86_64 — Intel. Homebrew встановлюється до /usr/local.

Підготовка до встановлення¶

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

1. Homebrew – менеджер пакетів, яким установлюються наведені нижче компоненти
2. Сервер PostgreSQL – для зберігання обчислених метрик і даних про продуктивність
3. Веб‑сервер – для розміщення панелі digna (digna Dashboard)

Якщо ці компоненти ще не налаштовано, скористайтеся наведеними нижче розділами, щоб установити та налаштувати їх.

Встановлення Homebrew¶

Homebrew — стандартний менеджер пакетів для macOS, який у всьому цьому посібнику використовується для встановлення PostgreSQL і nginx.

Крок 1: Перевірте, чи Homebrew уже встановлено¶

Відкрийте Terminal (натисніть Cmd + Space, введіть Terminal, натисніть Enter) і виконайте:

brew --version

Якщо повертається номер версії, перейдіть до розділу Налаштування сервера PostgreSQL.

Крок 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;"

Запишіть це значення — воно знадобиться під час налаштування серверної частини digna.

Встановлення PostgreSQL за допомогою Postgres.app¶

Якщо ви віддаєте перевагу графічному встановленню:

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

psql --version

Postgres.app також створює суперкористувача з іменем вашого облікового запису macOS.

Налаштування веб‑сервера¶

digna потребує веб‑сервера для розміщення панелі. Виберіть один із таких варіантів:

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

Потрібно встановити й налаштувати лише один із цих серверів.

Обидва розділи налаштовують дві речі, від яких залежить панель:

• Резервний маршрут для односторінкового застосунку (SPA fallback), щоб оновлення URL панелі не повертало 404
• Тип MIME для .md, щоб файли Markdown віддавалися коректно

Налаштування nginx¶

Огляд¶

nginx — легкий високопродуктивний веб‑сервер, що добре підходить для віддавання статичної панелі digna.

Встановлення¶

brew install nginx

Запуск nginx¶

brew services start nginx

Перевірте встановлення¶

1. Відкрийте браузер
2. Перейдіть за адресою http://localhost:8080
3. Ви повинні побачити сторінку привітання nginx

Налаштування сайту для панелі¶

Конфігурація 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¶

Огляд¶

Apache httpd входить до складу macOS, тож установлювати його не потрібно. За замовчуванням він вимкнений.

Запуск Apache¶

sudo apachectl start

Перевірте встановлення¶

1. Відкрийте браузер
2. Перейдіть за адресою http://localhost
3. Ви повинні побачити повідомлення "It works!"

Обов'язково: увімкніть mod_rewrite¶

Панель потребує перезапису 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/ — веб‑інтерфейс панелі
5. digna — основний виконуваний файл (серверна частина та CLI разом)

Щоб розпакувати з Terminal:

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

Зробіть файл виконуваним¶

Залежно від того, як передавався архів, біт виконання може не зберегтися після розпакування. Задайте його явно:

cd /opt/digna
chmod +x digna

Якщо macOS блокує застосунок¶

Файли, завантажені через браузер або поштовий клієнт, позначаються атрибутом карантину. Якщо macOS повідомляє, що застосунок «неможливо відкрити, оскільки не вдається перевірити розробника», зніміть цей атрибут із каталогу встановлення:

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)

Налаштування серверної частини¶

Крок 1: Створіть і відредагуйте файл конфігурації¶

Файл config_template.toml постачається у вашому каталозі встановлення digna. Потрібно лише перейменувати його на config.toml.

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

Розташування: /opt/digna/config.toml

Відкрийте config.toml у текстовому редакторі й налаштуйте кожен із наведених нижче розділів.

Розділ [app]¶

Цей розділ налаштовує параметри серверного застосунку digna:

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

Розділ [repo]¶

Цей розділ налаштовує підключення до бази даних PostgreSQL:

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

Розділ [base]¶

Цей розділ містить параметри безпеки та cookie:

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

Розділ [encryption]¶

Цей розділ містить ключ, яким шифруються конфіденційні значення, що зберігаються в репозиторії. Він обов'язковий — config check повідомляє про розділ [encryption] як FAILED, якщо ключа немає.

[encryption]
DIGNA_ENCRYPTION_KEY = 'ycELf6IbcO55dYIZHpPv6kQv/bbnUXoIaHLh2bh1kMg='

Розділ [logging]¶

Цей розділ налаштовує поведінку журналювання:

[logging]
digna_LOGGING_MODE = "INFO"
digna_LOGGING_BACKUP_COUNT = 10

Крок 2: Перевірте конфігурацію¶

Перед ініціалізацією репозиторію переконайтеся, що config.toml повний і правильно сформований. У каталозі встановлення digna виконайте:

./digna config check

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

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

Overall: OK

Виправте все, про що повідомлено як FAILED, і виконайте команду ще раз, перш ніж продовжувати. Повний перелік параметрів наведено в довіднику CLI.

Крок 3: Ініціалізуйте репозиторій¶

1. Відкрийте 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: Створіть користувача‑адміністратора¶

Користувач‑адміністратор створюється безпосередньо у схемі репозиторію, тож сервер поки що не мусить працювати. У каталозі встановлення 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 сервера - --port — порт сервера

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

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

Налаштування панелі¶

Крок 1: Розгорніть панель на веб‑сервері¶

Панель digna зчитує власну конфігурацію з dashboard/dashboard_config.toml. Цей файл не постачається разом зі встановленням — ви створюєте його в каталозі dashboard/ поруч із файлами панелі.

Його вміст описано в розділі Single Sign-On, і саме там цей файл і потрібен: він містить варіанти входу, які пропонує панель, а для розгортань із кількома екземплярами — підключення до серверної частини.

Виберіть свій веб‑сервер і виконайте відповідні кроки розгортання.

Розгортання в nginx¶

Якщо ви виконали кроки розділу Налаштування nginx, блок server уже вказує на вашу теку 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

Розгортання в Apache httpd¶

1. Скопіюйте панель до кореневого каталогу документів

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

2. Додайте правила перезапису

Створіть файл .htaccess у розгорнутій теці, щоб маршрути панелі зберігалися після оновлення сторінки в браузері:

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. Відкрийте панель

3. Відкрийте браузер
4. Перейдіть за адресою http://localhost/digna
5. Ви повинні побачити сторінку входу панелі digna

Запуск digna як фонової служби¶

Навіщо запускати digna як службу?¶

Запуск серверної частини digna як фонової служби гарантує, що вона:

• Автоматично запускається під час завантаження машини
• Працює у фоновому режимі без відкритого вікна Terminal
• Автоматично перезапускається в разі збою
• Керується через launchctl — менеджер служб macOS

Файли керування службою¶

Усі необхідні файли розташовані в каталозі встановлення digna, у підкаталозі bin/

Доступні такі скрипти оболонки:

• 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, 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, а потім перезавантажте сторінку з примусовим оновленням (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: Перезапустіть служби¶

Якщо digna працює як фонова служба:

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