Guide d'installation macOS pour digna Release 2026.11¶

Release : 2026.11

Dernière mise à jour : 7 novembre 2026

Table des matières¶

1. Introduction
2. Exigences système
3. Préparation avant l'installation
4. Configuration du serveur PostgreSQL
5. Configuration du serveur Web
6. Installation initiale
7. Configuration du backend
8. Configuration du tableau de bord
9. Exécution de digna en tant que service d'arrière-plan
10. Mise à niveau vers une nouvelle version

Introduction¶

À propos de digna¶

digna est une plateforme complète pilotée par l'IA conçue pour optimiser la gestion de la qualité des données dans divers environnements tels que les entrepôts, les data lakes et les lakehouses. Conçue pour être hautement évolutive et adaptable, digna répond aux défis modernes des données grâce à l'automatisation, à la surveillance en temps réel et à la détection d'anomalies.

digna se compose de deux composants principaux :

• digna : le cœur de l'application, chargé du traitement des données et de l'exécution des contrôles de qualité. Il réunit le backend et l'interface en ligne de commande dans un seul exécutable, remplaçant les programmes distincts dignabackend et dignacli des versions précédentes.
• dignadashboard : Une interface web hébergée sur un serveur web, fournissant un moyen convivial d'interagir avec la plateforme digna et de visualiser les indicateurs de qualité des données.

Nouveautés de la Release 2026.11¶

Cette version ajoute digna Data Reconciliation, digna Agentic avec le digna MCP Server, et le digna Engine, qui peut profiler les données au sein de digna et contrôler l'intégrité référentielle entre différentes technologies de bases de données. Consultez les notes de version pour tous les détails.

Pour une installation, cette version apporte un nouveau mécanisme de migration du référentiel, une section [duckdb] facultative dans config.toml pour le digna Engine, et un nouveau fichier de licence. La section sur la mise à niveau traite chacun de ces points.

Besoin d'un guide pour Windows ou Linux ?¶

Ce guide couvre macOS. Pour d'autres plateformes, consultez le Windows Installation Guide ou le Linux Installation Guide.

Exigences système¶

Avant de commencer l'installation, assurez-vous que votre système répond aux exigences minimales suivantes :

| Outils en ligne de commande | Xcode Command Line Tools (requis par Homebrew) |

Options d'installation de la base de données¶

Si PostgreSQL est déjà installé : Vous pouvez ajouter une nouvelle base de données pour digna à votre serveur PostgreSQL existant.

Si vous installez PostgreSQL sur la même machine que digna :

Vérifier votre architecture¶

Plusieurs chemins dans ce guide diffèrent entre les Mac Apple Silicon et Intel. Pour vérifier votre architecture, ouvrez Terminal et exécutez :

uname -m

• arm64 — Apple Silicon. Homebrew s'installe dans /opt/homebrew.
• x86_64 — Intel. Homebrew s'installe dans /usr/local.

Préparation avant l'installation¶

Avant d'installer digna, assurez-vous que trois prérequis essentiels sont en place :

1. Homebrew – le gestionnaire de paquets utilisé pour installer les composants ci-dessous
2. Serveur PostgreSQL – pour stocker les métriques calculées et les données de performance
3. Serveur Web – pour héberger le Dashboard digna

Si ces composants ne sont pas encore configurés, suivez les sections ci-dessous pour les installer et les configurer.

Installation de Homebrew¶

Homebrew est le gestionnaire de paquets standard pour macOS et est utilisé tout au long de ce guide pour installer PostgreSQL et nginx.

Étape 1 : Vérifier si Homebrew est déjà installé¶

Ouvrez Terminal (appuyez sur Cmd + Space, tapez Terminal, appuyez sur Entrée) et exécutez :

brew --version

Si un numéro de version est renvoyé, passez à la section Configuration du serveur PostgreSQL.

Étape 2 : Installer Homebrew¶

