Guide d'installation Linux pour digna Release 2026.06¶

Release : 2026.06

Dernière mise à jour : 5 septembre 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 systemd
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 de données tels que les entrepôts, les lacs 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 éléments 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, offrant un moyen convivial d'interagir avec la plateforme digna et de visualiser les métriques de qualité des données.

Nouveautés de la Release 2026.06¶

Cette version apporte des capacités d'observabilité des données directement dans votre code, permettant aux développeurs de surveiller la qualité des données à la source. Consultez les release notes pour tous les détails.

Vous cherchez Windows ou macOS ?¶

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

Quelle distribution couvre ce guide ?¶

Les instructions sont rédigées pour les deux familles de serveurs les plus courantes. Lorsque les deux diffèrent, les deux commandes sont fournies :

• famille Debian — Debian, Ubuntu. Gestionnaire de paquets : apt.
• famille RHEL — Red Hat Enterprise Linux, Rocky Linux, AlmaLinux, Fedora. Gestionnaire de paquets : dnf.

Toute distribution moderne avec systemd fonctionnera ; seuls les noms de paquets et quelques chemins de configuration changent.

Exigences système¶

Avant de commencer l'installation, assurez-vous que votre système respecte les exigences minimales suivantes :

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 distribution et votre architecture¶

Plusieurs commandes de ce guide diffèrent entre les familles Debian et RHEL. Pour vérifier laquelle vous utilisez, lancez :

cat /etc/os-release
uname -m

• ID=ubuntu ou ID=debian — utilisez les commandes apt.
• ID=rhel, rocky, almalinux ou fedora — utilisez les commandes dnf.
• x86_64 ou aarch64 — l'architecture du paquet d'installation dont vous avez besoin.

Préparation avant l'installation¶

Avant d'installer digna, assurez-vous que deux prérequis clés sont en place :

1. Serveur PostgreSQL – pour stocker les métriques calculées et les données de performance
2. Serveur Web – pour héberger le Dashboard de digna

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

Actualisation de l'index des paquets¶

Mettez à jour vos listes de paquets avant d'installer quoi que ce soit :

sudo apt update

sudo dnf check-update

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 géré à distance, vous pouvez passer à la section suivante.

Installation de PostgreSQL¶

Étape 1 : Installer le paquet serveur¶

sudo apt install -y postgresql postgresql-contrib

sudo dnf install -y postgresql-server postgresql-contrib

Étape 2 : Initialiser le cluster de bases¶

Sur la famille Debian, le paquet crée et démarre automatiquement un cluster — passez à l'étape suivante.

Sur la famille RHEL, le cluster doit être créé explicitement :

sudo postgresql-setup --initdb

Étape 3 : Démarrer et activer le service¶

sudo systemctl enable --now postgresql

Cela démarre PostgreSQL immédiatement et le configure pour redémarrer automatiquement au démarrage.

Étape 4 : Vérifier l'installation¶

psql --version
sudo systemctl status postgresql

Vous devriez voir la version de PostgreSQL et un service active (running).

Étape 5 : Se connecter au serveur¶

Un paquet PostgreSQL Linux crée un compte système postgres qui possède le cluster. Connectez-vous via ce compte :

sudo -u postgres psql

Étape 6 : Confirmer le port¶

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

sudo -u postgres psql -c "SHOW port;"

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

Étape 7 : Autoriser l'authentification par mot de passe pour l'utilisateur digna¶

digna se connecte à PostgreSQL via TCP en tant que digna_user, ce qui nécessite l'authentification par mot de passe plutôt que par peer authentication. Vérifiez que votre pg_hba.conf le permet.

Localisez le fichier :

sudo -u postgres psql -c "SHOW hba_file;"

Ouvrez-le dans un éditeur et confirmez que les lignes TCP locales utilisent scram-sha-256 (ou md5 sur les serveurs plus anciens) plutôt que ident :

# TYPE  DATABASE  USER  ADDRESS         METHOD
host    all       all   127.0.0.1/32    scram-sha-256
host    all       all   ::1/128         scram-sha-256

Rechargez PostgreSQL après toute modification :

sudo systemctl reload postgresql

Étape 8 : Si PostgreSQL fonctionne sur une autre machine¶

Pour accepter les connexions depuis un hôte différent, définissez listen_addresses dans postgresql.conf et ajoutez une ligne host correspondante pour votre réseau dans pg_hba.conf :

listen_addresses = '*'

Ensuite, ouvrez le port dans le pare-feu et redémarrez le service :

sudo ufw allow 5432/tcp

sudo firewall-cmd --permanent --add-port=5432/tcp && sudo firewall-cmd --reload

sudo systemctl restart postgresql

Configuration du serveur Web¶

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

