Choose your language

Choose your login

Contact us

PaperCut Pocket and PaperCut Hive deployment with JumpCloud (Windows)

This page applies to:

When deploying the PaperCut Pocket or PaperCut Hive edge node and print client with JumpCloud Device Management, we split the deployment into two parts: first the edge node, and then the print client.

The edge node

  • The computer app is run with elevated privileges, so it doesn’t require the user to be logged in.
  • The computer app creates the PaperCut Pocket or PaperCut Hive edge node Windows service, and PaperCut Printer object.
  • The edge node can be deployed without a print client. For example, you can install a super node on Windows Server.
  • The edge node must be deployed before installing the print client.

The print client

  • The computer app creates the print client processes for print job submission.
  • It installs files and processes in the Users Security Context.
  • The install runs as “Run as logged on User”.
  • After successful execution, it requires the user to perform the linking process via their email invite.

Prerequisites

  • You have already rolled out the JumpCloud Agent to your Windows computers.
  • Cloud storage is available to host the PaperCut Pocket or PaperCut Hive computer app installer.

Create the JumpCloud Commands and install the edge node and print client on users’ computers

You need to create separate JumpCloud commands to deploy the PaperCut Pocket or PaperCut Hive edge node and print client to your users’ computers.

1. Create the Command and deploy the PaperCut Pocket or PaperCut Hive edge node
  1. Go to PaperCut Hive Admin console > Manage > Edge Mesh and click Add edge nodes.

    PaperCut Pocket/PaperCut Hive admin interface - Add an edge node

    PaperCut Pocket/PaperCut Hive admin interface - Add an edge node

  2. Select Manually deploy edge nodes.

  3. Click Download for Windows to download the PaperCut Pocket or PaperCut Hive computer app (papercut-pocket.exe or papercut-hive.exe). Copy the downloaded file to your preferred cloud storage provider. (In this example we are using DropBox.)

  4. Under Step 2, click the Copy button to copy the command line, and then paste it into a text editor. You’ll need the /systemkey value later.

    PaperCut Pocket/PaperCut Hive admin interface - Manually deploy edge nodes

    PaperCut Pocket/PaperCut Hive admin interface - Manually deploy edge nodes

  5. Log in to JumpCloud and under Device Management navigate to Commands.

  6. Add a new Command by clicking on the plus icon and selecting Command.

  7. In the Name field type PaperCut Pocket edge node Install v2.0 or PaperCut Hive edge node Install v2.0

  8. Select Windows for Type and check the Windows Powershell checkbox.

  9. Paste the following script into the Command field.

#JumpCloud Command Script to install PaperCut Hive edge node v2.0

$folder = 'C:\Program files\PaperCut Hive'

if (-not (Test-Path -Path $Folder)) {

(New-Object System.Net.WebClient).DownloadFile("https://your-cloud-storage-location/papercut-hive.exe", "C:\TEMP\papercut-hive.exe")

start-process -FilePath "C:Temp\papercut-hive.exe" -ArgumentList '/VERYSILENT /systemKey="xxxxxxxxxxx"'

    }

else  { }
  1. Replace the /systemkey value in the script with the /systemkey value you noted down in Step 4.

  2. Edit the DownloadFile URL to the URL of where you have made the papercut-pocket.exe or papercut-hive.exe availale.

  3. For initial testing set the Launch Event to Run Manually. Once fully tested and you are comfortable you can change the Launch Event to run on a scheduled basis.

    JumpCloud - PaperCut Pocket/PaperCut Hive edge node Command

    JumpCloud - PaperCut Pocket/PaperCut Hive edge node Command

  4. Click on Devices to select your test computer that you wish to deploy PaperCut Hive edge node to. Best practice is to test the deployment to a test computer end to end before pushing out to a greater number of computers.

    JumpCloud - PaperCut Pocket/PaperCut Hive edge node Command

    JumpCloud - PaperCut Pocket/PaperCut Hive edge node Command

  5. Click Save to save the Command.

  6. Locate the PaperCut Pocket edge node Install v2.0 or PaperCut Hive edge node Install v2.0 Command from the list on the Commands page you are now on, and click the Run Now button for this command to execute it.

    The PaperCut Pocket or PaperCut Hive edge node is then deployed to your test computer(s).

2. Create the Command and Deploy PaperCut Pocket or PaperCut Hive print client

