PaperCut Client Deployment using Mac Packaging & Deployment Tools

KB Home   |   PaperCut Client Deployment using Mac Packaging & Deployment Tools

Main.MacClientAutomatedDeployment History

Hide minor edits - Show changes to output

May 18, 2015, at 09:31 PM by Vanessa White - formatting overhaul for clarity & to match w/ original document
Added lines 11-12:
\\
Added lines 15-16:

\\
Changed lines 52-54 from:
[=For stationary presentation computers and laptops substitute “open -g -W /Applications/PCClient.app” for “/[PathToApplication]/PCClient.app/Contents/MacOS/JavaAppLauncher” and exchange KeepAlive for RunAtLoad -- this will open the client app when the user logs in, and won’t respawn it if they quit the app.
For laptops going on and off site it may be best to skip the launchd plist,  to prevent blank PaperCut Client messages on users’ laptops when they’re off-site -- unless your PaperCut server is accessible from the public internet, laptops will not be able to reach it when offsite.=]
to:
* For stationary presentation computers and laptops substitute [=“open -g -W /Applications/PCClient.app” for “/[PathToApplication]/PCClient.app/Contents/MacOS/JavaAppLauncher”=] and exchange [=KeepAlive=] for [=RunAtLoad=] -- this will open the client app when the user logs in, and won’t respawn it if they quit the app.
* For laptops going on and off site it may be best to skip the launchd plist,  to prevent blank PaperCut Client messages on users’ laptops when they’re off-site -- unless your PaperCut server is accessible from the public internet, laptops will not be able to reach it when offsite.=]
Added lines 57-58:
\\
Changed lines 61-77 from:
!!!A lab of iMacs bound to a directory service

!!!!Deployment solution

[=PCClient.app=] bundled with the Launchd plist and a launchctl kickstart, deployed with management software.

!!!A large number of laptops, not bound to a directory service, but with service-matched shortnames

!!!!Deployment solution
[=PCClient.app=], and Launchd plist set to [=RunAtLoad=] available to users via self-service provided by the management app, or deployed via management app.

!!!BYO Laptops not bound to a directory service without matching shortnames

!!!!Deployment solution
[=PCClient.app=] deployed via self-service, or, alternate printing solutions utilizing PaperCut (Print to email, web print, etc).

to:
*A lab of iMacs bound to a directory service
**Deployment solution:
***
[=PCClient.app=] bundled with the Launchd plist and a launchctl kickstart, deployed with management software.

*A large number of laptops, not bound to a directory service, but with service-matched shortnames
**Deployment solution:
***
[=PCClient.app=], and Launchd plist set to [=RunAtLoad=] available to users via self-service provided by the management app, or deployed via management app.

*BYO Laptops not bound to a directory service without matching shortnames
**Deployment solution:
***
[=PCClient.app=] deployed via self-service, or, alternate printing solutions utilizing PaperCut (Print to email, web print, etc).

Changed line 47 from:
!!Notes
to:
!!!Notes
Added lines 51-52:
See [[MacClientStartupWithLaunchd|Starting the Client on Mac OS with Launchd]] for further details on using launchd.
May 15, 2015, at 06:12 AM by Tim B - Fixed up headings
Changed lines 53-56 from:
!!!1. A lab of iMacs bound to a directory service.

Deployment solution
to:
!!!A lab of iMacs bound to a directory service

!!!!
Deployment solution
Changed lines 59-61 from:
!!!2. A large number of laptops, not bound to a directory service, but with service-matched shortnames.

Deployment solution:
to:
!!!A large number of laptops, not bound to a directory service, but with service-matched shortnames

!!!!
Deployment solution
Changed lines 64-66 from:
!!!3. BYO Laptops not bound to a directory service without matching shortnames.

Deployment solution:
to:
!!!BYO Laptops not bound to a directory service without matching shortnames

