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 then 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:

  1. Open Task Manager.
  2. Select the Details tab.
  3. Right-click on PrinterInstallerClientLauncher.exe and select End Process Tree.

  4. After ending the services, select the Services tab.
  5. 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.

  1. Browse to:

    Copy Code
    HKEY_LOCAL_MACHINE\SOFTWARE\PrinterLogic\PrinterInstaller\Overrides
  2. Create a new string value named AlwaysDelete.
  3. Set the value to 1 to enable the override.
  4. 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 then Settings then 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:

  1. Browse to:

    Copy Code
    HKEY_LOCAL_MACHINE\SOFTWARE\PrinterLogic\PrinterInstaller\Overrides
  2. Create a new string value named client_show_icon.
  3. Set the value to 0.
  4. 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 then Settings then 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:

  1. Browse to:

    Copy Code
    HKEY_LOCAL_MACHINE\SOFTWARE\PrinterLogic\PrinterInstaller\Overrides
  2. Create a new string value named client_check_periodically.
  3. Set the value equal to the number of minutes that should expire before each check in (0 means never check in).
  4. 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.

  1. Browse to:

    Copy Code
    HKEY_LOCAL_MACHINE\SOFTWARE\PrinterLogic\PrinterInstaller\Overrides
  2. Create a new string value called NoEdge.
  3. Set the value to 1 to enable the override.
  4. 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:

  1. Browse to:

    Copy Code
    HKEY_LOCAL_MACHINE\SOFTWARE\PrinterLogic\PrinterInstaller\Overrides
  2. Create a new string value named MinStartupDelay.
  3. Set the value equal to the number of seconds that should expire before the Client starts its process.
  4. Create a new string value named MaxStartupDelay.
  5. Set the value equal to the maximum number of seconds that the Client will wait for the network to be available.
  6. 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:

  1. Browse to:

    Copy Code
    HKEY_LOCAL_MACHINE\SOFTWARE\PrinterLogic\PrinterInstaller\Overrides
  2. Create a new string value named epic.
  3. Set the value to 1.
  4. 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:

  1. Browse to:

    Copy Code
    HKEY_LOCAL_MACHINE\SOFTWARE\PrinterLogic\PrinterInstaller\Overrides
  2. Create a new string value named DISABLE_ENDPOINT_DETECTION.
  3. Set the value to 1 to enable the override.
  4. 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:

  1. Browse to:

    Copy Code
    HKEY_LOCAL_MACHINE\SOFTWARE\PrinterLogic\PrinterInstaller\Overrides
  2. Create a new string value named MinNewInstanceDelay.
  3. Set the value equal to the number of seconds that should expire before the Virtual Appliance Client starts its process.
  4. Create a new string value named MaxNewInstanceDelay.
  5. Set the value equal to the maximum number of seconds that the client will wait for the network to be available.
  6. 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:

  1. Browse to:

    Copy Code
    HKEY_LOCAL_MACHINE\SOFTWARE\PrinterLogic\PrinterInstaller\Overrides
  2. Create a new string value named RESTORE_USERINSTALLED_PRINTERS.
  3. 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.
  4. Set the value to 0 to keep everything behaving as normal.
  5. Set the value to 1 to force ON the behavior of TS mode that remembers printers from previous sessions and restores them.
  6. 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:

  1. Browse to:

    Copy Code
    HKEY_LOCAL_MACHINE\SOFTWARE\PrinterLogic\PrinterInstaller\Overrides
  2. Create a new string value named IgnoreGroupMembership.
  3. Set the value to 1.
  4. 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:

  1. Browse to:

    Copy Code
    HKEY_LOCAL_MACHINE\SOFTWARE\PrinterLogic\PrinterInstaller\Overrides
  2. Create a new string value named cache_manager_location.
  3. Set the value as the path to the new location.
  4. 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:

  1. Browse to:

    Copy Code
    HKEY_LOCAL_MACHINE\SOFTWARE\PrinterLogic\PrinterInstaller\Overrides
  2. Create a new string value: ProxyType (value name), PAC (value data)
  3. Create a new string value:: ProxyDiscovery (value name), [full URL of the PAC file] (value data)

    Copy Code
    Example
    https://sampledomain.com/proxy.pac

Option 2: Edit the Windows Registry (MANUAL)

Edit the registry at Computer\HKEY_LOCAL_MACHINE\SOFTWARE\PrinterLogic\PrinterInstaller\Overrides with the following entries:

  1. Browse to:

    Copy Code
    HKEY_LOCAL_MACHINE\SOFTWARE\PrinterLogic\PrinterInstaller\Overrides
  2. Create a new string value: ProxyType (value name), MANUAL (value data)
  3. Create a new string value: ProxyServer (value name), [full URL of the proxy server, including port] (value data)

    Copy Code

    Example

    http://proxy.domain.com:3128

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:

  1. Open Windows System Properties.
  2. Select the Advanced tab.
  3. Select Environment Variables.
  4. In the System Variables, select New...
  5. For the Variable name, enter PL_CONFIG_DIRECTORY.
  6. 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:

  1. Open Windows System Properties.
  2. Select the Advanced tab.
  3. Select Environment Variables.
  4. In the System Variables, select New...
  5. For the Variable name, enter PL_STORAGE_DIRECTORY.
  6. 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:

  1. Open Windows System Properties.
  2. Select the Advanced tab.
  3. Select Environment Variables.
  4. In the System Variables, select New...
  5. For the Variable name, enter XEROX_IGNORE_CHANGE_PERMISSIONS.
  6. 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.

  1. Browse to:

    Copy Code
    HKEY_LOCAL_MACHINE\SOFTWARE\PrinterLogic\PrinterInstaller\Overrides
  2. Create a new string value named DisablePortMonitor.
  3. Set the value to 1 to enable the override.
  4. Reboot the workstation or shutdown and restart the Client.