Installing YSoft SafeQ Client 2.x and adding a printer on a Mac workstation

YSOFT SafeQ Client for MAC OS 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 Mac OS X 10.6.3 or up to 10.9.

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.

Requirements

  • Mac OS X 10.6.3 or newer

  • Apple-provided Java 6 for Mac OS X (version 1.6.0_22 or newer)

  • Uninstall older version of YSoft SafeQ Client prior installation of new version (see Uninstall chapter)

images/s/-3eliqb/8502/404359a7d2ab19c9c7c58d12013124a386b28257/_/images/icons/emoticons/lightbulb_on.svg NOTE: In case of older Java user will be forced to quit application manually on logout or reboot

Installing YSoft SafeQ Client

1

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

2

In the YSoft SafeQ installation package, locate the file SafeQ Client.dmg.

3

Run the installation utility Client.pkg to install SafeQ Client.

4

Log out and Log in back or reboot machine after installation.

 

Adding a printer to YSoft SafeQ Client

To set SQPort support into your MacOS system please follow these steps:

images/s/-3eliqb/8502/404359a7d2ab19c9c7c58d12013124a386b28257/_/images/icons/emoticons/lightbulb_on.svg NOTE: sqport:// option is available only in Advanced printing menu. This menu is hidden by default.

1

Go to System preferences > Print & Faxes and add new printer by clicking + button.

images/download/attachments/21955669/macos-system-preferences.png

2

Now you have to add Advanced button to the bar. Press Control + Click on empty space in toolbar of Add Printer window.

Select Customize Toolbar.

images/download/attachments/21955669/macos-toolbar.png

3

Drag Advanced icon (gear wheel) to tool bar and drop it there.

images/download/attachments/21955669/macos-system-drag-wheel.png

4

Go to added Advanced selection and set all necessary options, then click Add.

    • Type - select SafeQ connected network printer

    • URL - enter path like: sqport://<safeq_server_ip>/<queue>
      Example: sqport://10.0.5.194/secure

    • Name: enter device name

    • Print Using - choose drivers for printer

images/download/attachments/21955669/addprinter.JPG

Configuration of the client

  • Client 2.x - Configuration is stored in /etc/safeq/safeq.ini. You do not need to edit it after installation. IP address of SafeQ server is determined from CUPS configuration, no need to enter IP here.

Configuration will take effect immediately after saving files, then user don't need to reboot workstation.

After you did all necessary configurations in the Safeq.ini file, you do not need to set anything in the Client configuration panel. 
When print job is send form the workstation, the popup window will appear with question about credentials of user. User has to fill in login and password, and then print job will be send to SafeQ.

Client configuration options - v2.x

Option name

Description

Default value

authMethod

Client authentication method:

    • login – authenticate by login

    • password – authenticate by login and password

    • text – set authText

    • owner – use Job owner for login - no pop-up promtipng for user info

 

protocol

Define protocol level.

  • 4 - Protocol Level 4 for communication with SafeQ Server 4

  • 3 - Protocol Level 3 for communication with SafeQ Server 3

 

 

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.

images/download/attachments/21955669/mac-cli-01b.png

 

Troubleshooting

For troubleshooting see YSoft Mac OS Client 2.x - troubleshooting

Uninstalling Client

To uninstall YSoft SafeQ Client from a Mac workstation, run the script uninstall.sh, which is included in the installation package. Open Terminal enter directory with uninstall script and type following commands:

sudo ./uninstall.sh