4.8. Proxy Printers

4.8.1. Proxy Printer List

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

SavaPage automatically detects CUPS printer queues, and uses their unique name to replicate corresponding Proxy Printers in its database.

When a printer queue is deleted in CUPS it is real-time detected by SavaPage, and as a result the corresponding Proxy Printer is marked as not present. Proxy Printers which are not present are hidden in the User Web App, so they cannot be used for printing.

When a printer queue is renamed in CUPS, two events occur in SavaPage. First, the new name is detected as a new Proxy Printer, and second, the Proxy Printer with the old name is detected as a deleted CUPS queue. Proxy Printers which are not present anymore can either be deleted or renamed.

SavaPage selects local CUPS printer queues by default. This is a sensible policy since local CUPS queues are able to connect to locally attached printers (USB, LPT) or network enabled printers. However, in some odd cases you might want to proxy print to a remote CUPS queue, i.e. a queue shared by another machine. In that case you can set the value of the cups.ipp.remote-enabled config item to Y. See Section 4.11.14, “Config Editor” on how to change this value.

Admin Web App: Proxy Printer - List Header

Figure 4.56. Admin Web App: Proxy Printer - List Header

  • The CUPS button is shown when the browser points to localhost,, a .local address, or to the intranet IP address of the SavaPage server, and host port matches the configured SavaPage port. Click the button to open the CUPS Administration web page in a new browser tab.

  • Click the Synchronize button to synchronize all CUPS printer options to SavaPage. Since SavaPage does not detect changed CUPS printer defaults, PPD driver and PPD Extension File content (yet), you need to perform this action after you change any of these parameters.

  • The Status button is shown when Printer SNMP is enabled. Push the button to refresh toner and printer state information for all printers.

Admin Web App: Proxy Printer - List Items

Figure 4.57. Admin Web App: Proxy Printer - List Items

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

  • 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 Proxy Printer, with several identifying and usage data. Two sample items are show above (not all data apply). Possible items are, from top to bottom:

    • The Proxy Printer status (at the top right corner).

    • The display name (alias) of the printer as shown to the user.

    • An inline pagometer Pie-Chart followed by the CUPS printer name, URI and PPD driver name.

      • The red color in the chart represents the number of pages printed. The orange color represents the number of printed sheets.

      • A double-click on the CUPS printer name downloads a text file with detailed printer properties, and is used by SavaPage developers and administrators to debug PPD to IPP mapping issues.

      • The PPD Extension File configured in the Proxy Printer Edit Dialog is shown in green: a double-click on its name will download the PPDE file. See Appendix K, PPD Extensions and Appendix L, IPP Extensions.

      • A double-click on the PPD driver name downloads the CUPS PPD file.

    • When Printer SNMP is enabled, the toner and status information. Click on the icon at the most right to refresh this information.

    • The Printer Groups this Proxy Printer is member of.

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

    • An optional red colored Configuration needed tag, to remind you to configure at least one (1) of the printer's Media Sources.

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

    • The pagometer of the Proxy Printer including the number of jobs, sheets and bytes printed.

  • Tap the Edit button to edit the entry. Proxy Printers which are present in CUPS can be edited: see Figure 4.59, “Admin Web App: Proxy Printer - Edit - Identity”. Proxy Printers which are not present in CUPS can also be deleted or renamed: see Figure 4.66, “Admin Web App: Proxy Printer - Rename”

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

  • The Home button is shown under the same condition as the CUPS button. Click to open the CUPS Administration web page for the printer in a new browser tab.


Due to Admin Privileges certain buttons might not be visible.


The CUPS Administration web page must be accessible as explained in Section 2.3, “Step 3 - Configure CUPS and Samba”. When CUPS authentication is required you can log in with user name root or with a user name that belongs to the admin group.


The pagometers of all Proxy Printers can be reset at OptionsAdvancedReset Pagometers

Each Proxy Printer in the list is marked with a primary icon:

A non-secure Proxy Printer that anyone can print to.

A non-secure Proxy Printer that no one can print to.