For the PaperCut Pocket or PaperCut Hive print client, you need to copy the installation command syntax from the InTune Add-on instructions. This contains the /userkey switch that signals the papercut-pocket.exe or papercut-hive.exe to create the user directories and processes.

  1. From the PaperCut Pocket or PaperCut Hive Admin console, under Manage select Add-ons > All Add-ons > Desktop App Deployment with Microsoft Intune.

  2. Click Learn More and Add. The Intune Add-on is now part of your “Added” Add-ons.

    PaperCut Pocket/PaperCut Hive - InTune Add-on

    PaperCut Pocket/PaperCut Hive - InTune Add-on

  3. On the Intune Add-on, select Manage and Follow these instructions.

    PaperCut Pocket/PaperCut Hive - InTune Add-on

    PaperCut Pocket/PaperCut Hive - InTune Add-on

  4. Select View set up process and scroll down to Install the user component.

  5. Go to step 7, copy the Install command string, and paste it into a text editor.

    PaperCut Pocket/PaperCut Hive - print client /userkey

    PaperCut Pocket/PaperCut Hive - print client /userkey

  6. Go to JumpCloud, log in again, and under Device Management navigate to Commands.

  7. Add a new command by clicking on the + icon and selecting Command.

  8. In the Name field, type PaperCut Pocket print client Install V2.0 or PaperCut Hive print client Install V2.0.

  9. Select Windows for Type and check the Windows Powershell checkbox.

  10. Paste the following script in to the Command field ensuring that you replace the /userkey value with the /userkey value from the install command you saved in Step 5.

#JumpCloud Command Script to install PaperCut Hive print client v2.0

$folder = '%localappdata%\Programs\PaperCut Hive'

if (-not (Test-Path -Path $Folder)) {

# If PSModule RunAsUser is not installed, install it
if ( -not (get-installedModule "RunAsUser" -ErrorAction SilentlyContinue)) {
    Install-PackageProvider -Name NuGet -MinimumVersion 2.8.5.201 -Force
    install-module RunAsUser -force
}

$Command = {

C:\Temp\papercut-hive.exe /VERYSILENT /CURRENTUSER /userkey="xxxxxxxxxxx"

}

invoke-ascurrentuser -scriptblock $Command

}
  1. For initial testing set the Launch Event to Run Manually you can change this to be scheduled later once you have finished your testing.

    JumpCloud - PaperCut Pocket/PaperCut Hive print client Command

    JumpCloud - PaperCut Pocket/PaperCut Hive print client Command

  2. Click on Devices to select your test workstation that you wish to deploy the PaperCut Hive print client. Best practice is to test the deployment to a test computer end to end before pushing out to a greater number of computers.

    JumpCloud - PaperCut Pocket/PaperCut Hive print client Command

    JumpCloud - PaperCut/PaperCut Hive print client Command

  3. Click on the Save button to save the command.

  4. Locate the PaperCut Pocket print client Install V2.0 or PaperCut Hive print client Install V2.0 Command from the list on the Commands page you are now on, and click on the Run Now button for this command to execute it.

    The PaperCut Pocket or PaperCut Hive print client is then deployed to your test computer(s).

Post-deployment

After both components are deployed, spot-check your test computer to ensure the following:

  1. In Task Manager, check the pc-edgenode-service is running.
    The Windows PC requires this service to perform Edge Mesh activities such as receiving, replicating, or printing jobs if the PaperCut Cloud Service calls upon it.
  2. In Task Manager, check that pc-print-client-service.exe is running.
    This is the print client needed to link the end-user to PaperCut Pocket or PaperCut Hive and submit jobs via the PaperCut Printer. This process must be running in memory. It provides the functions the user needs to print jobs via the PaperCut Printer.

If either of these are not running, please contact your PaperCut reseller and provide copies of the logs.

Locations of logs

  • Edge node service and setup logs:
    C:\Program Files\PaperCut Hive\data\logs or C:\Program Files\PaperCut Pocket\data\logs
  • User print client logs:
    %AppData%\Local\Programs\PaperCut Hive\data\logs or %AppData%\Local\Programs\PaperCut Pocket\data\logs
  • User client set up logs:
    • %AppData%\Local\Programs\PaperCut Hive\data\logs or %AppData%\Local\Programs\PaperCut Pocket\data\logs
    • %AppData%\Local\Temp

Comments