making the MFDs think™

YSoft SafeQ® Client for Windows

Installation and Usage guide

Version 1.4
 6.12.2010

© 2010 by Y Soft Corporation a.s.

All rights to this document, domestic and international, are reserved by Y Soft Corporation a.s.. No part of this
publication may be reproduced, stored in a retrieval system, or transmitted in any form or by any means (elec-
tronic, mechanical, photocopying, recording, or otherwise) without prior written permission of Y Soft.

Y Soft®, Y Soft SafeQ® and its logo are registered trademarks of Y Soft Corporation a.s.

All other brands and their products are trademarks or registered trademarks of their respective holders, and
should be noted as such.

YSOFT SAFEQ® CLIENT FOR WINDOWS V1.4 [EN] PAGE 2

 6.12.2010

TABLE OF CONTENTS

TABLE OF CONTENTS ............................................................................................................................................... 3

1.1 PURPOSE OF DOCUMENT ...................................................................................................................... 4
1.2 VALIDITY OF DOCUMENT ....................................................................................................................... 4
1.3 GOALS AND OBJECTIVES ........................................................................................................................ 4
1.4 TERMS AND ABBREVIATIONS ................................................................................................................ 4
2 OVERVIEW ...................................................................................................................................................... 5
2.1 COMPATIBILITY AND SYSTEM OVERVIEW ............................................................................................. 5
2.2 BENEFITS OF USING YSOFT SAFEQ CLIENT............................................................................................. 5
3 INSTALLATION AND CONFIGURATION ........................................................................................................... 6
3.1 INSTALLATION PROCEDURE ................................................................................................................... 6
3.2 PRE-CONFIGURATION OF THE CLIENT ................................................................................................... 7
3.3 CONFIGURATION OF THE YSQ CLIENT ................................................................................................... 9
4 YSQ CLIENT USAGE ....................................................................................................................................... 12
4.1 PRINT QUEUES LOOKUP ...................................................................................................................... 12
4.2 JOB IDENTIFICATION ............................................................................................................................ 12
4.2.1 JOB OWNER IDENTIFICATION ..................................................................................................... 13
4.2.2 LOGIN DIALOG IDENTIFICATION ................................................................................................. 13
4.2.3 LOGIN NAME IDENTIFICATION .................................................................................................... 13
4.2.4 TEXT IDENTIFICATION ................................................................................................................. 14
4.2.5 CARD – INPUT FROM KEYBOARD IDENTIFICATION ..................................................................... 14
4.3 PROJECT ACCOUNTING ........................................................................................................................ 14
5 YSQ CLIENT UNINSTALL ................................................................................................................................ 16
6 LANGUAGE SUPPORT ................................................................................................................................... 17
7 CONCLUSION ................................................................................................................................................ 18
8 RELATIONSHIP WITH OTHER DOCUMENTS .................................................................................................. 19
9 VERSION HISTORY ........................................................................................................................................ 20

YSOFT SAFEQ® CLIENT FOR WINDOWS V1.4 [EN] PAGE 3

 6.12.2010

1 IN TR OD U CT IO N

1.1 PURPOSE OF DOCUMENT

This documentation provides essential information on installation, configuration and usage of YSoft SafeQ®
Client on Windows platform.

1.2 VALIDITY OF DOCUMENT

This document is valid only for YSoft SafeQ® Client for Windows and does not cover YSoft SafeQ® Client on
Linux.

Refer to 1 for information about YSoft SafeQ® Client for Linux.

This document is valid for YSoft SafeQ® Client version 1.9 and newer.

1.3 GOALS AND OBJECTIVES

YSoft SafeQ® Client for Windows is dedicated application to take advantage of advanced SafeQ print features
and provide further benefits of using YSoft SafeQ® Server print and accounting system.

1.4 TERMS AND ABBREVIATIONS

YSQ Client
YSoft SafeQ® Client

MFD
Multi-Functional Device

YSOFT SAFEQ® CLIENT FOR WINDOWS V1.4 [EN] PAGE 4

 6.12.2010

2 OVERVIEW

2.1 COMPATIBILITY AND SYSTEM OVERVIEW

Purpose of YSQ Client is to submit print jobs to the SafeQ Server, while collecting further information provided
by the operating system or user input upon print.

