Guide d'installation Windows pour digna Release 2026.06¶
Release : 2026.06
Dernière mise à jour : 30 août 2026
Table des matières¶
- Introduction
- Exigences système
- Préparation avant l'installation
- Configuration du serveur PostgreSQL
- Configuration du serveur Web
- Installation initiale
- Configuration du backend
- Configuration du tableau de bord
- Exécuter digna en tant que service Windows
- 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
dignabackendetdignaclides 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 :
- Serveur PostgreSQL – pour stocker les métriques calculées et les données de performance
- 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¶
- Visitez la page de téléchargements PostgreSQL
- Sélectionnez Windows
- Téléchargez le dernier installateur
Étape 2 : Exécuter l'installateur¶
- Double-cliquez sur le fichier d'installation téléchargé
- 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é :
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¶
- Ouvrir le Panneau de configuration
- Appuyez sur
Win + R -
Tapez
controlet appuyez sur Entrée -
Accéder aux fonctionnalités Windows
- Cliquez sur Programmes
-
Sélectionnez Activer ou désactiver des fonctionnalités Windows
-
Activer Internet Information Services
- Faites défiler et trouvez Internet Information Services (IIS)
- Cochez la case pour l'activer
-
Cliquez sur le + pour développer et vérifiez que ces sous-composants sont sélectionnés :
- Web Management Tools
- World Wide Web Services
-
Cliquez sur OK pour appliquer les modifications
-
Vérifier l'installation d'IIS
- Ouvrez votre navigateur
- Accédez à
http://localhost - 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 :
- Ouvrez IIS Manager (appuyez sur
Win + R, tapezinetmgr, appuyez sur Entrée) - Naviguez vers Votre site > MIME Types
- Cliquez sur Add...
- Configurez :
- File name extension :
.md - 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¶
- Télécharger Apache Tomcat
- Visitez Apache Tomcat Downloads
-
Téléchargez la distribution ZIP pour Windows
-
Extraire l'archive
- Extrayez le fichier ZIP dans un répertoire sur votre système
-
Exemple :
C:\Program Files\Apache Tomcat -
Vérifier que Tomcat fonctionne
- Ouvrez votre navigateur
- Accédez à
http://localhost:8080 - 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¶
- Localisez le fichier ZIP d'installation de digna qui vous a été fourni
- Extrayez-le à l'emplacement d'installation souhaité
- Après extraction, vous devriez voir les éléments suivants :
dashboard/— Interface web du tableau de borddigna— 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.
- Localisez le fichier
license.tomlqui vous a été fourni - Copiez-le dans le répertoire racine d'installation de digna (là où se trouvent
config.tomlet l'exécutabledigna)
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.
| 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 :
| 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 :
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¶
- Ouvrez l'Invite de commandes
- Placez-vous dans le répertoire d'installation de digna (là où se trouvent
config.tomlet l'exécutabledigna) - Exécutez le test de connexion :
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 :
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¶
- Ouvrez une fenêtre Invite de commandes nouvelle
- Placez-vous dans le répertoire d'installation de digna
- Exécutez la commande suivante pour créer un utilisateur administrateur :
Exemple :
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 :
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¶
- Ouvrir IIS Manager
-
Appuyez sur
Win + R, tapezinetmgr, appuyez sur Entrée -
Créer un nouveau site Web
- Dans le panneau de gauche, faites un clic droit sur Sites
-
Sélectionnez Add Website...
-
Configurer le site Web
- Site Name : Entrez un nom (par ex., "dignaDashboard")
- Physical Path : Cliquez sur Parcourir et sélectionnez votre dossier
dashboard -
Binding : Définissez l'adresse IP et le port (port 80 par défaut pour HTTP, 443 pour HTTPS)
-
Démarrer le site
- Cliquez sur OK pour créer le site
-
Faites un clic droit sur le nouveau site et sélectionnez Start
-
Tester l'installation
- Ouvrez votre navigateur
- Accédez à
http://localhost(ou l'URL configurée) - Vous devriez voir la page de connexion du dashboard digna
Déploiement sur Apache Tomcat¶
- Copier le dashboard dans Tomcat
- Copiez le dossier
dashboarddans le répertoirewebappsde Tomcat - Renommez-le si nécessaire (par ex., en
digna) -
Exemple :
C:\Program Files\Apache Tomcat\webapps\digna -
Vérifier le déploiement
- Actualisez ou rechargez la page de gestion Tomcat (http://localhost:8080)
-
Vous devriez voir "digna" (ou le nom choisi) listé parmi les applications déployées
-
Accéder au dashboard
- Ouvrez votre navigateur
- Accédez à
http://localhost:8080/digna - 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¶
- Ouvrir l'Invite de commandes en tant qu'administrateur
- Clic droit sur Invite de commandes
-
Sélectionnez "Exécuter en tant qu'administrateur"
-
Se placer dans votre répertoire d'installation digna
-
Enregistrer le service
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 :
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¶
Pour arrêter le service¶
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 :
-
Arrêter et désenregistrer le service actuel
-
Déplacer les fichiers de l'application
-
Déplacez l'ensemble du dossier d'installation digna vers le nouvel emplacement
-
Enregistrer à nouveau le service depuis le nouvel emplacement
Reprenez les valeurs --address, --port ou --account que vous aviez utilisées la première fois — l'enregistrement précédent n'existe plus.
- Démarrer le service
Désinstaller le service¶
-
Arrêter le service en cours d'exécution
-
Désenregistrer le service
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 :
- Passez en revue chaque connexion définie dans votre installation et relevez celles qui n'utilisent pas encore ODBC — chacune devra être reconfigurée.
- 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.
- 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 :
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é :
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é :
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¶
- Extrayez le nouveau fichier ZIP d'installation digna
- Copiez le nouvel exécutable
dignaet le dossierdashboarddans 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¶
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 :
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 :
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 :
Étape 8 : Mettre à niveau le schéma du repository¶
Placez-vous dans le répertoire d'installation de digna et exécutez :
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 :
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 :
Si vous utilisez IIS ou Tomcat, redémarrez le serveur web correspondant.
Étape 10 : Vérifier la mise à niveau¶
- Accédez au dashboard digna
- Vérifiez que l'interface se charge correctement
- Consultez les journaux du serveur pour détecter d'éventuelles erreurs
- Convertissez à ODBC chaque connexion qui ne l'utilisait pas encore, puis testez toutes les connexions — voir Tester une connexion