4.7. Queues

Queues are print-in channels for acquiring SafePages.

4.7.1. Queue List

After a tap on the Queues button in the main menu this panel is shown. See Section 4.2, “Menu”.

Admin Web App: Queue - List

Figure 4.49. Admin Web App: Queue - List


  • All non-deleted queues are listed alphabetically by default. A different selection and sorting can be entered: see Figure 4.50, “Admin Web App: Queue - Select and Sort”.

  • Press the New button to create and edit a new queue.

  • The list can be traversed by tapping one of the buttons at the pager at the top or bottom of the page.

  • An entry is displayed for each queue, with identifying data and some usage statistics. From top to bottom:

    • The queue's trust or status (at the top right corner).

    • The URL Path of the queue. The path is relative to the /printers URL base.

    • An inline Line-Graph showing the day pagometers of the printed pages over the last 30 days.

    • The full IPPS URL variant of the queue.

      • SavaPage takes the first IPv4 address of the first network interface on the server platform as URL host. You can overrule this behavior by setting a fixed IPv4 address or DNS name in configuration item system.server.dns-name.

    • Optionally, the allowed client IPv4 and/or IPv6 addresses as a CIDR Set.

    • The period in which activity was accumulated on the pagometer.

    • The pagometer of the queue including the number of jobs and bytes printed.

  • Tap the Edit button to change or delete the queue. See Section 4.7.2, “Edit Queue”

  • The Log button brings you to the list of documents printed to the queue. See Figure 4.129, “Admin Web App: Document - List”

Note

Due to Admin Privileges certain buttons might not be visible.

Tip

The pagometers of all queues can be reset at OptionsAdvancedReset Pagometers

Admin Web App: Queue - Select and Sort

Figure 4.50. Admin Web App: Queue - Select and Sort


  • Queues can be selected by entering the containing text (fragment) of their URL Path Name.

  • Select the queue's Trust and (Deleted) Status. The - button will select both option values.

  • The list can be sorted Ascending or Descending on URL Path Name.

  • Tap the Apply button to (re)display the list.

  • A tap on the Default button resets the selection and sort fields to their default values.

4.7.2. Edit Queue

Admin Web App: Queue - Edit

Figure 4.51. Admin Web App: Queue - Edit


  • The URL Path is editable for non-reserved queues. Renaming the URL path name will permanently overwrite the old name in all related job history records with the new name.

    • In response to an IPP Get-Printer-Attributes request the printer-name is returned as SavaPage-urlpath. So, in this example the IPP printer-name will be SavaPage-public.

  • Enter IPv4 and/or IPv6 address ranges as a CIDR Set at IP addresses allowed to restrict access to the queue based on requesting IP address. If the field is empty all requesting IP addresses from private networks are allowed to print to the queue[19]. See Section 11.5.2, “HTTP XFF Header Settings”.

  • Tick the Trusted checkbox to make this a Trusted Queue. When this option is not selected the queue will be a Public Queue.

  • Tick the Disabled checkbox to disable access to the queue for all users.

  • Tick the Delete checkbox to delete the Queue. This will be a logical delete as long as related job history is present. Any logical deleted Queue will be physically deleted from the database when no related job history is present anymore. This situation will automatically occur when you enabled automatic backup in combination with the delete of old document logs. See Section 4.11.12, “Backups”.

  • Press the OK button to commit the changes and return to the Queue List.

  • The Cancel button brings you back to the Queue List without changing anything.

Important

Some reserved queues like Web Print and Mail Print can not be edited. Other reserved queues like AirPrint and Internet Print are untrusted by nature, hence the field Trusted cannot be edited.

Note

IPP printing from public IP addresses is denied by default. You can override this behavior by setting specific public IP address ranges at IP addresses allowed.

4.7.3. IPP Routing

The PDF of incoming PostScript documents on a non reserved and driver-print Queue can be routed to a Single Printer Target that is defined as Custom Proxy Print of the Terminal that matches the client IP address.

When the ipp.routing.enable configuration property is enabled (see table below), the following section appears in the Edit Queue dialog:

Admin Web App: Queue - IPP Routing Options

Figure 4.52. Admin Web App: Queue - IPP Routing Options


Select the Terminal option to enable IPP Routing for this Queue, and optionally enter an IPP key/value map in JSON format to override printer defaults. In this example IPP attribute media-source is assigned value tray-1.

Important

Use IPP attributes for routing and optionally use PPD to IPP Mappings in the printer PPD Extension File for the target printer.

IPP Routing Queues are marked with a small printer icon in the Queue List.

Admin Web App: Queue - List - IPP Routing Queue

Figure 4.53. Admin Web App: Queue - List - IPP Routing Queue


Configuration propertyDescription

ipp.routing.enable

Enable IPP Routing: Y or N (default)

Table 4.4. Configuration Properties for IPP Routing


See Section 4.11.14, “Config Editor” on how to set these items.

Important

IPP Routing Plug-in instances are called on an IPP Routing event, just before the PDF is send to the Proxy Printer. These plug-ins edit the PDF, for example by adding a header, footer and QR code image.

4.7.3.1. IPP Routing Example

  1. Alice logs into a computer at the Reception.

    • The computer has fixed IP address 192.168.1.50

  2. Alice prints the Sales Report document to SavaPage Queue /tray1

  3. The PostScript content is received by SavaPage and converted to PDF.

  4. SavaPage notices that ...

    • /tray1 is configured for IPP routing.

    • The requester's IP address 192.168.1.50 is linked to Terminal Reception.

    • Terminal Reception defines a Custom Proxy Print to the Single Printer Target HP-Reception.

  5. SavaPage decides to print the PDF to Proxy Printer HP-Reception.

  6. SavaPage notices that an IPP Routing Plug-in instance is present. Therefore, it calls the plug-in with the print job parameters (User id "Alice", Client IP address 192.168.1.50, CUPS printer name HP-Reception, Print Job Name Sales Report, date/time of the print) together with the PDF to be printed.

  7. The IPP Routing Plug-in calls a RESTful service of a third-party QR code provider, passes the print job parameters, obtains the QR code in return, and draws an image of the QR-code on the PDF to be printed.

  8. SavaPage prints the PDF as edited by the IPP Routing Plug-in to Proxy Printer HP-Reception using the IPP Routing Options of /tray-1.

  9. Alice collects the printed Sales Report document from the HP-Reception printer next to her desk.

4.7.4. Reserved Queues

Dedicated queues are reserved and pre-installed for:



[19] IANA reserved the following CIDR ranges for private networks: 10.0.0.0/8, 172.16.0.0/12 and 192.168.0.0/16.