Install Client on Ubuntu Linux

Client workstations must have hardware capable of running the operating system with a minimum of 100MB of free hard disk space for the client installation. Additional space for print drivers being installed will likely be required as well.

For a successful install it is recommended that you have the latest version of Ubuntu Linux and CUPS printing.

Install on Ubuntu LTS 18

Ubuntu/CUPS Update Commands (Optional)

sudo apt update
apt-get --reinstall install cups-daemon

Install and Configure the Client

1. Get the client install .deb file from the server:
   Copy Code

   64 bit

   wget https://Home_URL_Here/client/setup/printerinstallerclient_amd64.deb

2. Install the client, set the Home URL, and authorize the client with the following command:

   Replace <HOME_URL_HERE> with URL of your instance. Replace <AUTH_CODE_HERE> with your authorization code.

   Copy Code

   64 bit

   sudo dpkg -i printerinstallerclient_amd64.deb || sudo apt-get -f install && sudo /opt/PrinterInstallerClient/bin/./set_home_url.sh https <HOME_URL_HERE> && sudo /opt/PrinterInstallerClient/bin/use_authorization_code.sh <AUTH_CODE_HERE>

   If you are on a 64-bit HP ThinPro device, install the Client with the following command:

   Copy Code

   sudo dpkg -i printerinstallerclient_amd64.deb || sudo apt-get -f install && sudo /writable/opt/PrinterInstallerClient/bin/./set_home_url.sh https <HOME_URL_HERE> && sudo /opt/PrinterInstallerClient/bin/use_authorization_code.sh <AUTH_CODE_HERE>

Install on Ubuntu LTS 20

Install Dependencies

1. Install APT Dependencies.

   Copy Code

   Install APT Dependencies

   apt-get install --no-install-recommends --no-install-suggests -y \
     cups \
     libc-bin \
     libcups2 \
     libgssapi-krb5-2 \
     libtcl8.6 \
     libtk8.6 \
     libappindicator3-1 \
     libssl1.1 \
     net-tools

2. Download and Install PrinterLogic Dependencies.

   Copy Code

   Install PrinterLogic Dependencies

   wget http://security.ubuntu.com/ubuntu/pool/main/libf/libffi/libffi6_3.2.1-8_amd64.deb
   sudo dpkg -i libffi6_3.2.1-8_amd64.deb
   sudo apt-get -f install

Install and Configure Client

1. Download and Install the Client.

   Copy Code

   Download and Install Client

   wget https://printerlogic.printercloud.com/client/setup/printerinstallerclient_amd64.deb
   sudo dpkg -i printerinstallerclient_amd64.deb
   sudo apt-get -f install

2. Stop the Client.

   Copy Code

   Stop Client

   sudo systemctl stop printer-installer-client
   sudo killall -s SIGKILL PrinterInstallerClientService
   sudo killall -s SIGKILL PrinterInstallerClientInterface
   sudo killall -s SIGKILL PrinterLogicIdpAuthentication
   sudo killall -s SIGKILL system_tray_icon
   #If the device is configured as the Service Client, the commands below stop the additional services running.
   sudo killall -s SIGKILL PrinterLogicServiceManager
   sudo killall -s SIGKILL PrinterLogicServicePrinterApp
   sudo killall -s SIGKILL PrinterLogicServiceIdentitySync
   sudo killall -s SIGKILL PrinterLogicServiceSNMP
   sudo killall -s SIGKILL PrinterLogicServiceOffNetworkClient
   sudo killall -s SIGKILL PrinterLogicServiceOffNetworkServer

3. Add LD_Library_Path for dependencies.

   Copy Code

   Add Dependencies Path

   sudo sed -i 's/^\$EXE \&/LD_LIBRARY_PATH="$INSTALL_DIRECTORY\/service_interface\/lib${LD_LIBRARY_PATH:+:$LD_LIBRARY_PATH}" $EXE \&/' /opt/PrinterInstallerClient/service_interface/run_service.sh

4. Start the Client.

   Copy Code

   Start Client

   sudo systemctl start printer-installer-client

5. Set Home URL.

   Copy Code

   Set HomeURL

   sudo /opt/PrinterInstallerClient/bin/set_home_url.sh <HomeURL_Scheme> <HomeURL>

6. Set Authorization Code.

   Copy Code

   Set Authorization Code

   sudo /opt/PrinterInstallerClient/bin/use_authorization_code.sh <AuthCode>

Replace <HOME_URL_HERE> with URL of your instance. Replace <AUTH_CODE_HERE> with your authorization code.

General Commands

Starting the Client

sudo systemctl start printer-installer-client

Stopping the Client

