Bekannte Einschränkungen¶
Bekannte Einschränkungen
Dokumentierte Limitierungen der Inovetra AI Platform mit Auswirkungen, Workarounds und aktuellem Status.
Übersicht¶
| Einschränkung | Auswirkung | Workaround | Status |
|---|---|---|---|
| local-path StorageClass unterstützt keine dynamische PVC-Erweiterung | PVCs können nicht ohne Datenmigration vergrößert werden | Backup → PVC löschen → neu erstellen → Restore | Bekannt |
| bcrypt muss Version 4.0.1 sein | bcrypt 5.x bricht passlib-Kompatibilität | In requirements.txt auf bcrypt==4.0.1 gepinnt |
Behoben |
| MongoDB StatefulSet kann bei Updates hängen | Update schlägt fehl, Pod startet nicht | kubectl delete statefulset --cascade=orphan dann Re-Deploy |
Bekannt |
| Helm Timeout bei großen Deployments | Installation bricht ab | --timeout 15m wird automatisch gesetzt |
Behoben |
| Network Policy Egress deaktiviert | Potentiell offene ausgehende Verbindungen | Egress nur aktivieren mit vollständigen Regeln | Design-Entscheidung |
| Nur AMD64-Images | ARM-basierte VMs werden nicht unterstützt | AMD64-VM verwenden | Design-Entscheidung |
| Embedding-Modell-Wechsel erfordert Neuindexierung | Alle Dokumente müssen neu verarbeitet werden | Modellwechsel planen, ausreichend Zeit einrechnen | Bekannt |
| Multi-Group-RAG-Filter lieferte vor Chart 0.73.3 keine Treffer | Benutzer mit mehreren Gruppen fanden Dokumente nicht, die Admins fanden | Update auf Chart ≥ 0.73.3 (RAG API ≥ v0.48.3) |
Behoben |
Konnektor-access_groups-Änderungen propagierten vor Chart 0.73.3 nicht auf bestehende Chunks |
Berechtigungsänderungen wurden gespeichert, wirkten aber nicht | Update auf Chart ≥ 0.73.3 (RAG API ≥ v0.48.3, Connector Service ≥ v0.10.1) |
Behoben |
| Konnektor-Löschen ließ Dokumente verwaist in Qdrant zurück | Vektorindex wächst durch geloeschte Konnektoren | Update auf Chart ≥ 0.73.3 und ggf. POST /documents/inventory/cleanup ausführen |
Behoben |
Vor Chart 0.76.0 ingestierte Connector-Dokumente haben keine web_url im Qdrant-Payload |
Im Source-Click-Viewer fehlt der Button „Originalquelle öffnen“ für alte Dokumente, obwohl Confluence/SharePoint/GitHub-Quellen vorliegen | Nach Update auf Chart ≥ 0.76.0 (RAG API ≥ v0.50.0, Customer Portal ≥ v0.59.2) pro Konnektor einmalig „Komplett neu synchronisieren“ im Customer Portal auslösen |
Behoben (Migration erforderlich) |
| SMB-Konnektor erkennt gelöschte Dateien im Delta-Sync nicht | Im Quellsystem gelöschte Dateien bleiben in der Wissensdatenbank (Qdrant) erhalten | „Komplett neu synchronisieren“ hilft hier nicht — die Aktion lädt nur erneut hoch und entfernt nichts. Betroffene Dokumente auf der Seite Dokumente im Customer Portal einzeln löschen (entfernt Chunks und Inventareintrag) oder den Konnektor löschen und neu anlegen | Design-bedingt (SMB liefert kein zuverlässiges Änderungsjournal) |
| Konnektoren waren vor Chart 0.82.37 nur eingeschränkt bearbeitbar | Nach dem Anlegen ließen sich nur Name, Beschreibung, Sync-Intervall und Zugriffsgruppen ändern; Angaben wie Ordnerpfad, Dateimuster oder Zugangsdaten erforderten Löschen und Neuanlegen — samt Verlust der Sync-Historie | Update auf Chart ≥ 0.82.37 (Customer Portal ≥ v0.61.60); der Bearbeiten-Dialog zeigt danach alle Felder der Ersteinrichtung |
Behoben |
Gebrandete Wartungsseite (0.81.20) benötigt NetworkPolicy allow-maintenance |
Ohne diese Regel sehen Anwender während eines Updates rohe 502/503/504 statt der Wartungsseite | NetworkPolicy ist Teil des Helm Charts (ingress.maintenancePage.enabled, Standard aktiv); bei eigenen NetworkPolicy-Anpassungen erhalten |
Behoben (im Chart enthalten) |
| LibreChat-Wartungs-Redirect benötigt TLS-Sidecar | In einem offenen Chat-Tab erfolgt der Auto-Reload zur Wartungsseite nur, wenn der nginx-TLS-Sidecar aktiv ist (tls.enabled) |
tls.enabled aktiv lassen; ansonsten Nutzer einmalig manuell neu laden lassen |
Design-bedingt (SPA lädt Dokument nicht selbst neu) |
| web-scraper rendert kein JavaScript | Stark JavaScript-getriebene Seiten liefern bei der Websuche keinen oder leeren Inhalt | Textbasierte Seiten liefern die besten Ergebnisse; der Assistent nutzt die übrigen Treffer | Design-bedingt (httpx + trafilatura, kein Headless-Browser) |
| Inovetra RAG sucht nur bei aktiviertem Globus im Web (ab Chart 0.82.13) | Ohne Globus-Symbol antwortet der Wissensassistent rein dokumentenbasiert; ohne passende Dokumente „keine Informationen in den Dokumenten" | Beabsichtigt — der frühere automatische Web-Fallback bleibt entfernt, gesucht wird nur auf Nutzeraktion; siehe Websuche | Design-Entscheidung |
| --- |
Aktualität
Diese Liste wird bei jedem Release aktualisiert. Für aktuelle bekannte Probleme siehe die Release Notes der jeweiligen Version.
Weiterführende Seiten¶
- Troubleshooting Übersicht — Allgemeine Diagnoseschritte
- Updates und Upgrades — Release-Prozess und Update-Verfahren