Aller au contenu

Guide d'installation Windows pour digna Release 2026.06

Release : 2026.06

Dernière mise à jour : 30 août 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écuter digna en tant que service Windows
  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 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, 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. Voir les notes de version pour les détails complets.

Vous cherchez macOS ou Linux ?

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


Exigences système

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

Exigence Spécification
Système d'exploitation Windows Server ou Windows 10/11
Mémoire (Configuration minimale) 16 Go de RAM
Espace disque 10 Go d'espace disponible
Base de données PostgreSQL Server 12 ou supérieur
Serveur Web IIS, Apache Tomcat, ou équivalent

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 :

Spécifications recommandées

  • Mémoire : 32 Go de RAM (au lieu de 16 Go)
  • Espace disque : 50 Go d'espace disponible (au lieu de 10 Go)

Ces spécifications supérieures permettent d'héberger à la fois digna et la base de données PostgreSQL simultanément.


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 digna

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


Configuration du serveur PostgreSQL

Si PostgreSQL est déjà présent

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.

Installation de PostgreSQL

Suivez ces étapes pour installer PostgreSQL sur Windows :

Étape 1 : Télécharger PostgreSQL

  1. Visitez la page de téléchargements PostgreSQL
  2. Sélectionnez Windows
  3. Téléchargez le dernier installateur

Étape 2 : Exécuter l'installateur

  1. Double-cliquez sur le fichier d'installation téléchargé
  2. Suivez les invites de l'assistant d'installation

Étape 3 : Choisir le répertoire d'installation

Sélectionnez le répertoire où PostgreSQL sera installé. L'emplacement par défaut est généralement approprié.

Étape 4 : Sélectionner les composants

Pour une installation standard, conservez les options de composants par défaut.

Étape 5 : Définir le mot de passe du superutilisateur PostgreSQL

Saisissez et confirmez un mot de passe pour le superutilisateur PostgreSQL (postgres). Conservez ce mot de passe en lieu sûr — vous en aurez besoin plus tard.

Étape 6 : Configurer le numéro de port

Le port PostgreSQL par défaut est 5432. Vous pouvez utiliser le port par défaut ou spécifier un port différent si nécessaire.

Astuce

Si le port 5432 est déjà utilisé, choisissez un port alternatif et notez-le pour la configuration ultérieure.

Étape 7 : Choisir la locale

Sélectionnez la locale pour votre base de données. Le paramètre par défaut convient généralement à la plupart des installations.

Étape 8 : Terminer l'installation

Cliquez sur Suivant pour les étapes restantes, puis cliquez sur Terminer.

Étape 9 : Vérifier l'installation

Ouvrez l'Invite de commandes et vérifiez que PostgreSQL est installé :

psql --version

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


Configuration du serveur Web

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

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

Configuration IIS

Présentation

Internet Information Services (IIS) est le serveur web de Microsoft pour héberger des sites web et des applications web.

Activation d'IIS

  1. Ouvrir le Panneau de configuration
  2. Appuyez sur Win + R
  3. Tapez control et appuyez sur Entrée

  4. Accéder aux fonctionnalités Windows

  5. Cliquez sur Programmes
  6. Sélectionnez Activer ou désactiver des fonctionnalités Windows

  7. Activer Internet Information Services

  8. Faites défiler et trouvez Internet Information Services (IIS)
  9. Cochez la case pour l'activer
  10. Cliquez sur le + pour développer et vérifiez que ces sous-composants sont sélectionnés :

    • Web Management Tools
    • World Wide Web Services
  11. Cliquez sur OK pour appliquer les modifications

  12. Vérifier l'installation d'IIS

  13. Ouvrez votre navigateur
  14. Accédez à http://localhost
  15. Vous devriez voir la page de bienvenue IIS

Requis : Module URL Rewrite

IIS nécessite le composant URL Rewrite. Téléchargez et installez-le depuis la page officielle Microsoft.

Requis : Type MIME pour les fichiers Markdown

Pour que les fichiers Markdown (.md) soient servis correctement par IIS :

  1. Ouvrez IIS Manager (appuyez sur Win + R, tapez inetmgr, appuyez sur Entrée)
  2. Naviguez vers Votre site > MIME Types
  3. Cliquez sur Add...
  4. Configurez :
  5. File name extension : .md
  6. MIME type : text/markdown

Important

Sans ce paramétrage, les fichiers .md peuvent ne pas être servis correctement.


Configuration Apache Tomcat

Présentation

Apache Tomcat est un conteneur de servlets Java open-source et un serveur web.

