Troubleshooting

Troubleshooting

Kein Authentifizierungstoken gefunden

Symptom

• CLI‑Befehle (generate, package, upload, test) schlagen fehl mit Meldungen wie: „No authentication token found. Run: edge-connector auth“.

Lösung

• führe edge-connector auth --token "<ADMIN_JWT>" auf der Maschine aus, oder
• schließe im Desktop‑Modus den Browser‑Login ab.

Stelle sicher, dass AUTH_TOKEN_PATH auf einen beschreibbaren Ort zeigt, falls du den Pfad überschreibst.

Keine Verbindung zu Tool RPC

Symptom

• generate oder test meldet, dass keine Verbindung zum Tool‑RPC‑Server hergestellt werden kann oder ein Timeout auftritt.

Lösung

• prüfe die Tool‑RPC‑URL (TOOL_RPC_URL, config.json oder CLI‑Flags),
• stelle sicher, dass der Server von der Connector‑Maschine erreichbar ist (Netzwerk/Firewall),
• überprüfe, dass dein Token für die Zielumgebung gültig ist.

Deployment bereits verbunden

Symptom

• die Runtime loggt „Deployment already connected from another instance“.

Lösung

• stoppe den anderen Connector, der dieselbe deploymentId nutzt, oder
• erstelle ein separates Deployment für die neue Umgebung und aktualisiere die Credentials.

Upload fehlgeschlagen

Symptom

• edge-connector upload bricht mit HTTP‑Fehler oder „Upload failed“‑Meldungen ab.

Lösung

• stelle sicher, dass die Datei ein .tgz ist, das von edge-connector package erzeugt wurde,
• prüfe, dass die Dateigröße innerhalb des Limits liegt,
• verifiziere, dass dein Token gültig ist und Zugriff auf die Organisation hat,
• folge ggf. der detaillierten Server‑Fehlermeldung (z. B. ungültige orgId).

Immer noch Probleme?

Aktiviere ausführlichere Logs für deine Umgebung und teile relevante Connector‑ und Server‑Logs mit dem nara‑Team, damit wir bei der Analyse helfen können.