For macOS the pkg installer is provided. It doesn’t currently accept any configuration options so a manual application configuration is required after installation, as outlined in the following sections.
After installation the application will be started automatically. There is no need to restart the computer. After initial installation PC client must be configured manually using the configuration dialog and the
Service setup button. When pressing this button the user will be asked for the password for privilege elevation.
Unattended installation of pc client on mac devices:
Download this sample “com.everyoneprint.hcpclient.plist” text file to update it with desired pc client configuration parameters. Make sure the file is named as
Below is description of each of the parameters -
accountDomain– account domain name
authType– User authentication type: 0 = session user, 1 = custom login, 2 = Microsoft Azure OAuth2, 5 = OpenID Connect
gatewayAddress– SAFEQ Cloud gateway address
loginPopupType– specify the type of the login popup: 0=no popup, 1=informational bubble, 2=dialog
refreshPeriod– automatic synchronization period in minutes.
allowLocalStorage– true = turn on, false = turn off local storage mode of PC client. In this mode the jobs will be stored on Mac. This mode requires PC client registration and authorization on SAFEQ Cloud server.
storageType– 0 = send jobs to gateway, 1 = store jobs locally. This option is only applicable when local storage mode is activated. It corresponds to the tray menu item which can select the job destination.
allowConfiguration– true = enable configuration menu item, false = disable configuration menu item.
allowRememberLogin– true = show “Remember login” option when showing a prompt to enter custom username and password, false = do not show this option.
directOfflinePrint– true = enable direct offline printing
apiKey– custom API key to use instead of the default one.
offline– if set to true it will install PC client in offline mode, without registration or server connectivity check. See section 7.9 for details.
Shown below is how typical com.everyoneprint.hcpclient.plist file looks like –
<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd"> <plist version="1.0"> <dict> <key>accountDomain</key> <string>test.foo.com</string> <key>authType</key> <integer>1</integer> <key>gatewayAddress</key> <string>test.foo.com</string> <key>loginPopupType</key> <integer>2</integer> <key>refreshPeriod</key> <integer>60</integer> <key>allowLocalStorage</key> <false/> <key>offline</key> <true/> </dict> </plist>
Jamf best practices
For Jamf deployment it is recommended to use a script which runs before the pkg file is installed and which copies the plist file to the proper location.
PC client supports two locations for the plist file:
/Library/Managed Preferences. The latter can be used by Jamf deployment tool to deploy the preferences automatically without the custom script.
#!/bin/bash PLIST=/Library/Preferences/com.everyoneprint.hcpclient.plist cat << EOF >$PLIST [xml plist content] EOF defaults read $PLIST
[xml plist context] with the actual plist.
Steps for silent installation -
1. Copy updated com.everyoneprint.hcpclient.plist file at /Users/[username]/Library/Preferences on Mac device
sudo cp <from path> /Library/Preferences
2. Install SAFEQ Cloud PC client
sudo installer -pkg <SAFEQ Cloudclient-3.15.0-release-setup.pkg> -target /
sudo installer -store -pkg <SAFEQ Cloudclient-3.15.0-release-setup.pkg> -target /
3. Uninstall SAFEQ Cloud PC client
sudo /Applications/SAFEQ Cloudclient.app/Contents/MacOS/uninstall
Post your comment on this topic.