Deploy print queues using Jamf and Print Deploy

This topic explains how to deploy the PaperCutPrint Deploy client to a macOS client managed by Jamf Pro .

At a high level, the Print Deploy client is provided as a '.pkg', deployed by Jamf that will be configured via a '.plist' to communicate with the PaperCut Application Server to deploy the appropriate print queues with appropriate print drivers.

If you're interested in a different deployment method, here's a list of other deployment topics.

Before you start

This topic is for the following minimum software versions:

  • Jamf Pro: 10.12.0

  • PaperCut NG/MF: 19.1.0

  • macOS 10.13 (High Sierra) or higher

You need to be a Jamf Pro administrator (or have relevant permissions), and should have already:

  • macOS clients managed by Jamf Pro

  • existing, and appropriate groups in Jamf Pro.

You're also a PaperCut NG/MF administrator (or have relevant permissions), and should have already:

  • made sure that the PaperCut NG/MF Application Server is accessible via TCP 9191, 9192, 9174 from the targeted client machines—preferably by a FQDN (Fully Qualified Domain Name) rather than an IP address

  • set up your PaperCut Print Deploy Reference computer

  • deployed and manually tested at least one print queue.

You are working from your 'Documents' folder on your macOS machine.

Steps

To deploy the Print Deploy client using Jamf:

  1. (Optional) Customize the user login popup

  2. Create a .plist configuration file

  3. Add your '.plist' to Jamf Pro

  4. Download and extract the Print Deploy client

  5. Add your .pkg to Jamf Pro

  6. Deploy the PaperCut Print Deploy client

  7. Verify your deployment

Step 1: (Optional) Customize the user login popup

Depending on the method you've chosen to determine the user's identity, users might be presented with a one-off user login popup for authentication. For details on how to customize the branding and text on the popup, go to Customize the Print Deploy user login popup branding and text.

Step 2: Create a .plist configuration file

The PaperCut Print Deploy Client use the '.plist' file to bootstrap itself.

  1. Open a terminal and issue the following command:

    defaults write ~/Documents/com.papercut.printdeploy.client server_host hostname

  2. Replace the hostname with the FQDN from the '.dmg', for example, print-server.company.lan

  3. Convert the '.plist' file with the following command:

    /usr/bin/plutil -convert xml1 ~/Documents/com.papercut.printdeploy.client.plist

    This prevents an error in Jamf 'Problem uploading file. Plist files must be in XML format.

  4. Verify the contents of the new '.plist' with the following command:

    defaults read ~/Documents/com.papercut.printdeploy.client.plist

    The output should be:

    macOS:Documents localadmin$ defaults read ~/Documents/com.papercut.printdeploy.client.plist

    {

    "server_host" = "print-server.company.lan";

    }

    macOS:Documents localadmin$

Step 3: Add your '.plist' to Jamf Pro

  1. Log in to your Jamf Pro instance, for example, https://your-company.jamfcloud.com

  2. Click Computers > Configuration Profiles; then click + New.

  3. Type the display name and description.

  4. On the left, scroll down to Custom Settings; then click Configure.

  5. Click Upload PLIST file and navigate to the '.plist' file.

  6. Click the Scope tab and deploy the file to the appropriate computers.

  7. Click Save.

Step 4: Download and extract the Print Deploy client

NOTE

If you are installing the Print Deploy client manually, you don't need to extract the '.pkg' from the downloaded '.dmg'.

  1. Log in to your PaperCut NG/MF server, for example, https://print-server.company.lan:9192/admin

  2. Click Enable Printing > Print Deploy. The Print Deploy page is displayed.

  3. At the bottom of the page, next to Download clients click the macOS button.

  4. Save the .dmg file to your Documents folder.

  5. Look at the filename and check that the hostname between the square brackets is correct, for example, 'pc-print-deploy-client[print-server.company.lan].dmg'

  6. Double-click the .dmg file and copy PaperCut Print Deploy Client.pkg to the Desktop.

Step 5: Add your .pkg to Jamf Pro

  1. Log in to your Jamf Pro instance, for example, https://your-company.jamfcloud.com

  2. Click All Settings > Packages; then click New.

  3. Leave the Display Name as is for now.

  4. Click Choose File; then navigate to the downloaded Print Deploy client on the Desktop (extracted from the '.dmg' in the previous step).

  5. Rename the Display Name, for example, remove .pkg.

  6. Click Save.

Step 6: Deploy the PaperCut Print Deploy client

  1. Log in to your Jamf Pro instance, for example, https://your-company.jamfcloud.com

  2. Click the Computers tab > Policies ; then click + New.

  3. Type the Display Name.

  4. Set the appropriate triggers.

  5. Click Packages ; then click Configure.

  6. Next to the recently uploaded 'PaperCut Print Deploy Client' package, click Add.

  7. Click the Scope tab and deploy to the appropriate computers.

  8. Click Save.

Step 7: Verify your deployment

Depending on your Jamf environment, you should be able to trigger the deployment of your new PaperCut Print Deploy client via the following command in Terminal (requires sudo access): sudo jamf policy

After you issue the command the Print Deploy client is deployed to the computer along with the bootstraping '.plist' file.

Print queues are then installed as required. You can see them in System Preferences > Print & Scan (or if enabled, the CUPS web interface).

Some environments will present the logged in user with a username and password prompt.

NOTE

Default printer

The Print Deploy client sets the default printer (default print queue) based on if a print queue name is a Find me / Follow me queue (or variation of, with spaces/hyphens in between).

However, if Windows has been set up to manage the default printer for users, then the client honors the Windows setting.