A secured Proxy Printer whose jobs needs to be authorized with a NFC Card swipe on a Network Card Reader.

A Proxy Printer that can only be used from certain Terminals.

A Proxy Printer that can only be used from certain Terminals and whose jobs needs to be authorized with a NFC Card swipe on a Network Card Reader on other Terminals.

A Job Ticket Printer.

Table 4.6. Primary Printer Icons

When applicable, the following secondary icons are shown:

A PaperCut Managed Printer.

Print Archive enabled.

Print Journal enabled.

Table 4.7. Secondary Printer Icons Printer SNMP

SavaPage can use the SNMP protocol to query information about networked printers, like type/model, serial number, toner and operation status. SNMP is disabled by default. Use the configuration items below to enable and set operational properties. When SNMP is enabled, printer data are read automatically at the daily maintenance cycle at 55 minutes past midnight. See Section O.4, “Daily Maintenance”.

Configuration propertyDescription


Enable SNMP: Y or N (default)


Number of minutes since last printer print after which a next print triggers a new SNMP read of printer data (default 240).


Number of retries after SNMP read failure (default 2).


SNMP read timeout in milliseconds (default 1500).


reserved for future use


reserved for future use

Table 4.8. Configuration Properties for Printer SNMP

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


Use Server Command printerSnmp to SNMP query any printer available in the network. Print Archive

The Print Archive is the doc.store.archive.out.print branch of the Document Store. It must explicitly be enabled. Print Journal

The Print Journal is the doc.store.journal.out.print branch of the Document Store. It must explicitly be enabled. DNS-SD Printers

Printers that advertise themselves via DNS-SD (also known as Bonjour / Zeroconf) are not automatically part of CUPS. You can easily check: printer devices that show up with the lpinfo -v command do not show up as printer with the lpstat -v command.

Add your DNS-SD printers in CUPS by selecting them there from the list of Discovered Network Printers. Make sure to select a Model that uses CUPS filtering and is compatible with your printer. Do not select an IPP Everywhere variant as Model, as this will give you a "Local Raw Printer" throughput without filtering and print job options, which is unusable for SavaPage.


Placing your DNS-SD printers in a VLAN, which only the SavaPage server can access, prevents these printers from advertising themselves on user devices. If you subsequently add these DNS-SD printers in CUPS, users are forced to use them as Proxy Printer in the controlled environment of the SavaPage User Web App. CUPS Printer Class

A CUPS Class is a group of printers. When printing to it, CUPS will redirect the job to one of the printer members. Which printer would depend on user rights or which printer currently is available.

A CUPS Class appears as a regular Proxy Printer in the list: the number of member printers is enclosed in parenthesis, just after its CUPS name.


SavaPage requires that CUPS Class members all have the same PPD. Select and Sort

Admin Web App: Proxy Printer - Select and Sort

Figure 4.58. Admin Web App: Proxy Printer - Select and Sort

  • Proxy Printers can be selected by entering a fragment of their CUPS or display Name. So, entering "Xe" will select both "Xerox AltaLink" and "Xerox D110".

  • Select a Status, Mode, Scope or Deleted option. In each case the - button will select both option values.

  • The list can be sorted Ascending or Descending on display 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.

  • The minus button collapses the section.

4.8.2. Edit Proxy Printer Proxy Printer Identity

Admin Web App: Proxy Printer - Edit - Identity

