After a tap on the 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
Y. See Section 126.96.36.199, “Config Editor” on how to change
The “localhost”, “127.0.0.1”, 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.button is shown when the browser points to
Click the PPD Extension File content (yet), you need to perform this action after you change any of these parameters.button to synchronize all CUPS printer options to SavaPage. Since SavaPage does not detect changed CUPS printer defaults, PPD driver and
The Printer SNMP is enabled. Push the button to refresh toner and printer state information for all printers.button is shown when
All non-deleted Proxy Printers are listed alphabetically by default. A different selection and sorting can be entered: see Figure 4.46, “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. 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 Figure 4.47, “Admin Web App: Proxy Printer - Edit - Identity”. Proxy Printers which are not present in CUPS can also be deleted or renamed: see Figure 4.54, “Admin Web App: Proxy Printer - Rename”button to edit the entry. Proxy Printers which are present in CUPS can be edited: see
The CUPS Administration web page for the printer in a new browser tab.button is shown under the same condition as the button. Click to open the
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
Each Proxy Printer in the list is marked with a primary icon:
A non-secure Proxy Printer which can be used by any device.
A non-secure Proxy Printer which can not be used by any device.
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.4. Primary Printer Icons
When applicable, the following secondary icons are shown:
A PaperCut Managed Printer.
Print Archive enabled.
Print Journal enabled.
Table 4.5. Secondary Printer Icons
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 .
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.6. Configuration Properties for Printer SNMP
See Section 188.8.131.52, “Config Editor” on how to set these items.
Use Server Command printerSnmp to SNMP query any printer available in the network.
The Print Archive is the
branch of the Document
Store. It must explicitly be enabled.
The Print Journal is the
branch of the Document
Store. It must explicitly be enabled.
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.
Proxy Printers can be selected by entering the containing text (fragment) of their display name. So, entering "Xe" will select both "Xerox AltaLink" and "Xerox D110".
Select the (Deleted) Status. Thebutton will select both.
The list can be sorted Ascending or Descending on display name.
Tap the button to (re)display the list.
A tap on the button resets the selection and sort fields to their default values.
The minus button collapses the section.
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 thecheckbox to disable access to the Proxy Printer for all use.
Tick thecheckbox 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.
When the Print Archive and/or Journal function is enabled it can be for this printer. See Section 184.108.40.206, “Document Store”.
The PPD Extension File is optional and refers
.ppde text file 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 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.checkbox the printer will act as Job Ticket Printer and its display name will be shown to users with role
This option can not be selected for PaperCut managed printers (a warning message is displayed).
When the not selected, you can still activate , at least when they are enabled as configuration property: see Section 220.127.116.11, “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.option is
Press thebutton to commit the changes and return to the Proxy Printer List.
Thebutton brings you back to the Proxy Printer List without changing anything.
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.2.1, “Delegated Print - (Non) Secure & Job Ticket Scenarios”.
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 18.104.22.168, “General Financial Options”.
Printer costs are irrelevant and ignored in the following cases:
When this is a Job Ticket Media Costs are defined in the PPD Extension File.and
When a printer is selected from the Job Ticket Print dialog (Job Ticket cost is leading).
When PaperCut cost is leading. This is the case for a PaperCut Managed Printer, and when all conditions below are met:
This is a Non-Secure Printer (Secure Printing must be enforced by PaperCut). See Section 4.10.10, “Proxy Print”.
PaperCut Integration is enabled.
PaperCut Delegated Print Integration is enabled.
In this section 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.
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
*). 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 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
this correction is more basic, and is immediately reflected in
When the Printer Settings dialog. Indeed, some PPDs expect grayscale conversion is done client-side.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
This option is not available for a.
*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.
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.
The select menu is shown even if org.savapage-job-sheets is not configured in any job ticket PPDE file.
Costs for the manual media source can not be entered here, but must be specified as described in the next section.
In this section you can specify the Proxy Printer media costs for the manual media source. You can either use a or definition.
Thedefinition 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.
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.
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 at a daily schedule.
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.
See Figure 4.47, “Admin Web App: Proxy Printer - Edit - Identity” for a description of the basic edit options.
Tick the 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.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.
Press thebutton 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 thebutton to commit the renaming action and return to the Proxy Printer List.
Bothbuttons 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.