Currently YSQ Client supports Windows XP, Windows Vista, Windows 7 and Windows Server 2003.

Compatibility with following YSoft SafeQ editions is guaranteed:

 YSoft SafeQ PCAS 3.1.5.15 and newer
 YSoft SafeQ PCAS 3.5 Instant Edition
 YSoft SafeQ PCAS 3.6.x Professional and Enterprise Edition

2.2 BENEFITS OF USING YSOFT SAFEQ CLIENT

The main benefits of using the YSQ Client are:

 Print job compression – the print jobs are compressed by SafeQ client and sent to SafeQ server which
decompresses them. Network usage is lower and the print job transfer is quicker.

 Print job encryption – disallows an attacker to see the clear print job data on the communication
channel between the user’s workstation and SafeQ server.

 Load balancing – in case of SafeQ Enterprise edition sends the print job to the least loaded SafeQ
server in order to achieve the faster processing of the print job.

 Additional user authentication directly in the client – client can ask the user for his credentials.

 Project selection possibilities – it is possible to specify the number of the project the print job should
be accounted to.

 Language support.

YSOFT SAFEQ® CLIENT FOR WINDOWS V1.4 [EN] PAGE 5

 6.12.2010

3 INSTALLATION AND CONFIGURATION

YSoft SafeQ Client for Windows comes as a part of the full SafeQ installation pack. It will stay as a standalone
software on the Client PC, you can find it among the Printer Ports in the Printers folder.

Location of the installation files:

 <SafeQ install CD>\!SUPPORT\SafeQ Client or

 <SafeQ install CD>\support\YSoft SafeQ Client or

 partners’ portal (if you have access there)

3.1 INSTALLATION PROCEDURE

1. log in to Windows as administrator (or a user with admin rights)

2. go to the directory with YSQ Client installation files
3. for pre-configuration of the YSQ Client edit the SafeQ.ini file & save changes (for deeper informa-
tion about the pre-configuration please see chapter 3.2)
4. start Install.exe
Note: For installation of YSQ Client to SafeQ Server 2003, use Install.exe –f. This option affects
installation in a way that YSQ Port (part of the YSQ Client) is installed together with YSQ Client.

The procedure by the Install pack:

 Installing SafeQ Port Monitor

 Detecting Windows Version
(Windows 2003 Detected)

(Using NT Spooler)

 Checking Files
 Removing Old SafeQ Print Monitor
(Print Monitor Not Found)

 Deleting SafeQ Print Monitor Files from System Directory

 Copying Files to Windows System Directory
 Registering SafeQ Print Monitor
 Adding port configuration
New – IP: 192.168.0.1:9100, Desc: SafeQ Secure Port, Queue: se-
cure, Type:1

 Event Log Resources WERE installed

 SafeQ Port Monitor Installed Successfully.

For deeper information of the YSQ Client settings please see the chapter 3.2.

NOTE: If you are installing YSQ Client to Windows Vista or SafeQ Server 2003, installation files will be copied
in to Program Files directory. The success of the installation signs ysoft icon in system tray. Sometimes it is
necessary to restart computer after installation, because the application doesn’t start to currently logged
user.

YSOFT SAFEQ® CLIENT FOR WINDOWS V1.4 [EN] PAGE 6

 6.12.2010

3.2 PRE-CONFIGURATION OF THE CLIENT

Following chapter describes how to configure SafeQ.ini file. This ini file is used during installation proce-
dure.

The IP Address of the SafeQ Server. When used in a SafeQ Cluster, input the address of the first SafeQ
NOD. Use of DNS names is allowed.
You have to list all the other IP Addresses for other NODs of the SafeQ cluster. Use only in a SafeQ Clus-
ter.

ServerIP = 127.0.0.1
ServerIP2 =
ServerIP3 =

The TCP port of the SafeQ Server, which is used by the Client for job delivery.

ServerPort = 9100

The queue name has to match exactly the queue name created on the SafeQ Server.
For general secure queue as default use the name: secure.

Queue = secure

Job owner identify to the SafeQ Server.