Installation

  1. Télécharger Apache Tomcat
  2. Visitez Apache Tomcat Downloads
  3. Téléchargez la distribution ZIP pour Windows

  4. Extraire l'archive

  5. Extrayez le fichier ZIP dans un répertoire sur votre système
  6. Exemple : C:\Program Files\Apache Tomcat

  7. Vérifier que Tomcat fonctionne

  8. Ouvrez votre navigateur
  9. Accédez à http://localhost:8080
  10. Vous devriez voir la page de bienvenue Apache Tomcat

Astuce

Apache Tomcat démarre généralement automatiquement après l'installation. S'il ne démarre pas, naviguez vers le dossier bin et exécutez startup.bat.


Installation initiale

Étape 1 : Préparer le repository digna

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

Créer le schéma du repository et l'utilisateur

Ouvrez votre client PostgreSQL (pgAdmin, psql 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 espaces réservés 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;

Bonne pratique

Utilisez des mots de passe forts et complexes pour les utilisateurs de la base de données. Évitez les identifiants faciles à deviner.


É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é
  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)

Les fichiers de configuration et de licence ne font pas partie du paquet

Ni config.toml ni dashboard/dashboard_config.toml ne sont livrés avec l'installation — vous créez les deux vous-même, dans Configuration du backend et Configuration du tableau de bord. license.toml n'est pas livré non plus ; digna le fournit séparément, comme le décrit l'étape 3.

Étape 3 : Installer le fichier de licence

Important

Le fichier de licence n'est pas inclus dans le paquet d'installation et vous sera fourni séparément par digna.

  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.

Structure du répertoire après la configuration :

digna_installation/
├── config.toml         (fichier de configuration)
├── license.toml        (VOTRE FICHIER DE LICENCE - copiez-le ici)
├── digna               (exécutable principal)
└── 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.

Emplacement : digna_installation/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 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 = ["*"]
Paramètre Valeur Remarques
digna_APP_CORS_ALLOW_ORIGINS URL du frontend Si le dashboard est sur un serveur différent, incluez son URL
digna_APP_CORS_ALLOW_CREDENTIALS true Requis pour CORS avec identifiants
digna_APP_CORS_ALLOW_METHODS ["*"] Autorise toutes les méthodes HTTP
digna_APP_CORS_ALLOW_HEADERS ["*"] Autorise tous les en-têtes

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!"
Paramètre Valeur Remarques
digna_REPO_HOST localhost ou IP Nom d'hôte/IP du serveur PostgreSQL
digna_REPO_PORT 5432 (par défaut) Port PostgreSQL
digna_REPO_DB postgres Nom de la base de données
digna_REPO_SCHEMA dignarepo Schéma créé précédemment
digna_REPO_USER digna_user Utilisateur créé lors de la configuration PostgreSQL
digna_REPO_PASSWORD Votre mot de passe Mot de passe défini lors de la création du schéma

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"
Paramètre Valeur Remarques
DIGNA_FERNET_KEY Clé de chiffrement Utilisée pour chiffrer les tokens et les cookies (valeur par défaut fournie)
digna_COOKIE_DOMAIN localhost Doit correspondre au domaine de votre frontend
digna_COOKIE_SECURE false (local) / true (production) Utilisez true pour les connexions HTTPS
digna_COOKIE_HTTPONLY true Toujours activé pour la sécurité
digna_COOKIE_SAME_SITE lax Aide à prévenir les attaques CSRF
digna_TOKEN_EXPIRES_IN 86400 (24 heures) Durée de session en secondes
digna_MAX_WORKERS Nombre de coeurs CPU - 1 Nombre de tâches d'inspection parallèles
DIGNA_SCHEDULER_MAX_DELAY 100 Délai maximal, en secondes, que le planificateur peut ajouter avant de démarrer une tâche due
DIGNA_CLEANUP_TIME "12:00" Heure (format 24 h HH:MM) à laquelle démarre le nettoyage quotidien

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='
Paramètre Valeur Notes
DIGNA_ENCRYPTION_KEY Clé encodée en Base64 Chiffre les valeurs sensibles stockées dans le référentiel digna

Protéger config.toml

Cette clé est une valeur fixe, identique dans toutes les installations digna, et c'est elle qui déchiffre les valeurs sensibles de votre référentiel. Limitez l'accès à config.toml au compte qui exécute digna, gardez le fichier hors du gestionnaire de versions et des lecteurs partagés, et excluez-le de toute sauvegarde conservée de manière moins sûre que le référentiel lui-même.

Section [logging]

Cette section configure le comportement des logs :

