Last updated: August 22, 2024
Override Options for Windows
The following override options change the Virtual Appliance Client's functionality on a single device or image rather than making the change in the Admin Console and impacting all Clients.
The override options apply the overrides in the Windows Registry Editor on the target device(s). To open the registry settings, search in the Windows menu or open the Registry Editor in Windows (Run Regedit.exe).
Restart the Client
After implementing one of the overrides below, restart the Client for the changes to take effect.
Use the Task Manager to restart the Client. When you use the End Process Tree option, you are ending the following services:
- PrinterInstallerClientLauncher.exe
- PrinterInstallerClientInterface.exe
-
PrinterInstallerClient.exe
In multi-user environments there will be a PrinterInstallerClient.exe service running for each user connected to the server / image. If the other services don't close after using End Process Tree, they will need to be closed individually.
Follow these steps to restart the Client:
- Open Task Manager.
- Select the Details tab.
-
Right-click on PrinterInstallerClientLauncher.exe and select End Process Tree.
- After ending the services, select the Services tab.
- Right-click on the PrinterInstallerLauncher service and select Start.
Client Behavior
Force Delete Printers from Deployment Assignments
The Client's default functionality is not removing deployed printers from workstations if it cannot validate an Active Directory user, computer, or group membership. This behavior prevents printers from being removed due to temporary issues with Active Directory authentication.
Setting this override on a workstation or VDI image allows the Client to delete deployed printers if it cannot determine Active Directory information.
-
Browse to:
Copy CodeHKEY_LOCAL_MACHINE\SOFTWARE\PrinterLogic\PrinterInstaller\Overrides
- Create a new string value named AlwaysDelete.
- Set the value to 1 to enable the override.
- Reboot the workstation or shutdown and restart the Client.
Hide Client Icon
The Virtual Appliance Client includes a system tray icon for quick access to refreshing the Client, viewing printers, and other enabled features. You can hide the system tray icon globally in the Admin Console (Tools Settings Client in the Shortcut Options section), but this key comes in handy for environments where only a couple of workstations require it to be hidden.
To manually hide the client icon per workstation, create the following registry entry on each workstation you want it hidden:
-
Browse to:
Copy CodeHKEY_LOCAL_MACHINE\SOFTWARE\PrinterLogic\PrinterInstaller\Overrides
- Create a new string value named client_show_icon.
- Set the value to 0.
- Reboot the workstation or shutdown and restart the Client.
Manually Set Client Check-in Interval
With this Client override, you can manually specify a check-in interval for the Client on a workstation or server. The global client check-in, configured on Tools Settings Client in the Client Check-in section, sets the interval for the instance, but some environments may need a specific device to check in more frequently.
To manually set the automatic Client check-in per workstation, create the following registry entry on each computer:
-
Browse to:
Copy CodeHKEY_LOCAL_MACHINE\SOFTWARE\PrinterLogic\PrinterInstaller\Overrides
- Create a new string value named client_check_periodically.
- Set the value equal to the number of minutes that should expire before each check in (0 means never check in).
- Reboot the workstation or shutdown and restart the Client.
NoEdge — Not Recommended
NoEdge opens the Self-service Portal in Internet Explorer rather than in Microsoft Edge. This is not recommended since IE reached End of Life in 2022, but is available for those environments still using it.
-
Browse to:
Copy CodeHKEY_LOCAL_MACHINE\SOFTWARE\PrinterLogic\PrinterInstaller\Overrides
- Create a new string value called NoEdge.
- Set the value to 1 to enable the override.
- Reboot the workstation or shutdown and restart the Client.
Start Up Delay
With this override, the Client is delayed from performing any actions until the defined interval has passed after the workstation or server has started. The Min value sets the minimum time to wait before the Client engages, and the Max value sets the maximum time to wait before the Client engages.
This option is used frequently in VDI environments with a network lag or other software that uses large amounts of resources upon start up.
To manually set the start up delay, create the following registry entry on each workstation / VDI image:
-
Browse to:
Copy CodeHKEY_LOCAL_MACHINE\SOFTWARE\PrinterLogic\PrinterInstaller\Overrides
- Create a new string value named MinStartupDelay.
- Set the value equal to the number of seconds that should expire before the Client starts its process.
- Create a new string value named MaxStartupDelay.
- Set the value equal to the maximum number of seconds that the Client will wait for the network to be available.
- Reboot the workstation or shutdown and restart the Client.
EMR/EPIC/Citrix
Epic (EMR) Print Server Mode
Epic Print Server Mode is set on the Clients running Epic (EMR) print servers. It improves the efficiency of the Client in EMR printing environment in the following ways:
- Adds new printers or removes printers that have had their deployment removed when no one is logged in to the server. Normally, printers are not removed until some logs in.
- Disables unneeded hostname to IP address resolution for printers.
- Allows the installation of Epic-licensed printers.
When using Virtual Appliance to manage printers in both the enterprise and EMR environment, you will need to manually turn on Epic (EMR) Print Server Mode on the EMR print servers. To turn on Epic Print Server mode manually, create the following registry entry on each print server:
-
Browse to:
Copy CodeHKEY_LOCAL_MACHINE\SOFTWARE\PrinterLogic\PrinterInstaller\Overrides
- Create a new string value named epic.
- Set the value to 1.
- Reboot the workstation or shutdown and restart the Client.
EPIC has been renamed EMR (Electronic Medical Records); however, Epic Print Server Mode will still use epic as the string value.
Force Client to Ignore XenDesktop / View Client Registry Keys
This override forces the Client to ignore the registry keys from both Citrix XenDesktop and VMware View Clients and act as if it were running on a normal desktop.
To enable this override, create the following registry entry on each workstation / VDI image:
-
Browse to:
Copy CodeHKEY_LOCAL_MACHINE\SOFTWARE\PrinterLogic\PrinterInstaller\Overrides
- Create a new string value named DISABLE_ENDPOINT_DETECTION.
- Set the value to 1 to enable the override.
- Reboot the workstation or shutdown and restart the Client.
Instance Delay
With this override, the Client is delayed from performing any actions until the defined interval has passed after the client has started. The Min value sets the minimum time to wait before the Client engages, and the Max value sets the maximum time to wait before the Client engages.
This option is similar to the Start-Up Delay and is recommended for Terminal Server / Remote Desktop / Xen App environments. It prevents a new thread of the Client from starting its check-in too soon. This override is frequently used when long login times occur due to running programs, large GPO lists, or high numbers of Active Directory users and groups.
To enable this override, create the following registry entry on each workstation / server / image:
-
Browse to:
Copy CodeHKEY_LOCAL_MACHINE\SOFTWARE\PrinterLogic\PrinterInstaller\Overrides
- Create a new string value named MinNewInstanceDelay.
- Set the value equal to the number of seconds that should expire before the Virtual Appliance Client starts its process.
- Create a new string value named MaxNewInstanceDelay.
- Set the value equal to the maximum number of seconds that the client will wait for the network to be available.
- Reboot the workstation or shutdown and restart the Client.
Store Self-Installed Printers in Roaming Profiles
This override stores printers self-installed from the Self-service Portal in the users' roaming profiles, automatically reinstalling them the next time the user logs into a View Client / XenDesktop session. This is normal behavior in XenApp and Terminal Services (TS) sessions but can be turned off using this override if needed.
To enable this override, create the following registry entry on each workstation / server / image:
-
Browse to:
Copy CodeHKEY_LOCAL_MACHINE\SOFTWARE\PrinterLogic\PrinterInstaller\Overrides
- Create a new string value named RESTORE_USERINSTALLED_PRINTERS.
- Set the value to -1 to force OFF the behavior of TS mode that remembers printers from previous sessions, and cleans up reg keys that normally store them as users log in.
- Set the value to 0 to keep everything behaving as normal.
- Set the value to 1 to force ON the behavior of TS mode that remembers printers from previous sessions and restores them.
- Reboot the workstation or shutdown and restart the Client.
The registry key where the user's printers are stored is: HKCU\Printers\Settings\TS
.
Low-Bandwidth Environments
Ignore Group Membership
With this override set, the client doesn't perform LDAP group membership queries. In some environments the group query can create a noticeable load on the domain controller. This override is helpful in environments with domain controllers not equipped to handle the extra traffic.
To enable this override, create the following registry entry on each workstation / server / image:
-
Browse to:
Copy CodeHKEY_LOCAL_MACHINE\SOFTWARE\PrinterLogic\PrinterInstaller\Overrides
- Create a new string value named IgnoreGroupMembership.
- Set the value to 1.
- Reboot the workstation or shutdown and restart the Client.
Instead of seeing LDAP queries for groups, the log contains a message stating "Ignoring group memberships."
Move Cache Manager Storage to New Location
By default, the Cache Manager stores cache files to c:\program files (x86)\printer properties pro\printer installer client\cache
. This override enables you to change the cache storage location, for example, to a different hard drive. Reference Cache Drivers for more information on this feature.
To manually set where the Virtual Appliance Cache Manager stores files, create the following registry entry on the Cache Manager computer:
-
Browse to:
Copy CodeHKEY_LOCAL_MACHINE\SOFTWARE\PrinterLogic\PrinterInstaller\Overrides
- Create a new string value named cache_manager_location.
- Set the value as the path to the new location.
- Reboot the workstation or shutdown and restart the Client.
Proxy Overrides
For the Virtual Appliance Client and Service Client to communicate with your instance through a proxy server, a Windows machine needs to use proxy overrides in the Registry Editor. Follow either below to set up the proxy overrides.
Option 1: Edit the Windows Registry (PAC)
Edit the registry at Computer\HKEY_LOCAL_MACHINE\SOFTWARE\PrinterLogic\PrinterInstaller\Overrides
with the following entries:
-
Browse to:
Copy CodeHKEY_LOCAL_MACHINE\SOFTWARE\PrinterLogic\PrinterInstaller\Overrides
- Create a new string value: ProxyType (value name), PAC (value data)
-
Create a new string value:: ProxyDiscovery (value name), [full URL of the PAC file] (value data)
Option 2: Edit the Windows Registry (MANUAL)
Edit the registry at Computer\HKEY_LOCAL_MACHINE\SOFTWARE\PrinterLogic\PrinterInstaller\Overrides
with the following entries:
-
Browse to:
Copy CodeHKEY_LOCAL_MACHINE\SOFTWARE\PrinterLogic\PrinterInstaller\Overrides
- Create a new string value: ProxyType (value name), MANUAL (value data)
-
Create a new string value: ProxyServer (value name), [full URL of the proxy server, including port] (value data)
Service Client
Change Client Configuration Files Location
This system variable overrides the location where the Vasion Print Client configuration files are stored. This override is helpful on machines designated as the Service Client and helps keep files in the same area.
Items stored here are:
- stateid.dat — normally stored at C:\Program Files (x86)\Printer Properties Pro\Printer Installer Client\stateid.dat
- config.ini — normally stored at C:\Program Files (x86)\Printer Properties Pro\Printer Installer Client\config.ini
- PrinterLogicServiceManager/token.json — normally stored at C:\Program Files (x86)\Printer Properties Pro\Printer Installer Client\ServiceHost\config\token.json
To enable this override, create the following entry on the Service Client device:
- Open Windows System Properties.
- Select the Advanced tab.
- Select Environment Variables.
- In the System Variables, select New...
- For the Variable name, enter PL_CONFIG_DIRECTORY.
- For the Variable value, enter the path manually or use the Browse Directory button to select the desired location. Example: C:\ProgramData\PrinterLogic\config.
Change Service Client Services Files Location
This system variable overrides the location where the Vasion Print Service Client services files are stored. This override is helpful on machines designated as the Service Client and helps keep files in the same area.
Each Service Client service in use is stored in a sub-directory of the service's name. For example:
- PrinterLogicServicePrinterApp
- PrinterLogicServiceOutputManagement
To enable this override, create the following entry on the Service Client device:
- Open Windows System Properties.
- Select the Advanced tab.
- Select Environment Variables.
- In the System Variables, select New...
- For the Variable name, enter PL_STORAGE_DIRECTORY.
- For the Variable value, enter the path manually or use the Browse Directory button to select the desired location. Example: C:\ProgramData\PrinterLogic\storage.
Xerox Ignore Change Permissions
When the Xerox Control Panel Application (CPA) gets installed in Single Sign-On (SSO) Provider mode it changes the application permissions and adjusts the home screen. This override ignores application permission changes and sets the home screen to Virtual Appliance.
To enable this override, create the following entry on the Service Client device:
- Open Windows System Properties.
- Select the Advanced tab.
- Select Environment Variables.
- In the System Variables, select New...
- For the Variable name, enter XEROX_IGNORE_CHANGE_PERMISSIONS.
- For the Variable value, enter 1.
Troubleshooting
Disable Port Monitor
This override should NOT be used in environments with Pull or Secure Release Printing, as it will cause those services to stop functioning.
Virtual Appliance uses Port Monitor for features like Pull and Secure Release Printing. In environments that do not utilize these features, the following registry key can be implemented to disable Port Monitoring.
-
Browse to:
Copy CodeHKEY_LOCAL_MACHINE\SOFTWARE\PrinterLogic\PrinterInstaller\Overrides
- Create a new string value named DisablePortMonitor.
- Set the value to 1 to enable the override.
- Reboot the workstation or shutdown and restart the Client.
-
New Mobile App Release
iOS Released: October 8th, 2024 -
SAP Configuration
SAP Configuration Settings Topic -
Released: 10/02/2024
Updated Client Version Included
-
Released: September 3rd, 2024
-
Updated Supported ChromeOS Version
Supports ChromeOS 109+