Following options are supported:
1 - #user login
(The user who is logged on the computer)
3 - user defined text
(It will report the written text as a user name)
4 - dialog with password
(When a user prints, the SafeQ Client displays a dialog to authenticate the user by their login
name and password)
NOT AVAILABLE IN SAFEQ PORT FOR MS WINDOWS CLUSTER (formally SafeQ Port Enterprise)
5 - *(novell user login)
6 - *(novell user with context)
8 – dialog without password
(Similar to a dialog with password, but without password verification)
NOT AVAILABLE IN SAFEQ PORT FOR MS WINDOWS CLUSTER (formerly SafeQ Port Enterprise)
9 – keyboard reader
(The card number input is expected from a keyboard for ex.: via Card Reader)
NOT AVAILABLE IN SAFEQ PORT FOR MS WINDOWS CLUSTER (formally SafeQ Port Enterprise)
AuthType = 1
NOTE: Some options marked by # require enabling of the port 4097 in the SafeQ Configuration.
You can enable this port on the SafeQ web interface.

System Settings » System Setting » Print system Setting » SafeQ Secure Port = Yes

YSOFT SAFEQ® CLIENT FOR WINDOWS V1.4 [EN] PAGE 7

 6.12.2010

This text will be reported as a user name in case of AuthType=3, otherwise leave it empty

AuthText = johny.printer

The Client displays a dialog box with all projects available for the logged user. Each print can be thus
reported for another project.
Projects = 0

NOTE: NOT AVAILABLE IN SAFEQ PORT FOR MS WINDOWS CLUSTER (formally SafeQ Port Enterprise)
Allows load balancing among NODs in the SafeQ Cluster.

LoadBalancing = 1 (1= enable, 0= disable)

Periodically update the list of IP addresses of NODs in the SafeQ Cluster.

RefreshIPList = 0 (1= enable, 0= disable)

Compress job data on port (SafeQ Server will automatically decompress them)

Compression = 0 (1= enable, 0= disable)

Use SafeQ Fax server integration

FaxServer = 0 (1= enable, 0= disable)

Records a log file about the SafeQ Client operations.

LogToFile = 0 (1= enable, 0= disable)

Path to the log file. If empty <windir>\Temp\SQClient.log will be used:

LogFilePath = “c:\temp\client.log”

Search for the given name among the installed printers, and connect the one that matches to the
created port.
Leave empty to be ignored.

AssignPrinter = Name of the printer in MS Windows

NOTE: You can add more fields using options AssignPrinter2, AssignPrinter3, …
Encrypts data between the SafeQ port and the SafeQ Server –the transmitted job is also encrypted. This
setting requires setup of SSL certificates on the SafeQ Server and has an important influence on the
system efficiency.

Encryption = 0 (1= enable, 0= disable)

Identifies the project ID reported by this port, all prints made by this port will be reported to the speci-
fied project. 0 means no project will be reported.

DefaultProjectID = 0 (1= enable, 0= disable)

YSOFT SAFEQ® CLIENT FOR WINDOWS V1.4 [EN] PAGE 8

 6.12.2010

Indicates how the port should report the user name. If no input is given, than just standalone user name
is reported (default).

DS_FQDN_1779_NAME CN=someone, OU=Users, DC=Engineering, DC=Fabrikam,DC=Com

DS_NT4_ACCOUNT_NAME Engineering\someone
DS_DISPLAY_NAME Jeff Smith
DS_UNIQUE_ID_NAME {4fa050f0-f561-11cf-bdd9-00aa003a77b6}
DS_CANONICAL_NAME engineering.fabrikam.com/software/someone
DS_USER_PRINCIPAL_NAME SOMEONE@ENGINEERING.FABRIKAM.COM
DS_CANONICAL_NAME_EX engineering.fabrikam.com/software\someone
DS_SERVICE_PRINCIPAL_NAME WWW/WWW.FABRIKAM.COM@FABRIKAM.COM
DS_SID_OR_SID_HISTORY_NAME S-1-5-21-397955417-626881126-188441444-501
SAFEQ_SID_FORMAT 01:05:00:00:00:00:00:05:15:00:00:00:23:2e:93:00:5e:fc:94:30:e5:fd
CurrentUserNameFormat = DS_NT4_ACCOUNT_NAME

ProtocolLevel = 1 (1 = default behavior, 2 = not supported in SafeQ 3.1)

