› Printix Configurator › How to add print queues to computers with Printix Configurator

How to add print queues to computers with Printix Configurator

Use a CSV file with computers and print queues to add print queues to computers. Only if Printix Administrator has a matching Hostname of a computer and a matching print queue name, will the computer have the print queue added. Uppercase and lowercase letters are treated the same. The adding of the print queue is done as a task. If a computer is offline, it picks up on the tasks after it comes online.

You must use the -q2c (Queue to Computer) argument to have Printix Configurator offer this functionality.

See also:

Requirements

  • The CSV file MUST be semi-colon (;) separated.

    • Column headers are not allowed.

    • Do not have spaces before or after a semi-colon.

    • To not be rejected as an invalid format, each row in the CSV file MUST have the same number of semi-colons. Padding with semi-colon may be necessary as demonstrated by this example:

      • computer1;queueA;queueB;

      • computer2;queueA;queueB;queueC;

      • computer3;queueC;

  • Hostnames of the computers must be unique within your Printix Home.

  • Print queue names must be unique within your Printix Home.

  • A print driver must be selected for the print queue for the relevant systems (Windows, macOS, …).

  • Print queue is added regardless whether it is Active.

Ensure that you use Printix Configurator version 1.3.1250, which was released on 2022.12.22. If you use an earlier version, you get the error: Login failed (get token).

Create shortcut with -q2c argument

  1. Right-click PrintixConfigurator.exe and select Create shortcut.
  2. Right-click the shortcut and select Properties.
  3. Select the Shortcut tab.
  4. In the Target section, add -q2c like this: PrintixConfigurator.exe -q2c.

Start Printix Configurator

  1. Right-click the Printix Configurator shortcut file and select Run as administrator.
  2. Sign in.

    You must have the System manager role.

  3. If prompted, select a Printix Home.
    Example: acme.printix.net

    To change language, select Menu > Language.

    After signing in to Printix Configurator, you can close the browser window.

Import CSV file

  1. In Enter CSV file, select the field and browse to the CSV file you wish to use. Alternatively, you can paste the path to the CSV file.

    • Example content for the template file: Compix;Reception;Reception Staple.

    • Uppercase and lowercase letters are treated the same.

    • To not be rejected as an invalid format, each row in the CSV file MUST have the same number of semi-colons. Padding with semi-colon may be necessary.

  2. Select Open.
  3. Select Exit.

For troubleshooting, you can check the Printix Configurator log files. Output from a successful configuration is written as follows: 

Read X computers from CSV file
Validating configuration...
Start applying configuration...
Done  applying configuration

A delay of up to 30 minutes may occur before the result of the import is fully reflected in Printix Administrator. If a computer is offline, it will pick up on the tasks after it comes online.

If a print queue does not install, check the History on the computer for any hints on perhaps issues with the print driver and then try to change the print driver.