Deploy PaperCut Pocket and Hive with Addigy

The page describes how to configure and use Addigy to deploy PaperCut Hive and Pocket to users.

Before you start

Ensure you have the following access and resources before you begin:

• Administrator access to the PaperCut Pocket or PaperCut Hive admin console.
• Administrator access to the Addigy portal with Smart Software creation permissions.
• A target macOS test device enrolled in Addigy for deployment verification.

Configuring the client

Follow these steps to configure the deployment in Addigy:

1. In the PaperCut Pocket or PaperCut Hive admin console, select Add-ons.

2. Search for Jamf Pro, click More information, and then click Add. Navigate to the Setup Instructions Tab.
   

   

    

3. In the Jamf Pro add-on instructions page, locate the Step 1 (Download Installer Package) section, then click the link to download the .zip package.

   

4. In a separate browser tab, open the Addigy portal.

5. In the left navigation panel, select Catalog > Software > Smart Software.

   

6. Click New.

7. In the Smart Software creation interface, type a descriptive name in the Software Name field, for example, PaperCut Hive Client.

8. Type a version identifier and vendor details.

9. Under the installation header, click Select File(s).

10. Click Upload New.

11. Upload the downloaded .zip file to the file payload section, then click Upload and Mark as Selected.

12. Click Select to continue.

    

13. In the PaperCut admin console’s Jamf Pro add-on modal, copy the shell script code provided under Step 2, Action 5 (Installation Command).

14. In the Addigy portal, paste the script into the Install Commands text area.

15. In the pasted installation script, locate the following path reference: /Library/Application\ Support/JAMF/Waiting\ Room

    

16. Replace this path with the auto-generated path located directly below the Install Commands script window labeled Download Folder:

17. Verify that the uploaded .zip file name matches the name in the installation script exactly, and escape any special characters in the directory path with a backslash (\), for example: /Library/Addigy/ansible/packages/My\ PaperCut\ Deployment\ \(1.0\)/papercut-hive.zip

    

18. Scroll to the Condition for Install section.

19. In the Condition for Install dropdown, select Advanced: Custom Conditional Commands.

20. Paste the following bash script into the script input field to check if the target user profile already has the client installed:

    current_user=$(stat -f%Su /dev/console)
    if [[ -z "${current_user}" ]]; then
      echo "Error: Could not determine the logged-in user." &2
      exit 1
    fi
    current_user_home=$(dscl . -read /Users/"${current_user}" NFSHomeDirectory | cut -d' ' -f2)
    #target if pocket:
    target="${current_user_home}/Library/PaperCut Pocket"#target if hive
    #target="${current_user_home}/Library/PaperCut Hive"
    if [[ ! -f "${target}/pc-print-client-service" ]]; then
      exit 0;
    else
      exit 1;
    fi
    

     

    

21. Verify that the Install if return value is 0 checkbox is selected.

    

22. Expand the Removal Command dropdown.

    

23. In the PaperCut admin console’s Jamf Pro add-on modal, select the Uninstall Instructions tab at the top, then copy the uninstallation shell command string under Step 1, Action 5.

    

24. In the Addigy portal, paste the uninstallation script into the Remove Command script box.

    

25. Review all sections to ensure accurate entries, then click Save at the bottom of the page.

Test and assign the deployment

After saving the configuration, perform a test deployment before assigning it to production policies.

1. In the Addigy portal, select Devices.

2. Locate a test machine and manually deploy the newly created Smart Software item.

   

3. Wait for Addigy to report a successful deployment.

Deploy to production

1. In the Addigy portal, select Policies.

2. Select your production device policy, or create a new one.

3. Select Software > Smart Software.

4. Enable the new PaperCut item, then save and enforce the policy

   

5. If you want your users to receive the software as soon as possible, select Deploy now.