• nginx — léger et recommandé
• Apache httpd — alternative largement déployée

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 application monopage (single-page-application), afin qu'un rafraîchissement d'URL du tableau de bord ne retourne pas un 404
• Un type MIME .md, pour que les fichiers Markdown soient servis correctement

Configuration de nginx¶

Vue d'ensemble¶

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

Installation¶

sudo apt install -y nginx

sudo dnf install -y nginx

Démarrage de nginx¶

sudo systemctl enable --now nginx

Vérifier l'installation¶

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

Ouverture du pare-feu¶

Si le serveur est atteint depuis d'autres machines, autorisez le trafic HTTP :

sudo ufw allow 'Nginx Full'

sudo firewall-cmd --permanent --add-service=http && sudo firewall-cmd --reload

Configuration d'un site pour le tableau de bord¶

nginx inclut tous les fichiers de son répertoire conf.d pour les deux familles de distribution. Créez un fichier de configuration dédié pour digna à cet emplacement :

sudo nano /etc/nginx/conf.d/digna.conf

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

server {
    listen       80 default_server;
    listen       [::]:80 default_server;
    server_name  _;

    root   /opt/digna/dashboard;
    index  index.html;

    # Servir les fichiers Markdown avec le type MIME correct.
    types {
        text/markdown  md;
    }

    # Fallback pour application monopage : les chemins inconnus retournent index.html
    # au lieu d'un 404, afin que les routes du tableau de bord survivent à un rafraîchissement du navigateur.
    location / {
        try_files $uri $uri/ /index.html;
    }
}

Désactiver le site par défaut¶

Un seul bloc server peut être default_server pour un port. Sur la famille Debian, supprimez le site par défaut packagé pour qu'il ne rentre pas en conflit :

sudo rm /etc/nginx/sites-enabled/default

Sur la famille RHEL, commentez ou supprimez le bloc server { ... } à l'intérieur de /etc/nginx/nginx.conf.

Appliquer la configuration¶

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

sudo nginx -t
sudo systemctl reload nginx

Configuration d'Apache httpd¶

Vue d'ensemble¶

Apache httpd est disponible dans les dépôts par défaut de toutes les distributions prises en charge. Le paquet s'appelle apache2 dans la famille Debian et httpd dans la famille RHEL.

Installation¶

sudo apt install -y apache2

sudo dnf install -y httpd

Démarrage d'Apache¶

sudo systemctl enable --now apache2

sudo systemctl enable --now httpd

Vérifier l'installation¶

1. Ouvrez votre navigateur
2. Allez à http://localhost
3. Vous devriez voir la page par défaut Apache de la distribution

Requis : activer mod_rewrite¶

Le tableau de bord nécessite la réécriture d'URL.

Sur la famille Debian, activez le module et redémarrez :

sudo a2enmod rewrite
sudo systemctl restart apache2

Sur la famille RHEL, mod_rewrite est chargé par défaut. Confirmez-le :

httpd -M | grep rewrite

Requis : autoriser les overrides .htaccess¶

Ouvrez le fichier de configuration pour votre document root :

sudo nano /etc/apache2/apache2.conf

sudo nano /etc/httpd/conf/httpd.conf

Localisez le bloc <Directory> couvrant votre document root (/var/www/html sur les deux familles) et remplacez :

AllowOverride None

par :

AllowOverride All

Requis : type MIME pour les fichiers Markdown¶

Dans le même fichier, 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 systemctl restart apache2

sudo apachectl configtest
sudo systemctl restart httpd

Installation initiale¶

Étape 1 : Configurer le repository digna¶

Le repository 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 repository et l'utilisateur¶

Ouvrez votre client PostgreSQL (psql, pgAdmin ou similaire) 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 shell en une seule étape :

sudo -u postgres psql

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

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

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

Pour extraire depuis le shell :

sudo mkdir -p /opt/digna
sudo unzip digna-2026.06-linux-x86_64.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é conservé. Réglez-le explicitement :

cd /opt/digna
sudo chmod +x digna

Créer un compte de service¶

Il est recommandé d'exécuter le backend sous un utilisateur dédié sans privilèges pour les déploiements en production :

sudo useradd --system --no-create-home --shell /usr/sbin/nologin digna
sudo chown -R digna:digna /opt/digna

É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 de 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 la 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. Vous devez simplement le renommer en config.toml.

cd /opt/digna
sudo 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 les paramètres de l'application backend de 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 = ["*"]

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!"

sudo chown digna:digna /opt/digna/config.toml
sudo chmod 600 /opt/digna/config.toml

Section [base]¶

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

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

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 de journalisation :

[logging]
digna_LOGGING_MODE = "INFO"
digna_LOGGING_BACKUP_COUNT = 10

É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

Overall: OK