Si la commande n'a pas été trouvée, installez Homebrew en suivant les instructions sur le site officiel de Homebrew. L'installateur installe également les Xcode Command Line Tools s'ils ne sont pas déjà présents.

Étape 3 : Ajouter Homebrew à votre PATH¶

Sur Apple Silicon, l'installateur affiche deux commandes pour ajouter Homebrew à votre environnement shell. Exécutez-les comme indiqué, puis vérifiez :

brew --prefix

Cela doit afficher /opt/homebrew sur Apple Silicon ou /usr/local sur Intel.

Configuration du serveur PostgreSQL¶

Si vous avez déjà PostgreSQL¶

Si PostgreSQL est déjà installé et en cours d'exécution sur votre machine locale ou si vous utilisez un serveur PostgreSQL distant géré, vous pouvez passer à la section suivante.

Options d'installation¶

macOS propose deux façons simples d'installer PostgreSQL. Choisissez une seule :

• Homebrew — installation en ligne de commande, recommandée pour les déploiements serveur
• Postgres.app — installation graphique, pratique pour l'évaluation locale

Installation de PostgreSQL avec Homebrew¶

Étape 1 : Installer la formule PostgreSQL¶

brew install postgresql@16

Étape 2 : Ajouter PostgreSQL à votre PATH¶

Les formules PostgreSQL versionnées sont keg-only, ce qui signifie que Homebrew n'ajoute pas automatiquement leurs commandes à votre PATH. Ajoutez-les vous-même :

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

Étape 3 : Démarrer le service PostgreSQL¶

brew services start postgresql@16

Ceci démarre PostgreSQL immédiatement et le configure pour redémarrer automatiquement à chaque connexion.

Étape 4 : Vérifier l'installation¶

psql --version

Vous devriez voir la version de PostgreSQL si l'installation a réussi.

Étape 5 : Se connecter au serveur¶

psql postgres

Étape 6 : Confirmer le port¶

Le port PostgreSQL par défaut est 5432. Pour confirmer le port sur lequel votre serveur écoute :

psql postgres -c "SHOW port;"

Notez la valeur — vous en aurez besoin lors de la configuration du backend digna.

Installation de PostgreSQL avec Postgres.app¶

Si vous préférez une installation graphique :

1. Téléchargez Postgres.app et glissez-le dans votre dossier Applications
2. Ouvrez l'application et cliquez sur Initialize pour créer un nouveau serveur
3. Suivez les instructions de l'application pour ajouter ses outils en ligne de commande à votre PATH
4. Vérifiez l'installation :

psql --version

Postgres.app crée également un superutilisateur nommé d'après votre compte macOS.

Configuration du serveur Web¶

digna nécessite un serveur Web pour héberger le tableau de bord. Choisissez l'une des options suivantes :

• nginx — installé via Homebrew, recommandé
• Apache httpd — inclus avec macOS

Vous n'avez besoin d'installer et de configurer qu'un seul de ces serveurs.

Les deux sections configurent deux éléments dont dépend le tableau de bord :

• Un fallback pour les applications monopage, afin qu'actualiser une URL du tableau de bord n'entraîne pas un 404
• Un type MIME pour les fichiers .md, afin que les fichiers Markdown soient servis correctement

Configuration nginx¶

Vue d'ensemble¶

nginx est un serveur Web léger et performant bien adapté pour servir le tableau de bord statique digna.

Installation¶

brew install nginx

Démarrer nginx¶

brew services start nginx

Vérifier l'installation¶

1. Ouvrez votre navigateur
2. Accédez à http://localhost:8080
3. Vous devriez voir la page d'accueil nginx

Configurer un site pour le tableau de bord¶

La configuration nginx de Homebrew inclut tous les fichiers de son répertoire servers. Créez un fichier de configuration dédié pour digna là-bas :

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

Collez ce qui suit en remplaçant /path/to/digna/dashboard par le chemin réel vers votre dossier dashboard extrait :

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;
    }
}

