Knowledge Base

By default PaperCut NG uses ports:

IMPORTANT: We highly recommend leaving PaperCut on these ports as many areas of the application assume these ports are open. Changing ports will cause future problems. For example, you may upgrade PaperCut and the new features/components will default to the standard ports. Some organizations however have a preference for the standard port 80. This is an option, however first you must ensure that no other programs such as IIS or Apache are using the port on the same system.

Where possible we recommend forwarding or port redirection rather than remapping the application's own port (e.g. port 80 maps through to 9191 so it may be accessed both on port 80 and the standard 9191)

Linux:

Use iptables (or ipchains on old systems) to port-forward 80 to 9191. The following commands provide an example:

    /sbin/iptables -t nat -I PREROUTING --src 0/0 --dst <server_ip>
          -p tcp --dport 80 -j REDIRECT --to-ports 9191

    /sbin/iptables -t nat -I PREROUTING --src 0/0 --dst <server_ip>
          -p tcp --dport 443 -j REDIRECT --to-ports 9192

(indented text = all on one line)

Please these in a rc init script or the iptables startup config script as provided by your distribution.

Remapping port 80 to 9191 is recommend over changing the port in server.properties as port 80 directly requires processes to run with elevated root privileges. Forwarding provides an elegant solution without the need to change any PaperCut config or rights.

Mac:

Advanced Admins Only

Modify the Mac firewall (ipfw) with the following command:

    sudo /sbin/ipfw add 102 fwd 127.0.0.1,9191 tcp from any to any 80 in

See man ipfw for all the scary details!

Windows:

Set up a forward or redirect in IIS. Forward say /user through to :9191/user, etc.

Alternatively, change the ports defined in the file:

then restart the PaperCut Application Server" service under Control Panel -> Administrative Tools -> Services''

IMPORTANT: Also ensure the port numbers are updated in the following other areas:

• config.properties file located in the client directory (client connection information).
• connection.properties file located in the release directory (release station connection information)
• The print provider config file located at: C:\Program Files\PaperCut NG\providers\print\win\print-provider.conf (the print provider service must be restarted)
• The print provider config file located on any secondary server or future installed secondary server.

Other methods:

The guru system administrators could also consider using HTTP request proxies to forward requests from port 80 through to port 9191. For example, Apache mod_proxy could be used to accomplish this.

Categories: Implementation / Deployment, User Web Interface

Keywords: other port, standard ports, change ports