# Troubleshooting Zebra Printer Enrollment Failures in Hexnode UEM 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 StageWhat Should HappenFailure IndicatorEnrollment method selectionAdministrator selects Open Enrollment or Authenticated Enrollment.Incorrect method or user-assignment workflow selected.Commands file generationHexnode UEM creates the required printer commands file.File is missing, outdated, or generated for the wrong workflow.Printer detectionMobile or Windows setup utility detects the printer.Printer is not visible through Bluetooth or USB.Command transferCommands file is sent to the printer.Printer does not receive or apply the file.Printer restartPrinter restarts after receiving the commands.Printer does not restart or returns to the same state.Portal connectionPrinter 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: FieldWhat to VerifyUsernameConfirm that the username matches the required authenticated enrollment workflow.PasswordConfirm that the configured pre-shared key is entered correctly.Enrollment request typeConfirm that the file matches the selected Local User or Self Enrollment workflow.File versionConfirm 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. 1. **Enable Bluetooth on the mobile device:** Ensures the device can scan for nearby Zebra Printers. 2. **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. 3. **Pair the mobile device with the Zebra Printer:** Establishes communication between the Zebra Printer Setup Utility and the printer. 4. **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. 1. **Connect via USB:** Connect the Zebra Printer to the Windows device using a USB cable. 2. **Launch Zebra Printer Setup Utility:** Open the utility to detect connected printers. 3. **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. 4. **Deploy Commands File:** Select the target printer and send the enrollment commands file. The printer will process the commands and restart. Validate Successful Enrollment ------------------------------ 1. **Printer Restart:** Allow the printer to restart automatically after receiving the commands file to apply the configuration. 2. **Network Check:** Confirm that the printer connects to the designated wired or wireless network and can reach the Hexnode UEM portal. 3. **Console Verification:** Navigate to **Manage > Devices** in the Hexnode console. The printer should appear in the managed device list. 4. **Device Details:** Open the printer’s device details page to view inventory data, policy application status, and Action History. Troubleshooting Table --------------------- SymptomProbable CauseResolutionValidationPrinter does not appear in Manage > DevicesCommands 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 printerBluetooth 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 printerUSB 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 failsIncorrect 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 enrollmentNetwork configuration is incomplete or invalid.Review wired or wireless connectivity settings.Printer reports online in Hexnode UEM.Related Zebra Printer workflows ------------------------------- 1. [Zebra Printer enrollment in Hexnode](https://www.hexnode.com/mobile-device-management/help/zebra-printer-enrollment/)