Dieser Artikel ist nur für erfahrene Benutzer und zu Fehlerbehebungszwecken. Ändern Sie Dateien auf eigenes Risiko. Um Änderungen wirksam zu machen, müssen Sie die Anwendung stoppen und neu starten.
Abschnitte in diesem Artikel:
- Protokollierung
- Settings Datei
- Proxy settings
- Headless-Modus
- Ausführung als Windows-Dienst
- Endpoints
Protokollierung
nShift ApportConnect protokolliert Ereignisse in einer Datei namens application.log, die sich im Installationsverzeichnis befindet. Wenn Sie nicht sicher sind, wo nShift ApportConnect installiert ist, lesen Sie den Abschnitt Installation im Artikel Herunterladen und Installieren von ApportConnect.
Wenn etwas schiefgeht, möchten Sie möglicherweise die Protokolldatei(en) zur Überprüfung an den Kundensupport von nShift senden. Standardmäßig ist das Protokollierungslevel auf INFO gesetzt, was nur die wichtigsten Ereignisse und Fehler protokolliert. Sie können das Protokollierungslevel auf DEBUG unter Settings > ApportConnect Settings > Allgemein Settings ändern. Dies führt dazu, dass nShift ApportConnect alle Ereignisse und Fehler mit detaillierteren Informationen protokolliert, was für Debugging und Fehlerbehebung nützlich ist.
Sie können die Protokolldatei auch direkt an den Kundensupport von nShift senden, indem Sie auf Hilfe & Support > Kontaktieren Sie nShift klicken, das Formular ausfüllen und auf Senden klicken. Die Protokolldatei wird automatisch angehängt.
Settings Datei
Das Programm und die Benutzer settings werden in zwei separaten Dateien gespeichert: user_settings.json und program_settings.json, die sich im selben Verzeichnis wie die Protokolldatei befinden. (Das Installationsverzeichnis). Diese Datei enthält Informationen über die Benutzereinrichtung in nShift ApportConnect, sowie darüber, an welchen Server Dateien gesendet und Dokumente abgerufen werden sollen.
Proxy settings
nShift ApportConnect unterstützt die Verwendung eines HTTPS-Proxys für alle ausgehenden Kommunikationen. Um diese Funktion zu aktivieren, navigieren Sie zu Settings > ApportConnect Settings > Proxy Settings. Enable den Proxy und geben Sie die Proxy-Adresse und den Port ein. Stellen Sie sicher, dass Sie die Anwendung nach dem Speichern Ihrer Änderungen neu starten.
Headless-Modus
Sie können nShift ApportConnect im Headless-Modus ausführen, indem Sie das Programmargument -headless beim Starten des Programms übergeben. Es wird als Prozess im Betriebssystem ausgeführt, ohne eine GUI anzuzeigen. Wenn Sie das Programm von einem Terminal ausführen, wird die gesamte Ausgabe (Protokollierung) direkt an Sie angezeigt. Zusätzlich können Sie grundlegende Befehle im Terminal eingeben, um weitere Informationen zu erhalten und manuelle Ausdrucke durchzuführen. Um die verfügbaren Befehle zu sehen, geben Sie help ein, um eine Liste der Befehle anzuzeigen.
Ausführung als Windows-Dienst
Hinweis: Aufgrund der Plattformunabhängigkeit von nShift ApportConnect wurde kein nativer Code zur Ausführung als Windows-Dienst enthalten. Es gibt jedoch eine einfache Methode, um nShift ApportConnect als Dienst mit einer Drittanbieterbibliothek auszuführen.
nShift kann keine Verantwortung übernehmen oder die volle Funktionalität von Drittanbieteranwendungen gewährleisten.
In diesem Beispiel wird das Programm NSSM (Non-Sucking Service Manager) verwendet, um nShift ApportConnect als Windows-Dienst zu installieren.
- Laden Sie NSSM herunter unter (http://nssm.cc/download)
- Entpacken Sie die Dateien und wählen Sie den win32- oder win64-Ordner, abhängig von Ihrer OS-Architektur.
- Kopieren Sie nssm.exe aus dem entsprechenden Ordner (aus Schritt 2 ausgewählt) an einen beliebigen Ort auf Ihrem Computer (oder C:\Windows\System32, wenn Sie es global zugänglich machen möchten)
- Starten Sie eine Windows-Eingabeaufforderung mit Administratorrechten.
- (Überspringen Sie diesen Schritt, wenn nssm.exe in C:\Windows\System32 ist). Navigieren Sie in der Eingabeaufforderung zum Speicherort von nssm.exe.
- Geben Sie
nssm.exe install “ApportConnect”ein und drücken Sie Return/Enter.
- Es sollte ein neues Fenster angezeigt werden. Unter Anwendungspfad suchen und wählen Sie die installierte ApportConnect.exe aus.
- Sie können auch verschiedene andere Optionen in diesem Programm konfigurieren, wie z.B. den Benutzer, unter dem der Dienst ausgeführt werden soll, Prozesspriorität, Herunterfahrmethoden, automatischen Neustart und mehr. Für detaillierte Informationen lesen Sie den NSSM-Nutzungsleitfaden: NSSM - the Non-Sucking Service Manager.
- Wenn Sie die Konfiguration des Dienstes abgeschlossen haben, klicken Sie auf Dienst installieren.
-
Um den Dienst später über NSSM zu bearbeiten, öffnen Sie eine Eingabeaufforderung und geben Sie
nssm.exe edit "ApportConnect"ein.
Endpoints
Die folgenden Endpoints werden von ApportConnect verwendet:
- https://service.web-ta.net/integration/api/printr/print
- https://service.web-ta.net/integration/api/printr/incoming
- https://service.web-ta.net/integration/api/printr/lookup
- https://service.web-ta.net/integration/api/printr/version/getnew
- https://service.web-ta.net/integration/api/printr/support
Port: 443 (https://)