5.3.4. Installing SAFEQ Cloud PC Client on macOS

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:

*You can also use this guide to push pc client to mac devices using tools like jamf or Workspace ONE
For further information, you can refer to these Jamf guides -
Jamf – deploying custom configuration profiles
Jamf – installing packages

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 com.everyoneprint.hcpclient.plist
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/Preferences and /Library/Managed Preferences. The latter can be used by Jamf deployment tool to deploy the preferences automatically without the custom script.

Script example:

#!/bin/bash
PLIST=/Library/Preferences/com.everyoneprint.hcpclient.plist
cat << EOF >$PLIST
[xml plist content]
EOF
defaults read $PLIST

Replace [xml plist context] with the actual plist.

Steps for silent installation -

*You can also copy com.everyoneprint.hcpclient.plist file to /Library/Preferences if configuration is to be shared by all users. This requires restart of mac devices or running defaults read /Library/Preferences/com.everyoneprint.hcpclient.plist command.

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