Appliquer la configuration¶

Testez la configuration pour les erreurs de syntaxe, puis rechargez nginx :

nginx -t
brew services restart nginx

Configuration Apache httpd¶

Vue d'ensemble¶

macOS inclut Apache httpd, aucune installation n'est donc requise. Il est désactivé par défaut.

Démarrer Apache¶

sudo apachectl start

Vérifier l'installation¶

1. Ouvrez votre navigateur
2. Accédez à http://localhost
3. Vous devriez voir le message "It works!"

Requis : Activer mod_rewrite¶

Le tableau de bord requiert la réécriture d'URL. Ouvrez la configuration d'Apache :

sudo nano /etc/apache2/httpd.conf

Trouvez la ligne suivante et supprimez le # initial pour la décommenter :

LoadModule rewrite_module libexec/apache2/mod_rewrite.so

Requis : Autoriser les overrides .htaccess¶

Dans le même fichier, localisez le bloc <Directory "/Library/WebServer/Documents"> et changez :

AllowOverride None

en :

AllowOverride All

Requis : Type MIME pour les fichiers Markdown¶

Toujours dans httpd.conf, ajoutez la ligne suivante afin que les fichiers Markdown soient servis correctement :

AddType text/markdown .md

Appliquer la configuration¶

Vérifiez la configuration pour les erreurs de syntaxe, puis redémarrez Apache :

sudo apachectl configtest
sudo apachectl restart

Installation initiale¶

Étape 1 : Configurer le dépôt digna¶

Le dépôt digna stocke toutes les métriques calculées par digna. Il sert de base de données centrale pour les données analytiques et de performance.

Créer le schéma du dépôt et l'utilisateur¶

Ouvrez votre client PostgreSQL (psql, pgAdmin ou équivalent) et exécutez les commandes SQL suivantes :

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>;

Remplacez les paramètres suivants :

• <digna_repo_schema> — Le nom de schéma souhaité (par ex., dignarepo)
• <digna_repo_user> — Le nom d'utilisateur souhaité (par ex., digna_user)
• <digna_repo_password> — Un mot de passe sécurisé pour cet utilisateur

Exemple :

CREATE SCHEMA dignarepo;

CREATE USER digna_user WITH PASSWORD 'YourSecurePassword123!';

GRANT ALL PRIVILEGES ON SCHEMA dignarepo TO digna_user;

Pour exécuter ces commandes depuis le Terminal en une seule étape :

psql postgres

Puis collez les instructions à l'invite postgres=# et tapez \q pour sortir.

Étape 2 : Extraire le paquet d'installation digna¶

1. Localisez le fichier ZIP d'installation digna qui vous a été fourni
2. Extrayez-le à l'emplacement d'installation souhaité — par exemple /opt/digna ou ~/digna
3. Après extraction, vous devriez voir les éléments suivants :
4. dashboard/ — Interface Web du tableau de bord
5. digna — Exécutable principal (backend + CLI combinés)

Pour extraire depuis le Terminal :

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

Rendre l'exécutable exécutable¶

Selon la manière dont l'archive a été transférée, le bit exécutable peut ne pas avoir été préservé. Définissez-le explicitement :

cd /opt/digna
chmod +x digna

Si macOS bloque l'application¶

Les fichiers téléchargés via un navigateur ou un client mail sont marqués avec un attribut de quarantaine. Si macOS signale que l'application « cannot be opened because the developer cannot be verified », supprimez l'attribut de quarantaine du répertoire d'installation :

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

Alternativement, ouvrez System Settings → Privacy & Security, trouvez l'élément bloqué en bas de la page et cliquez sur Open Anyway.

Étape 3 : Installer le fichier de licence¶

1. Localisez le fichier license.toml qui vous a été fourni
2. Copiez-le dans le répertoire racine d'installation digna (là où se trouvent config.toml et l'exécutable digna)