Identification of job owner

JobOwnerMethod = 0 (0 = default behavior, 1 = identification is based on the owner of the printing

thread)

Timeout in seconds when communicating with SafeQ server over TCP/IP

NetworkTimeout = 60

NOTE: You can find this information as part of the SafeQ.ini file.

After you did all necessary configurations in the Safeq.ini file, you do not need to set anything in the YSQ
Client configuration panel.

3.3 CONFIGURATION OF THE YSQ CLIENT

In any case you still need to change the settings, you can do following:

YSOFT SAFEQ® CLIENT FOR WINDOWS V1.4 [EN] PAGE 9

 6.12.2010

1) Modify the Port settings in the Printer list.

 Start menu -> Settings -> Printers (or Printers and Faxes – depends on the op-
erating system)
 File menu -> Server properties
 Ports tab
 In the list select the port whose settings you want to modify, then press the Configure Port but-
ton

Picture 1 - SafeQ Client Options

 In this window (SAFEQ Client – Options) you can see all the settings of the YSQ Client. If you
have administrator rights you can modify them, and then use the new settings.
 After you made all the settings you wanted to, use your printer as a normal Printer. Just print
with it.

Reinstall YSQ Client (using SafeQ.ini file)

2) 1. Uninstall YSQ Client (chapter 5)
2. Install new YSQ Client (chapter 3.1)

YSOFT SAFEQ® CLIENT FOR WINDOWS V1.4 [EN] PAGE 10

 6.12.2010

3) Change the values in the Windows Registry and restart spooler:

