Aller au contenu

Sauvegarder

Cette procédure produit un jeu de sauvegarde cohérent : les bases et les fichiers datent du même instant. SmartAGT ne crée aucune sauvegarde automatiquement. Les commandes visent un serveur unique.

Ce qu’il faut sauvegarder

Élément Linux Windows
Bases smartagt, smartagt_vector et smartagt_bff PostgreSQL PostgreSQL
Stockage intégré, avec le marqueur storage-owner.json /var/lib/smartagt/backend/mediastore/seaweedfs C:\app\data\backend\mediastore\seaweedfs
Données des services /var/lib/smartagt/backend, /var/lib/smartagt/bff C:\app\data\backend, C:\app\data\bff
Configuration et certificats posés /app/config/backend, /app/config/bff C:\app\config\backend, C:\app\config\bff
Environnement des services : KEK, mots de passe, identité du nœud /etc/smartagt/*.env Registre des services
Définition des services et leurs surcharges /etc/systemd/system/ (unités SmartAGT) Créée par l’installation

Avec un stockage S3, le dossier mediastore/seaweedfs n’existe pas : sauvegardez le bucket avec vos outils, pendant la même interruption. Une base vectorielle déclarée sur un serveur distinct se sauvegarde aussi.

Les KEK du Backend et du Frontend restent en plus dans votre coffre : sans elles, ni les bases ni les fichiers ne sont lisibles.

Procédure

1. Arrêter les services

sudo systemctl stop smartagt-frontend-service SmartAGT-AI-Gateway-Service smartagt-scheduler-worker smartagt-rag-embed-worker smartagt-rag-ingestor-worker SmartAGT-Platform-Service

Résultat attendu : systemctl is-active renvoie inactive pour chaque service, et pgrep -u svc-smartagt-backend ne renvoie rien, stockage intégré compris.

$services = 'smartagt-frontend-service', 'SmartAGT-AI-Gateway-Service', 'smartagt-scheduler-worker', 'smartagt-rag-embed-worker', 'smartagt-rag-ingestor-worker', 'SmartAGT-Platform-Service'
$services | Where-Object { Get-Service $_ -ErrorAction SilentlyContinue } | Stop-Service

Résultat attendu : Get-Service $services affiche Stopped pour chaque service installé.

PostgreSQL reste démarré. L’arrêt de Platform arrête aussi le stockage intégré.

2. Exporter les bases

umask 077
backup=/var/backups/smartagt/$(date +%Y%m%d-%H%M%S)
sudo mkdir -p "$backup"
sudo chown "$USER" "$backup"
pg_dump -h <hôte PostgreSQL> -U smartagt -W -Fc -d smartagt -f "$backup/smartagt.dump"
pg_dump -h <hôte PostgreSQL> -U smartagt -W -Fc -d smartagt_vector -f "$backup/smartagt_vector.dump"
pg_dump -h <hôte PostgreSQL> -U smartagt_bff -W -Fc -d smartagt_bff -f "$backup/smartagt_bff.dump"
$backup = "C:\Backup\smartagt\$(Get-Date -Format 'yyyyMMdd-HHmmss')"
New-Item -ItemType Directory -Path $backup | Out-Null
icacls $backup /inheritance:r /grant:r '*S-1-5-32-544:(OI)(CI)F' '*S-1-5-18:(OI)(CI)F' | Out-Null
$pg = 'C:\app\PostgreSQL\18\bin'
& "$pg\pg_dump.exe" -h <hôte PostgreSQL> -U smartagt -W -Fc -d smartagt -f "$backup\smartagt.dump"
& "$pg\pg_dump.exe" -h <hôte PostgreSQL> -U smartagt -W -Fc -d smartagt_vector -f "$backup\smartagt_vector.dump"
& "$pg\pg_dump.exe" -h <hôte PostgreSQL> -U smartagt_bff -W -Fc -d smartagt_bff -f "$backup\smartagt_bff.dump"

Utilisez les outils clients de PostgreSQL 18. Le format -Fc sert à pg_restore et n’est pas chiffré.

Résultat attendu : trois fichiers .dump non vides dans le dossier du jeu.

3. Copier les fichiers

cd /
sudo tar -czpf "$backup/fichiers.tar.gz" \
  var/lib/smartagt app/config etc/smartagt \
  etc/systemd/system/SmartAGT-* etc/systemd/system/smartagt-*

Résultat attendu : tar -tzf "$backup/fichiers.tar.gz" liste var/lib/smartagt/backend/mediastore/seaweedfs/storage-owner.json.

robocopy C:\app\data "$backup\data" /E /COPY:DAT /R:1 /W:1 | Out-Null
robocopy C:\app\config "$backup\config" /E /COPY:DAT /R:1 /W:1 | Out-Null
foreach ($name in $services | Where-Object { Get-Service $_ -ErrorAction SilentlyContinue }) {
    reg export "HKLM\SYSTEM\CurrentControlSet\Services\$name" "$backup\$name.reg" /y | Out-Null
}

Résultat attendu : $backup\data\backend\mediastore\seaweedfs\storage-owner.json existe, avec un fichier .reg par service.

Le cache des modèles, backend/models sous le dossier des données, peut être exclu : il se télécharge de nouveau si le serveur joint Hugging Face. Un modèle déposé à la main se redépose.

4. Redémarrer les services

sudo systemctl start SmartAGT-Platform-Service smartagt-rag-ingestor-worker smartagt-rag-embed-worker smartagt-scheduler-worker SmartAGT-AI-Gateway-Service smartagt-frontend-service
[array]::Reverse($services)
$services | Where-Object { Get-Service $_ -ErrorAction SilentlyContinue } | Start-Service

Ne démarrez que les services installés. AI Gateway est facultative.

Résultat attendu : la page de connexion s’affiche.

5. Protéger le jeu

Le jeu contient l’environnement des services, donc les KEK et les mots de passe. Chiffrez-le, conservez-le hors du serveur et limitez son accès à vos administrateurs de sauvegarde. Gardez avec lui la version des packages installés : une restauration se fait sur la même version.

Cas particuliers

Cohérence entre les bases et les fichiers

Les trois exports et la copie des fichiers doivent provenir de la même interruption. Un stockage intégré plus ancien ou plus récent que la base smartagt peut refuser de démarrer à la restauration, ou laisser des documents introuvables.

Cluster

En cluster, le stockage est S3. Arrêtez les services sur tous les nœuds, exportez les bases une fois, sauvegardez le bucket, puis copiez la configuration et l’environnement de chaque nœud.