sudo systemctl stop printer-installer-client
sudo killall -s SIGKILL PrinterInstallerClientService
sudo killall -s SIGKILL PrinterInstallerClientInterface
sudo killall -s SIGKILL PrinterLogicIdpAuthentication
sudo killall -s SIGKILL system_tray_icon
#If the device is configured as the Service Client, the commands below stop the additional services running.
sudo killall -s SIGKILL PrinterLogicServiceManager
sudo killall -s SIGKILL PrinterLogicServicePrinterApp
sudo killall -s SIGKILL PrinterLogicServiceIdentitySync
sudo killall -s SIGKILL PrinterLogicServiceSNMP
sudo killall -s SIGKILL PrinterLogicServiceOffNetworkClient
sudo killall -s SIGKILL PrinterLogicServiceOffNetworkServer

Refreshing the Client

sudo /opt/PrinterInstallerClient/bin/refresh.sh

List all PrinterLogic Binaries currently running

sudo ps aux | grep "$(cat /etc/pl_dir)"

Setting Proxy Server on Mac/Ubuntu/RedHat

If using a proxy server, you may need to additionally set these environment variables (normally set in /etc/environment).

http_proxy=<proxy_server_fqdn_or_ip>:<port>
https_proxy=<proxy_server_fqdn_or_ip>:<port>

Example:

• http_proxy=proxy.mycompany.com:8080
• https_proxy=proxy.mycompany.com:8080

To disable the Proxy completely, see the PL_PROXY overrides below.

General Overrides

General Mac/Linux (Ubuntu/RedHat) Client Overrides

The supported method for adding overrides for Mac/Ubuntu/Redhat is to place the variable in /etc/environment.

For example: echo "PL_DISABLE_AD_LOOKUPS=1" | sudo tee -a /etc/environment

After an override is implemented, the client must be restarted for the override to take effect.

PL_DISABLE_AD_LOOKUPS

By default, the PrinterLogic Client will try to look up current user information from discoverable Active Directory domain controllers that exist in DNS. If the Mac/Linux workstation is not integrated with Active Directory, an environment variable can be added to prevent this from occurring. Only applicable for Mac/Ubuntu/RedHat client version 25.1.0.610 and later.

PL_DISABLE_AD_LOOKUPS=1

PL_TRUST_STORE

Setting this variable causes the client to ignore certificate verification failures. Though not commonly used, some environments may have restrictions that conflict with certificate verification, and this override can be applied. Values can be "1" or "true" to enforce validation, or "0" or "false" to ignore failures.

PL_TRUST_STORE=0

PL_PROXY

PL_PROXY_TYPE

Overrides detection of the proxy. Valid values are none, MANUAL, PAC, or NONE.

To disable using a Proxy server completely, use PL_PROXY_TYPE=NONE.

PL_HTTP_PROXY

If PL_PROXY_TYPE is set to MANUAL, overrides the HTTP proxy.

PL_HTTPS_PROXY

If PL_PROXY_TYPE is set to MANUAL, overrides the HTTPS proxy.

General Windows/Mac/Linux (Ubuntu/RedHat) Overrides

PL_CONFIG_DIRECTORY

Defines the directory where the PrinterLogic client configuration is stored. This is helpful if running Service Client services.

Example: PL_CONFIG_DIRECTORY=/opt/pl-config

Items stored here:

• pl_device_id (Mac/Ubuntu/RedHat)
  • Normally stored at /etc/pl_device_id
• stateid.dat (Windows)
  • Normally stored at C:\Program Files (x86)\Printer Properties Pro\Printer Installer Client\stateid.dat
• pl_configuration.json (Mac/Ubuntu/RedHat)
  • Normally stored at /opt/PrinterInstallerClient/configuration.json
• config.ini (Windows)
  • Normally stored at C:\Program Files (x86)\Printer Properties Pro\Printer Installer Client\config.ini
• PrinterLogicServiceManager/token.json
  • (Mac/Ubuntu/RedHat) Normally stored at /opt/PrinterInstallerClient/service_client/service-manager/config/token.json
  • (Windows) Normally stored at C:\Program Files (x86)\Printer Properties Pro\Printer Installer Client\ServiceHost\config\token.json

PL_STORAGE_DIRECTORY

Defines the directory for the PrinterLogic Service Client services storage.

Example: PL_STORAGE_DIRECTORY=/opt/pl-storage

Items stored in here:

• Each used Service Client service is written to this directory in a sub directory of the service's name. (PrinterLogicServicePrinterApp, PrinterLogicServiceOutputManagement, etc.)

PL_RUN_AS

Sets the user account used to run the PrinterLogic Client. Handy for Service Client installations where you don't want the services running as root.

Example: PL_RUN_AS=nobody

XEROX_IGNORE_CHANGE_PERMISSIONS

When set on the Service Client, pushing the CPA to Xerox devices in SSO Provider mode does not change any application permissions or set the Home screen to PrinterLogic. Value "1" for "enable".

XEROX_IGNORE_CHANGE_PERMISSIONS=1