[HKEY_LOCAL_MACHINE\SYSTEM\ControlSet001\Control\Print\Monitors\SafeQ\Ports

Modifying any entries in the Windows Registry can cause the system malfunctioning or dam-
age. Please only modify them if you REALLY aware of what you are doing!!!

NOTE: If you create more than one YSQ Client Port, then in the Ports folder within the registry, sub-
st
folders will be created consequently. E.g.: 001 will be the name of the 1 port, then 002,…

YSOFT SAFEQ® CLIENT FOR WINDOWS V1.4 [EN] PAGE 11

 6.12.2010

4 YSQ CLIENT USAGE

This chapter provides instruction on using YSQ Client. It describes main features like job identification, project
accounting, etc.

4.1 PRINT QUEUES LOOKUP

The YSQ Client provides a mechanism for discovering of all print queues on the specific YSQ server. The YSQ
server is specified by its IP address. Use the Find button to get all print queues existing on the server. Then
choose one of the queues from the combo box.

Picture 2 - Print queues lookup

4.2 JOB IDENTIFICATION

This section describes usage of YSQ Client in coxtext of different Identification settings. The YSQ Client supports
following type of job identification (see Picture 3):

 Job owner
 Login dialog
 Login dialog (login name only)
 Text
 Card – input from keyboard

YSOFT SAFEQ® CLIENT FOR WINDOWS V1.4 [EN] PAGE 12

 6.12.2010

The Indentification method can be change according instruction provided by chapter 3.3.

Picture 3 - Job Identification

4.2.1 JOB OWNER IDENTIFICATION

Job owner type of identification has to chosen. When user performs a print job, the job is delivered to the YSoft
SafeQ server and is automatically assigned to the user logged on the Windows system.

No additional interactivity of the user is required.

4.2.2 LOGIN DIALOG IDENTIFICATION

Login dialog type of identification has to chosen. After user performs a print job, the login dialog comes up on
the workstation and user enters login name and password. This job is delivered to the YSoft SafeQ server and
recognition of the job is based on login dialog’s data.

Note: This type of identification requires port 4097 to be opened on Safe server side.

4.2.3 LOGIN NAME IDENTIFICATION

YSOFT SAFEQ® CLIENT FOR WINDOWS V1.4 [EN] PAGE 13

 6.12.2010

Login dialog – login name only type of identification has to chosen. After user performs a print job, the login
dialog comes up on the workstation and user enters login name. This job is delivered to the YSoft SafeQ server
and recognition of the job is based on login dialog’s data.

Note: This type of identification requires port 4097 to be opened on Safe server side.

4.2.4 TEXT IDENTIFICATION

Text type of identification has to chosen and user name specified in the edit box. After user performs a print
job, the job is delivered to the YSoft SafeQ server and the job is automatically assigned to the user entered on
the line.

4.2.5 CARD – INPUT FROM KEYBOARD IDENTIFICATION

Card - input from keyboard type of identification has to chosen. After user performs a print job, user is asked
for entering a card number (text form). This job is delivered to the YSoft SafeQ server and the job is automati-
cally assigned to the user specified by the card number entered on the line.

Note: This type of identification requires port 4097 to be opened on Safe server side.

4.3 PROJECT ACCOUNTING

The option for Project Accounting has to be enabled (see Picture 4). When user perform a print job, he is asked
for a project to which the print job should be accounted. User can select from the list of project existing on the
YSoft SafeQ server. YSQ Client offers just projects that user has rights for.

YSOFT SAFEQ® CLIENT FOR WINDOWS V1.4 [EN] PAGE 14

 6.12.2010

Picture 4 - Project Accounting

YSOFT SAFEQ® CLIENT FOR WINDOWS V1.4 [EN] PAGE 15

 6.12.2010

5 YSQ CLIENT UNINSTALL

The uninstallation of the YSQ Client is performed by the same installer file (install.exe), but executed with a “-u”
parameter.

You need Administrator privileges, then execute the following command:

 Open a command line (Windows button + R or Start -> Run -> CMD)
 Enter the folder where the install files are.
 Enter the command:
Install.exe –u
The uninstall process of the YSQ Client will be done in a few seconds.
 When the task is done you will see the following lines:
Uninstalling SafeQ Port Monitor…
- Detecting Windows Version
(Windows 2003 Detected)
- Port SafeQ001 type SafeQ will be disconnected
- Disconnecting Printer ‘Windows Printer Name’ from SafeQ Port
- Removing Old SafeQ Print Monitor
- Deleting SafeQ Print Monitor Files from System Directory
SafeQ Port Monitor Uninstalled Successfully.
 All the printers that have been configured to use the SafeQ Client Port, will be set to File port.
NOTE: Uninstall the client that is installed using –f parameter is necessary to use this parameter when
you uninstalling.

YSOFT SAFEQ® CLIENT FOR WINDOWS V1.4 [EN] PAGE 16

 6.12.2010

6 LANGUAGE SUPPORT

The YSQ Client support Czech, English, German, Japanese and Chinese languages at the moment. The localiza-
tion of user interface depends on the system where the YSQ Client has been installed on. It means, the inter-
face of YSQ Client will support Japanese only on Japanese Windows platform.

YSOFT SAFEQ® CLIENT FOR WINDOWS V1.4 [EN] PAGE 17

 6.12.2010

7 CONCLUSION

In this document you got acquainted with the basic functions of Ysoft SafeQ Client for Windows. You can find
download other documents as well as the YSQ Client application on the Partner’s Portal.

Partner‘s Portal web page: http://www.ysoft.com/partner-network/log-on-to-partner-portal/

YSOFT SAFEQ® CLIENT FOR WINDOWS V1.4 [EN] PAGE 18

 6.12.2010

8 RELATIONSHIP WITH OTHER DOCUMENTS

This section describes how this guide is related to other documentation:

Nr. Document Version Author

1. YSQ Client for Linux - Installation and Usage Guide [EN] 1.3 JOL
2.
3.
4.
5.
6.
7.

YSOFT SAFEQ® CLIENT FOR WINDOWS V1.4 [EN] PAGE 19

 6.12.2010

9 VERSION HISTORY

Document author/owner: YSoft s.r.o

For document version history see Table No. 1:

Version Date Change Status Author

1.0 8. 11. 2008 Initial version of document Draft JOL
1.1 2. 2. 2009 Document conversion to Windows Draft IPO
1.2 23. 2. 2009 Finalization Final JMU
1.3 14.7.2009 Structure of chapter 1 and 2 changed Final PNE
Chapter 4 (usage) completed
Chapter 6 (language support) 7 (Conclusion) and 8
(related documentation) added
1.4 6.12.2010 Review of compatibility with SafeQ and updated Final PMA
company name

Table No. 1: Document version

YSOFT SAFEQ® CLIENT FOR WINDOWS V1.4 [EN] PAGE 20