Troubleshooting Xerox utilities on Linux

Issue

This article covers troubleshooting known issues with the Xerox Print Manager suite of commands for Linux.

Environment

  • OS: RHEL, Fedora, Ubuntu, Debian
  • "xeroxprtmgr" or "xeroxofficeprtmgr" package installed

Resolution

RHEL 7, Fedora, Ubuntu, Debian

If the printer is installed correctly, the xeroxprtmgr GUI should show up after the user prints from any program. If it doesn't:

  1. Check the printer configuration to make sure the UI is enabled and check the secondary queue. In a terminal type: xeroxquemgr queue_name -queueprops
    The queue name, queue_name, must be specified.
     
  2. If the "Print Driver GUI Enabled" field says "false", enter: xeroxquemgr queue_name -modifyq -uienable
    This should resolve the issue. If so, you're done; stop. If not, continue with Step 3.
     
  3. Check if the "Job Queue Name" field shows a queue name out of line with the installed printers. This means that if only one Xerox printer queue is installed but the job queue is named "_xeroxtq2_", this is wrong and should be "_xeroxtq1_". Basically the order the printer was installed in should coincide with the queue name.
     
  4. If there is a difference, you'll need to wipe the queues and reinstall the printers. To wipe them, in a terminal enter: sudo xeroxquemgr -removeq all
     
  5. Afterwards, install your needed printers again.

RHEL 8, Fedora 30+, CentOS 8

If the printer is installed correctly, the xeroxofficeprtmgr GUI should show up after the user prints from any program. There may be problems with the program opening if the new Wayland gnome desktop interface is being used.  You can try to switch your default desktop at the login screen to Gnome Xorg, to test if this is the problem.  If it doesn't correct the problem, try following the below steps

  1. Check the printer configuration to make sure the UI is enabled and check the secondary queue. In a terminal type: xeroxofficequemgr queue_name -queueprops
    The queue name, queue_name, must be specified.
     
  2. If the "Print Driver GUI Enabled" field says "false", enter: xeroxofficequemgr queue_name -modifyq -uienable
    This should resolve the issue. If so, you're done; stop. If not, continue with Step 3.
     
  3. Check if the "Job Queue Name" field shows a queue name out of line with the installed printers. This means that if only one Xerox printer queue is installed but the job queue is named "_xeroxtq2_", this is wrong and should be "_xeroxtq1_". Basically the order the printer was installed in should coincide with the queue name.
     
  4. If there is a difference, you'll need to wipe the queues and reinstall the printers. To wipe them, in a terminal enter: sudo xeroxofficequemgr -removeq all
     
  5. Afterwards, install your needed printers again.

External Resources

Print Article