Universal Print Connector for PaperCut MF/NG

Universal Print is Microsoft’s SaaS cloud print service for M365 and Azure customers migrating away from local print servers.

The PaperCut connector component enables PaperCut MF or NG to manage Universal Print jobs and add the functionality of PaperCut to Universal Print environments. It also:

  • Registers your local Windows print queues with Universal Print
  • Pulls down print jobs from Universal Print, and sends them to your local queues
  • Monitors printer and job status and reports this back to Universal Print

It’s a complete replacement for the default Microsoft connector. This means no additional software applications or network hardware components are needed to use PaperCut with Universal Print.

This page covers the installation and setup process for using PaperCut MF or NG with Universal Print.

Requirements

  • A Windows installation of PaperCut MF or PaperCut NG, version 18.0 or newer.

Additional requirements from Microsoft

  • Azure Active Directory
  • Azure Active Directory Domain Services

You will need the credentials of a user in this Azure tenant with the Global Administrator role to complete the setup.

This guide assumes that you’ve already configured your PaperCut installation to sync with Azure Active Directory as a user identity source.

It’s highly recommended you explore Microsoft’s Universal Print documentation to understand how Universal Print works.

Known limitations

  • Printer capabilities vary between manufacturer and version of printer driver being used. Universal Print tries to unify the many different printer features on the market into a common set. This means advanced printing options like stapling or hole punching might not be available for your model of printer yet.
  • There is a system-wide document size limit of 100 MB enforced by Microsoft.
  • Changing the name of a registered print queue in Windows will cause the connector to stop functioning correctly.

Release notes

Installation

How you install and set up the connecter depends on what version of PaperCut NG/MF you have:

  • Version 21.0 and newer: The connector component is included only with the install package for “Standard installation” and you manage it using the user interface.
  • Version 21.0 and newer “Secondary print server installation” and “Site server installation” : The connector component will need to be downloaded here and installed. In order for the secondary connectors to be listed and managed in PaperCut Configure the secondary / site server connectors.
  • Version 18.0 to v20.1: You will need to download the connector component downloaded here and install and manage it using the command line.

Install the connector on the same server that your PaperCut installation is, so it has access to the print queues that are being monitored.

This component automatically updates itself to make sure you’re always up to date with changes in Universal Print.

Configuration - PaperCut NG or MF version 21.0 or newer

Note: There are separate steps further down this page for versions 18.0 to 20.1.3.

Set up

When you install PaperCut NG or MF, by default the PaperCut Universal Print Connector for Microsoft is installed as a separate service alongside PaperCut.

  1. Enable Universal Print integration.
    a. Log in to the PaperCut Admin web interface.
    b. Navigate to Enable Printing > Mobile & BYOD.
    c. Click the Enable Universal Print integration checkbox.
    d. Click Apply at the bottom of the page. The Universal Print tab is added.
  2. Click the Universal Print tab. The page shows the connectors that are associated with your PaperCut installation. By default, you’ll only see the connector that is preinstalled on your primary server.

Note 💡 If you have updated/ upgraded to PaperCut v21 and completed the steps above but are unable to see the connector, please perform the following:

  • Go to OptionsConfig Editor (advanced) → search for universal-print.server.trusted-cert → amend the value to N → click Update

Register a printer

Printers must be registered with Universal Print before they can be shared and used.

  1. Click Enable Printing > Universal Print to go to the Universal Print connector configuration page.
  2. Click the connector running on the print server that has your printer(s) attached. A list of all printers associated with the connector is displayed.
  3. Click Register on the printer you want to make available in Universal Print. The Register Printer dialog box is displayed.
  4. Follow the instructions online to complete the registration. During the registration process, you will be redirected to authenticate with Azure using an account with the Global Administrator role. You’ll then give consent to the connector service to register the printer.
  5. Share the printer with the users in your organization. These steps are described in Microsoft’s Getting Started with Universal Print documentation.


Secondary Connectors

The connector can support multiple “secondary” connectors. This allows you to centrally manage a collection of connectors installed on multiple servers. Please find the steps required for this below.

  1. Ensure you are using PaperCut v21 and above.
  2. Install the PaperCut Universal Print Connector onto the secondary/ site server(s) which you would like to appear in Enable Printing → Universal Print.
  3. Edit the connector configuration file as an admin, located at [app-path]\providers\universal-print\win\data\conf\pc-upconnector.conf on the main PaperCut server.
    • Fill the Authorization property with a unique string greater than 12 characters. Your choice for this value. It will be used on the secondary server(s) too.
      • Example: “Authorization”: “thisisalongstring”
  4. Edit the configuration file on the secondary server(s). Default location: C:\Program Files\PaperCut connector for Microsoft Universal Print\data\conf\pc-upconnector.conf.
    • Fill the PrimaryIpAddr property with the IP address of the primary connector server.
    • Fill the Authorization property with the same value as in step 3.
  5. Restart the PaperCut Connector for Microsoft Universal Print service on the primary server, followed by the secondary servers.

Note 💡 Please ensure that TCP port 9151 is open between the app server and any secondary servers for the connectors to successfully appear in Enable Printing → Universal Print.

Configuration - PaperCut NG or MF versions 18.0 to 20.1

You need to configure the connector before it can monitor Universal Print for print jobs.

The configuration process allows you to choose which local queues to register and monitor.

This is done using the “configure.exe” tool in the connector installation directory.

  1. Run Command Prompt as an Administrator
  2. Change directory into the installation directory for the PaperCut Connector
    • cd “C:\Program Files\PaperCut connector for Microsoft Universal Print”
  3. Identify your connector version, which is inside the .version file
    • type .version
  4. Go to the version folder.
    • cd v2020–07–17–1411
  5. . Run “configure.exe”
    • configure.exe

The configuration utility will now guide you through the steps to register your printers.

Once you’ve completed the configuration, restart the PaperCut Connector for Microsoft Universal Print service for the changes to apply.

You can now share the printers you’ve registered with your users! These steps are described on Microsoft’s Getting Started with Universal Print documentation.

To enable debug in PaperCut connector for Microsoft Universal Print:

  1. Edit the connector configuration file as an admin, located at [app-path]\providers\universal-print\win\data\conf\pc-upconnector.conf on the main PaperCut server.
  2. Find the line “Debug”: false,
  3. Change the entry to “Debug”: true,
  4. Save the file.
  5. Restart the “PaperCut connector for Microsoft Universal Print” service in Services.msc.

The log file is located in [app-path]\providers\universal-print\win\data\logs.

Note 💡 On secondary / site servers the conf file will be in “C:\Program Files\PaperCut connector for Microsoft Universal Print\data\conf”. The log file is in “C:\Program Files\PaperCut connector for Microsoft Universal Print\data\logs”.


Still have questions?

Let us know! We love chatting about what’s going on under the hood. Feel free to leave a comment below or visit our Support Portal for further assistance.

Categories: How-to Articles, Installing, Uninstalling and Migrating

Keywords: universal-print, connector, setup

Comments