Figure 4.59. Admin Web App: Proxy Printer - Edit - Identity

  • The title bar shows the CUPS Printer Name.

  • The Display name and Location are editable.

  • Multiple Proxy Printer Groups can be entered separated by space, comma, colon or semicolon.

  • Tick the Disabled checkbox to disable access to the Proxy Printer for all use.

  • Tick the Internal use checkbox to mark the printer for internal use only. This will disable access to the Proxy Printer from the User Web App, but the printer can still be used for internal print work flow scenarios.

  • The optional PPD Extension File can be selected from a list with .ppde text files with extensions to the assigned PPD in CUPS. This is the way to map vendor specific PPD options to IPP attributes. See Appendix K, PPD Extensions.

  • By ticking the Job Ticket Printer checkbox the printer will act as Job Ticket Printer and its display name will be shown to users with role Job Ticket Creator for printer selection. An entry field is shown where you must enter the Proxy Printer Group containing the printers the Job Ticket print job can be redirected to. See Section 4.8.3, “Printer Groups” and Chapter 5, Job Tickets Web App.

    Admin Web App: Proxy Printer - Edit -Job Ticket Printer

    Figure 4.60. Admin Web App: Proxy Printer - Edit -Job Ticket Printer

    This option can not be selected for PaperCut managed printers (a warning message is displayed).

  • When the Job Ticket Printer option is not selected, you can still activate Job Ticket Labels, at least when they are enabled as configuration property: see Section, “Configuration Properties” (when tags are disabled, the option is not shown). When this option is activated a user can select a Job Ticket Labels for this regular proxy printer: see Section 3.5.5, “Print Job Settings”. The selected labels are shown as CUPS job ID prefix.

  • Press the Apply button to commit the changes and return to the Proxy Printer List.

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


When the content of the PPD Extension File is changed, you must Synchronize the Proxy Printers to take those changes into effect.

See Section 3.5.9, “Job Ticket Print” for an explanation of Job Tickets and how users can create them. Also see Chapter 5, Job Tickets Web App and Section A.3.1, “Delegated Print - (Non) Secure & Job Ticket Scenarios”. Printer Costs

Printer costs are specified per media side and can be set for One-sided and Two-sided prints and differentiated for B/W (Black and White) and Color printing.

When SavaPage calculates the cost of a Proxy Print job, the two-sided (duplex) page cost is only applied to pages that are part of a sheet that is printed on both sides. So, for a document with an odd number of pages, the two-sided cost is not applied to the last page. For example, when a 7 page document is printed as two-sided, the two-sided cost is applied to the first 6 pages, and the one-sided cost to the last.

Costs are displayed, and can be entered, with a precision (number of decimals) as defined in Section, “General Financial Options”.

Printer costs are irrelevant and ignored in the following cases: Media Sources

In case Printer Costs are relevant, you can assign Media Size and Costs to Media Sources.


If no Media Source is configured, a red colored Configuration needed tag will show up for this printer in the Proxy Printer List and the printer will not be available for printing.

Admin Web App: Proxy Printer - Edit - Media Source

Figure 4.61. Admin Web App: Proxy Printer - Edit - Media Source

  • The header text Cost per media side ... is prefixed with the same printer marker icon(s) as shown in the Printer List.

  • CUPS printer defaults are indicated in the header with an asterisk (*). In some odd cases the CUPS printer color mode default grayscale is not correctly transferred as IPP attribute. You can easily correct this behavior by setting the Use B/W as default option at the top of the Media Source section. Instead, you can also use a PPD to IPP mapping to set the default for the IPP print-color-mode attribute: this correction is more basic, and is immediately reflected in de default * indicator.

  • When the Perform B/W conversion locally option is set, grayscale print jobs are converted to B/W before sending them to a color capable proxy printer. This setting is needed when you observe that print jobs with color content are printed in color, despite the Grayscale Color Mode setting in the Printer Settings dialog. Indeed, some PPDs expect grayscale conversion is done client-side.

    • This option is not available for a Job Ticket Printer.

  • The *auto text below the Source header indicates that the printer supports automatic tray selection based on media options.

  • Each entry in the list has a checkbox with the IPP attribute keyword of the Media Source.

  • Tick the checkbox to enable the media source, and enter a user-friendly name as will show up in the Media Source picklist of the Printer Settings dialog.

  • Select the Media Size that is present in the Media Source.

  • Specify the costs. Notice that only those cost cells are enabled that are applicable for the printer.

  • You can mark a media source as preferred by pressing the Star button at the left. A preferred source is taken as default in situations where multiple media sources contain the same requested media size. For instance, in Job Ticket Redirect Printer settings.


