Service Client

A Service Client is a Virtual Appliance client that has been promoted to provide additional service functions within the instance. The Service Client machine can be a workstation or a server always available on your network.

Windows devices using ARM processors are not currently supported for Admin Console machines and end user workstations.

Minimum Machine Requirements

The following are MINIMUM specs for the Service Client machine. You may need to increase these specs depending on the services you're running. Monitor the CPU and RAM utilization and allocate additional resources as needed.

  • Workstation:
    • Windows 10, 11; Server 2016, 2019, 2022 is highly recommended.
    • Mac with an Intel processor, or you can use an Ubuntu LTS box 20.04.
  • 20GB space on the Hard Drive.
  • 8GB RAM.
  • Dual-core processor.
  • Visual C++ Redistributable for Visual Studio 2015-2022 bundle is required.
    • Both the x86 and x64 redistributable packages must be installed. You can download these packages from the Microsoft Download Center.

Additional CPA Requirements

Additional requirements for the Printer Apps Service for the CPA Control Panel Application. An application installed on compatible MFP devices that aids in the release of held print jobs.:

  • Service Client machine should be placed as close to the devices it's managing as possible
  • Add an additional 2GB RAM to the minimum listed above for every 100 printers
  • If SSO is used RAM should be monitored and increased as needed due to increased memory usage during check-in times.

Designate the Service Client

  1. Select a machine to set up as the Service Client that meets the minimum specs listed above.
  2. Install and authorize the Client on the machine. For details about installing the Client, see Install the Client & Web Extension.

    We highly recommend that the Service Client runs the latest version since some features may require it.

  3. Note the machine(s) IP address (preferred) or Hostname.

Create Service Client

  1. Sign in to the Admin Console.
  2. Select the folder where you want to place the Service Client.
  3. Select the New button at the top of the folder structure, or

    New Service Client option using the New button.

  4. Right-click on the folder and select New then Service Client.

    New Service Client option using the context menu.

  5. In the Name field, give the Service Client object an identifiable name.
  6. In the IP Address or Hostname enter the IP Address or FQDN of the Service Client object host machine.
  7. Select Add Service Client.

    Add Service Client modal.

    If you use HTTPS, use the FQDN to reduce potential communication issues. This is especially important for CPA manufacturers such as Ricoh, Toshiba, and Kyocera.

Refresh the Service Client Machine

On the machine designated as the Service Client, refresh the Client and confirm the processes are running by doing the following:

  1. Locate the Virtual Appliance icon in the system tray and right-click to open the context menu, or

    Refresh Configuration option from system tray

  2. Open the start menu, search / locate and open the Printer Installer folder.

    Refersh Client option from Start Menu

  3. Select Refresh Configurations.
  4. Open Task Manager and select the Details tab.
  5. In the Search field type "printer" to locate the Client processes.
  6. Confirm the PrinterLogicServiceManager.exe process is running along with the three PrinterInstallerClient processes.

    Task Manager Details tab view with the PrinterLogic Service Manager service running

You can view each Service Client service you enable in the Task Manager.

Reauthorization Steps

Use the following steps to generate a new authorization token for a Service Client if it's missing, or if the PrinterLogicServiceManager.exe service is crashing.

Reauthorize the Service Client only if you've checked the URL, client authorization, and folders first. Complete the steps below within two minutes or the reauthorization fails.

  1. On the machine set up as the Service Client, navigate to C:\Program Files (x86)\Printer Properties Pro\Printer Installer Client\ServiceHost/Config.
  2. Verify if there is an existing token.json file. If there is, delete the file.
  3. Open the Task Manager.
  4. Select the Details tab.
  5. Right-click on PrinterInstallerClientLauncher.exe and select End Process Tree. There are three PrinterInstallerClient processes running for the Client. If the other two services don't close, then close them individually.
  6. In the Virtual Appliance Admin Console, navigate to the Service Client object.
  7. Select the Service Client and in the General tab, select Reauthorize.
  8. Select Okay to close the message.
  9. Back on the Service Client machine, select the Services tab in the Task Manager.
  10. Right-click on PrinterInstallerLauncher service and select Start.

Once the services start, the machine pulls down a fresh token.

Troubleshooting Help