[logging]
digna_LOGGING_MODE = "INFO"
digna_LOGGING_BACKUP_COUNT = 10
Paramètre Valeur Remarques
digna_LOGGING_MODE INFO ou DEBUG INFO pour la production, DEBUG pour le dépannage
digna_LOGGING_BACKUP_COUNT 10 Nombre de sauvegardes journalières des logs à conserver

É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 l'Invite de commandes
  2. Placez-vous dans le répertoire d'installation de digna (là où se trouvent config.toml et l'exécutable digna)
  3. Exécutez le test de connexion :
digna repo check

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

É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 de données PostgreSQL.

Étape 5 : Créer un utilisateur administrateur

  1. Ouvrez une fenêtre Invite de commandes nouvelle
  2. Placez-vous dans le répertoire d'installation de 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

Cela crée un utilisateur avec les privilèges administratifs complets.

Bonne pratique

Utilisez un mot de passe fort contenant un mélange de majuscules, minuscules, chiffres et caractères spéciaux.


Étape 6 : Démarrer le serveur digna

Dans le répertoire d'installation de 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

Le serveur occupe le terminal

serve s'exécute au premier plan et continue de tourner jusqu'à ce que vous l'arrêtiez avec Ctrl+C. Laissez-le tourner pendant que vous terminez la configuration ; pour le démarrer automatiquement au démarrage, voir Exécuter digna en tant que service Windows.

Configuration du tableau de bord

Étape 1 : Déployer le dashboard sur le serveur web

Le dashboard 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 dashboard.

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 dashboard 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 IIS

  1. Ouvrir IIS Manager
  2. Appuyez sur Win + R, tapez inetmgr, appuyez sur Entrée

  3. Créer un nouveau site Web

  4. Dans le panneau de gauche, faites un clic droit sur Sites
  5. Sélectionnez Add Website...

  6. Configurer le site Web

  7. Site Name : Entrez un nom (par ex., "dignaDashboard")
  8. Physical Path : Cliquez sur Parcourir et sélectionnez votre dossier dashboard
  9. Binding : Définissez l'adresse IP et le port (port 80 par défaut pour HTTP, 443 pour HTTPS)

  10. Démarrer le site

  11. Cliquez sur OK pour créer le site
  12. Faites un clic droit sur le nouveau site et sélectionnez Start

  13. Tester l'installation

  14. Ouvrez votre navigateur
  15. Accédez à http://localhost (ou l'URL configurée)
  16. Vous devriez voir la page de connexion du dashboard digna

