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 needs JDK 8 or higher to be 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

1.2.1.2. CUPS

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

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

sudo apt install cups       1
sudo apt install cups-bsd   2

1

This package provides the parts of CUPS which are needed for using printer drivers.

2

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.

1.2.1.3. SMTP

An SMTP host must be available for sending email messages. See Section 4.11.4, “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 Chapter 21, 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 our 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 Section 13.5.9, “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 when Encrypted PDF for Proxy Printing is allowed. See Section 4.11.13.9, “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. wkhtmltopdf

wkhtmltopdf is a command line tool to render HTML into PDF. In some cases it may produce better results than the default rendering method. Installation is optional. If installed it is used by default.

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

wkhtmltopdf --version

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

sudo apt install wkhtmltopdf

You can disable usage of wkhtmltopdf by setting config property system.cmd.wkhtmltopdf.enable value to N. See Section 4.11.14, “Config Editor” on how to change this value.

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

Avahi is a system which facilitates service discovery on a local network via the mDNS/DNS-SD [5] 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-daemon avahi-discover libnss-mdns

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 Appendix D, 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® .



[4] 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 Section K.1.1.6, “print-scaling”.

[5] 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).