Pourquoi c'est important : Le fichier de licence contient vos informations client, la date d'expiration de la licence et la signature numérique. Ne modifiez pas ce fichier — toute modification l'invalidera.

Arborescence après configuration :

/opt/digna/
├── config.toml         (fichier de configuration)
├── license.toml        (VOTRE FICHIER DE LICENCE - copiez-le ici)
├── digna               (exécutable principal)
├── bin/                (scripts de gestion du service)
└── dashboard/          (interface web)
    └── (fichiers du dashboard)

Configuration du backend¶

Étape 1 : Créer et éditer le fichier de configuration¶

Le fichier config_template.toml est fourni dans votre répertoire d'installation digna. Renommez-le simplement en config.toml.

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

Emplacement : /opt/digna/config.toml

Ouvrez config.toml dans un éditeur de texte et configurez chaque section ci-dessous.

Section [app]¶

Cette section configure le partage de ressources entre origines (CORS) entre le tableau de bord et le backend :

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

Section [repo]¶

Cette section configure la connexion à la base de données 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

Section [base]¶

Cette section contient les paramètres de sécurité, des cookies et des inspections :

[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

Section [encryption]¶

Cette section contient la clé utilisée pour chiffrer les valeurs sensibles stockées dans le référentiel. Elle est obligatoire — config check signale la section [encryption] comme FAILED si la clé est absente.

[encryption]
DIGNA_ENCRYPTION_KEY = 'ycELf6IbcO55dYIZHpPv6kQv/bbnUXoIaHLh2bh1kMg='

Section [logging]¶

Cette section configure le comportement des journaux :

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

Section [duckdb] (facultative)¶

Nouveauté de la Release 2026.11. Cette section définit les ressources du digna Engine, qui profile les données au sein de digna pour les connexions de base de données dont l'emplacement de profilage est digna Engine, et exécute les contrôles d'intégrité référentielle entre des sources de données situées sur des connexions de base de données différentes. Voir Emplacement de profilage.

La section est facultative. Sans elle, les valeurs par défaut ci-dessous s'appliquent.

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

mkdir -p /opt/digna/tmp

Étape 2 : Vérifier la configuration¶

Avant d'initialiser le référentiel, vérifiez que config.toml est complet et correctement formé. Depuis votre répertoire d'installation digna, exécutez :

./digna config check

Chaque section est validée séparément, de sorte qu'une seule erreur ne masque pas l'état des autres :

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

Corrigez tout ce qui est signalé comme FAILED et relancez la commande avant de continuer. Un WARNING sous Unknown keys liste les clés de config.toml que digna ne lit pas ; elles n'ont aucun effet, supprimez-les donc ou corrigez leur orthographe. La liste complète des options figure dans la référence CLI.

Étape 3 : Initialiser le dépôt¶

1. Ouvrez Terminal
2. Allez dans votre répertoire d'installation digna (là où se trouvent config.toml et l'exécutable digna)
3. Exécutez le test de connexion :

cd /opt/digna
./digna repo check

Sur un nouveau schéma, la commande se connecte puis signale qu'aucun référentiel n'est encore installé :

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

À ce stade, c'est le résultat attendu : il confirme que digna atteint PostgreSQL et le schéma. Une erreur de connexion ou d'authentification indique au contraire un problème dans la section [repo] ou dans la configuration de PostgreSQL.

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

Étape 4 : Installer le schéma du dépôt¶

Dans le même répertoire, exécutez :

./digna repo upgrade

Cette commande installe les tables nécessaires dans le schéma du référentiel et se termine par :

✅ Repo schema 'dignarepo' is up to date.

Étape 5 : Créer un utilisateur administrateur¶

1. Ouvrez une nouvelle fenêtre Terminal
2. Allez dans votre répertoire d'installation digna
3. Exécutez la commande suivante pour créer un utilisateur administrateur :

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

Exemple :

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

Ceci crée un utilisateur avec l'adresse e-mail admin@example.com et des privilèges administratifs complets.