!!!!
Deployment solution
May 15, 2015, at 06:08 AM by Tim B - Updated links
Changed lines 26-27 from:
If you're deploying the [=PCClient.app in /Applications/=] then you can use this linked plist: (link to plist currently on the site).
to:
If you're deploying the [=PCClient.app in /Applications/=] then you can use this linked plist: [[(Attach:)PaperCut_LaunchD.zip]].
Changed line 71 from:
''Categories:'' [[Category.TODOFirstCategory|+]], [[Category.TODOSecondCategoryIfNeeded|+]]
to:
''Categories:'' [[Category.UserClientTool|+]], [[Category.Mac|+]]
Changed line 73 from:
[-Keywords: TODO keywords here if needed-]
to:
[-Keywords: launchd, client, login hook, munki, casper-]
May 15, 2015, at 06:01 AM by Tim B - First render of this page.
Added lines 1-73:
(:title PaperCut Client Deployment using Mac Packaging & Deployment Tools:)

This guide is intended for Macintosh Systems Administrators, Software Packagers, and Client Systems Administrators who have a software packaging and deployment solution already in place, such as Jamf’s Casper Suite, or Munki.

It is assumed that you wish to install the PaperCut client locally to workstations.

It is assumed that you have experience packaging and deploying packages in your environment.

For large managed Mac install bases, it is generally not feasible to install the PaperCut Client application [=(PCClient.app)=] by hand on each workstation. This document will explain some best practices for automated deployment of [=PCClient.app=], and any additional files you may wish to deploy with it.

!!Critical Notes
* Please make sure that you keep the version deployed to client machines’ [=PCClient.app=] version up-to-date with the version on your PaperCut application server.

!!Key Components Required for Deployment
* [=PCClient.app=] (required)
* launchd.plist file (required if you wish to keep [=PCClient=] running at all times)

You will need to package [=PCClient.app, and launchd.plist=] if required, and distribute the package to your Mac systems.

!!![=PCClient.app=]
This application is responsible for reporting user balances to your users. It can be found inside the PaperCut NG/MF folder after you’ve completed a server install.  The default path is [=/Applications/Papercut [NG/MF]/client/PCClient.app=].

!!!Launchd.plist
For permanently on-site Macs, where the PaperCut Client app needs to launch on user login and stay running for the entire user session, you should install a launchd plist. For best results store the launchd plist in [=/Library/LaunchAgents/=].

If you're deploying the [=PCClient.app in /Applications/=] then you can use this linked plist: (link to plist currently on the site).

[=If you're using a customized location for the Papercut client app (perhaps in /Applications/Utilities/ or /usr/local/) you will need to modify and deploy the following plist, replacing [PathToApplication] with the appropriate path:=]

[@
  <?xml version="1.0" encoding="UTF-8"?>
  <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
  <plist version="1.0">
  <dict>
      <key>Label</key>
      <string>com.papercut.client.agent</string>
      <key>ProgramArguments</key>
      <array>
          <string>/[PathToApplication]/PCClient.app/Contents/MacOS/JavaAppLauncher</string>
      </array>
      <key>KeepAlive</key>
      <true/>
  </dict>
  </plist>
@]

!!Notes
[=For stationary presentation computers and laptops substitute “open -g -W /Applications/PCClient.app” for “/[PathToApplication]/PCClient.app/Contents/MacOS/JavaAppLauncher” and exchange KeepAlive for RunAtLoad -- this will open the client app when the user logs in, and won’t respawn it if they quit the app.
For laptops going on and off site it may be best to skip the launchd plist,  to prevent blank PaperCut Client messages on users’ laptops when they’re off-site -- unless your PaperCut server is accessible from the public internet, laptops will not be able to reach it when offsite.=]

!!Example deployments

!!!1. A lab of iMacs bound to a directory service.

Deployment solution

[=PCClient.app=] bundled with the Launchd plist and a launchctl kickstart, deployed with management software.

!!!2. A large number of laptops, not bound to a directory service, but with service-matched shortnames.

Deployment solution:
[=PCClient.app=], and Launchd plist set to [=RunAtLoad=] available to users via self-service provided by the management app, or deployed via management app.

!!!3. BYO Laptops not bound to a directory service without matching shortnames.

Deployment solution:
[=PCClient.app=] deployed via self-service, or, alternate printing solutions utilizing PaperCut (Print to email, web print, etc).


----
''Categories:'' [[Category.TODOFirstCategory|+]], [[Category.TODOSecondCategoryIfNeeded|+]]
----
[-Keywords: TODO keywords here if needed-]

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.

Article last modified on May 18, 2015, at 09:31 PM
Printable View   |   Article History   |   Edit Article