You are here: Installation > Advanced implementation > Resiliency with Site Servers > Install a Site Server

Install a Site Server

Site Servers are an architectural component of the PaperCut solution. Setup is a straightforward process. Like most architecture projects, the time is best spent planning.

1. Planning

Planning is the most critical step of a successful Site ServerSite Servers take over the role of a Primary Application Server in the event of network outages. Key roles taken over include authentication, copy and print tracking and Find-Me printing. Site Servers ensure continuous availability of printing resources to support key business functions over unreliable network links or during unplanned network disruptions. deployment. Take a few moments prior to installation to run through a checklist of items:

2. Apply your license

Your Application Server must be licensed for Site Servers before installing the Site Server software.

3. [optional] Import a trusted signed certificate

Where practical, consider implementing a signed certificate for SSLSecure Sockets Layer (SSL) is the standard security technology for establishing an encrypted link between a web server and a browser. This link ensures that all data passed between the web server and browsers remain private and integral. The protocol uses a third party, a Certificate Authority (CA), to identify one end or both end of the transactions. To be able to create an SSL connection a web server requires an SSL certificate. When you choose to activate SSL on your web server you will be prompted to complete a number of questions about the identity of your website and your company. Your web server then creates two cryptographic keys - a Private Key and a Public Key. communications. For more information, see Generate an SSL/HTTPS key .

4. Installation

Before installing a Site Server, verify that the primary server (central Application Server) is set up and running correctly.

Windows

On a Windows server, install the Site Server software by selecting the Site Server installation (advanced) option in the installation wizard. If the PaperCut primary server software was previously installed on the server, uninstall it prior to installing the Site Server software.

Linux

Follow the existing Quick install: Linux (CUPS and/or Samba) section of the PaperCut manual, with the additional parameter of ––site-server when executing the installer.

Mac

On a Mac server, install the Site Server by downloading the latest Mac DMG disk image and run the contained installer called PaperCut MF Site Server Install (advanced).pkg

5. Post installation setup

  1. Set a unique name for the Site Server you are configuring.

  2. Enter the name or IP of the Application Server this Site Server connects to.

  3. Enter the credentials of a user with administrator access to PaperCut on the primary server.

    The Site Server is now connected to the Application Server and begins the data synchronization process.

  4. The Site Server requires no additional configuration at the local machine. You can use the Login link under the Application Server image to access the PaperCut Admin web interface. The Sites tab is now available.

  5. Select Sites > Offline Policies to set the Offline Policies for your installation.

Advanced Site Server configuration

The majority of the Site Server configuration is done in the Admin web interface, however, there are additional configuration options available in the print-provider.conf file.

Connect multiple print servers to a Site Server

If you have installed the Site Server onto an existing PaperCutConfiguring secondary print servers and locally attached printers, the Print ProviderA Print Provider is a monitoring service installed on a secondary print server to allow PaperCut to control and track printers. This monitoring component intercepts the local printing and reports the use back to the primary Application Server. is automatically configured to work with the new Site Server. However, if you have more than one print server connected to the Site Server, the Print Provider on these servers needs to be upgraded to the same version of the Application Server and also configured in the following file to connect to the Site Server address:

  1. Open the following file in a text editor:

    [app-path]\providers\print\win\print-provider.conf

  2. Locate the line starting with ApplicationServer= then enter the Site Server IP address. For example:

    ApplicationServer=mainserver.localdomain.com

  3. Locate the line starting with ApplicationServerPort= then enter the port connecting to the Site Server. For example:

    ApplicationServerPort=9191

  4. Restart the server running Print Provider. If you do not want to restart the server, manually restart the PaperCut Print Provider service.

Connect directly with the Application Server when the Site Server is down

With the standard configuration, if your Site server is unavailable, the Print Providers will not work, even if the Application Server is available. You can, however, configure your Print Providers to attempt to connect directly with the Application Server if the Site Server is unavailable.

  1. Open the following file in a text editor:

    [app-path]\providers\print\win\print-provider.conf

  2. Add a new line with RedirectFallbackServer= then the Application Server IP address and port. For example:

    RedirectFallbackServer=mainserver.localdomain.com:9191

  3. Restart the server running Print Provider. If you do not want to restart the server, manually restart the PaperCut Print Provider service.

Release Station configuration

The Standard Release Stations and Mobile Print Release —releasing print jobs on your mobile apps are both supported by the Site Server to allow held jobs to be released in both online and offline operation.

Testing your installation

The Sites tab of the Admin web interface shows at a glance the status of all Site Servers. While the Site Server is connected, PaperCut operates as per normal.

To verify that your Site Server is providing resilience, you can take the site offline. You can achieve this by simulating network failure (pulling the plug), or by disabling the site in the Sites tab.

  1. On the Sites tab, select the site.

  2. In the Site Connection area, choose Disable connection (force offline).

  3. Click Apply.

You can validate the site as being in offline mode using the Site Server URL (http://[Site Server]:9191/admin). Printing and copying should continue according to the offline policiesOffline Policies allow an Administrator to define PaperCut's behaviour when there is an outage that disrupts PaperCut normal operations. Offline policies include account selection policy (the default account to charge (default is "Offline account")), offline credit policy (whether to assume credit is available or to deny the job when the Application Server is unavailable), user authentication policy (the behavior in offline mode where PaperCut cannot validate the owner of the job), and User Password Authentication (whether user authentication is attempted during a network outage). defined in the installation section. Validating the application of the policies via copy and print transactions ensures your settings have been applied correctly.

To complete the test, return the Site to online by selecting Enable connection in the Site record. Validate your transactions have been uploaded to the Application Server by searching either the User, Device, Printer, or Job log.

Important:

Version upgrades to the Application Server result in the Site Servers supporting their local site in offline mode until they are also upgraded. Make sure you upgrade the Site Servers as part of your upgrade procedure.


Comments

Share your findings and experience with other PaperCut users. Feel free to add comments and suggestions about this Knowledge Base article. Please don't use this for support requests.