Category filter
Troubleshooting Zebra Printer Enrollment Failures in Hexnode UEM
TL;DR
Zebra Printer enrollment failures usually occur when the printer cannot receive the enrollment commands file, cannot connect to the configured network, or cannot authenticate with the required enrollment details. In Hexnode UEM, Zebra Printers can be enrolled through Open Enrollment or Authenticated Enrollment using the Zebra Printer Setup Utility.
This guide helps administrators identify whether an enrollment failure occurs during Bluetooth pairing, USB detection, enrollment-file transfer, pre-shared-key validation, printer restart, or initial connection to the Hexnode UEM portal.
Before You Begin
Confirm the following prerequisites before troubleshooting Zebra Printer enrollment:
- The Zebra Printer is powered on and running Link-OS 5.0 or later.
- The correct enrollment method was selected and the corresponding enrollment commands file was downloaded.
- The printer has a working wired or wireless network configuration.
- The Zebra Printer Setup Utility is installed on the provisioning device.
- For Open Enrollment using iOS/Android: Bluetooth is enabled on the mobile device and paired with the printer.
- For Open Enrollment with Windows: The printer is connected via USB and visible in the Zebra Printer Setup Utility.
- For Authenticated Enrollment: The correct username and pre-shared key are available when required.
Identify the Failed Enrollment Stage
Review the table below to pin down the exact phase where the enrollment process broke down:
| Enrollment Stage | What Should Happen | Failure Indicator |
|---|---|---|
| Enrollment method selection | Administrator selects Open Enrollment or Authenticated Enrollment. | Incorrect method or user-assignment workflow selected. |
| Commands file generation | Hexnode UEM creates the required printer commands file. | File is missing, outdated, or generated for the wrong workflow. |
| Printer detection | Mobile or Windows setup utility detects the printer. | Printer is not visible through Bluetooth or USB. |
| Command transfer | Commands file is sent to the printer. | Printer does not receive or apply the file. |
| Printer restart | Printer restarts after receiving the commands. | Printer does not restart or returns to the same state. |
| Portal connection | Printer communicates with Hexnode UEM. | Printer remains absent from Manage > Devices. |
Troubleshoot Open Enrollment
Open Enrollment does not require credentials during the enrollment process. The administrator selects a domain and default user before generating the enrollment commands file. Use Open Enrollment when printers are provisioned in a controlled environment and can be assigned to a selected default user.
Check the following settings:
- The correct domain and default user were selected in the portal.
- The current Open Enrollment commands file was downloaded and sent to the intended printer.
- The printer maintains active network connectivity after commands are applied.
Caution: Restrict access to Open Enrollment commands files. The file can enroll a printer without requiring credentials during the printer-enrollment process.
Troubleshoot Authenticated Enrollment
Authenticated Enrollment uses a Local User or Self Enrollment request type. The workflow is completed from a Windows device using the Zebra Printer Setup Utility.
If your organization uses pre-shared-key authentication, verify the following fields in the enrollment commands file:
| Field | What to Verify |
|---|---|
| Username | Confirm that the username matches the required authenticated enrollment workflow. |
| Password | Confirm that the configured pre-shared key is entered correctly. |
| Enrollment request type | Confirm that the file matches the selected Local User or Self Enrollment workflow. |
| File version | Confirm that the current commands file is being used. |
Configure the pre-shared key in the Hexnode portal under:
Enrollment Settings > Security > Zebra Printer enrollment authentication password
Important: A missing or incorrect username or pre-shared key will prevent the printer from completing Authenticated Enrollment.
Troubleshoot Bluetooth Enrollment (Mobile Devices)
Use this workflow when performing Open Enrollment using an Android or iOS device.
- Enable Bluetooth on the mobile device: Ensures the device can scan for nearby Zebra Printers.
- Enable Bluetooth pairing on the Zebra Printer: Press and hold the printer Feed button for 5 seconds until the Bluetooth icon blinks. The printer is now discoverable.
- Pair the mobile device with the Zebra Printer: Establishes communication between the Zebra Printer Setup Utility and the printer.
- Send the enrollment commands file: Open the Zebra Printer Setup Utility and deploy the commands file. The printer will receive the configuration and restart.
Troubleshoot Windows and USB Enrollment
Use this workflow when performing Open or Authenticated Enrollment from a Windows PC.
- Connect via USB: Connect the Zebra Printer to the Windows device using a USB cable.
- Launch Zebra Printer Setup Utility: Open the utility to detect connected printers.
- Refresh or Install: If the printer does not appear, click Refresh Printer List. If it still fails to appear, select Install New Printer to complete setup and add it to the list.
- Deploy Commands File: Select the target printer and send the enrollment commands file. The printer will process the commands and restart.
Validate Successful Enrollment
- Printer Restart: Allow the printer to restart automatically after receiving the commands file to apply the configuration.
- Network Check: Confirm that the printer connects to the designated wired or wireless network and can reach the Hexnode UEM portal.
- Console Verification: Navigate to Manage > Devices in the Hexnode console. The printer should appear in the managed device list.
- Device Details: Open the printer’s device details page to view inventory data, policy application status, and Action History.
Troubleshooting Table
| Symptom | Probable Cause | Resolution | Validation |
|---|---|---|---|
| Printer does not appear in Manage > Devices | Commands file was not sent successfully, printer cannot reach portal, or printer did not restart. | Recheck the file, printer network settings, and selected enrollment workflow. | Printer appears in the managed device list. |
| Mobile device cannot discover printer | Bluetooth pairing is incomplete or printer Bluetooth mode is inactive. | Enable Bluetooth, activate printer pairing mode, and pair the devices again. | Printer appears in Bluetooth settings and Zebra Printer Setup Utility. |
| Zebra Printer Setup Utility does not detect printer | USB connection, driver, or printer-list issue. | Reconnect USB, install required drivers, use Refresh Printer List, or select Install New Printer. | Printer appears in the utility printer list. |
| Authenticated Enrollment fails | Incorrect username, missing pre-shared key, or mismatched request type. | Review the commands file and update required fields. | Printer restarts and appears in Hexnode UEM. |
| Printer remains offline after enrollment | Network configuration is incomplete or invalid. | Review wired or wireless connectivity settings. | Printer reports online in Hexnode UEM. |
Frequently Asked Questions
Why does my Zebra Printer not appear in Hexnode UEM after enrollment?
The printer may not have received the enrollment commands file, failed to complete its restart sequence, or cannot establish outbound network connectivity to the Hexnode UEM portal.
Can I use an Android or iOS device for Authenticated Enrollment?
No. Authenticated Enrollment requires executing the workflow from a Windows device using the Zebra Printer Setup Utility.
Can I use a Windows device for Open Enrollment?
Yes. The Zebra Printer Setup Utility on Windows fully supports Open Enrollment workflows.
Why does Authenticated Enrollment require changes to the commands file?
When pre-shared-key authentication is enabled, the enrollment commands file must be populated with the correct username and pre-shared key prior to deployment to pass authentication.
What should I do if Zebra Printer Setup Utility cannot find my printer?
Verify the physical USB connection, refresh the printer list inside the utility, install missing printer drivers, or use the Install New Printer wizard if detection continues to fail.