Déploiement sur Apache Tomcat

  1. Copier le dashboard dans Tomcat
  2. Copiez le dossier dashboard dans le répertoire webapps de Tomcat
  3. Renommez-le si nécessaire (par ex., en digna)
  4. Exemple : C:\Program Files\Apache Tomcat\webapps\digna

  5. Vérifier le déploiement

  6. Actualisez ou rechargez la page de gestion Tomcat (http://localhost:8080)
  7. Vous devriez voir "digna" (ou le nom choisi) listé parmi les applications déployées

  8. Accéder au dashboard

  9. Ouvrez votre navigateur
  10. Accédez à http://localhost:8080/digna
  11. Vous devriez voir la page de connexion du dashboard digna

Exécuter digna en tant que service Windows

Pourquoi utiliser un service Windows ?

Exécuter le backend digna en tant que service Windows garantit qu'il : - Démarre automatiquement au démarrage du serveur - S'exécute en arrière-plan sans fenêtre Invite de commandes ouverte - Redémarre automatiquement en cas de crash - Peut être géré via les Services Windows

Les commandes windows

Le service est géré par l'exécutable digna lui-même, au moyen des sous-commandes digna windows. Il n'y a aucun fichier batch à exécuter.

Commande Rôle
digna windows install Enregistre digna en tant que service Windows
digna windows start Démarre le service enregistré
digna windows stop Arrête le service en cours d'exécution
digna windows uninstall Désenregistre le service

Administrateur requis

Les quatre commandes doivent être exécutées depuis une Invite de commandes ouverte en tant qu'administrateur.

Chaque commande accepte --name pour cibler un service enregistré sous un nom autre que celui par défaut. La liste complète des options figure dans la référence CLI.

Installation du service

  1. Ouvrir l'Invite de commandes en tant qu'administrateur
  2. Clic droit sur Invite de commandes
  3. Sélectionnez "Exécuter en tant qu'administrateur"

  4. Se placer dans votre répertoire d'installation digna

    cd C:\path\to\digna
    

  5. Enregistrer le service

    digna windows install
    

Indiquez l'adresse et le port, sauf si les valeurs par défaut vous conviennent

install inscrit l'adresse et le port dans l'enregistrement du service, et le service se lie exactement à ce qui a été inscrit. Les valeurs par défaut sont 127.0.0.1 et 8000, qui n'acceptent que les connexions provenant de la machine elle-même. Un dashboard situé sur un autre hôte ne peut pas l'atteindre ; indiquez donc l'adresse sur laquelle le backend doit écouter :

digna windows install --address 0.0.0.0 --port 8082

Ces valeurs ne sont pas lues depuis config.toml. Pour les modifier ultérieurement, désinstallez le service puis réinstallez-le avec les nouvelles valeurs.

Le service est enregistré avec démarrage automatique ; il démarrera donc avec Windows. Il ne démarre pas immédiatement — voir la section suivante.

Options d'installation

Option Valeur par défaut Rôle
--name digna Nom sous lequel enregistrer le service
--display-name digna Nom affiché dans services.msc
--description digna data quality backend Description affichée dans services.msc
--address 127.0.0.1 Adresse sur laquelle le service lie son API
--port 8000 Port sur lequel le service lie son API
--working-dir le répertoire de l'exécutable digna Répertoire contenant config.toml et license.toml, dont le service fait son répertoire de travail
--start-type auto auto démarre avec Windows, manual démarre uniquement sur demande, disabled enregistre le service mais refuse de le démarrer
--account LocalSystem Compte sous lequel exécuter le service, par exemple DOMAIN\user ou .\user
--password Mot de passe du compte indiqué par --account

Exécution sous un compte de domaine

LocalSystem n'a pas d'identité réseau : l'authentification Windows auprès de SQL Server et tout accès à un partage réseau échoueront donc. Installez le service avec --account et --password lorsqu'il doit accéder à des ressources en tant qu'utilisateur spécifique.

Démarrer et arrêter le service

Pour démarrer le service

digna windows start

Pour arrêter le service

digna windows stop

Astuce

Arrêtez toujours le service avant de mettre à jour les fichiers de l'application.

Déplacer le service vers un nouveau répertoire

Si vous devez déplacer l'installation digna :

  1. Arrêter et désenregistrer le service actuel

    cd C:\old\path\digna
    digna windows stop
    digna windows uninstall
    

  2. Déplacer les fichiers de l'application

  3. Déplacez l'ensemble du dossier d'installation digna vers le nouvel emplacement

  4. Enregistrer à nouveau le service depuis le nouvel emplacement

    cd C:\new\path\digna
    digna windows install
    

Reprenez les valeurs --address, --port ou --account que vous aviez utilisées la première fois — l'enregistrement précédent n'existe plus.

  1. Démarrer le service
    digna windows start
    

Désinstaller le service

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

    cd C:\path\to\digna
    digna windows stop
    

  2. Désenregistrer le service

    digna windows uninstall
    

Le serveur digna est maintenant désenregistré en tant que service Windows.


Mise à niveau vers une nouvelle version

Avant la mise à 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.

Connexions Databricks Legacy

Le connecteur Databricks Legacy a été supprimé dans cette version. Migrez ces connexions vers le connecteur Databricks.

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 les pertes de données. Une sauvegarde vous permet de récupérer en cas de problème inattendu lors de la mise à niveau.

Processus de mise à niveau

Étape 1 : Arrêter et désenregistrer l'ancien service

Si digna s'exécute en tant que service Windows, arrêtez-le à l'aide des fichiers batch de votre installation actuelle — les commandes digna windows appartiennent à la nouvelle version et ne sont pas encore disponibles :

cd C:\path\to\digna\bin
stop_service.bat

Désenregistrez ensuite le service, là encore avec l'ancien fichier batch. L'enregistrement pointe vers l'ancien exécutable et ses scripts, que cette mise à niveau remplace tous deux ; il ne peut donc pas être réutilisé :

uninstall_service.bat

Désenregistrez le service avant de renommer quoi que ce soit

uninstall_service.bat se trouve dans le dossier bin que vous êtes sur le point de renommer, et c'est le seul moyen de supprimer l'enregistrement qu'il a créé. Exécutez-le tant que l'ancienne installation est encore en place. Si le dossier a déjà été renommé, redonnez-lui son nom d'origine, désenregistrez le service, puis continuez.

Notez le compte sous lequel le service s'exécutait, ainsi que l'adresse et le port sur lesquels il servait — vous en aurez besoin à l'étape 9.

É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é :

# Rename the folder containing dignabackend
ren dignabackend dignabackend_old
# Rename the folder containing dignacli
ren dignacli dignacli_old
# Rename dashboard
ren dashboard dashboard_old

dignabackend et dignacli ne sont plus utilisés

À partir de la version 2026.06, dignabackend et dignacli sont remplacés par l'exécutable unique digna, qui réunit le backend et la CLI. Ne conservez dignabackend_old et dignacli_old que jusqu'à la vérification de la mise à niveau — vous pourrez ensuite supprimer les deux dossiers. Conservez dashboard_old jusqu'à ce que vous en ayez restauré vos fichiers de configuration (voir l'étape 4). Le dossier bin disparaît également : ses fichiers batch pilotaient l'ancien service et la version 2026.06 ne les livre plus ; une fois le service désenregistré à l'étape 1, ils ne servent plus qu'à induire en erreur.

