Aller au contenu

Exploitation

Les services de SmartAGT sont créés à l'installation et démarrent avec le serveur. Cette page regroupe leurs commandes d'exploitation.

Pour remplacer les packages par une nouvelle version, suivez Mettre à jour.

Prérequis

Procédure d'exploitation

Service Rôle Nom affiché sous Windows
SmartAGT-Platform-Service API SmartAGT Platform Service
smartagt-rag-ingestor-worker Extraction et découpage des documents SmartAGT RAG-Ingestor Worker
smartagt-rag-embed-worker Calcul des vecteurs SmartAGT RAG-Embed Worker
smartagt-scheduler-worker Tâches planifiées SmartAGT Scheduler Worker
SmartAGT-AI-Gateway-Service AI Gateway SmartAGT AI Gateway Service
smartagt-frontend-service Frontend SmartAGT Frontend Service
Action Commande
Démarrer sudo systemctl start <service>
Arrêter sudo systemctl stop <service>
Redémarrer sudo systemctl restart <service>
Consulter l'état systemctl status <service>
Consulter les journaux journalctl -u <service>
Désactiver le démarrage automatique sudo systemctl disable <service>
Rétablir le démarrage automatique sudo systemctl enable <service>

Plusieurs services se passent à la suite dans une même commande.

Action Commande
Démarrer Start-Service <service>
Arrêter Stop-Service <service>
Redémarrer Restart-Service <service>
Consulter l'état Get-Service <service>
Consulter les journaux dossiers C:\app\logs\backend et C:\app\logs\bff
Désactiver le démarrage automatique Set-Service <service> -StartupType Manual
Rétablir le démarrage automatique Set-Service <service> -StartupType Automatic

Plusieurs services se passent à la suite dans une même commande, séparés par des virgules.

Redémarrez un service après une modification du YAML ou de son environnement. Les workers attendent que l'API ait préparé la base avant de démarrer.

Chaque nœud Backend porte les services des rôles que lui attribue deployment.nodes, chaque nœud Frontend le service du Frontend. Exécutez les commandes sur le nœud concerné.

Une modification du YAML ou de l'environnement se reporte sur tous les nœuds concernés. Pour ce changement de configuration, redémarrez-les ensuite un par un : les autres nœuds continuent de servir pendant ce temps. Les workers attendent que l'API ait préparé la base avant de démarrer.

Un changement de version suit l'arrêt coordonné de Mettre à jour.

Cas particuliers

Réinitialiser le Backend

init --reset efface les bases smartagt et smartagt_vector et repart d'une installation neuve : l'activation est à refaire.

  1. Sauvegardez les bases, puis arrêtez les services du Backend. Le stockage intégré refuse le reset tant qu'un de ses processus tourne.
  2. Relancez la commande de l'étape Initialiser, avec --reset.
  3. Démarrez les services du Backend, relancez l'étape Initialiser du Frontend avec --adopt-backend-key, puis redémarrez son service.

L'ancien stockage intégré reste sous <data_dir>/mediastore/seaweedfs.reset-<horodatage>. Pour revenir en arrière, restaurez les bases et redonnez à ce dossier le nom seaweedfs. Sinon, supprimez-le pour libérer le disque. Avec S3 : Configurer S3.

Réinitialiser le Backend

init --reset efface les bases smartagt et smartagt_vector, vide le bucket de ses objets SmartAGT et repart d'une installation neuve : activation, secret de déploiement et rattachement des nœuds Frontend sont à refaire, comme à l'installation.

Sauvegardez les bases et le bucket, puis arrêtez les services du Backend sur tous les nœuds. Sur le premier nœud Platform seulement, relancez les commandes de l'étape Initialiser, init avec --reset. Détail de la purge : Configurer S3.