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.