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.