YSoft Mac OS Client 4.x - troubleshooting

Unable to update password in keychain

It may happen that for some reason it is not possible to update password in keychain.

Problem:

the old password still persists in each print.

Solution:

Open Keychain Access application. Find "SafeQClient" entry. CTRL+Click and click Delete "SafeQClient"

images/download/attachments/21955674/Screen_Shot_2013-08-23_at_12.48.12.png

How to read client global preferences

Command

defaults read /Library/Preferences/com.ysoft.SafeQBackend

Example output

{
global = {
authMethod = password;
authText = "";
isEncryptionEnabled = 1;
isWebAppEnabled = 1;
};
}

Note: User password and user information is stored in local keystore - use Keychain Access application.

How to update client settings from command line

E.g. goal is to disable web application. It is possible to use PlistBuddy command line tool.

To disable web application from command line:

sudo /usr/libexec/PlistBuddy -c "Set :global:isWebAppEnabled 0" /Library/Preferences/com.ysoft.SafeQBackend.plist

When you reopen System Preferences panel with Y Soft configuration you'll see new values. (Sometimes it gets cached and it is necessary to close and open panel again).

sudo /usr/libexec/PlistBuddy -c "Set :global:authMethod owner" /Library/Preferences/com.ysoft.SafeQBackend.plist

 

You can verify your configuration by following command:

/usr/libexec/PlistBuddy -c "print :global:isWebAppEnabled:" /Library/Preferences/com.ysoft.SafeQBackend.plist

PlistBuddy documentation: https://developer.apple.com/library/mac/documentation/Darwin/Reference/Manpages/man8/PlistBuddy.8.html

How to change authentication method to owner

Command: 

sudo /usr/libexec/PlistBuddy -c "Set :global:authMethod owner" /Library/Preferences/com.ysoft.SafeQBackend.plist

How to enable Print Roaming from command line

It is necessary to set option and reboot machine

Command:

sudo /usr/libexec/PlistBuddy -c "Set :global:isDHCPPrintRoamingEnabled 1" /Library/Preferences/com.ysoft.SafeQBackend.plist
sudo /usr/libexec/cups/backend/sqport --dhcp-sync

 

How to set multiple options in one command

Use multiple -c command

sudo /usr/libexec/PlistBuddy -c "Set :global:authMethod owner" -c "Set :global:isWebAppEnabled 0" /Library/Preferences/com.ysoft.SafeQBackend.plist

Application always display UI in one language

MacOS is able to store language preferences directly for one application.

Check configuration:

defaults read $(mdls -name kMDItemCFBundleIdentifier -raw /Applications/YSoft\ SafeQ\ Client.app) AppleLanguages

You can clear configuration:

defaults delete $(mdls -name kMDItemCFBundleIdentifier -raw /Applications/YSoft\ SafeQ\ Client.app) AppleLanguages

 

Log files

Logs are located in the following four locations:

  • /var/log/cups/access_log

  • /var/log/cups/error_log

  • /var/log/cups/page_log

  • var/log/system.log

NOTE: System logs can be also already archived in /var/log. For example /var/log/system.log.0.gz, /var/log/system.log.1.gz.
Logs contain also information about other applications and not just logs from YSoft Mac OS Client.

Use following command for zipping all logs into one archive:

zip ysoft_mac_logs /var/log/cups/* /var/log/system.log