API Troubleshooting
Grundregel
- Bei Problemen zuerst sicherstellen, dass aB-Agenta auf die aktuelle Version aktualisiert ist. Viele Fehlerursachen sind bereits in neueren Versionen behoben.
Logdatei prüfen
- Im Unterordner logs liegt abserverservicefx.log. Viele Fehlerursachen können hier gefunden werden.
Service startet nicht
- Fehlkonfiguration → Einstellungen auf Korrektheit und Vollständigkeit prüfen
- Antivirus unterbindet Ausführung des Service → Ausnahme definieren
Service via localhost nicht erreichbar
- Port schon belegt → anderen Port ausprobieren
Service im LAN nicht erreichbar
- Port in Windows-Firewall gesperrt → Port öffnen via Button in Service-Einstellungen
- Port in Drittanbieter Software Firewall gesperrt → Port manuell öffnen
Service im WAN nicht erreichbar
- Port in Hardware-Firewall gesperrt → öffnen
- Router zwischen LAN und WAN → Port weiterleiten
- Verweist die Domain auf die korrekte öffentliche IP-Adresse?
- Ist die öffentliche IP-Adresse erreichbar?
Let’s Encrypt Zertifikat kann nicht ausgestellt werden
- Let’s Encrypt Port in lokaler oder Hardware-Firewall gesperrt → öffnen
- Let’s Encrypt muss im WAN auf Port 80 erreichbar sein. Ggf. entsprechende Port-Weiterleitung einrichten
- Service hat keine Schreibrechte auf Zertifikatsspeicher → Service als Benutzer mit Admin-Rechten betreiben
Anmeldung scheitert trotz korrekten Anmeldedaten
- Datenordner wurde aus Client Perspektive angegeben → aus Server Perspektive angeben
- Nicht ausreichende Zugriffsrechte auf Datenordner → Rechte für den Benutzer erteilen, der den Service ausführt
- Datenordner liegt im LAN auf Netzwerkfreigabe → der Benutzer „Lokales System“ kann nicht auf Netzwerkfreigaben zugreifen. Melden Sie den Service mit einem anderen Benutzer mit lokalen Administrator-Rechten an.
- Datenordner liegt auf Netzlaufwerk → Netzlaufwerke sind meistens für einzelne Benutzer definiert. Verwenden Sie stattdessen einen UNC-Pfad.
- Antivirus sperrt Zugriff auf Datenordner → Ausnahme definieren
- Datenordner wurde nicht (korrekt) im Service freigegeben → In Service-Einstellungen den Datenordner korrekt in Ordner-Freigabe eingeben. Schreibweise muss mit Datenordnereinstellung übereinstimmen. Siehe Log-Datei für erwartete Schreibweise.
- SQL-Server wurde nicht (korrekt) im Service freigegeben → In Service-Einstellungen die SQL-Server-Instanz korrekt in SQL-Server-Freigabe eingeben. Schreibweise muss mit Datenordnereinstellung übereinstimmen. Siehe Log-Datei für erwartete Schreibweise.
Kein Zugriff auf Dokumente
- Nicht ausreichende Zugriffsrechte auf ggf. abweichenden Dokumentenordner (Arbeitsplatzeinstellungen) → Rechte für den Benutzer erteilen, der den Service ausführt
- ggf. abweichender Dokumentenordner liegt im LAN auf Netzwerkfreigabe → der Benutzer „Lokales System“ kann nicht auf Netzwerkfreigaben zugreifen. Melden Sie den Service mit einem anderen Benutzer mit lokalen Administrator-Rechten an.