Table of Contents
This chapter contains advanced configuration related to PaperCut's internal web server (powered by Apache Jetty). The configuration options mentioned here should generally only be used as a reference for specific requirements, as some changes could negatively impact on system functionality.
Some features in PaperCut require being able to create a link or address for the application server. One example of this is when using Email to Print - the verification email sent to users contains a link that they must click. This link must resolve to the PaperCut server both from the internet and from the local network.
The default address presented in these cases is an automatically detected IP address. In some cases this may not be suitable, for example where it needs to be resolved from the internet.
The recommended approach is to configure a DNS name for your PaperCut server that can be resolved and accessed wherever your users require it. This may involve creating a public/external DNS name and opening the appropriate ports in your firewall. After the name is configured, navigate to DNS name and enter your chosen (fully qualified) name.
→ → → , choose
In some circumstances, you may also need to customize the server HTTP port presented to users.
An example scenario is when a reverse proxy server for WebAuth or Shibboleth SSO is placed
in front of the PaperCut MF server.
For this situation, PaperCut provides two advanced config keys to allow the user facing server port
to be customized: system.network-port-http.user-facing
and system.network-port-https.user-facing
. (See the section called “Using the Config Editor”
for instructions on using the Config Editor.)
In some cases PaperCut will publish its address to external components (e.g. MFDs) to allow them to establish a connection back to the server. The published address is an automatically detected IP address by default. If your server has multiple IP addresses then the detected IP may not be suitable and may cause components to fail to connect.
To resolve this you can configure the network address (e.g. DNS name or IP address) that PaperCut
publishes to these external components. To do this use the Config Editor (see
the section called “Using the Config Editor”) to change the system.network-address
to your chosen
address.
This is configured separately from the Server address presented to users to provide the option to use an IP address for components and a DNS name for users (for example, to avoid DNS lookups on devices that do not cache the result).
© Copyright 1999-2014. PaperCut Software International Pty Ltd. All rights reserved.