CPA Manager
Last Updated: April 07, 2026
You use the Control Panel Application (CPA) Manager to simultaneously install apps on multiple printer objects that are from the same manufacturer. The CPA Manager also provides a status overview of each installed app across your network, including which printers have which apps installed.
Access the CPA Manager
To access the CPA Manager, log in to the Admin Console on the device that is managing your Printer Apps service, select the Service Client in the tree structure, and select the Printer Apps tab.
CPA Manager Details
The top of the tab shows the following:
- The option to turn on the Printer Apps service.
- The Service Client status.
- The status indicator, which appears green for online and red for offline.
- The current Service Client version.
- Service Client HTTPS certificate information.
- The Service Client hostname or IP address.
- The certificate hostname or IP address.
- The certificate status, which is whether the certificate matches the hostname.
TLS Settings Section
Use this section to adjust the installation and general communication between all printers and the Service Client to allow Transport Layer Security (TLS) 1.0. Simplified Scanning features might not function on older devices that do not support TLS 1.2 or later. Turning on this option is not recommended and is meant for only customers with legacy equipment that does not function with a later version.
For more details refer to Transport Layer Security (TLS) Settings.
Service Log Level Section
Use this section to adjust the log level for the CPA service.
The Service Log Level section on the Printer Apps tab changes which information is recorded in the printer apps logs. This feature requires Printer Apps version 25.4.4 or later. Use the dropdown menu to adjust logging as needed when troubleshooting your environment.
Choose from the following options:
- Info: Default mode that shows information-level logging for running services, including errors and warnings.
- Debug: Shows all messages, including info, debug, error, and warning messages.
- Warning: Shows errors and warnings.
- Error: Shows only errors.
Do the following to adjust the logging level:
- Go to the Printer Apps tab of the Service Client that is running the Printer Apps service.
- In the Service Log Level section, select the desired option.
- Select Save in the upper-right corner.
- Allow 1 minute for the change to take effect.
When you finish troubleshooting, change the log level to the recommended Error option, and save the change.
Printers List
The bottom part of the Printer Apps tab shows the list of printers that have apps installed and are managed by the Service Client. You can select any column heading to sort in ascending or descending order. The number of printers added to the CPA Manager appears above the Actions dropdown menu.
There are several columns:
- Printer Name: The name of the printer object as defined in the tree structure. Select the name to open the printer object.
- IP Address: The printer object's IP address.
- Printer Folder Path: Shows the folder path to the printer object.
- Manufacturer: The printer object's device manufacturer.
- ICMP Ping The printer object's current Internet Control Message Protocol (ICMP) Internet Control Message Protocol (ICMP) is a network protocol used for diagnostics and network management. ICMP pings are echo request and echo reply messages. status, which indicates connectivity between devices. The ping intervals match those set for your Simple Network Management Protocol (SNMP) status monitoring.
- CPA Authentication: Lists icons that depict the authentication types configured for the object. Hover over the icons to view descriptions:
: username and password authentication.
: PIN authentication.
: badge scan authentication.
: single sign-on (SSO) authentication.
- Status: Lists messages about the printer object's current status and, in some cases, past status. These messages can help you determine which errors are blocking installation, the current progress of an installation, and whether you previously had the app installed.
Turn On the Printer Apps Service
Follow these steps:
- Go to the Service Client's Printer Apps tab.
-
Select Enable Printer Apps.
- Select Save.
- Access the device designated as the Service Client.
- Use the system tray icon or Start menu to refresh configurations.
- Open the Task Manager, and select the Details tab.
- In the Search field, enter "printer" to locate the Client processes.
- Confirm that the following services are running:
- Client services, which include PrinterInstallerClient.exe, PrinterInstallerClientInterface.exe, and PrinterInstallerClientLauncher.exe..
- PrinterLogicServiceManager.exe.
- PrinterLogicServicePrinterApp.exe.
- Other services running on the Service Client also appear.
Add Printers
There are two way to add printers for installation:
- Select the printers from a list.
- Browse and select the printers from the tree structure. By using the tree structure, you can select a folder, which automatically selects all printer objects within it.
Select Printers
When you add multiple printers, they must all be from the same manufacturer.
Follow these steps:
- Select the Add Printers button.
-
Select any printers from the list as long as they are from the same manufacturer, and then select Next.
-
Select the manufacturer from the dropdown menu.
-
Select settings to apply to all selected printers, and then select Next. The options that appear vary by manufacturer.
If you use an identity provider (IdP), the CPA only supports badge and PIN authentication.
-
Confirm that all the printers are from the same manufacturer, and then select Save.
-
Select Close on the modal. The process continues in the background and might take some time.
The printers appear in the list, and you can view the current statuses in the Status column.
Browse Printers
Follow these steps:
- Select the Add Printers button.
-
Select the Browse button.
-
Open the tree structure to the printer or folder that you want to add to the CPA Manager list. Then select Add.
You can hold the Ctrl or Shift key to select multiple folders and printers. All selected printers must be from the same manufacturer. Select a folder only if all printers in that folder are from the same manufacturer.
-
After you add the selected printers, select Next.
-
Select the manufacturer from the dropdown menu.
-
Select settings to apply to all selected printers, and then select Next. The options that appear vary by manufacturer.
-
Confirm that all the printers are from the same manufacturer, and then select Save.
-
Select Close on the modal. The process continues in the background and might take some time.
The printers appear in the list, and you can view the current statuses in the Status column.
Action Options
You can perform specific actions, depending on which printers you select in the CPA Manager list. Actions rely on certain factors, such as printer configuration and whether the selected printers have the same manufacturer. Actions become available when you select a printer.
Just because a printer appears in the list does not mean that it is ready to have an app installed. The list includes any printer associated with the Service Client.
Options include the following:
- Install Apps: This option installs the CPA or Off-Network Cloud Print (ONCP) app onto printers. When the printer is added correctly, you can install multiple CPAs or ONCP apps onto printers, regardless of the manufacturer.
- Uninstall Apps: This option uninstalls apps from printers. You can uninstall multiple apps, regardless of the manufacturer.
- Modify: This option is available only if you select printers from the same manufacturer. You can modify the printer's admin credentials, SSO authentication, and CPA authentication.
- Delete: This option removes the printer definition from the Service Client, which removes the Service Client from the Printer Apps. If you delete a printer here, the Apps tab on the printer no longer lists the Service Client. This option does not delete the printer from the tree structure. You can delete multiple items at once.
Install Apps
When you add multiple printers, they must all be from the same manufacturer.
Follow these steps:
- Select the printer that you want to install apps on.
-
Select Install Apps from the Actions menu.
- Select from the following apps, which appear as long as they are turned on and meet all requirements:
- Direct Secure Release.
- Scan to Email: If your printer supports Simplified Scanning.
- Scan to Cloud: If your printer supports Simplified Scanning.
- QR Code Display.
- Copy / Scan Tracking.
- Off-Network Cloud Print (ONCP).
-
Select Save.
Depending on which features you select, the process can take time. You can refresh the page to view status changes.
-
Select Close on the modal. The process continues in the background and might take some time.
After the installation completes, the status updates to Control Panel: Install completed successfully or ONCP: Install completed successfully. Hover over the CPA Authentication icons to view descriptions.
Uninstall Apps
When you add multiple printers, they must all be from the same manufacturer.
Follow theses steps:
-
Select the printer that you want to uninstall apps from.
-
Select Uninstall Apps from the Actions menu.
-
Select the apps to uninstall, and then select Save.
Depending on which features you select, the process can take time. You can refresh the page to view status changes.
-
Select Close on the modal. The process continues in the background and might take some time.
After the process completes, the status updates to Control Panel: Uninstall completed successfully or ONCP: Uninstall completed successfully. The status always appears in blue to indicate that you successfully uninstalled the app.
Modify Configurations
When you add multiple printers, they must all be from the same manufacturer.
Follow these steps:
- Select the printer that you want to modify app settings for.
- Select Modify from the Actions menu.
-
Adjust the app settings, and then select Save.
Delete Printers
Follow these steps:
- Select the printer that you want to delete.
- Select Delete from the Actions menu.
- In the modal, select OK.
Troubleshooting Help
Is an Identity Provider Configured?
The CPA requires the use of an IdP. This can be LDAP or another IdP such as Entra ID (Azure AD), Okta, etc.
Check the Default Printer Admin Credentials
Are the default printer admin credentials correct?CPA installations can fail if the admin username and password are incorrect. You can resolve this issue by modifying the credentials used for CPA installation. With the Modify option in the CPA Manager, update the credentials for multiple printers as long as they are the same brand. Often, the default admin name and password are the same multiple manufacturers.
Is There a Self-signed Certificate?
At a minimum, the printer requires a self-signed certificate. If an Amazon Root CA 1 certificate is not installed, follow this link to see the steps to obtain the certificate so you can manually install it on the printer.
Is There a Time Difference Between the Service Client and the Printer?
If a certificate did not authorize, it could be because a printer is in a different time zone than the Service Client hosting the Printer Apps. When the Service Client pushes out the CPA application with the certificate, due to the time difference, the certificate may be expired.
You can reach the info page to check the timezone in two ways:
- Log in to the CPA, then tap on the PrinterLogic logo at the top.
- Install the CPA with Extended Debug mode enabled, then tap on the PrinterLogic logo at the top (without the need to log in first).
Check the Network Settings
- Verify that the IP address assigned to the printer is accurate within the Admin Console.
- Ensure that you can successfully ping the printer from the Service Client machine.
Are You Using a Universal Print Driver?
Sometimes printer-specific drivers can cause installation issues for the CPA. Use a universal print driver to ensure a smooth and successful installation.
This is a generic communication error. A few things to check are:
- The Service Client is not listening over port 31988. Update the configuration to allow listening over port 31988.
- The printer does not trust the Vasion Print certificate. Register or upload a new certificate.
Fuji Xerox Specific
In the printer settings, configure the Domain Name within the DNS Configuration settings to see if it resolves.
The CPA requires a Service Client to install apps to the printer. Check that the Service Client machine is not shut down or in an error state.
On the machine, open the Task Manager and select the details tab. In the Search field, type "printer" to locate the Client processes.
If neither the PrinterLogicServiceManager.exe or PrinterLogicServicePrinterApp.exe processes are running on the Service Client device, verify the Client installation and / or check the Service Client was installed properly.
Verify the Client Installation
Verify the Client is installed, authorized and pointing to the correct instance. A quick test is to click the system tray icon to open the Self-service Portal. If it opens to the correct URL, you can sign in, and see / install printers from the portal, then the client is authorized.
If you're prompted for an authorization code in the Self-service Portal, see Device Authorization for steps on how to create one.
If the Self-service Portal opens to an incorrect URL, you'll need to set the home URL. See Update the Home URL.
Verify the Service Client Configuration
Navigate to C:\Program Files (x86)\Printer Properties Pro\Printer Installer Client\ServiceHost. and check the following:
If the Service Host folder is not created, check the machine's hostname or IP address and compare with what you entered for the Service Client in the Admin Console.
If the folder is created, check the config folder in it. A token.json file is saved here when the Service Client is authorized.
If the folder is created, but the token.json file is not there, you need to reauthorize the Service Client, see Reauthorization Steps. Please note that the Service Client authorization is different from the Client authorization.
You can find the log file on the Service Client machine at the following path:
Windows:
C:\Program Files (x86)\Printer Properties Pro\Printer Installer Client\ServiceClientLogs\PrinterLogicServicePrinterApp.log
Mac/Linux:
/opt/printerinstallerclient/log/printerlogicserviceprinterapp.log
If the installation fails with an InvalidSolutionsKeyError, update the printer's region in the firmware settings.
The CPA can show text in the following languages. For more details refer to Supported Languages.
- Dutch: 0413.
- English: 0409.
- French: 040C.
- German: 0407.
- Italian: 0410.
- Japanese: 0411.
- Polish: 0415.
- Portuguese: 0416.
- Simplified Chinese: 0404.
- Spanish: 040A.
- Swedish: 0409.
- Thai: 041E.
- Turkish: 041F.
To display a printer in the CPA Manager list, it only needs to be associated with a Service Client. A Service Client can also be assigned to a printer through the printer’s Apps tab. If it is assigned in the printer's Apps tab, it also displays in the CPA Manager.
However, keep in mind that just because a printer is displayed in the CPA Manager does not necessarily mean it is configured correctly. If the configuration on the printer Apps tab is incorrect, such as an incorrect username and password, the installation will fail whether it is initiated from the printer's Apps tab or the CPA Manager.