UPS Shipping Dashboard Support

2. Dashlink Print: Bekende Problemen & Probleemoplossing

3 min read

Probleemoplossingsgids voor Dashlink Print. Behandelt veelvoorkomende afdrukfouten, browserproblemen, QZ Tray-problemen en hun oplossingen.

Stapsgewijze handleiding

Gids voor Dashlink Print Problemen & Oplossingen

This article provides a comprehensive guide to known issues and troubleshooting steps for Dashlink Print users. It is designed for users who are experiencing problems with installation, operation, or software conflicts.

Vereisten

Before installing Dashlink Print you must make sure to have all previous versions of QZ Tray uninstalled. Each client will need to manually uninstall QZ Tray first, the two applications should not coexist because they will fight for the same port number. For Windows, the uninstall can be performed through the Control Panel/System Preferences. For Mac, the app can be dragged to the recycling bin, or advanced users may wish to run the uninstall script. For Linux, the uninstall script is needed.

1.1

For Windows, the uninstall can be performed through the Control Panel/System Preferences.

1.2

For Mac, the app can be dragged to the recycling bin, or advanced users may wish to run the uninstal

For Mac, the app can be dragged to the recycling bin, or advanced users may wish to run the uninstall script.

1.3

For Linux, the uninstall script is needed.

Bekende Problemen: Conflicterende Applicaties

Having two versions of Dashlink Print and/or QZ Tray installed simultaneously can cause conflicts. Ensure only one version is installed. Antivirus software may block Dashlink Print communication. Add an exception for the Dashlink Print application in your antivirus settings. Firewall settings may block WebSocket connections. Ensure port 8181 (or configured port) is allowed through your firewall.

2.1

Resolve Java Conflicts

Uninstall older Java versions or use Dashlink Print 2.2 or higher.

Older Java versions can cause conflicts. If uninstalling is not possible, Dashlink Print 2.2+ includes its own Java version.

2.2

Antivirus Software Adjustments

Modify antivirus settings to allow Dashlink Print installation and operation.

Disable application containment and web filtering for Dashlink Print and its Java Runtime. Whitelist necessary local ports and directories.

→ https://qz.io/support/

Probleemoplossing: Logboeken

To automatically zip logs and place on your desktop: Right-click the Dashlink Print Icon, select Advanced, then Troubleshooting. Click "Zip Logs" to create a log archive. These logs are essential for our support team to diagnose issues.

3.1

Access Logs

Locate and zip log files for troubleshooting.

Use Dashlink Print's advanced troubleshooting options to zip logs and place them on your desktop. Logs are stored in specific directories on Windows, Mac, and Linux.

→ https://qz.io/wiki/faq#logs

3.2

Console Logs for Debugging

Use command line to access verbose console logs.

Launch Dashlink Print from the command line with specific memory settings to view detailed debug messages. Adjust memory allocation as needed.

→ https://qz.io/wiki/faq#console-logs

3.3

Resolve PKIX Path Errors

Address SSL handshake exceptions and certificate issues.

Append specific commands to fetch detailed SSL certificate information. Check for broken certificate chains or self-signed certificates and update Java if necessary.

→ https://github.com/qzind/tray/files/2194181/Document.1906321.1.pdf

3.4

Fix Software Launch Issues

Reinstall Java and check environmental variables to resolve launch problems.

A corrupt Java installation can prevent software from launching. Reinstall Java using the offline installer and check for custom JAVA_HOME variables.

→ https://qz.io/wiki/upgrading-java

3.5

Troubleshoot Printer Listing

Address issues with listing printers on Mac and Windows.

On Mac, reset the printing system and re-add printers. On Windows, remove conflicting printer drivers to resolve listing issues.

→ https://qz.io/wiki/faq#cannot-list-printers

3.6

Temporary File Access: If the antivirus blocks access to the temporary directory, please disable or

Temporary File Access: If the antivirus blocks access to the temporary directory, please disable or whitelist the Dashlink Print installer.

3.7

Other issues: QZ Industries does not provide support for issues created by third party antivirus app

Other issues: 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 support channels.

Probleemoplossing: Raw Printing Problemen

Raw printing sends data directly to the printer without processing. Ensure the printer is configured for raw mode. Check that the correct printer name is being used in the print command. Verify the raw data format matches what the printer expects (ZPL, EPL, ESC/POS, etc.).

Probleemoplossing: HTML Printing Problemen

HTML printing (JavaFX) can cause printing to fail if: the HTML page width exceeds the printer page width, printer resolution for HTML print is high (e.g. 600dpi, 1200dpi) — try hard-coding a lower DPI, or out of memory issues occur if running the 32-bit JVM. If JavaFX is not available, ensure the correct Java version is installed.

Probleemoplossing: Thermische/Label Printer Configuratie

If your thermal or label printer has undesired results, it may be improperly configured. Check the printer driver settings for paper size, orientation, and print quality. Ensure the label dimensions match the configured media size. Verify the printer is using the correct print language (ZPL, EPL). Test with a simple raw print command to isolate the issue.

6.1

Dashlink Print Icon, Advanced, Troubleshooting, Zip Logs (To Desktop)

Ondersteuning

For additional support, please open a ticket describing your issue in detail. Include the zipped log files from the Troubleshooting step above, your operating system version, browser version, and printer model.