Help Center menu

PRODUCT MANUALS

Print Deploy manual

PRODUCTS FEATURED

List of installation parameters and filename configurations

This topic explains how to use optional parameters and filename configuration combinations to deploy the PaperCutPrint Deploy client to a multiple operating systems.

At a high level, when downloading the Print Deploy client it will have the name of the Print Deploy server added to the filename.

e.g:

  • pc-print-deploy-client[printserver.company.lan].msi

  • pc-print-deploy-client[192.168.1.100].dmg

  • pc-print-deploy-client[printserver].deb

The Print Deploy client also accepts parameters via command line.

  • msiexec /i pc-print-deploy-client.msi STRICT_SSL=true

  • For .rpm based distributions: sudo STRICT_SSL=true yum localinstall pc-print-deploy-client\[<hostname>\].rpm

  • For .deb based distributions: sudo STRICT_SSL=true dpkg -i pc-print-deploy-client\[<hostname>\].deb

  • macOS uses a .plist

This topic explains what parameters and filename configurations are available, and what they do.

Before you start

This is an advanced topic. In most environments the servername in the installer filename is sufficient to install the client.

Priority order

The Print Deploy client installers will preference parameters first, then filename configurations and finally fall back to defaults.

e.g. msiexec /i pc-print-deploy-client[server.company.lan].msi SERVER_HOST=printserver.company.lan will result in the Print Deploy client being configured to work with printserver.company.lan.

Available Parameters and Filename configurations

Filename (common)

Name Type Values Examples
serverhost filename IP Address
FQDN
Hostname
pc-print-deploy-client[printserver.company.lan].msi
pc-print-deploy-client[printserver.company.lan].dmg
pc-print-deploy-client[printserver.company.lan].deb
pc-print-deploy-client[printserver.company.lan].rpm

pc-print-deploy-client[printserver].msi
pc-print-deploy-client[printserver].dmg
pc-print-deploy-client[printserver].deb
pc-print-deploy-client[printserver].rpm

pc-print-deploy-client[192.168.0.10].msi
pc-print-deploy-client[192.168.0.10].dmg
pc-print-deploy-client[192.168.0.10].deb
pc-print-deploy-client[192.168.0.10].rpm
serverhost_port filename TCP Port pc-print-deploy-client[hostname_443].msi
pc-print-deploy-client[hostname_443].dmg
pc-print-deploy-client[hostname_443].deb
pc-print-deploy-client[hostname_443].rpm
schema_serverhost_port filename http or https pc-print-deploy-client[http_hostname_443].msi
pc-print-deploy-client[http_hostname_443].dmg
pc-print-deploy-client[http_hostname_443].deb
pc-print-deploy-client[http_hostname_443].rpm

pc-print-deploy-client[https_hostname_443].msi
pc-print-deploy-client[https_hostname_443].dmg
pc-print-deploy-client[https_hostname_443].deb
pc-print-deploy-client[https_hostname_443].rpm
strict_ssl_serverhost_port
Windows only
filename http-strict pc-print-deploy-client[http-strict_hostname_443].msi

pc-print-deploy-client[http-strict_hostname_port].msi

Windows msiexec parameters

Name Type Values Examples
SERVER_HOST msi param IP Address
FQDN
Hostname
msiexec /i pc-print-deploy-client.msi SERVER_HOST=printserver.company.lan

msiexec /i pc-print-deploy-client.msi SERVER_HOST=printserver

msiexec /i pc-print-deploy-client.msi SERVER_HOST=192.168.0.10
SERVER_PORT msi param TCP Port msiexec /i pc-print-deploy-client.msi SERVER_PORT=443
SERVER_SCHEME msi param http or https msiexec /i pc-print-deploy-client.msi SERVER_SCHEME=http

msiexec /i pc-print-deploy-client.msi SERVER_SCHEME=https
SKIP_DPM msi param true or false msiexec /i pc-print-deploy-client.msi SKIP_DPM=true
STRICT_SSL msi param true or false msiexec /i pc-print-deploy-client.msi STRICT_SSL=true

macOS /Library/Managed Preferences/com.papercut.printdeploy.client.plist entries

Name Type Values Examples
server_host .plist IP Address
FQDN
Hostname
defaults write <filename> server_host printserver.company.lan

defaults write <filename> server_host printserver

defaults write <filename> server_host 192.168.0.10
server_port .plist TCP Port defaults write <filename> server_port 443
server_scheme .plist http or https defaults write <filename> server_scheme http

defaults write <filename> server_scheme https
skip_dpm .plist true or false defaults write <filename> skip_dpm true
strict_ssl .plist true or false defaults write <filename> strict_ssl true

Note: All .plist entries are lowercase.

Linux .deb based distro’s

Name Type Values Examples
server_host environment variable IP Address
FQDN
Hostname
sudo SERVER_HOST=printserver.company.lan dpkg -i pc-print-deploy-client.deb

sudo SERVER_HOST=printserver dpkg -i pc-print-deploy-client.deb

sudo SERVER_HOST=192.168.0.10 dpkg -i pc-print-deploy-client.deb
server_port environment variable TCP Port sudo SERVER_PORT=443 dpkg -i pc-print-deploy-client.deb
server_scheme environment variable http or https sudo SERVER_SCHEME=http dpkg -i pc-print-deploy-client.deb

sudo SERVER_SCHEME=https dpkg -i pc-print-deploy-client.deb
skip_dpm environment variable true or false sudo SKIP_DPM=true dpkg -i pc-print-deploy-client.deb
strict_ssl environment variable true or false sudo STRICT_SSL=true dpkg -i pc-print-deploy-client.deb

Linux .rpm based distro’s

Name Type Values Examples
server_host environment variable IP Address
FQDN
Hostname
sudo STRICT_SSL=true dpkg -i pc-print-deploy-client[].deb
server_port environment variable TCP Port
server_scheme environment variable http or https
skip_dpm environment variable true or false
strict_ssl environment variable true or false

Windows notes

Many organisations use Microsoft’s Intune to push the Print Deploy Client to the user’s machines. We have instructions on how to do that here: Deploy print queues using Microsoft Intune and Print Deploy

Other deployment methods may be able to take advantage of the file name options above, however customers using msiexec parameters have reported success. Adding a /log parameter will allow you to diagnose any installation problems.

macOS notes

The PaperCut Print Deploy Client use the .plist file to bootstrap itself. This must be found at /Library/Managed Preferences/com.papercut.printdeploy.client.plist

To create a reference .plist file, you can use the following example:

  1. Open a terminal and issue the following command:

    defaults write ~/Documents/com.papercut.printdeploy.client server_host hostname

  2. Replace the hostname with the FQDN from the ‘.dmg’, for example, print-server.company.lan

  3. Convert the .plist file with the following command:

    /usr/bin/plutil -convert xml1 ~/Documents/com.papercut.printdeploy.client.plist

    This prevents an error in Jamf ‘Problem uploading file. Plist files must be in XML format’.

  4. Verify the contents of the new .plist with the following command:

    defaults read ~/Documents/com.papercut.printdeploy.client.plist

    The output should be:

    macOS:Documents localadmin$ defaults read ~/Documents/com.papercut.printdeploy.client.plist    
    {
        "server_host" = "print-server.company.lan";
    }
    macOS:Documents localadmin$
    
  5. Copy ~/Documents/com.papercut.printdeploy.client.plist to /Library/Managed Preferences/com.papercut.printdeploy.client.plist on your macOS device, and install the Print Deploy Client.

Comments