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.10.14.10, “Config Editor” on how to change this value.

Admin Web App: Proxy Printer - List

Figure 4.40. Admin Web App: Proxy Printer - List


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

  • The CUPS button is shown when the browser points to localhost, 127.0.0.1, a .local address, or to the intranet IP address of the SavaPage server. 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 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 identifying data and some usage statistics. 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 Name of the printer. The red color in the chart represents the number of pages printed. The orange color represents the number of printed sheets.

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

    • The make and model of the printer.

    • 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.

    • The Printer Groups this Proxy Printer is member of.

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

    The Log button brings you to the list of documents printed to the Proxy Printer. See Figure 4.109, “Admin Web App: Documents - 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.

Note

Due to Admin Privileges certain buttons might not be visible.

Important

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.

Tip

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

Each Proxy Printer in the list is marked with an 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 which can only be used from certain Terminals.

A Proxy Printer which 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.

4.8.1.1. 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.

Important

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

4.8.1.2. Select and Sort

Admin Web App: Proxy Printer - Select and Sort

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


  • Proxy Printers can be selected by entering the containing text (fragment) of their display name. So, entering "HL-" will select both "HL-1430-SERIES" and "HL-2030-SERIES".

  • Select the (Deleted) Status. The - button will select both.

  • 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.

4.8.2. Edit Proxy Printer

4.8.2.1. Proxy Printer Identity

Admin Web App: Proxy Printer - Edit - Identity

Figure 4.42. 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 PPD Extension File is optional and refers to a .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 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. 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.

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

  • 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.

Important

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.4.8, “Job Ticket Print” for an explanation of Job Tickets and how users can create them. Also see:

4.8.2.2. 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 4.10.12.2, “General Financial Options”.

Printer costs are irrelevant and ignored in the following cases:

4.8.2.3. Media Sources

In this section you can assign Media Size and Costs to Media Sources.

Admin Web App: Proxy Printer - Edit - Media Source

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


  • 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.

  • 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.

Warning

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 - Manual Media Source

Figure 4.44. 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.

4.8.2.4. Manual Media Sizes

In this section 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.45. 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.46. 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:

Note

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.

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.47. Admin Web App: Proxy Printer - Rename


  • See Figure 4.42, “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.

Caution

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.