# Vérification du bon fonctionnement

Voici une **checklist de vérification du bon fonctionnement** du système, suivie d’un **tableau récapitulatif des problèmes possibles en cas d’indisponibilité**.

<div id="bkmrk-"><div>- - - - - -

</div></div>### ✅ **Checklist de vérification du bon fonctionnement**

<div id="bkmrk-%C3%89l%C3%A9ment-%C3%A0-v%C3%A9rifier-p"><div><table><thead><tr><th>Élément à vérifier</th><th>Procédure de vérification</th><th>Statut (✓/✗)</th></tr></thead><tbody><tr><td>**1. Containers dans Portainer**</td><td>Accéder à l’interface Portainer et s’assurer que tous les conteneurs sont en état **"Running"** :  
- `openwebui`, `qdrant`, `postgres`, `sophia-nodered-openwebui-1`  
- `infomaniak-xinference-1`, `infomaniak-docling-1`, `infomaniak-portainer_agent-1`  
- `searxng`, `firecrawl-api-1 (et les containers de la stack firecrawl)`</td><td>  
</td></tr><tr><td>**2. Interface Sophia (OpenWebUI)**</td><td>Accéder à : `https://sophia.vincennes.fr`  
→ Vérifier que la page charge correctement et que l’interface est interactive.</td><td>  
</td></tr><tr><td>**3. Interface Node-RED**</td><td>Accéder à : `http://sp26.vincennes.fr:1886`  
→ Vérifier que l’éditeur s’ouvre et que les flux sont actifs.</td><td>  
</td></tr><tr><td>**4. Firecrawl (API et message par défaut)**</td><td>Accéder à : `http://sp26.vincennes.fr:3003`  
→ Vérifier que la réponse "SCRAPERS-JS: Hello, world! K8s! "s’affiche.</td><td>  
</td></tr><tr><td>**5. Interface Docling**</td><td>Accéder à : `http://sp26.vincennes.fr:5002/ui`  
→ Vérifier que l’interface utilisateur de Docling est accessible.</td><td>  
</td></tr><tr><td>**6. XInference et modèle de reranking**</td><td>1. Accéder à l’interface XInference via le tunnel : `http://sp26.vincennes.fr:9995`  
2. Vérifier que le modèle `bge-reranker-v2-m3` est **chargé et en cours d’exécution** dans la section `/reranker`.</td><td>  
</td></tr><tr><td>**7. SearXNG**</td><td>Accéder à : `http://sp26.vincennes.fr:8056`  
→ Vérifier que l’interface de recherche s’affiche.  
→ Effectuer une recherche test (ex: "test").</td><td>  
</td></tr><tr><td>**8. Endpoint OpenAI**</td><td>Depuis l’interface Sophia (Menu Images) :  
→ Lancer une génération d’image.  
→ Vérifier que la requête atteint OpenAI et retourne une image.</td><td>  
</td></tr><tr><td>**9. Endpoints Infomaniak (via Node-RED)**</td><td>Vérifier dans les menus Sophia :  
- **Connexions** : état des endpoints texte/audio/image  
- **Documents**, **Audio**, **Recherche** : que les appels passent via `http://sp26.vincennes.fr:1886`  
→ Vérifier les logs Node-RED en cas d’erreur.</td><td>  
</td></tr><tr><td>**10. Logs des conteneurs de tunnel SSH**</td><td>Vérifier les logs des conteneurs suivants dans Portainer :  
- `infomaniak-xinference-1`  
- `infomaniak-docling-1`  
- `infomaniak-portainer_agent-1`  
→ Rechercher des erreurs de connexion SSH, timeout ou refus.  
→ S’assurer que la VM Infomaniak est joignable (ping ou test de connexion réseau).</td><td>  
</td></tr></tbody></table>

- - - - - -

</div></div>### ⚠️ **Tableau des problèmes possibles en cas d’indisponibilité**

<div id="bkmrk-service-indisponible"><div><table><thead><tr><th>Service indisponible</th><th>Symptôme observé</th><th>Cause probable</th><th>Impact fonctionnel</th></tr></thead><tbody><tr><td>**Conteneur non démarré dans Portainer**</td><td>Interface inaccessible, erreur 502/503</td><td>Conteneur crashé, mauvaise configuration, dépendance manquante</td><td>Blocage total du service associé</td></tr><tr><td>**Sophia (OpenWebUI)**</td><td>Page blanche, erreur de chargement</td><td>Problème réseau, conteneur down, certificat SSL expiré</td><td>Interface principale inutilisable</td></tr><tr><td>**Node-RED**</td><td>Éditeur inaccessible ou flux inactifs</td><td>Conteneur down, erreur dans un flux critique</td><td>Toutes les intégrations (recherche, audio, embedding) bloquées</td></tr><tr><td>**Firecrawl**</td><td>API ne répond pas ou timeout</td><td>Conteneur down, VM surchargée, erreur de scraping</td><td>Impossible d’extraire du contenu web pour les recherches</td></tr><tr><td>**Docling**</td><td>`/ui` inaccessible ou erreur 500</td><td>Tunnel SSH rompu, service Docling arrêté sur Infomaniak</td><td>Analyse des documents PDF/HTML impossible</td></tr><tr><td>**XInference / bge-reranker-v2-m3**</td><td>Modèle non chargé ou erreur 404/500</td><td>Modèle non démarré, mémoire insuffisante, tunnel SSH défaillant</td><td>Détérioration de la qualité des réponses (RAG)</td></tr><tr><td>**SearXNG**</td><td>Page de recherche inaccessible</td><td>Conteneur down ou configuration réseau incorrecte</td><td>Recherche web impossible via Sophia</td></tr><tr><td>**Endpoint OpenAI**</td><td>Génération d’image échoue</td><td>Clé API invalide, réseau bloqué, quota dépassé</td><td>Fonctionnalité d’image inactive</td></tr><tr><td>**Endpoints Infomaniak**</td><td>Erreurs dans les menus Sophia (Connexions, Audio, etc.)</td><td>Tunnel SSH rompu, VM éteinte, problème d’authentification</td><td>Toutes les fonctions IA distantes (transcription, embedding) inactives</td></tr><tr><td>**Logs des tunnels SSH**</td><td>Messages répétés : `Connection refused`, `Broken pipe`, `Failed to connect`</td><td>VM Infomaniak éteinte, firewall, clé SSH expirée, réseau instable</td><td>Perte de contrôle et de données vers les services distants</td></tr></tbody></table>

- - - - - -

</div></div>> 🔍 **Recommandation** : Cette checklist peut être utilisée quotidiennement ou après chaque déploiement/mise à jour. En cas d’indisponibilité, consulter en priorité les **logs des conteneurs de tunnel SSH** et vérifier la **connectivité réseau vers la VM Infomaniak**.