[Legacy] Building A Mac Client Install Package

KB Home   |   [Legacy] Building A Mac Client Install Package

NOTE: This method is only available for PaperCut 12 and earlier and only tested to work on Tiger 10.4 and Leopard 10.5. It also installs a LaunchD LaunchAgent to ensure the client automatically starts on login/boot.

The Mac client is provided as a standard .app package. No special installation is normally required. The application package PCClient.app can be simply dragged into the Applications directory on any computer. Some organizations however would like to deploy the application in an installer package so the installation process is consistent with other applications. This Knowledge Base article provides the resources to build your own installer. (A custom installer needs to be built for each site as each site’s PCClient.app is different as it’s customized to connect to the unique server via it’s IP address and/or hostname.)

Prerequisites:

  • Advanced Apple Mac administration knowledge.
  • A copy of the PackageMaker program provided by Apple (provided in the Developer Tools CD).
  • A working installation of PaperCut.

The Process:

  1. Copy your client from the PaperCut server to a workstation’s /Applications directory
  2. Confirm that it works as expected (e.g. via double-click). Make any configuration changes as required (e.g. edit PCClient.app/Contents/Resources/config.properties)
  3. Install PackageMaker
  4. Download the DMG file here and open it.
  5. Copy the working client into the directory root/Applications/ in this DMG.
  6. Open the “PaperCut Custom Client Package Project” in PackageMaker.
  7. Select Build... from the Project menu and save the created installer package to your HD.
  8. Test your newly created installer package including a full system restart to confirm that the client will automatically start after login.
  9. Provide the installer in a DMG to your users. The process of creating a disk image is discussed here.

Tip: It may be helpful to include other information in the DMG such as a README file that discusses how to install, your organizations print quota policy, and who to contact in the event of any problems.

This method will work on Tiger 10.4 and Leopard 10.5. It also installs a LaunchD LaunchAgent to ensure the client automatically starts on login/boot.

The DMG also contains a README file that has additional information you may find useful. Also please feel free to email our dev. team for assistance.


Categories: Implementation, Deployment


keywords: apple, client deployment, packaging, installer, installation, packagemaker

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 December 13, 2013, at 06:23 PM
Printable View   |   Article History   |   Edit Article