Override Options for Mac / Linux

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.

Overrides

The overrides for Linux are generally defined in /etc/environment. For example: echo "PL_DISABLE_AD_LOOKUPS=1" | sudo tee -a /etc/environment. The recommended method for applying overrides on macOS is to edit the /Library/LaunchDaemons/com.printerlogic.client.plist file and add the key and string values in the following format:

<key>EnvironmentVariables</key>
<dict>
    <key>PL_CONFIG_DIRECTORY</key>
    <string>/opt/pl-config</string>
    
    <key>PL_TRUST_STORE</key>
    <string>0</string>
</dict>

Please note, the <key>EnvironmentVariables</key> should only be defined once within the file. Define additional environment variables using the <dict> element, as shown above.

After applying a new override, the Virtual Appliance Client must be restarted or the device must be rebooted.

Client

Disable Active Directory Lookups

By default, Virtual Appliance Client will try to look up current user information from discoverable Active Directory(AD) domain controllers that exist in Domain Name System (DNS). If the macOS / Linux workstation is not integrated with Active Directory, you can add an environment variable to prevent the lookup. It only applies to macOS / Ubuntu / RedHat Client version 25.1.0.610 and later.

To enable this override, create the following entry on the device:

1. Navigate to /etc/environment or edit the /Library/LaunchDaemons/com.printerlogic.client.plist file.
2. Create a key named PL_DISABLE_AD_LOOKUPS.
3. Set the string value to 1 to disable AD lookup.
   1. Setting the value back to 0 enables AD lookup.

Ignore Certificate Failures

Set this variable for the Client to ignore certificate verification failures. Some environments may have restrictions that conflict with certificate verification, and can apply this override.

To enable this override, create the following entry on the device:

1. Navigate to /etc/environment or edit the /Library/LaunchDaemons/com.printerlogic.client.plist file.
2. Create a key named PL_TRUST_STORE.
3. Set the string value to 0 or false to ignore certificate failures.
   1. Setting the value back to 1 or true enforces certificate validation.

Proxy Overrides

Set Proxy Type

This override impacts detection of a proxy.

1. Navigate to /etc/environment or edit the /Library/LaunchDaemons/com.printerlogic.client.plist file.
2. Create a key named PL_PROXY_TYPE.
3. Set the string value to the desired option.
   1. MANUAL
   2. PAC
   3. NONE (Disables proxy server use)

Set Proxy to HTTP or HTTPS

This override sets the proxy type to HTTP or HTTPS.

1. Navigate to /etc/environment or edit the /Library/LaunchDaemons/com.printerlogic.client.plist file.
2. Create the desired option.
   1. http_proxy=<Proxy Server FQDN or IP>:<Port>
   2. https_proxy=<Proxy Server FQDN or IP>:<Port>

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:

• pl_device_id — normally stored at /etc/pl_device_id
• pl_configuration.json — normally stored at /opt/PrinterInstallerClient/configuration.json
• PrinterLogicServiceManager/token.json — normally stored at /opt/PrinterInstallerClient/service_client/service-manager/config/token.json

To enable this override, create the following entry on the Service Client device:

1. Navigate to /etc/environment or edit the /Library/LaunchDaemons/com.printerlogic.client.plist file.
2. Create a key named PL_CONFIG_DIRECTORY.
3. Set the string value to the file desired location. Example: PL_CONFIG_DIRECTORY=/opt/pl-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. Navigate to /etc/environment or edit the /Library/LaunchDaemons/com.printerlogic.client.plist file.
2. Create a key named PL_STORAGE_DIRECTORY.
3. Set the string value to the file desired location. Example: PL_STORAGE_DIRECTORY=/opt/pl-config.

Set User Account to Nobody

This override is specific to Ubuntu headless installation and changes the user account running the Client from root to nobody. This override is handy for Service Clients where you don't want the enabled services running as root.

To enable this override, create the following entry on the Service Client device:

1. Navigate to /etc/environment or edit the /Library/LaunchDaemons/com.printerlogic.client.plist file.
2. Create a key named PL_RUN_AS.
3. Set the string value to the desired account, other than root. Example: PL_RUN_AS=nobody.

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. Navigate to /etc/environment or edit the /Library/LaunchDaemons/com.printerlogic.client.plist file.
2. Create a key named XEROX_IGNORE_CHANGE_PERMISSIONS.
3. Set the string value to 1.