Installing YSoft SafeQ Client on a Windows workstation or server or server cluster

Overview

To print from a local workstation (or server) via YSoft SafeQ Client, YSoft SafeQ Client must be installed on the workstation and a printer must be added for use by the workstation. In the YSoft SafeQ Client configuration file, the IP address of the YSoft SafeQ server must match the target IP address in the Client configuration.

To prepare a workstation for printing via the Client, perform these two main steps:

  • Install YSoft SafeQ Client (see "Installing YSoft SafeQ Client").

  • Add a printer to YSoft SafeQ Client (see "Adding a printer for use with YSoft SafeQ Client").

If no graphical user interface is required (that is, if no user interaction is required to send print jobs to the YSoft SafeQ server), deploy the Client as described in "Installing/uninstalling the Enterprise version of YSoft SafeQ Client" or "Installing/uninstalling the Enterprise version of YSoft SafeQ Client in a Windows server  cluster."

Limitations and requirements

  • List of supported operating systems is available in "YSoft SafeQ Client features" article.

  • YSoft SafeQ Client does not support bidirectional communication with a printer. This option must be disabled in a printer properties dialogue.

  • YSoft SafeQ Client does not support Windows 8 and Server 2012 v4 print drivers (built-in). Thus assigning SafeQ port to such a device produces following error: "Printer settings could not be saved. This operation is not supported." To assign SafeQ port to device, v3 print drivers (external third party drivers) must be used.

  • The language of server-provided content displayed by YSoft SafeQ Client (e.g. price estimation, shared queues, notifications) depends on the MS Windows language for date, time, and number formats.

  • .NET 2.0 Framework is required for YSoft SafeQ Client on Workstation (not required for enterprise installation on server).

Installing YSoft SafeQ Client

Follow these steps to install YSoft SafeQ Client on a Windows workstation:

1

Log in to the Windows workstation as administrator (or as a user with administrator rights).
 

2

Go to the folder that contains the YSoft SafeQ installation files.
 

3

Configure the Client by editing the file SafeQ.ini. (Configuration options are described in SafeQ Client configuration options)
 

4

From the command line, run the utility install.exe. The output should be similar to this example:

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.

Adding a printer for use with YSoft SafeQ Client

To install a new printer for use with YSoft SafeQ Client, follow these steps:

1

For adding printer to your workstation with Windows OS go to Control Panel > Devices and Printers > Add printer.

When Add printer wizard will be opened click The printer that I want isn't listed button.

images/download/attachments/21955662/find_printer.png

2

Select Add a local printer or network printer with manual settings and click Next.

images/download/attachments/21955662/add_local_printer.png

3

Select the Use existing port and select SafeQ Client Secure Port as the printing port

OR

click Create a new port and select SafeQ.

images/download/attachments/21955662/choose_port.png

4

Perform few other steps to set all necessary option for new printer to finish the installation wizard.
 

5

If device is installed,and SafeQ Client has not been yet been configured before installation in the SafeQ.ini file, configure it now.

In your OS go to Devices > Printer properties > select SafeQ Secure Port > Configure port.

images/download/attachments/21955662/win_basic.png

5b

If Microsoft Windows 7/8 OS is used, the port configuration is available with "elevated" right only accessible via Print server properties.

Devices and Printers > select the printer which port you want to reconfigure or any other printer > Print server properties > navigate to Ports tab > Change ports settings > select SafeQ Secure Port > Configure port.


images/download/attachments/21955662/Print_server_properties.png















images/download/attachments/21955662/Change_ports_settings.png



















images/download/attachments/21955662/Configure_port.png





















images/download/attachments/21955662/clientsetup.JPG

Uninstalling YSoft SafeQ Client

 

Follow these steps to uninstall YSoft SafeQ Client from a Windows workstation:

1

Log in to the Windows workstation as administrator (or as a user with administrator rights).
 

2

Go to the folder that contains the YSoft SafeQ installation files.
 

3

From the command line, run the file install.exe, using the parameter -u. The output should be similar to the example shown here:

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.

Installing/uninstalling the Enterprise version of YSoft SafeQ Client on a single print server

To install or uninstall the Enterprise version of YSoft SafeQ Client, follow all the steps described for installing or uninstalling the standard version, but when running files from command lines, include the parameter -a (install.exe -a).

The -a parameter disables installation of the Client GUI application and ensures that any errors that occur during delivery of jobs to the YSoft SafeQ server do not hang the Windows spooler by waiting for user interaction.

Installing/uninstalling the Enterprise version of YSoft SafeQ Client on a print server hosted by Windows 2008/R2 server cluster

To deploy the Enterprise version of YSoft SafeQ Client in a Windows server cluster, follow these steps:

  1. Install YSoft SafeQ Client Enterprise on each node of the Windows cluster, using an empty configuration file SafeQ.ini.

  2. Change settings in the YSoft SafeQ Client Enterprise configuration file (SafeQ.ini) as necessary.

  3. Install YSoft SafeQ Client Enterprise to a virtual server by entering the command install \\printservername -a -c on the command line at any cluster node.

To uninstall Client from the Windows server cluster, follow these steps:

  1. On the virtual server, manually disconnect all printers (print queues) from the SafeQE port.

  2. Delete printer port(s) SafeQE from the virtual server by entering the command install \\printservername -a -c -u on the command line.

  3. Uninstall YSoft SafeQ Client Enterprise from all nodes by entering the command install -a -u on the command line.

To update the Enterprise version of YSoft SafeQ Client to a newer version, it is necessary to perform the complete uninstallation procedure described in the previous paragraph.