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.