Guide d'installation macOS 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 d'arrière-plan
10. Mise à niveau vers une nouvelle version

Introduction¶

À propos de digna¶

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

digna se compose de deux composants principaux :

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

Nouveautés de la Release 2026.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.

Besoin d'un guide pour Windows ou Linux ?¶

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

Exigences système¶

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

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

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

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

Vérifier votre architecture¶

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

uname -m

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

Préparation avant l'installation¶

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

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

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

Installation de Homebrew¶

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

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

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

brew --version

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

Étape 2 : Installer Homebrew¶

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

Étape 3 : Ajouter Homebrew à votre PATH¶

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

brew --prefix

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

Configuration du serveur PostgreSQL¶

Si vous avez déjà PostgreSQL¶

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

Options d'installation¶

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

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

Installation de PostgreSQL avec Homebrew¶

Étape 1 : Installer la formule PostgreSQL¶

brew install postgresql@16

Étape 2 : Ajouter PostgreSQL à votre PATH¶

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

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

Étape 3 : Démarrer le service PostgreSQL¶

brew services start postgresql@16

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

Étape 4 : Vérifier l'installation¶

psql --version

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

Étape 5 : Se connecter au serveur¶

psql postgres

Étape 6 : Confirmer le port¶

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

psql postgres -c "SHOW port;"

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

Installation de PostgreSQL avec Postgres.app¶

Si vous préférez une installation graphique :

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

psql --version

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

Configuration du serveur Web¶

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

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

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

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

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

Configuration nginx¶

Vue d'ensemble¶

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

Installation¶

brew install nginx

Démarrer nginx¶

brew services start nginx

Vérifier l'installation¶

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

Configurer un site pour le tableau de bord¶

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

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

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

server {
    listen       8080;
    server_name  localhost;

    root   /path/to/digna/dashboard;
    index  index.html;

    # Serve Markdown files with the correct MIME type.
    types {
        text/markdown  md;
    }

    # Single-page-application fallback: unknown paths return index.html
    # instead of a 404, so dashboard routes survive a browser refresh.
    location / {
        try_files $uri $uri/ /index.html;
    }
}

Appliquer la configuration¶

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

nginx -t
brew services restart nginx

Configuration Apache httpd¶

Vue d'ensemble¶

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

Démarrer Apache¶

sudo apachectl start

Vérifier l'installation¶

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

Requis : Activer mod_rewrite¶

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

sudo nano /etc/apache2/httpd.conf

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

LoadModule rewrite_module libexec/apache2/mod_rewrite.so

Requis : Autoriser les overrides .htaccess¶

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

AllowOverride None

en :

AllowOverride All

Requis : Type MIME pour les fichiers Markdown¶

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

AddType text/markdown .md

Appliquer la configuration¶

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

sudo apachectl configtest
sudo apachectl restart

Installation initiale¶

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

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

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

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

CREATE SCHEMA <digna_repo_schema>;

CREATE USER <digna_repo_user> WITH PASSWORD '<digna_repo_password>';

GRANT ALL PRIVILEGES ON SCHEMA <digna_repo_schema> TO <digna_repo_user>;

Remplacez les paramètres suivants :

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

Exemple :

CREATE SCHEMA dignarepo;

CREATE USER digna_user WITH PASSWORD 'YourSecurePassword123!';

GRANT ALL PRIVILEGES ON SCHEMA dignarepo TO digna_user;

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

psql postgres

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

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

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

Pour extraire depuis le Terminal :

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

Rendre l'exécutable exécutable¶

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

cd /opt/digna
chmod +x digna

Si macOS bloque l'application¶

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

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

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

Étape 3 : Installer le fichier de licence¶

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

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

Arborescence après configuration :

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

Configuration du backend¶

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

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

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

Emplacement : /opt/digna/config.toml

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

Section [app]¶

Cette section configure 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 = ["*"]

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

Section [base]¶

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

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

Section [encryption]¶

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