Étape 6 : Démarrer le serveur digna¶

Dans le répertoire d'installation digna, démarrez le serveur avec :

./digna serve --address <host> --port <port>

Paramètres : - --address — Nom d'hôte/IP du serveur (par défaut 127.0.0.1) - --port — Port du serveur (par défaut 8000)

Une fois le serveur démarré, il affiche l'adresse sur laquelle il écoute :

Server running on http://127.0.0.1:8082

Configuration du tableau de bord¶

Étape 1 : Déployer le tableau de bord sur le serveur Web¶

Le tableau de bord digna lit sa propre configuration dans dashboard/dashboard_config.toml. Ce fichier n'est pas livré avec l'installation — vous le créez dans le répertoire dashboard/, à côté des fichiers du tableau de bord.

Son contenu est décrit sous Authentification unique (SSO), là où le fichier est également nécessaire : il contient les options de connexion proposées par le tableau de bord et, pour les déploiements multi‑instance, la connexion au backend.

Choisissez votre serveur Web et suivez les étapes de déploiement correspondantes.

Déployer sur nginx¶

Si vous avez suivi la section Configuration nginx, le bloc serveur pointe déjà vers votre dossier dashboard et aucune copie n'est requise.

1. Confirmer le chemin
2. Ouvrez $(brew --prefix)/etc/nginx/servers/digna.conf

3. Vérifiez que root pointe vers votre dossier dashboard extrait

4. S'assurer que le dossier est lisible

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

5. Recharger nginx

   nginx -t
   brew services restart nginx
   

6. Tester l'installation

7. Ouvrez votre navigateur
8. Accédez à http://localhost:8080 (ou votre URL configurée)
9. Vous devriez voir la page de connexion du tableau de bord digna

Déployer sur Apache httpd¶

1. Copier le tableau de bord dans la racine du document

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

2. Ajouter les règles de réécriture

Créez un fichier .htaccess dans le dossier déployé afin que les routes du tableau de bord survivent à un rafraîchissement du navigateur :

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

Collez ce qui suit :

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. Redémarrer Apache

   sudo apachectl restart
   

2. Accéder au tableau de bord

3. Ouvrez votre navigateur
4. Accédez à http://localhost/digna
5. Vous devriez voir la page de connexion du tableau de bord digna

Exécution de digna en tant que service d'arrière-plan¶

Pourquoi exécuter digna en tant que service ?¶

Exécuter le backend digna en tant que service d'arrière-plan garantit qu'il :

• Démarre automatiquement au démarrage de la machine
• S'exécute en arrière-plan sans fenêtre Terminal ouverte
• Redémarre automatiquement en cas de plantage
• Peut être géré via launchctl, le gestionnaire de services de macOS

Fichiers de gestion du service¶

Tous les fichiers nécessaires se trouvent dans le répertoire d'installation digna sous : bin/

Les scripts shell suivants sont disponibles :

• install_service.sh — Enregistre digna auprès de launchd
• uninstall_service.sh — Désenregistre le service
• start_service.sh — Démarre le service enregistré
• stop_service.sh — Arrête le service en cours d'exécution

Rendre les scripts exécutables¶

L'extraction peut ne pas préserver le bit exécutable. Avant la première utilisation :

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

Installer le service¶

1. Ouvrez Terminal

2. Allez dans le dossier bin

   cd /opt/digna/bin
   

3. Exécutez le script d'installation

   sudo ./install_service.sh
   

Le serveur digna est maintenant enregistré auprès de launchd avec le démarrage automatique activé. Le service ne démarre pas immédiatement — voir la section suivante pour le démarrer.

Démarrer et arrêter le service¶

Pour démarrer le service¶

1. Ouvrez Terminal
2. Allez dans /opt/digna/bin
3. Exécutez :

   sudo ./start_service.sh
   

Pour arrêter le service¶

