Aktualisierung CarrierAPI

Aus Wiki - Heidler Strichcode GmbH
Zur Navigation springen Zur Suche springen


In dieser Beschreibung finden Sie alle notwendigen Informationen, um die Carrier API Version 3 zu aktualisieren. Bitte lesen Sie sich diese aufmerksam durch. Bei Rückfragen wenden Sie sich bitte direkt an den Support (support@heidler-strichcode.de)

Verzeichnisname / Dienstname

Die Carrier API wird in der Regel im Heidler Verzeichnis als HeidlerCarrierAPI installiert.

Die Benamung des Windowsdiensts entspricht dabei der Benamung des Installationsverzeichnisses.

Kompatibilität

Die Carrier API ab Version 2.0 kann problemlos auf die neueste Version aktualisiert werden.

Update Dauer / Downtime

Für das Update sollten ca. 5 Minuten Downtime eingeplant werden.

Während dieser Zeit können Sie nicht mit Frachtführern verarbeiten, die über einen Webservice abwickeln.

Offline-Abwicklungen sind davon nicht betroffen.

Was muss nach dem Update gemacht werden?

Während der Aktualisierung wird automatisch der Windowsdienst beendet.

Dieser wird nach dem ausführen des Setups im Standard nicht automatisch gestartet.

Dies muss manuell erfolgen. Alternativ gibt es im Setup ein Häkchen um den Dienst automatisch starten zu lassen.

Wie prüfe ich, ob die Applikation nach dem Update ordnungsgemäß funktioniert?

Nachdem der Windowsdienst wieder gestartet worden ist, sollten zum einen die Logs der Carrier API geprüft werden. Diese befinden sich im Hauptverzeichnis im Unterordner logs.

carrierapiservice.log: In diesem Log kann der Start / Stopp vom Windowsdienst, sowie eingehende Anfragen nachvollzogen werden.

error.log: In diesem Log findet man alle aufgetretenen Applikationsfehler

Prüfen Sie nach der Verarbeitung in einem Webservice Modul beide Logs, ob Anfragen erfolgreich verarbeitet werden konnten und ob Fehlermeldungen auftreten.

Weitere Logs:

Jedes Carrier API Modul hat detaillierte Logs zur Verarbeitung im jeweiligen Modul.

Hier werden u.a. auch die komplette Anfrage an den Webservice und dessen Antwort vom Webservice geloggt.

Welche Tests sollte Ich nach dem Update durchführen?

Nachdem der Dienst gestartet wurde sollte man einen Testdatensatz verarbeiten.

Hierzu können Sie einen Frachtführer Ihrer Wahl verwenden, sofern dieser über einen Webservice arbeitet.

Sonstige Besonderheiten

Es gibt keine weitere Besonderheit.