É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 dans votre répertoire d'installation

Important

Ni config.toml ni dashboard/dashboard_config.toml ne sont jamais inclus dans le ZIP d'installation — l'équipe digna ne livre jamais aucun de ces deux fichiers. Votre configuration existante n'est donc pas touchée par la mise à niveau, et les copies se trouvant dans les dossiers renommés *_old sont les seules dont vous disposez.

Étape 4 : Restaurer vos fichiers de configuration

copy dashboard_old\dashboard_config.toml dashboard\dashboard_config.toml

La version 2026.06 modifie config.toml

Trois paramètres sont nouveaux et obligatoires, deux autres ne sont plus utilisés. Un config.toml repris d'une version précédente ne contient pas les nouveaux paramètres, et digna ne démarrera pas tant qu'ils seront absents. Ajoutez ce qui suit à votre config.toml existant :

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

[encryption]
DIGNA_ENCRYPTION_KEY = 'ycELf6IbcO55dYIZHpPv6kQv/bbnUXoIaHLh2bh1kMg='

Ajoutez les deux clés [base] à votre section [base] existante et ajoutez [encryption] comme nouvelle section. Supprimez ensuite de [app] les deux paramètres qui ne sont plus utilisés, digna_APP_HOST et digna_APP_PORT — le serveur tire désormais son adresse et son port de digna serve.

Le rôle de chaque paramètre est décrit dans Configuration du backend.

Authentification unique : le format de [oidc_clients] a changé

La version 2026.06 remplace le tableau de tables par une table par fournisseur, nommée d'après la clé du fournisseur. DIGNA_OIDC_KEY disparaît — la clé fait désormais partie de l'en-tête de section.

Avant :

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

Après :

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

Répétez la section pour chaque fournisseur, et gardez chaque clé identique au key défini dans dashboard_config.toml. digna config check signale oidc_clients comme FAILED tant que l'ancienne forme subsiste. Seules les installations qui utilisent l'authentification unique sont concernées.

Étape 5 : Recharger le serveur web

Le dashboard 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 version fait l'objet d'une licence distincte. Copiez le license.toml fourni par l'équipe digna pour cette version dans le répertoire d'installation, en remplaçant l'ancien :

copy /Y C:\path\to\new\license.toml license.toml

Ne conservez pas la licence précédente

Un license.toml émis pour une version antérieure ne couvre pas celle-ci, et chaque commande qui vérifie la licence — user, inspection, repo — s'interrompt avant de toucher au référentiel lorsque la vérification échoue. Vérifiez-la avant d'aller plus loin :

digna license check

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

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

digna repo upgrade

Cela met à jour le schéma PostgreSQL vers la version la plus récente tout en conservant toutes les données existantes.

Étape 9 : Enregistrer et démarrer le service

L'ancien enregistrement a été supprimé à l'étape 1 ; le service est donc enregistré à nouveau — cette fois avec l'exécutable digna, qui n'a pas de fichiers batch :

cd C:\path\to\digna
digna windows install --address <address> --port <port>
digna windows start

Donnez à --address et --port les valeurs sur lesquelles servait l'ancien service, sauf si vous souhaitez les nouvelles valeurs par défaut 127.0.0.1 et 8000 ; elles sont inscrites dans l'enregistrement et ne sont plus lues depuis config.toml. Ajoutez --account et --password si l'ancien service s'exécutait sous un compte de domaine. Voir Exécuter digna en tant que service Windows pour la liste complète des options.

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

cd C:\path\to\digna
digna serve --address <address> --port <port>

Si vous utilisez IIS ou Tomcat, redémarrez le serveur web correspondant.

Étape 10 : Vérifier la mise à niveau

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