Aller au contenu

Restaurer

Cette procédure remet une installation dans l’état d’un jeu produit par Sauvegarder. Les commandes visent un serveur unique.

Prérequis

  • Packages Backend et Frontend de la même version que le jeu, installés selon Installer le Backend et Installer le Frontend : comptes de service sous Linux, services sous Windows.
  • PostgreSQL 18 avec pgvector, et les rôles smartagt et smartagt_bff avec les mots de passe enregistrés dans le jeu : Préparer les bases.
  • Le jeu de sauvegarde déchiffré, dans un dossier réservé aux administrateurs. Les commandes le désignent par $backup.

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
$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 : chaque service installé est arrêté.

2. Recréer les bases

Ouvrez psql avec le compte postgres, comme pour la préparation des bases. Ces commandes suppriment les bases existantes.

DROP DATABASE IF EXISTS smartagt;
DROP DATABASE IF EXISTS smartagt_vector;
DROP DATABASE IF EXISTS smartagt_bff;
CREATE DATABASE smartagt OWNER smartagt ENCODING 'UTF8' TEMPLATE template0;
CREATE DATABASE smartagt_vector OWNER smartagt ENCODING 'UTF8' TEMPLATE template0;
CREATE DATABASE smartagt_bff OWNER smartagt_bff ENCODING 'UTF8' TEMPLATE template0;
REVOKE ALL ON DATABASE smartagt FROM PUBLIC;
REVOKE ALL ON DATABASE smartagt_vector FROM PUBLIC;
REVOKE ALL ON DATABASE smartagt_bff FROM PUBLIC;

Résultat attendu : psql répond trois fois DROP DATABASE, trois fois CREATE DATABASE, puis trois fois REVOKE.

3. Restaurer les bases

sudo cat "$backup/smartagt.dump" | sudo -u postgres pg_restore -d smartagt
sudo cat "$backup/smartagt_vector.dump" | sudo -u postgres pg_restore -d smartagt_vector
sudo cat "$backup/smartagt_bff.dump" | sudo -u postgres pg_restore -d smartagt_bff
$pg = 'C:\app\PostgreSQL\18\bin'
& "$pg\pg_restore.exe" -U postgres -d smartagt "$backup\smartagt.dump"
& "$pg\pg_restore.exe" -U postgres -d smartagt_vector "$backup\smartagt_vector.dump"
& "$pg\pg_restore.exe" -U postgres -d smartagt_bff "$backup\smartagt_bff.dump"

Le compte postgres recrée les extensions et rend chaque objet à son rôle d’origine. Si PostgreSQL est sur un autre serveur, ajoutez -h <hôte PostgreSQL> et un superutilisateur.

Résultat attendu : chaque commande se termine sans erreur.

4. Restaurer les fichiers

cd /
sudo rm -rf /var/lib/smartagt/backend/mediastore/seaweedfs
sudo tar -xzpf "$backup/fichiers.tar.gz"
sudo systemctl daemon-reload

Résultat attendu : /var/lib/smartagt/backend/mediastore/seaweedfs/storage-owner.json existe et appartient à svc-smartagt-backend.

Remove-Item C:\app\data\backend\mediastore\seaweedfs -Recurse -Force -ErrorAction SilentlyContinue
robocopy "$backup\data" C:\app\data /E /COPY:DAT /R:1 /W:1 | Out-Null
robocopy "$backup\config" C:\app\config /E /COPY:DAT /R:1 /W:1 | Out-Null
Get-ChildItem "$backup\*.reg" | ForEach-Object { reg import $_.FullName }

Résultat attendu : C:\app\data\backend\mediastore\seaweedfs\storage-owner.json existe, et l’environnement de chaque service porte les valeurs du jeu.

5. 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.

Résultat attendu :

  • la page de connexion s’affiche et le compte admin se connecte ;
  • une conversation existante s’ouvre ;
  • un document déposé avant la sauvegarde se télécharge.

Cas particuliers

Restaurer sur un nouveau serveur

En serveur unique, l’identité du nœud dérive par défaut de la carte réseau, et le stockage intégré refuse un disque marqué par un autre nœud. Avant l’étape 5, relevez la valeur node_id dans storage-owner.json, puis ajoutez SMARTAGT_NODE_ID=<valeur relevée> à l’environnement des services du Backend : /etc/smartagt/backend.env sous Linux, environnement des services sous Windows.

Sous Linux, activez aussi les services restaurés, dont les liens de démarrage ne sont pas dans le jeu : sudo systemctl enable suivi des services installés.

Remplacez le certificat de vos écoutes s’il porte le nom de l’ancien serveur : Installer vos certificats.

Messages du stockage intégré au démarrage
Message Cause
Le manifeste diffère de la topologie acceptée. Restaurer le manifeste de cette installation avant le redémarrage. Identité du nœud différente, voir le cas précédent
Le disque appartient à un autre nœud ou une autre installation. Dossier mediastore/seaweedfs d’une autre installation ou d’un autre jeu
Le disque d'un ancien membre est absent ; sa reprise automatique est refusée. Base restaurée sans le dossier mediastore/seaweedfs
Les volumes d'un ancien membre sont absents ; utiliser la maintenance de stockage. Dossier restauré sans ses volumes
Frontend restauré seul ou Backend plus récent

Si le Frontend signale backend_key_changed, relancez l’étape Initialiser du Frontend avec --adopt-backend-key, puis redémarrez son service.

Stockage S3

Restaurez le bucket avec vos outils au même point que les bases, avant l’étape 5. L’étape 4 ne contient alors pas de dossier mediastore/seaweedfs.