1. Ouvrez Terminal
2. Allez dans /opt/digna/bin
3. Exécutez :

   sudo ./stop_service.sh
   

Vérifier le service¶

Pour confirmer que le service est enregistré et en cours d'exécution :

sudo launchctl list | grep digna

Une ligne commençant par un PID indique que le service est en cours d'exécution. Un - dans la première colonne signifie qu'il est enregistré mais arrêté.

Déplacer le service vers un nouveau répertoire¶

launchd stocke le chemin absolu vers l'exécutable, donc déplacer l'installation nécessite de réenregistrer le service :

1. Désinstaller le service actuel

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

2. Déplacer les fichiers de l'application

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

3. Réinstaller le service

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

4. Démarrer le service

   sudo ./start_service.sh
   

Désinstaller le service¶

1. Arrêter le service en cours d'exécution

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

2. Désinstaller le service

   sudo ./uninstall_service.sh
   

Le serveur digna est maintenant désenregistré de launchd.

Mise à niveau vers une nouvelle version¶

Cette section décrit la mise à niveau d'une installation de la Release 2026.06 vers la Release 2026.11. Si votre installation est plus ancienne, lisez d'abord Mise à niveau depuis une release antérieure à 2026.06.

Avant de mettre à niveau¶

La création d'une sauvegarde du référentiel digna est obligatoire

Avant de mettre à niveau digna, sauvegardez votre référentiel (PostgreSQL) pour vous protéger contre la perte de données. Une sauvegarde vous permet de restaurer en cas de problème inattendu pendant la mise à niveau.

Pour créer une sauvegarde depuis le Terminal :

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

Demander le fichier de licence de la Release 2026.11

La Release 2026.11 nécessite un nouveau license.toml. Demandez-le à l'équipe digna avant de commencer, et gardez-le à portée de main pour l'étape 7.

Mise à niveau depuis une release antérieure à 2026.06¶

La Release 2026.06 a apporté trois changements qui s'appliquent toujours lorsque vous mettez à niveau une installation plus ancienne directement vers la 2026.11 :

• ODBC uniquement. digna atteint chaque technologie source via ODBC. Toute connexion de base de données qui n'utilise pas encore ODBC doit être convertie à ODBC après la mise à niveau ; il n'y a pas de conversion automatique. Installez au préalable les pilotes ODBC sur l'hôte digna, voir Installer le pilote ODBC sur l'hôte digna, et préparez les propriétés de chaque connexion à partir des guides par technologie. Le connecteur Databricks Legacy n'existe plus ; migrez ces connexions vers le connecteur Databricks.
• Un seul exécutable. dignabackend et dignacli sont remplacés par l'exécutable unique digna, qui réunit le backend et la CLI.
• config.toml. La section [encryption] est obligatoire, et DIGNA_APP_HOST et DIGNA_APP_PORT ne sont plus lus : le serveur tire son adresse et son port de digna serve. Comparez votre fichier avec Configuration du backend.

Les étapes ci-dessous signalent les points où une installation plus ancienne demande une démarche différente. La mise à niveau du référentiel à l'étape 8 amène directement un référentiel de n'importe quelle release antérieure à la 2026.11.

Processus de mise à niveau¶

Étape 1 : Arrêter le service digna¶

Si digna s'exécute en tant que service d'arrière-plan, arrêtez-le d'abord :

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

Si digna s'exécute au premier plan, appuyez sur Ctrl+C dans sa fenêtre Terminal.

Étape 2 : Sauvegarder l'installation actuelle¶

Dans votre répertoire d'installation digna, renommez l'exécutable et le dossier du tableau de bord de votre installation actuelle, afin que la nouvelle version puisse être déployée à côté :

cd /opt/digna
mv digna digna_old
mv dashboard dashboard_old

