Linux support is limited. The problem with Linux is that there are many different flavors and versions. Consult your solution with Solution Architect.

Configuration of the client
- Configuration options
Entering the user name and password in Client
Uninstalling Client
Troubleshooting:

YSoft SafeQ Client for Linux is dedicated application to take advantage of advanced SafeQ print features and provide further benefits of using SafeQ Server print and accounting system. Its purpose is to submit your print jobs to the SafeQ Server, while collecting further information provided by the operating system or user input upon print. SafeQ Client supports Linux with Gnome, KDE 5 or newer.

Supported operating systems

Required packages:

QT5 and QT5 webkit

If those two packages are not available on the system, then the system is not supported.

Not supported OS:

Ubuntu 12 LTS - reason: it does not have QT5 webkit
Fedora 24 - reason: rpm package magic number not compatible
Oracle Solaris 11 - reason: QT5 is not available

Supported OS:

Ubuntu 14, Ubuntu 16 LTS
Mint 18
Centos 7
Fedora 25
openSUSE 42.2 LEAP

Supported architecture: Intel based 64bit (x86_64/amd64)

List of supported operating systems is limited, please consult solution architect before moving into production. There are several other options how the Linux client could send authenticated jobs to SQ. E.g. with Python client 1.x (but it has limitations).

Supported Window managers:

KDE5
Gnome

Any other window manager might not display completely configuration options for the client. It is possible to configure the client by CUPS web interface available at http://localhost:631.

Benefits of using SafeQ client

The main benefits of using the client are:

Additional user authentication directly in the client - client can ask the user for his credentials.
Billing codes selection possibilities - it is possible to specify the number of the project the print job should be accounted to.
Price estimation and VIP shared queues.
TLS1.2 encryption of data-in-transit.

Requirements

Linux with Gnome or KDE 5 (does not work on older KDE distributions).
Gnome Keyring or KDE Wallet for storing passwords
#KDE Wallet with apt-get (Debian based distributions)
sudo apt-get install libkf5wallet-dev

#KDE Wallet with yum (RPM based distributions)
sudo yum install kf5-kwallet

#Gnome keyring with apt-get (Debian based distributions)
sudo apt-get install libgnome-keyring0

#gnome keyring with yum (RPM based distributions)
sudo yum install gnome-keyring

Installing YSoft SafeQ Client

1	Log in to the Linux workstation.
2	In the YSoft SafeQ installation package, locate files libcrafter_0.0.2_amd64.deb(.rpm) and ysoft-client_4.x-x_amd64.deb(.rpm).
3	Double click the libcrafter_0.0.2_amd64.deb(.rpm) and follow instructions and then do the same with the ysoft-client_4.x-x_amd64.deb(.rpm). NOTE: you will be prompt to login as administrator
	OR On Debian run (NOTE: Commands have to be run if this particular order. If it says you do not have required libraries after running "sudo dpkg -i .deb", ignore it and run "sudo apt-get -f install", it will install all required libraries.): `sudo` `dpkg -i libcrafter_0.0.2_amd64.deb` `sudo` `apt-get -f` `install` `sudo` `dpkg -i ysoft-client_4.x-x_amd64.deb` `sudo` `apt-get -f` `install`
4	Logout at the end of the installation.

Adding a printer to YSoft SafeQ Client

To set SQPort support into your Linux distribution please follow these steps:

Without GUI:

1	Run in terminal: `lpadmin -p [printer_name] -v` `[sqport://<ip_address>/<queue>] -L [printer_location] -P [printers_ppd_file]`

Using CUPS web interface

1	Open CUPS web interface (if enabled): http://localhost:631 Choose Add Printer. Select: YSoft SafeQ Connected printer Set device URI to: sqport://<safeq_server_ip>/<queue_type>. E.g.: sqport://safeq.mynetwork/ Finish installation

With GUI:

1	Go to System settings > Printers and add new printer by clicking Add button. NOTE: It is possible that your distribution does not have this type of system settings application for the printers. You could either install the "system-config-printer" or add the printer with the lpadmin command.
2	Now select YSoft SafeQ connected network printer. Set device URI to: sqport://<safeq_server_ip>/<queue_type>. Click Forward.
3	Select driver corresponding to your printer.
4	Select PostScript and GenericPostScript Printer Foomatic on the right side. Click Forward.
5	Name your printer and click Apply.

Configuration of the client

1

Go to System settings > YSoft SafeQ

images/download/attachments/46924237/Screen_Shot_2014-12-04_at_10.11.50.png

OR [if the application in System settings is not supported on your distribution]

Run

ysoft-client-settings

in terminal.

NOTE: For regular users the application will be only read-only. Administrator can change the settings in the application.

2

Changes are stored when the YSoft SafeQ application is closed.

images/download/attachments/46924237/Screen_Shot_2014-12-18_at_08.45.02.png

Configuration options

Option name	Description	Default value
Identification	Client identification method: Username and password – authenticate by login and password Username – authenticate by username Owner – use Job owner for login - no pop-up promtipng for user credentials Text – use specified text for authentication - no pop-up promtipng for user credentials	Username and password
Encryption	When selected: Client will encrypt authentication information and job data by SSL. When not selected: Client will send authentication information and job data without any encryption.	Selected
Web based YSoft SafeQ applications	When selected: Client will display window with YSoft SafeQ web applications after delivering job. YSoft SafeQ provides several applications: Selection of billing code, VIP shared queues or price estimation. When not selected: Client just delivers job to SafeQ. User won't be prompted to select billing code, VIP shared queues or price estimation.	Selected
Print Roaming	When selected: Backend will get the IP from DHCP server.	Not selected

Entering the user name and password in Client

The first time Client is used (or any time the stored password doesn't match a YSoft SafeQ user's password), the user must enter his/her user name and password.

User specify username and password. Click Submit to send job to YSoft SafeQ server. Click Cancel to cancel job delivery.

images/download/attachments/46924237/Screen_Shot_2014-12-04_at_10.47.59.png

Uninstalling Client

Open Terminal and run the following command:

sudo dpkg -r ysoft-client
sudo dpkg -r libcrafter

You'll prompted for your root password.

NOTE: Your printer will NOT be deleted. You have to delete your printer from Printers.

Troubleshooting:

Problem:

User could not see "SafeQ connected network printer" when adding new printer in cups interface or the printer was not found when adding printer through terminal.

Diagnostic:

Open Terminal window and type following command:

/usr/lib/cups/backend/sqport

Expected output:

network sqport "Unknown" "SafeQ connected network printer"

Possible errors:

No such file or directory

Reason: Client is not installed.
Solution: Install client again.

Cannot execute binary file : Exec format error

Reason: You are using different OS architecture, most likely 32bit to install 64bit package
Solution: Install 64bit os version

Permission denied

Reason: Incorrect permission. User is not able to execute printing backend.
Further diagnostic - type following command:
ls -l /usr/libexec/cups/backend/sqport
Possible solution: Reinstall client.