Depending on the PPD file used for the CUPS printer, some media sources might not be applicable. You are advised to do some tests to make sure that media sizes are indeed applicable to the media sources as you intended.

Admin Web App: Proxy Printer - Edit - Job Sheet Media Sources

Figure 4.62. Admin Web App: Proxy Printer - Edit - Job Sheet Media Sources

  • When the printer is member of at least one Job Ticket Printer Group, and can therefore act as redirect printer, a media-source select menu for Job Sheets is shown. Multiple media-sources with assigned media-size can be selected.

    • When this printer is selected as redirect printer, the first Jobs Sheets media-source that matches the requested job-sheet media size will be selected as default. See Section 5.2.6, “Job Ticket Print”.

  • The select menu is shown even if org.savapage-job-sheets is not configured in any job ticket PPDE file.

Admin Web App: Proxy Printer - Edit - Manual Media Source

Figure 4.63. Admin Web App: Proxy Printer - Edit - Manual Media Source

  • Costs for the manual media source can not be entered here, but must be specified as described in the next section. Manual Media Sizes

In case Printer Costs are relevant, you can specify the Proxy Printer media costs for the manual media source. You can either use a Simple or Advanced definition.

Admin Web App: Proxy Printer - Edit - Manual Media Size (Simple)

Figure 4.64. Admin Web App: Proxy Printer - Edit - Manual Media Size (Simple)

The Simple definition allows for a single cost per media side. This is appropriate for a non-duplex monochrome Proxy Printer that can handle a single media size (Letter or A4) only.

Admin Web App: Proxy Printer - Edit - Manual Media Size (Advanced)

Figure 4.65. Admin Web App: Proxy Printer - Edit - Manual Media Size (Advanced)

Advanced mode is best suited for a duplex color Proxy Printer that can handle multiple media sizes.

  • The list of supported media sizes is dependent on the Proxy Printer type.

  • Use the check-box at a media size to enable its custom cost specification.

  • Costs for unspecified (disabled) media sizes fall back to the Default specification.

4.8.3. Printer Groups

Printer Groups allow administrators to combine Proxy Printer instances so they can be addressed as group by a single tag. A Proxy Printer can have one or more groups tags. See Section 4.8.2, “Edit Proxy Printer”.

Printer Groups are used to customize access to Proxy Printers. See:


Printer Group tags are added to the database on first use. Tags without Proxy Printer members are removed from the database at the start of the application and thereafter in a Daily Job.

4.8.4. Rename Proxy Printer

When a Proxy Printer is removed from the host system it is marked in the list as not present. When editing new options appear, as is shown in the screenshot below.

Admin Web App: Proxy Printer - Rename

Figure 4.66. Admin Web App: Proxy Printer - Rename

  • See Figure 4.59, “Admin Web App: Proxy Printer - Edit - Identity” for a description of the basic edit options.

  • Tick the Delete when job history is cleaned button to logically delete the Proxy Printer. It 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. Deleting makes sense if the queue is permanently removed from CUPS, and you don't want the Proxy Printer list in the Admin Web App to be cluttered with out-of-date "not present" Proxy Printers.

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

  • You can change the associated CUPS printer by entering a New name. Renaming makes sense as a mirroring action of renaming a CUPS queue. After renaming a printer in CUPS, the Proxy Printer associated with the old CUPS name will be identified by SavaPage as "not present", and a new Proxy Printer for the new CUPS queue will be created. At this point you can re-associate (rename) the old CUPS name of the Proxy Printer to the new one. This will work as long as no job history is already accumulated on the Proxy Printer associated with this new CUPS name. To overrule this constraint you can tick the Replace (delete) existing printer with identical name checkbox, so an existing Proxy Printer associated with the same (new) CUPS name will be deleted and replaced.

  • Press the Rename button to commit the renaming action and return to the Proxy Printer List.

  • Both Cancel buttons bring you back to the Proxy Printer List without changing anything.


If SavaPage detects a CUPS queue whose name is identical to a logical deleted Proxy Printer, the logical delete mark will be removed and the Proxy Printer will be re-activated.