{"id":1669,"date":"2022-12-05T15:52:00","date_gmt":"2022-12-05T15:52:00","guid":{"rendered":"https:\/\/ecommerce.help\/?p=1669"},"modified":"2023-07-06T08:38:28","modified_gmt":"2023-07-06T08:38:28","slug":"known-issues-troubleshooting","status":"publish","type":"post","link":"https:\/\/ecommerce.help\/ecommerce-shipping-solution\/dashlink-print\/known-issues-troubleshooting\/","title":{"rendered":"2. Dashlink Print: Known Issues &#038; Troubleshooting"},"content":{"rendered":"\n<div class=\"wp-block-rank-math-toc-block\" id=\"rank-math-toc\"><h2>Table of Contents<\/h2><nav><ul><li class=\"\"><a href=\"#pre-requisites\">Pre-requisites<\/a><\/li><li class=\"\"><a href=\"#1-known-issues\">1. Known Issues<\/a><ul><li class=\"\"><a href=\"#conflicting-applications\">Conflicting Applications<\/a><\/li><\/ul><\/li><li class=\"\"><a href=\"#2-troubleshooting\">2. Troubleshooting<\/a><ul><li class=\"\"><a href=\"#debugging-dashlink-print\">Debugging Dashlink Print<\/a><ul><li class=\"\"><a href=\"#logs\">Logs<\/a><\/li><li class=\"\"><a href=\"#console-logs\">Console Logs<\/a><\/li><li class=\"\"><a href=\"#pkix-build-path-failed\">PKIX Build Path Failed<\/a><\/li><\/ul><\/li><li class=\"\"><a href=\"#crash-during-printing\">Crash During Printing<\/a><\/li><li class=\"\"><a href=\"#cannot-launch-software\">Cannot Launch Software<\/a><\/li><li class=\"\"><a href=\"#cannot-list-printers\">Cannot List Printers<\/a><\/li><li class=\"\"><a href=\"#raw-printer-queues\">Raw Printer Queues<\/a><\/li><li class=\"\"><a href=\"#debugging-web-sockets\">Debugging WebSockets<\/a><ul><li class=\"\"><a href=\"#debugging-web-sockets-in-2-0\">Debugging WebSockets in 2.0<\/a><\/li><\/ul><\/li><li class=\"\"><a href=\"#socket-disconnected\">Socket Disconnected<\/a><\/li><li class=\"\"><a href=\"#other-errors\">Other Errors<\/a><\/li><li class=\"\"><a href=\"#invalid-json\">Invalid JSON<\/a><\/li><li class=\"\"><a href=\"#j-script\">JScript<\/a><\/li><\/ul><\/li><li class=\"\"><a href=\"#3-support\">3. Support<\/a><\/li><\/ul><\/nav><\/div>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"pre-requisites\">Pre-requisites<\/h2>\n\n\n\n<p>Before installing Dashlink Print you must make sure to have all previous versions of QZ Tray uninstalled. <\/p>\n\n\n\n<p>Each client will need to manually&nbsp;uninstall&nbsp;QZ&nbsp;Tray first, the two applications should not coexist because they will fight for the same port number.<\/p>\n\n\n\n<ul>\n<li>For Windows, the&nbsp;uninstall&nbsp;can be performed through the Control Panel\/System Preferences.<\/li>\n\n\n\n<li>For Mac, the app can be dragged to the recycling&nbsp;bin, or advanced users may wish to run the&nbsp;<a href=\"https:\/\/qz.io\/docs\/deployment#windows-uninstall\" target=\"_blank\" rel=\"noreferrer noopener\">uninstall&nbsp;script<\/a>.<\/li>\n\n\n\n<li>For Linux, the&nbsp;<a href=\"https:\/\/qz.io\/docs\/deployment#windows-uninstall\" target=\"_blank\" rel=\"noreferrer noopener\">uninstall&nbsp;script<\/a>&nbsp;is needed.<\/li>\n<\/ul>\n\n\n\n<p><\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"1-known-issues\"><a id=\"_Toc98272178\">1. Known Issues<\/a><\/h2>\n\n\n\n<h4 class=\"wp-block-heading\" id=\"conflicting-applications\">Conflicting Applications<\/h4>\n\n\n\n<p>The following applications may cause issues with Dashlink Print installation.<\/p>\n\n\n\n<ul>\n<li><strong>Older Java versions:<\/strong>&nbsp;Dashlink Print works best with Java 11 or higher. Older Dashlink Print versions may conflict with Dashlink Print and cause it to fail to start.\n<ul>\n<li>If possible, uninstall all versions of Java, JRE, JDK or OpenJDK from the system.<\/li>\n\n\n\n<li>If uninstalling old versions of Java is not possible, install Dashlink Print 2.2 or higher, which will come bundled with its own Java version.<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><strong>Antivirus Software:<\/strong>&nbsp;Some antivirus applications may prevent Dashlink Print from installing or running.\n<ul>\n<li>Comodo Antivirus will force application containment the Dashlink Print installer and prevent it from being installed, uninstalled and prevent it from running. Moreover, disabling Comodo will have very little effect because it will re-enable itself without warning. Dashlink Print is not supported with Comodo Antivirus.<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><strong>Other Antivirus:<\/strong>\n<ul>\n<li><strong>Application containment:<\/strong>&nbsp;If the antivirus forces application containment, please disable this application containment for Dashlink Print and the Java Runtime which it uses.<\/li>\n\n\n\n<li><strong>Web Filtering:<\/strong>&nbsp;If the antivirus blocks access to local ports or localhost certificates, please disable or whitelist&nbsp;<code>https:\/\/localhost:8181<\/code>,&nbsp;<code>http:\/\/localhost:8182<\/code>.<\/li>\n\n\n\n<li><strong>Temporary File Access:<\/strong>&nbsp;If the antivirus blocks access to the temporary directory, please disable or whitelist the Dashlink Print installer.<\/li>\n\n\n\n<li><strong>Other issues:<\/strong>&nbsp;QZ Industries does not provide support for issues created by third party antivirus applications. Built-in features (such as Windows Defender) are supported and may be escalated to the various&nbsp;<a href=\"https:\/\/qz.io\/support\/\" target=\"_blank\" rel=\"noopener\">support<\/a>&nbsp;channels.<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"2-troubleshooting\"><a id=\"_Toc98272179\">2. Troubleshooting<\/a><\/h2>\n\n\n\n<h4 class=\"wp-block-heading\" id=\"debugging-dashlink-print\">Debugging Dashlink Print<\/h4>\n\n\n\n<h5 class=\"wp-block-heading\" id=\"logs\"><a href=\"https:\/\/qz.io\/wiki\/faq#logs\" target=\"_blank\" rel=\"noopener\"><\/a>Logs<\/h5>\n\n\n\n<ul>\n<li>To automatically zip logs and place on your desktop:\n<ul>\n<li>Dashlink Print Icon, Advanced, Troubleshooting, Zip Logs (To Desktop)<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li>Dashlink Print places log files in the following locations:\n<ul>\n<li>Windows:&nbsp;<code>%APPDATA%\\qz<\/code><\/li>\n\n\n\n<li>Mac:&nbsp;<code>~\/Library\/Application Support\/qz<\/code><\/li>\n\n\n\n<li>Linux:&nbsp;<code>~\/.qz<\/code><\/li>\n<\/ul>\n<\/li>\n<\/ul>\n\n\n\n<h5 class=\"wp-block-heading\" id=\"console-logs\"><a href=\"https:\/\/qz.io\/wiki\/faq#console-logs\" target=\"_blank\" rel=\"noopener\"><\/a>Console Logs<\/h5>\n\n\n\n<ul>\n<li>The recommended approach for getting verbose output from Dashlink Print is to launch the software from command line. This will expose the Java Console with detailed information about debug messages and exceptions including full backtrace of where a particular exception occurred.<\/li>\n\n\n\n<li>Dashlink Print launches with&nbsp;<code>512MB<\/code>&nbsp;of memory. We must specify&nbsp;<code>-Xms512M<\/code>&nbsp;in the command in order to prevent unexpected behavior and crashing. This unnecessary for Mac unless following the basic syntax (<code>java -jar qz-tray.jar<\/code>) . More memory can be allocated but should not be necessary.<strong>Basic syntax<\/strong>&nbsp;(after closing all instances of Dashlink Print)java -Xms512M -jar qz-tray.jar<strong>Windows<\/strong>&nbsp;(after closing all instances of Dashlink Print)java -Xms512M &#8211;add-exports java.desktop\/sun.swing=ALL-UNNAMED -jar &#8220;%PROGRAMFILES%\\Dashlink Print\\qz-tray.jar&#8221;<strong>Mac OS X<\/strong>&nbsp;(after closing all instances of Dashlink Print)\/Applications\/QZ\\ Tray.app\/Contents\/MacOS\/QZ\\ Tray<strong>Linux\/Other<\/strong>&nbsp;(after closing all instances of Dashlink Print)\/opt\/qz-tray\/qz-tray<\/li>\n<\/ul>\n\n\n\n<h5 class=\"wp-block-heading\" id=\"pkix-build-path-failed\"><a href=\"https:\/\/qz.io\/wiki\/faq#pkix-build-path-failed\" target=\"_blank\" rel=\"noopener\"><\/a>PKIX Build Path Failed<\/h5>\n\n\n\n<p>Sometimes a message&nbsp;<code>java.lang.UnsupportedOperationException: Cannot parse (FILE)<\/code>&nbsp;will appear. This is often a failure by Java to download the specific resource and it will be followed by&nbsp;<code>Caused by: javax.net.ssl.SSLHandshakeException: sun.security.validator.ValidatorException: PKIX path building failed<\/code><\/p>\n\n\n\n<ul>\n<li>To fetch detailed HTTPS\/SSL certificate information, append&nbsp;<code>-verbose -Djava.security.debug=certpath<\/code>&nbsp;before the&nbsp;<code>-Xms512<\/code>&nbsp;command. The output will be very large, you may redirect it to file using&nbsp;<code>&gt; file.log 2&gt;&amp;1<\/code>&nbsp;at the end.<\/li>\n\n\n\n<li>See also&nbsp;<a href=\"https:\/\/github.com\/qzind\/tray\/files\/2194181\/Document.1906321.1.pdf\" target=\"_blank\" rel=\"noopener\">https:\/\/github.com\/qzind\/tray\/files\/2194181\/Document.1906321.1.pdf<\/a><\/li>\n\n\n\n<li><strong>Common Causes<\/strong>\n<ul>\n<li><strong>Broken certificate chain<\/strong>&nbsp;Remedy: Check validity sslshopper.com, fix chain per CA instructions.<\/li>\n\n\n\n<li><strong>Self-signed certificate<\/strong>&nbsp;Remedy: Add an exception to Proxy or Firewall for this address &#8212; OR &#8212; Install certificate into Java.<\/li>\n\n\n\n<li><strong>Newly-trusted CA<\/strong>&nbsp;Remedy: Update Java. This is fairly common for LetsEncrypt certificates.<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n\n\n\n<h4 class=\"wp-block-heading\" id=\"crash-during-printing\"><a href=\"https:\/\/qz.io\/wiki\/faq#crash-during-printing\" target=\"_blank\" rel=\"noopener\"><\/a>Crash During Printing<\/h4>\n\n\n\n<h4 class=\"wp-block-heading\" id=\"cannot-launch-software\"><a href=\"https:\/\/qz.io\/wiki\/faq#cannot-launch-software\" target=\"_blank\" rel=\"noopener\"><\/a>Cannot Launch Software<\/h4>\n\n\n\n<ol>\n<li>A corrupt Java installation may prevent the software from installing or loading. A corrupt Java installation is fairly common in Windows, and can be resolved by reinstalling Java using the Java&nbsp;<a href=\"https:\/\/java.com\/en\/download\/manual.jsp\" target=\"_blank\" rel=\"noopener\">offline installer<\/a>. The offline installer has been reported to fix many issues with corrupt Java installations. Take a look at&nbsp;<a href=\"https:\/\/qz.io\/wiki\/upgrading-java\" target=\"_blank\" rel=\"noopener\">this guide<\/a>&nbsp;for our recommended steps on reinstalling Java on all platforms.<br><br><strong>Signs of a corrupt Java install:<\/strong><code>Creating keystore for ws:\/\/localhost...<\/code><br><code>- [failed] Creating a CA keypair...<\/code><br><br>&#8230; or &#8230;<br><br><strong><code>java -version<\/code><\/strong><br><code>\"An error has occurred while processing the shared archive file. Unable to unmap shared space. Error occurred during initialization of VM. Unable to use shared archive.\"<\/code><\/li>\n\n\n\n<li>Sometimes custom&nbsp;<code>JAVA_HOME<\/code>&nbsp;environmental variables will prevent Dashlink Print from loading. If the software can be launched&nbsp;<a href=\"https:\/\/qz.io\/wiki\/faq#debugging-qz-tray\" target=\"_blank\" rel=\"noopener\">via the command line<\/a>&nbsp;this is likely the case. In windows this can be checked by going to&nbsp;<strong>System &gt; Advanced system settings &gt; Environment Variables<\/strong><\/li>\n\n\n\n<li>HTML printing (JavaFX) can cause printing to fail if the following is true:\n<ul>\n<li><strong>Issue<\/strong>: HTML page width is set to 100%.<br><strong>Remedy:<\/strong>&nbsp;Hard-code an acceptable page with using CSS, e.g.&nbsp;<code>800px<\/code><\/li>\n\n\n\n<li><strong>Issue<\/strong>: Printer resolution for HTML print is high (e.g. 600dpi, 1200dpi).<br><strong>Remedy<\/strong>: Hard-code a lower DPI (e.g. 300dpi) using&nbsp;<a href=\"https:\/\/qz.io\/api\/qz.configs#.setDefaults\" target=\"_blank\" rel=\"noopener\"><code>{ units: 'in', density: 300 }<\/code><\/a>. We also recommend setting a sane&nbsp;<code>fallbackDensity<\/code>&nbsp;incase 300dpi is unsupported by certain hardware.<\/li>\n\n\n\n<li><strong>Issue<\/strong>: Out of memory issues can occur if running the 32-bit JVM.<br><strong>Remedy<\/strong>: See&nbsp;<strong>32-bit vs. 64-bit:<\/strong>&nbsp;section below.<\/li>\n\n\n\n<li><strong>Issue<\/strong>:&nbsp;<code>java.lang.NoClassDefFoundError: javafx\/print\/PrintColor at qz.printer.PrintOptions$ColorType<\/code><br><strong>Remedy<\/strong>: JavaFX is not distributed with all Java versions. Please install JavaFX for your platform (e.g.&nbsp;<code>openjfx<\/code>, etc).<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><strong>Images\/PDFs cause software to stop working<\/strong>: More commonly&nbsp;<code>Cannot call method public void qz.ws.PrintSocketClient#onMessage<\/code>, this is generally a sign that the JVM has hit an unrecoverable error. The most common cause is large print operations on a 32-bit JVM. A temporary workaround is to specify&nbsp;<a href=\"https:\/\/qz.io\/wiki\/2.0-Pixel-Printing#rasterize\" target=\"_blank\" rel=\"noopener\"><code>{ rasterize: false }<\/code><\/a>&nbsp;in the configuration, but this will only fix PDFs. A permanent solution is to switch to a 64-bit JVM which allocates a larger heap space. If 32-bit is required, additional heap space may be allocated via&nbsp;<a href=\"https:\/\/qz.io\/wiki\/faq#troubleshooting\" target=\"_blank\" rel=\"noopener\">command-line<\/a>.<\/li>\n\n\n\n<li><strong>32-bit vs. 64-bit:<\/strong>&nbsp;Some 64-bit workstations have both 32-bit and 64-bit Java versions installed. If both are needed, make sure both are upgraded, otherwise, removing the 32-bit version is advised to assist with the troubleshooting process.<\/li>\n\n\n\n<li><strong>Insufficient Java Version<\/strong>&nbsp;<code>\"A Java Exception has occurred\"<\/code>&nbsp;may appear if attempting to launch against an outdated Java version. For a list of minimum Java requirements see&nbsp;<a href=\"https:\/\/qz.io\/wiki\/faq#java-versions\" target=\"_blank\" rel=\"noopener\">Java Versions<\/a>. May also be reported as&nbsp;<code>Could not find the main class qz.ws.PrintSocketServer. Program will exit.<\/code><\/li>\n\n\n\n<li><strong>Disk Corrupted:<\/strong>&nbsp;Always try&nbsp;<code>fsck<\/code>&nbsp;(Linux),&nbsp;<code>Disk Utility<\/code>&nbsp;(MacOS) or&nbsp;<code>chkdsk<\/code>&nbsp;(Windows). Physical drives can show strange symptoms when they are beginning to fail however SSDs hard drives are susceptible to a condition called &#8220;worn bits&#8221; or more properly &#8220;SSD Endurance&#8221; which is responsible for re-using NAND flash memory. This process should be self-healing but on occasion can cause issues with certain drive firmwares. Make sure to scan your disk for health when encountering launch issues.<\/li>\n<\/ol>\n\n\n\n<h4 class=\"wp-block-heading\" id=\"cannot-list-printers\"><a href=\"https:\/\/qz.io\/wiki\/faq#cannot-list-printers\" target=\"_blank\" rel=\"noopener\"><\/a>Cannot List Printers<\/h4>\n\n\n\n<ol>\n<li>Mac\n<ul>\n<li>Due to an upstream bug with Java, printer listings may fail on Mac.The current workaround is to:<ul><li>Open System PreferencesPrinters and ScannersRight Click &gt; Reset Printing SystemRe-add all printers<\/li><\/ul>We realize this is not ideal, but have found no another work-around on Mac.<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li>Windows\n<ul>\n<li>Although rare, there are scenarios of not being able to list printers, only being able to list one printer, or listing printers takes several minutes to complete. This is likely caused by a driver conflict between the offending printer driver and the print spooler, resulting in the entire print subsystem to hang.The workaround is to remove the offending printer or printer driver.<\/li>\n<\/ul>\n<\/li>\n<\/ol>\n\n\n\n<h4 class=\"wp-block-heading\" id=\"raw-printer-queues\"><a href=\"https:\/\/qz.io\/wiki\/faq#raw-printer-queues\" target=\"_blank\" rel=\"noopener\"><\/a>Raw Printer Queues<\/h4>\n\n\n\n<p>If your thermal or label printer has undesired results, it may be improperly configured. Here are our tutorials for setting up a printer to receive raw languages on each platform:<\/p>\n\n\n\n<ul>\n<li><a href=\"https:\/\/qz.io\/wiki\/setting-up-a-raw-printer-in-windows\" target=\"_blank\" rel=\"noopener\">Windows<\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/qz.io\/wiki\/setting-up-a-raw-printer-in-osx\" target=\"_blank\" rel=\"noopener\">OS X<\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/qz.io\/wiki\/setting-up-a-raw-printer-in-ubuntu-linux\" target=\"_blank\" rel=\"noopener\">Linux<\/a><\/li>\n<\/ul>\n\n\n\n<p><strong>Note:<\/strong>&nbsp;Some Windows drivers, such as Zebra&#8217;s ZDesigner driver for Microsoft Windows, will support raw printing alongside pixel-based\/PostScript printing. You may use those drivers or a raw-generic\/text-only driver to send raw commands, but the generic driver will not be able to print images\/PDF\/HTML.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\" id=\"debugging-web-sockets\"><a href=\"https:\/\/qz.io\/wiki\/faq#debugging-websockets\" target=\"_blank\" rel=\"noopener\"><\/a>Debugging WebSockets<\/h4>\n\n\n\n<p>By default, Dashlink Print suppresses verbose websocket information from the console, however occasionally this information may be useful for debugging\/troubleshooting connectivity issues.<\/p>\n\n\n\n<h5 class=\"wp-block-heading\" id=\"debugging-web-sockets-in-2-0\"><a href=\"https:\/\/qz.io\/wiki\/faq#debugging-websockets-in-20\" target=\"_blank\" rel=\"noopener\"><\/a>Debugging WebSockets in 2.0<\/h5>\n\n\n\n<ul>\n<li><strong>2.0 Only<\/strong>&nbsp;&#8211; Using the&nbsp;<a href=\"https:\/\/qz.io\/api\/qz.api#.showDebug\" target=\"_blank\" rel=\"noopener\"><code>qz.api.showDebug(...)<\/code><\/a>&nbsp;API option, verbose connection details will logged to the browser&#8217;s console.qz.api.showDebug(true); \/\/ must be called prior to calling qz.websocket.connect()<\/li>\n<\/ul>\n\n\n\n<h4 class=\"wp-block-heading\" id=\"socket-disconnected\"><a href=\"https:\/\/qz.io\/wiki\/faq#socket-disconnected\" target=\"_blank\" rel=\"noopener\"><\/a>Socket Disconnected<\/h4>\n\n\n\n<ul>\n<li>This is often a sign of an incompatible version. Please make sure you are using a build correct for your system (e.g. 1.9, 2.0)<\/li>\n<\/ul>\n\n\n\n<h4 class=\"wp-block-heading\" id=\"other-errors\"><a href=\"https:\/\/qz.io\/wiki\/faq#other-errors\" target=\"_blank\" rel=\"noopener\"><\/a>Other Errors<\/h4>\n\n\n\n<ul>\n<li>Console logs say&nbsp;<code>Process finished with exit code 2<\/code>\n<ul>\n<li>Cause: This indicates another instance of Dashlink Print is already running on the designated ports on that machine. If it has become unresponsive, attempt to kill the Dashlink Prints&nbsp;<code>java<\/code>&nbsp;process and try launching it again.<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li>Error:&nbsp;<code>typeerror: _qz.tools.hash is not a function<\/code>\n<ul>\n<li>Cause: Make sure the page is being rendered with UTF-8&nbsp;<code>&lt;meta charset='utf-8'&gt;<\/code>.<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li>Error:&nbsp;<code>WebSocket connection to 'wss:\/\/localhost:8181\/' failed: Error in connection establishment: net::ERR_CONNECTION_CLOSED<\/code>\n<ul>\n<li>Cause: Java 9 (Beta) is known to cause this error. Please downgraded to a supported&nbsp;<a href=\"https:\/\/qz.io\/wiki\/faq#java-versions\" target=\"_blank\" rel=\"noopener\">Java version<\/a>.<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li>Error:&nbsp;<code>SCRIPT1010: Expected identifier qz-tray.js<\/code>\n<ul>\n<li>Cause: IE11 may be emulating an older browser. Please use IE10, IE11 or Edge browser emulation. Offending code may look like this&nbsp;<code>&lt;meta http-equiv=\"X-UA-Compatible\" content=\"IE=EmulateIE7\" \/&gt;<\/code><\/li>\n<\/ul>\n<\/li>\n\n\n\n<li>Error:&nbsp;<code>Server returned HTTP response code: 403 for URL<\/code>\n<ul>\n<li>Cause: Assuming permission issues have been ruled out, some servers require a&nbsp;<code>User Agent String<\/code>&nbsp;to be passed to the web controller. Dashlink Print 2.0 sends a blank&nbsp;<code>User Agent String<\/code>. Dashlink Print 2.1+ provides a proper&nbsp;<code>User Agent String<\/code>. Alternately, disable the&nbsp;<code>User Agent Filtering<\/code>&nbsp;on the web controller. For example, Cloudfare callls this&nbsp;<code>Browser Integrity Check<\/code>&nbsp;and can be disabled.<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n\n\n\n<h4 class=\"wp-block-heading\" id=\"invalid-json\"><a href=\"https:\/\/qz.io\/wiki\/faq#invalid-json\" target=\"_blank\" rel=\"noopener\"><\/a>Invalid JSON<\/h4>\n\n\n\n<ul>\n<li>If the browser console says&nbsp;<code>Invalid JSON<\/code>, try changing your HTTP headers in the sign-message example to use&nbsp;<code>text\/plain<\/code>&nbsp;instead of&nbsp;<code>application\/json<\/code>. In PHP, this is done via:- header(&#8216;Content-Type: application\/json&#8217;); + header(&#8216;Content-Type: text\/plain&#8217;);<strong>Note:<\/strong>&nbsp;This technique will vary depending on the server-side language being used.<\/li>\n<\/ul>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h4 class=\"wp-block-heading\" id=\"j-script\"><a href=\"https:\/\/qz.io\/wiki\/faq#jscript\" target=\"_blank\" rel=\"noopener\"><\/a>JScript<\/h4>\n\n\n\n<ul>\n<li>Error:&nbsp;<code>Automatic certificate installation is not available for this platform<\/code>\n<ul>\n<li>Cause: Several.\n<ul>\n<li><strong>Note:<\/strong>&nbsp;Dashlink Print 2.1&nbsp;uses Java for certificate installation and may correct this problem.<\/li>\n\n\n\n<li>If using Comodo antivirus, use Advanced View, Auto-containment, Disabled before installing.<\/li>\n\n\n\n<li>If using Windows XP, follow the on-screen instructions.<\/li>\n\n\n\n<li>This issue may be caused by bad data being returned from&nbsp;<code>certutil<\/code>&nbsp;command. Contact&nbsp;<a href=\"mailto:support@qz.io\">support@qz.io<\/a>&nbsp;for assistance.<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li>Error:&nbsp;<code>Can\u2019t find script engine \u201cVBScript\u201d for script.<\/code>\n<ul>\n<li><strong>Note:<\/strong>&nbsp;Dashlink Print&nbsp;has removed the&nbsp;<code>VBScript\/JScript<\/code>&nbsp;dependency and may correct this problem.<\/li>\n\n\n\n<li>Cause: The Windows desktop installers for Windows use&nbsp;<code>JScript<\/code>&nbsp;engine for certain tasks. On occasion Antivirus Engines may try to replace this engine. To determine if this is the cause run the following commands from Command Prompt: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}\\InprocServer32 \/ve<\/li>\n\n\n\n<li>If the system is configured properly, each command will return the following value:<code>(Default) REG_SZ C:\\Windows\\System32\\jscript.dll<\/code><\/li>\n\n\n\n<li>If the system is misconfigured, it will return some other value. This value can be repaired by hand using the Windows Registry Editor.<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"3-support\"><a id=\"_Toc98272186\">3. Support<\/a><\/h2>\n\n\n\n<p>If you have any questions or issues using the Dashboard, please open up a support case by writing us at: <a href=\"mailto:upsplugins@ecommerce.help\">upsplugins@ecommerce.help<\/a> and include the following information<\/p>\n\n\n\n<ol>\n<li>Error Description (ideally with video\/screenshots)<\/li>\n\n\n\n<li>Computer Operating System<\/li>\n\n\n\n<li>Printer Model<\/li>\n<\/ol>\n\n\n\n<h2 class=\"wp-block-heading\"><\/h2>\n","protected":false},"excerpt":{"rendered":"<p>Pre-requisites Before installing Dashlink Print you must make sure to have all previous versions of QZ Tray uninstalled. Each client will need to manually&nbsp;uninstall&nbsp;QZ&nbsp;Tray first, the two applications should not coexist because they will fight for the same port number. 1. Known Issues Conflicting Applications The following applications may cause issues with Dashlink Print installation.&hellip;<\/p>\n","protected":false},"author":2,"featured_media":1900,"comment_status":"closed","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[56],"tags":[65,45,66,64,22],"acf":[],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v22.5 - https:\/\/yoast.com\/wordpress\/plugins\/seo\/ -->\n<title>2. Dashlink Print: Known Issues &amp; Troubleshooting - eCommerce.Help<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/ecommerce.help\/ecommerce-shipping-solution\/dashlink-print\/known-issues-troubleshooting\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"2. Dashlink Print: Known Issues &amp; Troubleshooting - eCommerce.Help\" \/>\n<meta property=\"og:description\" content=\"Pre-requisites Before installing Dashlink Print you must make sure to have all previous versions of QZ Tray uninstalled. Each client will need to manually&nbsp;uninstall&nbsp;QZ&nbsp;Tray first, the two applications should not coexist because they will fight for the same port number. 1. Known Issues Conflicting Applications The following applications may cause issues with Dashlink Print installation.&hellip;\" \/>\n<meta property=\"og:url\" content=\"https:\/\/ecommerce.help\/ecommerce-shipping-solution\/dashlink-print\/known-issues-troubleshooting\/\" \/>\n<meta property=\"og:site_name\" content=\"eCommerce.Help\" \/>\n<meta property=\"article:published_time\" content=\"2022-12-05T15:52:00+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2023-07-06T08:38:28+00:00\" \/>\n<meta name=\"author\" content=\"Eduardo Pena\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"Eduardo Pena\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"8 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"Article\",\"@id\":\"https:\/\/ecommerce.help\/ecommerce-shipping-solution\/dashlink-print\/known-issues-troubleshooting\/#article\",\"isPartOf\":{\"@id\":\"https:\/\/ecommerce.help\/ecommerce-shipping-solution\/dashlink-print\/known-issues-troubleshooting\/\"},\"author\":{\"name\":\"Eduardo Pena\",\"@id\":\"https:\/\/ecommerce.help\/es\/#\/schema\/person\/3e2710e0e0495ab35b58589a6681854f\"},\"headline\":\"2. Dashlink Print: Known Issues &#038; Troubleshooting\",\"datePublished\":\"2022-12-05T15:52:00+00:00\",\"dateModified\":\"2023-07-06T08:38:28+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\/\/ecommerce.help\/ecommerce-shipping-solution\/dashlink-print\/known-issues-troubleshooting\/\"},\"wordCount\":1915,\"publisher\":{\"@id\":\"https:\/\/ecommerce.help\/es\/#organization\"},\"image\":{\"@id\":\"https:\/\/ecommerce.help\/ecommerce-shipping-solution\/dashlink-print\/known-issues-troubleshooting\/#primaryimage\"},\"thumbnailUrl\":\"https:\/\/ecommerce.help\/wp-content\/uploads\/2023\/06\/Default.png\",\"keywords\":[\"Dashlink\",\"eCommerce Shipping Solution\",\"Label\",\"Printing\",\"UPS Plugins\"],\"articleSection\":[\"Dashlink Print\"],\"inLanguage\":\"en-US\"},{\"@type\":\"WebPage\",\"@id\":\"https:\/\/ecommerce.help\/ecommerce-shipping-solution\/dashlink-print\/known-issues-troubleshooting\/\",\"url\":\"https:\/\/ecommerce.help\/ecommerce-shipping-solution\/dashlink-print\/known-issues-troubleshooting\/\",\"name\":\"2. Dashlink Print: Known Issues & Troubleshooting - eCommerce.Help\",\"isPartOf\":{\"@id\":\"https:\/\/ecommerce.help\/es\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\/\/ecommerce.help\/ecommerce-shipping-solution\/dashlink-print\/known-issues-troubleshooting\/#primaryimage\"},\"image\":{\"@id\":\"https:\/\/ecommerce.help\/ecommerce-shipping-solution\/dashlink-print\/known-issues-troubleshooting\/#primaryimage\"},\"thumbnailUrl\":\"https:\/\/ecommerce.help\/wp-content\/uploads\/2023\/06\/Default.png\",\"datePublished\":\"2022-12-05T15:52:00+00:00\",\"dateModified\":\"2023-07-06T08:38:28+00:00\",\"breadcrumb\":{\"@id\":\"https:\/\/ecommerce.help\/ecommerce-shipping-solution\/dashlink-print\/known-issues-troubleshooting\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/ecommerce.help\/ecommerce-shipping-solution\/dashlink-print\/known-issues-troubleshooting\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/ecommerce.help\/ecommerce-shipping-solution\/dashlink-print\/known-issues-troubleshooting\/#primaryimage\",\"url\":\"https:\/\/ecommerce.help\/wp-content\/uploads\/2023\/06\/Default.png\",\"contentUrl\":\"https:\/\/ecommerce.help\/wp-content\/uploads\/2023\/06\/Default.png\",\"width\":1570,\"height\":1570},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/ecommerce.help\/ecommerce-shipping-solution\/dashlink-print\/known-issues-troubleshooting\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"eCommerce Help\",\"item\":\"https:\/\/ecommerce.help\/es\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"eCommerce Shipping Solution\",\"item\":\"https:\/\/ecommerce.help\/es\/desk\/ecommerce-shipping-solution\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"QZ Tray\",\"item\":\"https:\/\/ecommerce.help\/desk\/ecommerce-shipping-solution\/dashlink-print\/\"},{\"@type\":\"ListItem\",\"position\":4,\"name\":\"3. QZ Tray: Known Issues & Troubleshooting\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/ecommerce.help\/es\/#website\",\"url\":\"https:\/\/ecommerce.help\/es\/\",\"name\":\"eCommerce.Help\",\"description\":\"Technical Support for eCommerce Merchants\",\"publisher\":{\"@id\":\"https:\/\/ecommerce.help\/es\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/ecommerce.help\/es\/?s={search_term_string}\"},\"query-input\":\"required name=search_term_string\"}],\"inLanguage\":\"en-US\"},{\"@type\":\"Organization\",\"@id\":\"https:\/\/ecommerce.help\/es\/#organization\",\"name\":\"eCommerce Help\",\"url\":\"https:\/\/ecommerce.help\/es\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/ecommerce.help\/es\/#\/schema\/logo\/image\/\",\"url\":\"https:\/\/ecommerce.help\/wp-content\/uploads\/2021\/09\/eCommerce-Help-Logo-Color-Resized.png\",\"contentUrl\":\"https:\/\/ecommerce.help\/wp-content\/uploads\/2021\/09\/eCommerce-Help-Logo-Color-Resized.png\",\"width\":2529,\"height\":409,\"caption\":\"eCommerce Help\"},\"image\":{\"@id\":\"https:\/\/ecommerce.help\/es\/#\/schema\/logo\/image\/\"}},{\"@type\":\"Person\",\"@id\":\"https:\/\/ecommerce.help\/es\/#\/schema\/person\/3e2710e0e0495ab35b58589a6681854f\",\"name\":\"Eduardo Pena\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/ecommerce.help\/es\/#\/schema\/person\/image\/\",\"url\":\"https:\/\/secure.gravatar.com\/avatar\/43b5627b0c685e827a456bb617a72716?s=96&d=mm&r=g\",\"contentUrl\":\"https:\/\/secure.gravatar.com\/avatar\/43b5627b0c685e827a456bb617a72716?s=96&d=mm&r=g\",\"caption\":\"Eduardo Pena\"},\"url\":\"https:\/\/ecommerce.help\/author\/eduardo-p\/\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"2. Dashlink Print: Known Issues & Troubleshooting - eCommerce.Help","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/ecommerce.help\/ecommerce-shipping-solution\/dashlink-print\/known-issues-troubleshooting\/","og_locale":"en_US","og_type":"article","og_title":"2. Dashlink Print: Known Issues & Troubleshooting - eCommerce.Help","og_description":"Pre-requisites Before installing Dashlink Print you must make sure to have all previous versions of QZ Tray uninstalled. Each client will need to manually&nbsp;uninstall&nbsp;QZ&nbsp;Tray first, the two applications should not coexist because they will fight for the same port number. 1. Known Issues Conflicting Applications The following applications may cause issues with Dashlink Print installation.&hellip;","og_url":"https:\/\/ecommerce.help\/ecommerce-shipping-solution\/dashlink-print\/known-issues-troubleshooting\/","og_site_name":"eCommerce.Help","article_published_time":"2022-12-05T15:52:00+00:00","article_modified_time":"2023-07-06T08:38:28+00:00","author":"Eduardo Pena","twitter_card":"summary_large_image","twitter_misc":{"Written by":"Eduardo Pena","Est. reading time":"8 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/ecommerce.help\/ecommerce-shipping-solution\/dashlink-print\/known-issues-troubleshooting\/#article","isPartOf":{"@id":"https:\/\/ecommerce.help\/ecommerce-shipping-solution\/dashlink-print\/known-issues-troubleshooting\/"},"author":{"name":"Eduardo Pena","@id":"https:\/\/ecommerce.help\/es\/#\/schema\/person\/3e2710e0e0495ab35b58589a6681854f"},"headline":"2. Dashlink Print: Known Issues &#038; Troubleshooting","datePublished":"2022-12-05T15:52:00+00:00","dateModified":"2023-07-06T08:38:28+00:00","mainEntityOfPage":{"@id":"https:\/\/ecommerce.help\/ecommerce-shipping-solution\/dashlink-print\/known-issues-troubleshooting\/"},"wordCount":1915,"publisher":{"@id":"https:\/\/ecommerce.help\/es\/#organization"},"image":{"@id":"https:\/\/ecommerce.help\/ecommerce-shipping-solution\/dashlink-print\/known-issues-troubleshooting\/#primaryimage"},"thumbnailUrl":"https:\/\/ecommerce.help\/wp-content\/uploads\/2023\/06\/Default.png","keywords":["Dashlink","eCommerce Shipping Solution","Label","Printing","UPS Plugins"],"articleSection":["Dashlink Print"],"inLanguage":"en-US"},{"@type":"WebPage","@id":"https:\/\/ecommerce.help\/ecommerce-shipping-solution\/dashlink-print\/known-issues-troubleshooting\/","url":"https:\/\/ecommerce.help\/ecommerce-shipping-solution\/dashlink-print\/known-issues-troubleshooting\/","name":"2. Dashlink Print: Known Issues & Troubleshooting - eCommerce.Help","isPartOf":{"@id":"https:\/\/ecommerce.help\/es\/#website"},"primaryImageOfPage":{"@id":"https:\/\/ecommerce.help\/ecommerce-shipping-solution\/dashlink-print\/known-issues-troubleshooting\/#primaryimage"},"image":{"@id":"https:\/\/ecommerce.help\/ecommerce-shipping-solution\/dashlink-print\/known-issues-troubleshooting\/#primaryimage"},"thumbnailUrl":"https:\/\/ecommerce.help\/wp-content\/uploads\/2023\/06\/Default.png","datePublished":"2022-12-05T15:52:00+00:00","dateModified":"2023-07-06T08:38:28+00:00","breadcrumb":{"@id":"https:\/\/ecommerce.help\/ecommerce-shipping-solution\/dashlink-print\/known-issues-troubleshooting\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/ecommerce.help\/ecommerce-shipping-solution\/dashlink-print\/known-issues-troubleshooting\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/ecommerce.help\/ecommerce-shipping-solution\/dashlink-print\/known-issues-troubleshooting\/#primaryimage","url":"https:\/\/ecommerce.help\/wp-content\/uploads\/2023\/06\/Default.png","contentUrl":"https:\/\/ecommerce.help\/wp-content\/uploads\/2023\/06\/Default.png","width":1570,"height":1570},{"@type":"BreadcrumbList","@id":"https:\/\/ecommerce.help\/ecommerce-shipping-solution\/dashlink-print\/known-issues-troubleshooting\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"eCommerce Help","item":"https:\/\/ecommerce.help\/es\/"},{"@type":"ListItem","position":2,"name":"eCommerce Shipping Solution","item":"https:\/\/ecommerce.help\/es\/desk\/ecommerce-shipping-solution\/"},{"@type":"ListItem","position":3,"name":"QZ Tray","item":"https:\/\/ecommerce.help\/desk\/ecommerce-shipping-solution\/dashlink-print\/"},{"@type":"ListItem","position":4,"name":"3. QZ Tray: Known Issues & Troubleshooting"}]},{"@type":"WebSite","@id":"https:\/\/ecommerce.help\/es\/#website","url":"https:\/\/ecommerce.help\/es\/","name":"eCommerce.Help","description":"Technical Support for eCommerce Merchants","publisher":{"@id":"https:\/\/ecommerce.help\/es\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/ecommerce.help\/es\/?s={search_term_string}"},"query-input":"required name=search_term_string"}],"inLanguage":"en-US"},{"@type":"Organization","@id":"https:\/\/ecommerce.help\/es\/#organization","name":"eCommerce Help","url":"https:\/\/ecommerce.help\/es\/","logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/ecommerce.help\/es\/#\/schema\/logo\/image\/","url":"https:\/\/ecommerce.help\/wp-content\/uploads\/2021\/09\/eCommerce-Help-Logo-Color-Resized.png","contentUrl":"https:\/\/ecommerce.help\/wp-content\/uploads\/2021\/09\/eCommerce-Help-Logo-Color-Resized.png","width":2529,"height":409,"caption":"eCommerce Help"},"image":{"@id":"https:\/\/ecommerce.help\/es\/#\/schema\/logo\/image\/"}},{"@type":"Person","@id":"https:\/\/ecommerce.help\/es\/#\/schema\/person\/3e2710e0e0495ab35b58589a6681854f","name":"Eduardo Pena","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/ecommerce.help\/es\/#\/schema\/person\/image\/","url":"https:\/\/secure.gravatar.com\/avatar\/43b5627b0c685e827a456bb617a72716?s=96&d=mm&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/43b5627b0c685e827a456bb617a72716?s=96&d=mm&r=g","caption":"Eduardo Pena"},"url":"https:\/\/ecommerce.help\/author\/eduardo-p\/"}]}},"_links":{"self":[{"href":"https:\/\/ecommerce.help\/wp-json\/wp\/v2\/posts\/1669"}],"collection":[{"href":"https:\/\/ecommerce.help\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/ecommerce.help\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/ecommerce.help\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/ecommerce.help\/wp-json\/wp\/v2\/comments?post=1669"}],"version-history":[{"count":13,"href":"https:\/\/ecommerce.help\/wp-json\/wp\/v2\/posts\/1669\/revisions"}],"predecessor-version":[{"id":1952,"href":"https:\/\/ecommerce.help\/wp-json\/wp\/v2\/posts\/1669\/revisions\/1952"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/ecommerce.help\/wp-json\/wp\/v2\/media\/1900"}],"wp:attachment":[{"href":"https:\/\/ecommerce.help\/wp-json\/wp\/v2\/media?parent=1669"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/ecommerce.help\/wp-json\/wp\/v2\/categories?post=1669"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/ecommerce.help\/wp-json\/wp\/v2\/tags?post=1669"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}