Corrigez tout ce qui est signalé comme FAILED et relancez la commande avant de continuer. La liste complète des options figure dans la référence CLI.

Étape 3 : Initialiser le repository¶

1. Ouvrez un terminal
2. Placez-vous dans votre répertoire d'installation digna (là où se trouvent config.toml et l'exécutable digna)
3. Lancez le test de connexion :

cd /opt/digna
./digna repo check

Vous devriez voir une confirmation que la connexion est établie (le repository lui‑même n'a pas encore été initialisé).

sudo ln -s /opt/digna/digna /usr/local/bin/digna

Étape 4 : Installer le schéma du repository¶

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

./digna repo install

Cette commande installe les tables et le schéma nécessaires dans votre base PostgreSQL.

Étape 5 : Créer un utilisateur administrateur¶

1. Ouvrez un nouveau terminal
2. Placez-vous dans votre répertoire d'installation digna
3. Exécutez la commande suivante pour créer un utilisateur admin :

./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 - --port — Port du serveur

Vous devriez voir des messages de démarrage confirmant que le serveur fonctionne :

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

sudo ufw allow 8082/tcp

sudo firewall-cmd --permanent --add-port=8082/tcp && sudo firewall-cmd --reload

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éploiement sur nginx¶

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

1. Confirmez le chemin
2. Ouvrez /etc/nginx/conf.d/digna.conf

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

4. Assurez-vous que le dossier est lisible

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

5. Rechargez nginx

   sudo nginx -t
   sudo systemctl reload nginx
   

6. Tester l'installation

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

Déploiement sur Apache httpd¶

1. Copiez le tableau de bord dans le document root

   sudo cp -R /opt/digna/dashboard /var/www/html/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 /var/www/html/digna/.htaccess

Collez ce qui suit :

RewriteEngine On
RewriteBase /digna/

# Servir les fichiers et répertoires existants tels quels.
RewriteCond %{REQUEST_FILENAME} -f [OR]
RewriteCond %{REQUEST_FILENAME} -d
RewriteRule ^ - [L]

# Tout le reste retombe sur le point d'entrée de l'application monopage.
RewriteRule ^ index.html [L]

1. Redémarrer Apache

   sudo systemctl restart apache2
   

   sudo systemctl restart httpd
   

2. Accéder au tableau de bord

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

Étape 2 : SELinux (famille RHEL uniquement)¶

Sur RHEL, Rocky, AlmaLinux et Fedora, SELinux est en mode enforcing par défaut et bloquera le serveur web qui tente de lire des fichiers en dehors de ses emplacements attendus. Vérifiez s'il est actif :

getenforce

Si le résultat est Enforcing et que vous servez le tableau de bord depuis /opt/digna/dashboard, étiquetez le répertoire pour que le serveur web puisse le lire :

sudo semanage fcontext -a -t httpd_sys_content_t "/opt/digna/dashboard(/.*)?"
sudo restorecon -Rv /opt/digna/dashboard

Exécution de digna en tant que service systemd¶

Pourquoi exécuter digna en tant que service ?¶

Exécuter le backend digna en tant que service systemd garantit qu'il :

• Démarre automatiquement au démarrage de la machine
• S'exécute en arrière-plan sans terminal ouvert
• Redémarre automatiquement en cas de crash
• Peut être géré via systemctl, le gestionnaire de services standard de Linux

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 systemd
• 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
sudo chmod +x *.sh

Installer le service¶

1. Ouvrez un terminal

2. Placez-vous 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 systemd 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 un terminal
2. Placez-vous dans /opt/digna/bin
3. Exécutez :

   sudo ./start_service.sh
   

Pour arrêter le service¶

1. Ouvrez un terminal
2. Placez-vous dans /opt/digna/bin
3. Exécutez :

   sudo ./stop_service.sh
   

Gérer le service avec systemctl¶

Une fois enregistré, le service peut également être contrôlé avec les commandes systemd standard depuis n'importe quel répertoire :

sudo systemctl start digna
sudo systemctl stop digna
sudo systemctl restart digna
sudo systemctl status digna

Vérifier le service¶

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

systemctl is-enabled digna
systemctl is-active digna

enabled signifie que le service démarre au démarrage ; active signifie qu'il est en cours d'exécution maintenant.

Voir les journaux du service¶

systemd capture tout ce que le backend écrit sur la console. Pour le lire :

sudo journalctl -u digna -n 100

Pour suivre le journal en direct pendant que vous reproduisez un problème :

sudo journalctl -u digna -f

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

Le fichier d'unité 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 systemd.

Mise à niveau vers une nouvelle version¶

Avant de mettre à niveau¶

Vérifiez d'abord toutes les connexions aux bases de données

À partir de la version 2026.06, digna atteint chaque technologie source via ODBC. Les versions précédentes offraient le choix entre un pilote propre à chaque technologie et ODBC, via le commutateur Use ODBC. L'équipe digna a décidé de s'appuyer uniquement sur ODBC, parce qu'une interface unique et standard apporte plus qu'un ensemble de pilotes sur mesure :

• Authentification — l'authentification fait partie d'ODBC ; une connexion peut donc utiliser tout ce que son pilote prend en charge : mots de passe, jetons et PAT, Kerberos et Active Directory, MFA et authentification unique via navigateur, identités cloud, certificats client et TLS. Les nouvelles méthodes arrivent avec une mise à jour du pilote, sans attendre une version de digna.
• Pilotes maintenus par les éditeurs de bases de données — le pilote de l'éditeur suit les nouvelles versions du serveur et les correctifs de sécurité, et vous pouvez le mettre à jour à votre propre rythme, indépendamment de digna.
• Une seule façon de tout configurer — chaque technologie est une liste de propriétés clé/valeur, avec la même interface, le même chiffrement des valeurs sensibles et le même dépannage, au lieu d'un jeu de champs différent par source.
• Réglage et portée — les options du pilote telles que les délais d'attente, les paramètres TLS, les proxys et la taille des lots sont disponibles pour toutes les sources, et toute technologie disposant d'un pilote ODBC conforme peut être connectée, y compris celles pour lesquelles digna ne publie pas de guide dédié.

Concrètement, le commutateur Use ODBC et les champs distincts hôte, port, base de données, utilisateur et mot de passe n'existent plus. Toute connexion qui n'utilise pas déjà ODBC doit être convertie à ODBC — il n'y a pas de conversion automatique, prévoyez-le donc avant la mise à niveau :

1. Passez en revue chaque connexion définie dans votre installation et relevez celles qui n'utilisent pas encore ODBC — chacune devra être reconfigurée.
2. Installez le pilote ODBC correspondant sur l'hôte digna — les connexions sont ouvertes depuis le serveur qui exécute le backend digna, et non depuis le navigateur. Voir Installer le pilote ODBC sur l'hôte digna.
3. Préparez les propriétés ODBC de chaque connexion concernée. Les guides par technologie indiquent, pour chaque source, un jeu de propriétés éprouvé.

Après la mise à niveau, convertissez chaque connexion concernée à ODBC et testez-la depuis le tableau de bord — voir Créer une connexion à une base de données et Tester une connexion.

La création d'une sauvegarde du repository digna est OBLIGATOIRE

Avant de mettre à niveau digna, sauvegardez votre repository (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 shell :

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

Processus de mise à niveau¶

Étape 1 : Arrêter le service digna¶

Si digna s'exécute en tant que service systemd, 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 de terminal.

Étape 2 : Sauvegarder l'installation actuelle¶

Dans votre répertoire d'installation digna, renommez les dossiers de votre installation actuelle afin que la nouvelle version puisse être déployée à côté :

cd /opt/digna
sudo mv dignabackend dignabackend_old

sudo mv dignacli dignacli_old

sudo mv dashboard dashboard_old

É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 la propriété du compte de service :

sudo chmod +x /opt/digna/digna
sudo chown -R digna:digna /opt/digna

Étape 4 : Restaurer vos fichiers de configuration¶

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

É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 (Ctrl+F5).

Étape 6 : Vérifier la configuration¶

Assurez-vous que le config.toml mis à jour 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 et relancez la commande avant de continuer.

Étape 7 : Remplacer le fichier de licence¶

Chaque release fait l'objet d'une licence distincte. Copiez le license.toml fourni par l'équipe digna pour cette release dans le répertoire d'installation, en remplaçant l'ancien :

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

./digna license check

Étape 8 : Mettre à niveau le schéma du repository¶

Placez-vous dans votre répertoire d'installation digna et exécutez :

cd /opt/digna
./digna repo upgrade

Cela met à jour le schéma PostgreSQL vers la dernière version tout en préservant toutes les données existantes.

Étape 9 : Redémarrer les services¶

Si vous l'exécutez en tant que service systemd :

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, rechargez le serveur web respectif :

sudo systemctl reload nginx

sudo systemctl restart apache2

Sur la famille RHEL, réappliquez l'étiquetage SELinux si le répertoire dashboard a été remplacé :

sudo restorecon -Rv /opt/digna/dashboard

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

1. Accédez au tableau de bord digna
2. Vérifiez que l'interface se charge correctement
3. Consultez les journaux du serveur pour détecter des erreurs :
4. Convertissez à ODBC chaque connexion qui ne l'utilisait pas encore, puis testez toutes les connexions — voir Tester une connexion

sudo journalctl -u digna -n 100