1.2. System Requirements

1.2.1. Server

SavaPage Open Print Portal can be installed on any modern GNU/Linux system that supports systemd service manager like distributions based on Debian and Red Hat Enterprise Linux (RHEL), and openSUSE. Debian based distributions that use SysV init scripts are also supported.

Note

Throughout this manual GNU/Linux command and file examples are given for Debian based systems. Commands and files might differ for other distributions, but not in function. For example, the Debian apt command has a RHEL yum and openSUSE yast equivalent. It is trusted that system administrators can translate the examples to their own environment. If applicable, functional differences between distributions will be explained.

Installed host package versions are shown in the Admin Web App.

1.2.1.1. Java

SavaPage is a Java program and must have JDK 11 or higher installed. Check the installation by executing both the java and javac commands: they should echo usage information.

On Debian based systems you can install the JDK package with this command:

sudo apt install default-jdk-headless

1.2.1.2. CUPS

SavaPage uses local CUPS printer queues for Proxy Printing. CUPS 1.4 or higher must be installed [3].

On Debian based systems you can install CUPS with these commands:

sudo apt install cups sudo apt install cups-bsd This package provides the parts of CUPS which are needed for using printer drivers. This package provides the BSD commands for interacting with CUPS, like lpr.

Important

SavaPage will automatically add any local CUPS printer as proxy printer. So, for proxy printing to work, first add each proxy printer as CUPS printer.

Tip

Modern GNU/Linux distributions have everything prepared for using most printers. For USB printers it is often enough to simply plug them in. For network printers you simply start the distribution’s printer setup tool out of the system administration menu or out of a system administration application, click on a button for adding a new printer and then follow the screen instructions. If this does not work, usually there is no suitable driver installed on your system. Verify in the OpenPrinting database whether your printer is supposed to work and whether there is a driver or PPD file available. See the OpenPrinting CUPS Quick Start for more details.

[3]

CUPS 1.4 or higher provides the Job Template attribute “fit-to-page” that is used by SavaPage proxy printing to scale documents to fit the size of selected media. See https://www.cups.org/doc/options.html. Also see print-scaling.

1.2.1.3. SMTP

An SMTP host must be available for sending email messages. See Mail.

1.2.1.4. Database

SavaPage is packaged with an internal database that offers you the opportunity to evaluate the product on a small scale right away. However, when promoting SavaPage to a production environment with multiple users, we strongly advise you to use PostgreSQL as external database server. See Using an External Database.

Warning

Using the internal database in situations with concurrent use will inevitably lead to locking, deadlock and out-of-memory errors, which can make the system totally unresponsive. See the notes on Database Locking.

1.2.1.5. Poppler

SavaPage needs the PDF utilities based on Poppler to function properly.

Poppler is a PDF rendering library based on Xpdf PDF viewer. The command line utilities are used to get information of PDF documents, convert them to other formats, or manipulate them. SavaPage uses pdftocairo to convert PDF pages to images and to Repair PDF documents.

Check if the package is installed by entering the following command:

pdftocairo -v

On Debian based systems you can install the package with this command:

sudo apt install poppler-utils

Note

See pdf2cairo Image Strategy if errors are encountered when creating SafePage images.

1.2.1.6. QPDF

QPDF is a command-line program that does structural, content-preserving transformations on PDF files. The package is used to decrypt PDF from Web Print and Mail Print if Encrypted PDF for Proxy Printing is allowed. See SafePages.

Check if the package is installed by entering the following command:

qpdf --version

On Debian based systems you can install the package with this command:

sudo apt install qpdf

1.2.1.7. rsvg-convert

rsvg-convert is a command-line program that converts SVG images into PNG raster images, PDF, PS, or SVG vector images, or dumps of Cairo XML or recording surfaces. The program is used by SavaPage Draw and needed to handle Standard File Type SVG.

Check if the package is installed by entering the following command:

rsvg-convert --version

On Debian based systems you can install the package with this command:

sudo apt install librsvg2-bin

1.2.1.8. heif-convert

heif-convert is a command-line program that converts HEIF images to JPEG. Installation is optional.

Check if the package is installed by entering the following command:

heif-convert --help

On Debian based systems you can install the package with this command:

sudo apt install libheif-examples

1.2.1.9. ImageMagick

SavaPage needs the convert command of the ImageMagick software suite to manipulate images.

ImageMagick is a software suite to create, edit, compose and convert bitmap images in a variety of formats (over 100) .

Check by entering the following command:

convert --version

On Debian based systems you can install the package with this command:

sudo apt install imagemagick

1.2.1.10. Avahi

Avahi is needed if you want to use IPP Everywhere and AirPrint to print to SavaPage. It is also needed to retrieve the hostname of CUPS printers whose URI refers to a DNS-SD instance (dnssd:// scheme) in order to establish an SNMP connection. See Printer SNMP.

Avahi is a system which facilitates service discovery on a local network via the mDNS/DNS-SD [4] protocol suite. Any modern GNU/Linux system has Avahi installed, but to be sure you can check by entering the following command:

avahi-browse --version

On Debian based systems you can install the package with this command:

sudo apt install avahi-utils avahi-discover libnss-mdns

[4]

mDNS/DNS-SD enables you to plug your laptop or computer into a network and instantly be able to view other people who you can chat with, find printers to print to or find files being shared. Compatible technology is found in Apple macOS (branded Bonjour and sometimes Zeroconf).

1.2.1.11. Hardware

The SavaPage server process requires a minimum of 2 CPU cores, 2GB of RAM and 1 GB of free disk space.

Note

Depending on the expected print quota you should reserve extra disk-space for each SavaPage user. See Capacity Planning.

1.2.2. Clients

On desktop and mobile clients you need an HTML5 compatible browser and support for Internet Printing Protocol (IPP), IP Printing (JetDirect) or AirPrint® .