Conservez digna_old jusqu'à ce que vous ayez vérifié la mise à niveau, et dashboard_old jusqu'à ce que vous en ayez restauré vos fichiers de configuration (voir l'étape 4). Vous pourrez ensuite supprimer les deux.

Étape 3 : Extraire et déployer la nouvelle version¶

1. Extrayez le nouveau fichier ZIP d'installation digna
2. Copiez le nouvel exécutable digna et le dossier dashboard vers votre répertoire d'installation
3. Restaurez le bit exécutable et, si nécessaire, supprimez l'attribut de quarantaine :

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

Étape 4 : Restaurer vos fichiers de configuration¶

cp dashboard_old/dashboard_config.toml dashboard/dashboard_config.toml

La Release 2026.11 ne nécessite aucune modification de config.toml : un fichier qui fonctionne avec la Release 2026.06 continue de fonctionner. Deux modifications sont facultatives :

• Ajoutez une section [duckdb] si des connexions de base de données doivent utiliser le digna Engine et que ses valeurs par défaut ne conviennent pas à votre hôte.
• Omettez la section [app] si un reverse proxy sert le tableau de bord et le backend sous une même origine.

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

Étape 5 : Recharger le serveur Web¶

Le tableau de bord est un ensemble de fichiers statiques ; votre serveur Web — ainsi que le navigateur — peut donc encore servir la version précédente. Rechargez ou redémarrez le serveur Web qui héberge le dossier dashboard, puis rechargez la page en forçant l'actualisation (Cmd+Shift+R).

Étape 6 : Vérifier la configuration¶

Assurez-vous que config.toml est complet avant de toucher au référentiel :

./digna config check

Chaque section doit être signalée OK. Corrigez tout ce qui est signalé comme FAILED, supprimez les clés listées sous Unknown keys, et relancez la commande avant de continuer.

Étape 7 : Remplacer le fichier de licence¶

Un fichier de licence est normalement repris d'une release à la suivante. La Release 2026.11 fait exception : elle ajoute deux modules sous licence, digna Data Reconciliation et digna Agentic, et une licence émise avant la 2026.11 ne les contient pas. Copiez le license.toml fourni par l'équipe digna pour la Release 2026.11 dans le répertoire d'installation, en remplaçant l'ancien :

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

./digna license check

Étape 8 : Mettre à niveau le schéma du référentiel¶

Dans votre répertoire d'installation digna, exécutez :

cd /opt/digna
./digna repo upgrade

La Release 2026.11 gère le schéma du référentiel au moyen de migrations versionnées. La première mise à niveau depuis une release antérieure amène le schéma à la dernière version de l'ancien mécanisme, enregistre cet état comme point de départ, puis applique les migrations de la Release 2026.11. Elle se termine par :

✅ Baseline migration recorded as applied.
✅ Repo schema 'dignarepo' is up to date.

Toutes les données existantes sont préservées. Pour connaître l'état du référentiel à tout moment, exécutez ./digna repo check : la commande liste la dernière migration appliquée et celles qui sont encore en attente.

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

Étape 9 : Redémarrer les services¶

Si vous l'exécutez en tant que service d'arrière-plan :

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

Si vous l'exécutez manuellement, redémarrez le serveur :

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

Si vous utilisez nginx ou Apache, redémarrez le serveur web correspondant :

brew services restart nginx

sudo apachectl restart

Étape 10 : Vérifier la mise à niveau¶

1. Vérifiez la release du nouvel exécutable :

   ./digna version
   

   La première ligne doit indiquer Release: 2026.11.

2. Accédez au tableau de bord digna et vérifiez que l'interface se charge correctement.

3. Consultez la sortie du serveur et les fichiers du répertoire logs pour détecter des erreurs.
4. Testez vos connexions de base de données — voir Tester une connexion. Après une mise à niveau depuis une release antérieure à 2026.06, convertissez d'abord à ODBC chaque connexion qui ne l'utilisait pas encore.

Pour commencer avec les nouveaux modules, voir digna Data Reconciliation, Connecter un agent IA pour le digna MCP Server, et Emplacement de profilage pour le digna Engine.