[encryption]
DIGNA_ENCRYPTION_KEY = 'ycELf6IbcO55dYIZHpPv6kQv/bbnUXoIaHLh2bh1kMg='

Section [logging]¶

Cette section configure le comportement des journaux :

[logging]
digna_LOGGING_MODE = "INFO"
digna_LOGGING_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 dépôt¶

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

cd /opt/digna
./digna repo check

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

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

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

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

./digna repo 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 nouvelle fenêtre Terminal
2. Allez dans votre répertoire d'installation digna
3. Exécutez la commande suivante pour créer un utilisateur administrateur :

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

Exemple :

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

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

Étape 6 : Démarrer le serveur digna¶

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

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

Paramètres : - --address — Nom d'hôte/IP du serveur - --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

Configuration du tableau de bord¶

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

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

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

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

Déployer sur nginx¶

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

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

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

4. S'assurer que le dossier est lisible

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

5. Recharger nginx

   nginx -t
   brew services restart nginx
   

6. Tester l'installation

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

Déployer sur Apache httpd¶

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

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

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

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

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

Collez ce qui suit :

RewriteEngine On
RewriteBase /digna/

# Serve existing files and directories as-is.
RewriteCond %{REQUEST_FILENAME} -f [OR]
RewriteCond %{REQUEST_FILENAME} -d
RewriteRule ^ - [L]

# Everything else falls back to the single-page application entry point.
RewriteRule ^ index.html [L]

1. Redémarrer Apache

   sudo apachectl restart
   

2. Accéder au tableau de bord

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

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

Pourquoi exécuter digna en tant que service ?¶

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

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

Fichiers de gestion du service¶

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

Les scripts shell suivants sont disponibles :

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

Rendre les scripts exécutables¶

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

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

Installer le service¶

1. Ouvrez Terminal

2. Allez dans le dossier bin

   cd /opt/digna/bin
   

3. Exécutez le script d'installation

   sudo ./install_service.sh
   

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

Démarrer et arrêter le service¶

Pour démarrer le service¶

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

   sudo ./start_service.sh
   

Pour arrêter le service¶

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

   sudo ./stop_service.sh
   

Vérifier le service¶

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

sudo launchctl list | grep digna

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

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

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

1. Désinstaller le service actuel

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

2. Déplacer les fichiers de l'application

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

3. Réinstaller le service

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

4. Démarrer le service

   sudo ./start_service.sh
   

Désinstaller le service¶

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

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

2. Désinstaller le service

   sudo ./uninstall_service.sh
   

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

Mise à niveau vers une nouvelle version¶

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.

La création d'une sauvegarde du dépôt digna est OBLIGATOIRE

Avant de mettre à niveau digna, sauvegardez votre dépôt (PostgreSQL) pour vous protéger contre la perte de données. Une sauvegarde vous permettra de récupérer en cas de problème imprévu lors de la mise à niveau.

Pour créer une sauvegarde depuis le Terminal :

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

Processus de mise à niveau¶

Étape 1 : Arrêter le service digna¶

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

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

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

Étape 2 : Sauvegarder l'installation actuelle¶

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

cd /opt/digna
mv dignabackend dignabackend_old

mv dignacli dignacli_old

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 dans votre répertoire d'installation
3. Restaurez le bit exécutable et, si nécessaire, supprimez l'attribut de quarantaine :

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

Étape 4 : Restaurer vos fichiers de configuration¶

cp dashboard_old/dashboard_config.toml dashboard/dashboard_config.toml

[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 (Cmd+Shift+R).

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

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

./digna license check

Étape 8 : Mettre à niveau le schéma du dépôt¶

Allez 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 conservant toutes les données existantes.

Étape 9 : Redémarrer les services¶

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

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

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

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

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

brew services restart nginx

sudo apachectl restart

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

1. 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 d'éventuelles erreurs
4. Convertissez à ODBC chaque connexion qui ne l'utilisait pas encore, puis testez toutes les connexions — voir Tester une connexion