2. Dashlink-Druck: Bekannte Probleme und Fehlerbehebung
Inhaltsverzeichnis
Voraussetzungen
Bevor Sie Dashlink Print installieren, müssen Sie sicherstellen, dass alle früheren Versionen von QZ Tray deinstalliert sind.
Jeder Client muss QZ Tray zuerst manuell deinstallieren. Die beiden Anwendungen sollten nicht nebeneinander existieren, da sie um die gleiche Portnummer kämpfen.
- Unter Windows kann die Deinstallation über die Systemsteuerung/Systemeinstellungen durchgeführt werden.
- Für Mac kann die App in den Papierkorb gezogen werden, oder fortgeschrittene Benutzer möchten sie möglicherweise ausführen Deinstallationsskript.
- Für Linux ist die Deinstallationsskript wird gebraucht.
1. Bekannte Probleme
Widersprüchliche Anwendungen
Die folgenden Anwendungen können Probleme bei der Installation von Dashlink Print verursachen.
- Ältere Java-Versionen: Dashlink Print funktioniert am besten mit Java 11 oder höher. Ältere Versionen von Dashlink Print können zu Konflikten mit Dashlink Print führen und dazu führen, dass der Start fehlschlägt.
- Deinstallieren Sie nach Möglichkeit alle Versionen von Java, JRE, JDK oder OpenJDK vom System.
- Wenn die Deinstallation alter Java-Versionen nicht möglich ist, installieren Sie Dashlink Print 2.2 oder höher, das mit einer eigenen Java-Version geliefert wird.
- Antiviren Software: Einige Antivirenanwendungen verhindern möglicherweise die Installation oder Ausführung von Dashlink Print.
- Comodo Antivirus erzwingt die Anwendungseindämmung des Dashlink Print-Installationsprogramms und verhindert, dass es installiert, deinstalliert und ausgeführt wird. Darüber hinaus wird die Deaktivierung von Comodo nur sehr geringe Auswirkungen haben, da es sich ohne Vorwarnung selbst wieder aktiviert. Dashlink Print wird von Comodo Antivirus nicht unterstützt.
- Andere Antivirenprogramme:
- Anwendungsbeschränkung: Wenn das Antivirenprogramm die Anwendungseindämmung erzwingt, deaktivieren Sie bitte diese Anwendungseindämmung für Dashlink Print und die von ihm verwendete Java Runtime.
- Webfilterung: Wenn das Antivirenprogramm den Zugriff auf lokale Ports oder Localhost-Zertifikate blockiert, deaktivieren Sie es bitte oder setzen Sie es auf die Whitelist
https://localhost:8181
,http://localhost:8182
. - Temporärer Dateizugriff: Wenn das Antivirenprogramm den Zugriff auf das temporäre Verzeichnis blockiert, deaktivieren Sie bitte das Dashlink Print-Installationsprogramm oder setzen Sie es auf die Whitelist.
- Andere Probleme: QZ Industries bietet keinen Support für Probleme, die durch Antivirenanwendungen von Drittanbietern verursacht werden. Integrierte Funktionen (z. B. Windows Defender) werden unterstützt und können auf die verschiedenen erweitert werden Unterstützung Kanäle.
2. Fehlerbehebung
Debuggen von Dashlink Print
Protokolle
- So komprimieren Sie Protokolle automatisch und platzieren sie auf Ihrem Desktop:
- Dashlink-Drucksymbol, Erweitert, Fehlerbehebung, Zip-Protokolle (auf den Desktop)
- Dashlink Print platziert Protokolldateien an den folgenden Orten:
- Windows:
%APPDATA%\qz
- Mac:
~/Library/Application Support/qz
- Linux:
~/.qz
- Windows:
Konsolenprotokolle
- Der empfohlene Ansatz für eine ausführliche Ausgabe von Dashlink Print besteht darin, die Software über die Befehlszeile zu starten. Dadurch werden der Java-Konsole detaillierte Informationen zu Debug-Meldungen und Ausnahmen angezeigt, einschließlich einer vollständigen Rückverfolgung, wo eine bestimmte Ausnahme aufgetreten ist.
- Dashlink Print startet mit
512 MB
der Erinnerung. Wir müssen spezifizieren-Xms512M
im Befehl, um unerwartetes Verhalten und Abstürze zu verhindern. Dies ist für Mac nicht erforderlich, es sei denn, Sie befolgen die grundlegende Syntax (java -jar qz-tray.jar
). Mehr Speicher kann zugewiesen werden, sollte aber nicht notwendig sein.Grundlegende Syntax (nach dem Schließen aller Instanzen von Dashlink Print)java -Xms512M -jar qz-tray.jarWindows (nach dem Schließen aller Instanzen von Dashlink Print)java -Xms512M –add-exports java.desktop/sun.swing=ALL-UNNAMED -jar „%PROGRAMFILES%\Dashlink Print\qz-tray.jar“Mac OS X (nachdem alle Instanzen von Dashlink Print geschlossen wurden)/Applications/QZ\Tray.app/Contents/MacOS/QZ\TrayLinux/Andere (nachdem alle Instanzen von Dashlink Print geschlossen wurden)/opt/qz-tray/qz-tray
PKIX-Erstellungspfad fehlgeschlagen
Manchmal eine Nachricht java.lang.UnsupportedOperationException: Kann nicht analysiert werden (DATEI)
wird auftauchen. Hierbei handelt es sich häufig um einen Fehler von Java beim Herunterladen der spezifischen Ressource, und es kommt zu einem Fehler Verursacht durch: javax.net.ssl.SSLHandshakeException: sun.security.validator.ValidatorException: PKIX-Pfaderstellung fehlgeschlagen
- Um detaillierte Informationen zum HTTPS/SSL-Zertifikat abzurufen, hängen Sie an
-verbose -Djava.security.debug=certpath
Vor dem-Xms512
Befehl. Die Ausgabe wird sehr groß sein, Sie können sie mit in eine Datei umleiten> file.log 2>&1
Am Ende. - Siehe auch https://github.com/qzind/tray/files/2194181/Document.1906321.1.pdf
- Häufige Ursachen
- Defekte Zertifikatskette Abhilfe: Gültigkeit von sslshopper.com prüfen, Kette gemäß CA-Anweisungen reparieren.
- Selbstsigniertes Zertifikat Abhilfe: Fügen Sie für diese Adresse eine Ausnahme zum Proxy oder zur Firewall hinzu – ODER – Installieren Sie das Zertifikat in Java.
- Neu vertrauenswürdige Zertifizierungsstelle Abhilfe: Java aktualisieren. Dies ist bei LetsEncrypt-Zertifikaten ziemlich häufig der Fall.
Absturz beim Drucken
Die Software kann nicht gestartet werden
- Eine beschädigte Java-Installation kann die Installation oder das Laden der Software verhindern. Eine beschädigte Java-Installation kommt unter Windows recht häufig vor und kann durch eine Neuinstallation von Java mithilfe von Java behoben werden Offline-Installationsprogramm. Es wurde berichtet, dass das Offline-Installationsprogramm viele Probleme mit beschädigten Java-Installationen behebt. Schauen Sie mal rein diesen Leitfaden für unsere empfohlenen Schritte zur Neuinstallation von Java auf allen Plattformen.
Anzeichen einer beschädigten Java-Installation:Keystore für ws://localhost erstellen...
- [fehlgeschlagen] Erstellen eines CA-Schlüsselpaars ...
… oder …Java-Version
„Beim Verarbeiten der freigegebenen Archivdatei ist ein Fehler aufgetreten. Die Zuordnung des freigegebenen Speicherplatzes konnte nicht aufgehoben werden. Bei der Initialisierung der VM ist ein Fehler aufgetreten. Das freigegebene Archiv kann nicht verwendet werden.“
- Manchmal individuell
JAVA_HOME
Umgebungsvariablen verhindern, dass Dashlink Print geladen wird. Wenn die Software gestartet werden kann über die Kommandozeile das ist wahrscheinlich der Fall. In Windows kann dies überprüft werden, indem Sie auf gehen System > Erweiterte Systemeinstellungen > Umgebungsvariablen - HTML-Druck (JavaFX) kann dazu führen, dass der Druck fehlschlägt, wenn Folgendes zutrifft:
- Ausgabe: Die HTML-Seitenbreite ist auf 100% eingestellt.
Abhilfe: Codieren Sie eine akzeptable Seite mithilfe von CSS fest, z. B800px
- Ausgabe: Die Druckerauflösung für den HTML-Druck ist hoch (z. B. 600 dpi, 1200 dpi).
Abhilfe: Codieren Sie einen niedrigeren DPI-Wert (z. B. 300 dpi) fest mit{ Einheiten: 'in', Dichte: 300 }
. Wir empfehlen außerdem, eine vernünftige Einstellung vorzunehmenFallbackDensity
Falls 300 dpi von bestimmter Hardware nicht unterstützt wird. - Ausgabe: Beim Ausführen der 32-Bit-JVM kann es zu Problemen mit nicht genügend Arbeitsspeicher kommen.
Abhilfe: Sehen 32-Bit vs. 64-Bit: Abschnitt unten. - Ausgabe:
java.lang.NoClassDefFoundError: javafx/print/PrintColor bei qz.printer.PrintOptions$ColorType
Abhilfe: JavaFX wird nicht mit allen Java-Versionen verteilt. Bitte installieren Sie JavaFX für Ihre Plattform (z. Bopenjfx
, usw).
- Ausgabe: Die HTML-Seitenbreite ist auf 100% eingestellt.
- Bilder/PDFs führen dazu, dass die Software nicht mehr funktioniert: Häufiger
Die Methode public void qz.ws.PrintSocketClient#onMessage kann nicht aufgerufen werden
Dies ist im Allgemeinen ein Zeichen dafür, dass in der JVM ein nicht behebbarer Fehler aufgetreten ist. Die häufigste Ursache sind große Druckvorgänge auf einer 32-Bit-JVM. Eine vorübergehende Problemumgehung ist anzugeben{ rastern: false }
in der Konfiguration, aber dadurch werden nur PDFs repariert. Eine dauerhafte Lösung besteht darin, auf eine 64-Bit-JVM umzusteigen, die einen größeren Heap-Speicherplatz zuweist. Wenn 32-Bit erforderlich ist, kann zusätzlicher Heap-Speicherplatz über zugewiesen werden Befehlszeile. - 32-Bit vs. 64-Bit: Auf einigen 64-Bit-Workstations sind sowohl 32-Bit- als auch 64-Bit-Java-Versionen installiert. Wenn beide benötigt werden, stellen Sie sicher, dass beide aktualisiert sind. Andernfalls wird empfohlen, die 32-Bit-Version zu entfernen, um die Fehlerbehebung zu erleichtern.
- Unzureichende Java-Version
„Eine Java-Ausnahme ist aufgetreten“
kann erscheinen, wenn Sie versuchen, mit einer veralteten Java-Version zu starten. Eine Liste der Mindestanforderungen für Java finden Sie unter Java-Versionen. Kann auch als gemeldet werdenDie Hauptklasse qz.ws.PrintSocketServer konnte nicht gefunden werden. Anwendung wird beendet.
- Festplatte beschädigt: Immer versuchen
fsck
(Linux),Festplattendienstprogramm
(MacOS) bzwchkdsk
(Windows). Physische Laufwerke können seltsame Symptome zeigen, wenn sie anfangen auszufallen. SSD-Festplatten sind jedoch anfällig für einen Zustand, der „abgenutzte Bits“ oder besser gesagt „SSD-Ausdauer“ genannt wird und für die Wiederverwendung von NAND-Flash-Speicher verantwortlich ist. Dieser Prozess sollte selbstheilend sein, kann jedoch gelegentlich Probleme mit bestimmten Laufwerks-Firmwares verursachen. Stellen Sie sicher, dass Sie Ihre Festplatte auf ihren Zustand überprüfen, wenn Startprobleme auftreten.
Drucker können nicht aufgelistet werden
- Mac
- Aufgrund eines Upstream-Fehlers mit Java können Druckerlisten auf dem Mac fehlschlagen. Die aktuelle Problemumgehung besteht darin:
- Öffnen Sie die Systemeinstellungen „Drucker und Scanner“. Rechtsklick > „Drucksystem zurücksetzen“ – fügen Sie alle Drucker erneut hinzu
- Aufgrund eines Upstream-Fehlers mit Java können Druckerlisten auf dem Mac fehlschlagen. Die aktuelle Problemumgehung besteht darin:
- Windows
- Obwohl selten, kommt es vor, dass keine Drucker aufgelistet werden können, nur ein Drucker aufgelistet werden kann oder die Auflistung von Druckern mehrere Minuten in Anspruch nimmt. Dies wird wahrscheinlich durch einen Treiberkonflikt zwischen dem fehlerhaften Druckertreiber und dem Druckspooler verursacht, was dazu führt, dass das gesamte Drucksubsystem hängen bleibt. Die Problemumgehung besteht darin, den fehlerhaften Drucker oder Druckertreiber zu entfernen.
Rohdruckerwarteschlangen
Wenn Ihr Thermo- oder Etikettendrucker unerwünschte Ergebnisse liefert, ist er möglicherweise falsch konfiguriert. Hier sind unsere Tutorials zum Einrichten eines Druckers für den Empfang von Rohsprachen auf jeder Plattform:
Notiz: Einige Windows-Treiber, wie z. B. der ZDesigner-Treiber von Zebra für Microsoft Windows, unterstützen neben dem pixelbasierten/PostScript-Druck auch Raw-Druck. Sie können diese Treiber oder einen generischen Roh-/Nur-Text-Treiber verwenden, um Rohbefehle zu senden, aber der generische Treiber ist nicht in der Lage, Bilder/PDF/HTML zu drucken.
Debuggen von WebSockets
Standardmäßig unterdrückt Dashlink Print ausführliche Websocket-Informationen aus der Konsole. Gelegentlich können diese Informationen jedoch zum Debuggen/Beheben von Verbindungsproblemen nützlich sein.
Debuggen von WebSockets in 2.0
- Nur 2.0 - Verwendung der
qz.api.showDebug(...)
API-Option, ausführliche Verbindungsdetails werden in der Konsole des Browsers protokolliert.qz.api.showDebug(true); // muss vor dem Aufruf von qz.websocket.connect() aufgerufen werden
Steckdose nicht angeschlossen
- Dies ist oft ein Zeichen für eine inkompatible Version. Bitte stellen Sie sicher, dass Sie einen für Ihr System korrekten Build verwenden (z. B. 1.9, 2.0).
Andere Fehler
- Konsolenprotokolle sagen
Der Vorgang wurde mit Exit-Code 2 abgeschlossen
- Ursache: Dies weist darauf hin, dass bereits eine andere Instanz von Dashlink Print auf den angegebenen Ports auf diesem Computer ausgeführt wird. Wenn es nicht mehr reagiert, versuchen Sie, die Dashlink-Drucke zu deaktivieren
Java
Führen Sie den Vorgang aus und versuchen Sie erneut, ihn zu starten.
- Ursache: Dies weist darauf hin, dass bereits eine andere Instanz von Dashlink Print auf den angegebenen Ports auf diesem Computer ausgeführt wird. Wenn es nicht mehr reagiert, versuchen Sie, die Dashlink-Drucke zu deaktivieren
- Fehler:
Typfehler: _qz.tools.hash ist keine Funktion
- Ursache: Stellen Sie sicher, dass die Seite mit UTF-8 gerendert wird
<meta charset='utf-8'>
.
- Ursache: Stellen Sie sicher, dass die Seite mit UTF-8 gerendert wird
- Fehler:
WebSocket-Verbindung zu „wss://localhost:8181/“ fehlgeschlagen: Fehler beim Verbindungsaufbau: net::ERR_CONNECTION_CLOSED
- Ursache: Es ist bekannt, dass Java 9 (Beta) diesen Fehler verursacht. Bitte auf eine unterstützte Version herunterstufen Java-Version.
- Fehler:
SCRIPT1010: Erwarteter Bezeichner qz-tray.js
- Ursache: IE11 emuliert möglicherweise einen älteren Browser. Bitte verwenden Sie die Browseremulation IE10, IE11 oder Edge. Beleidigender Code könnte so aussehen
<meta http-equiv="X-UA-Compatible" content="IE=EmulateIE7" />
- Ursache: IE11 emuliert möglicherweise einen älteren Browser. Bitte verwenden Sie die Browseremulation IE10, IE11 oder Edge. Beleidigender Code könnte so aussehen
- Fehler:
Der Server hat den HTTP-Antwortcode 403 für die URL zurückgegeben
- Ursache: Vorausgesetzt, dass Berechtigungsprobleme ausgeschlossen wurden, erfordern einige Server eine
Benutzer-Agent-Zeichenfolge
an den Web-Controller übergeben werden. Dashlink Print 2.0 sendet ein LeerzeichenBenutzer-Agent-Zeichenfolge
. Dashlink Print 2.1+ bietet eine ordnungsgemäße FunktionBenutzer-Agent-Zeichenfolge
. Alternativ können Sie die deaktivierenFilterung von Benutzeragenten
auf dem Webcontroller. Cloudfare nennt dies beispielsweiseBrowser-Integritätsprüfung
und kann deaktiviert werden.
- Ursache: Vorausgesetzt, dass Berechtigungsprobleme ausgeschlossen wurden, erfordern einige Server eine
Ungültiger JSON
- Wenn die Browserkonsole sagt
Ungültiger JSON
Versuchen Sie, Ihre HTTP-Header im zu verwendenden Sign-Message-Beispiel zu ändernText/einfach
anstattapplication/json
. In PHP geschieht dies über:- header('Content-Type: application/json'); + header('Content-Type: text/plain');Notiz: Diese Technik variiert je nach verwendeter serverseitiger Sprache.
JScript
- Fehler:
Für diese Plattform ist keine automatische Zertifikatinstallation verfügbar
- Ursache: Mehrere.
- Notiz: Dashlink Print 2.1 verwendet Java für die Zertifikatsinstallation und kann dieses Problem möglicherweise beheben.
- Wenn Sie Comodo Antivirus verwenden, verwenden Sie vor der Installation die Option „Erweiterte Ansicht“, „Automatische Eindämmung“ und „Deaktiviert“.
- Wenn Sie Windows XP verwenden, befolgen Sie die Anweisungen auf dem Bildschirm.
- Dieses Problem kann durch fehlerhafte Daten verursacht werden, die von zurückgegeben werden
certutil
Befehl. Kontakt support@qz.io zur Hilfe.
- Ursache: Mehrere.
- Fehler:
Die Skript-Engine „VBScript“ für das Skript kann nicht gefunden werden.
- Notiz: Dashlink Print hat das entfernt
VBScript/JScript
Abhängigkeit und kann dieses Problem beheben. - Ursache: Die Windows-Desktop-Installationsprogramme werden von Windows verwendet
JScript
Motor für bestimmte Aufgaben. Gelegentlich versuchen Antiviren-Engines möglicherweise, diese Engine zu ersetzen. Um festzustellen, ob dies die Ursache ist, führen Sie die folgenden Befehle über die Eingabeaufforderung aus: reg query HKCR\CLSID\{cc5bbec3-db4a-4bed-828d-08d78ee3e1ed}\InprocServer32 /ve reg query HKCR\CLSID\{f414c260-6ac0-11cf-b6d1 -00aa00bbbb58}\InprocServer32 /ve reg query HKCR\CLSID\{f414c261-6ac0-11cf-b6d1-00aa00bbbb58}\InprocServer32 /ve reg query HKCR\CLSID\{f414c262-6ac0-11cf-b6d1-00aa00bbbb58}\Inproc Server32 /ve - Wenn das System richtig konfiguriert ist, gibt jeder Befehl den folgenden Wert zurück:
(Standard) REG_SZ C:\Windows\System32\jscript.dll
- Wenn das System falsch konfiguriert ist, wird ein anderer Wert zurückgegeben. Dieser Wert kann manuell mit dem Windows-Registrierungseditor repariert werden.
- Notiz: Dashlink Print hat das entfernt
3. Unterstützung
Wenn Sie Fragen oder Probleme bei der Verwendung des Dashboards haben, eröffnen Sie bitte einen Support-Fall, indem Sie uns schreiben an: upsplugins@ecommerce.help und geben Sie die folgenden Informationen an
- Fehlerbeschreibung (idealerweise mit Video/Screenshots)
- Computer-Betriebssystem
- Druckermodell
War dieser Artikel hilfreich?
Haben Sie weitere Fragen? Einen Antrag stellen