Deployment of YSoft SafeQ Client v3

Folder structure

Following is what the folder structure looks like for the deployed YSoft SafeQ Client v3.

[Client Installation Path]
├── JobStore
└── versions
    ├── latest  // Symlink to the latest version, system services use this to always target latest version
    └── 9.9.9
        ├── configuration
        ├── logs
        └── ...

Installation instructions for macOS workstations:

The client application package contains the installation script install.rb. Two components will be installed: YSoft SafeQ Spooler service (com.ysoft.safeq.spooler) and YSoft SafeQ Client (com.ysoft.safeq.client).

Installation deploys three print queues. You can change their drivers and use any of them. The script has the following arguments:

Installation steps for macOS workstations:

1. Download the "YSoft SafeQ Client v3 macOS.dmg" disk image (you can find it in the product installation packages).
2. Open the disk image – it will mount a new volume.
3. Open terminal in the directory of the mounted volume - there are several ways to achieve it.
   1. Way 1
      1. Open disc image
         

         

      2. Right-click on any file in the disk image.
      3. Expand the "Services" submenu.
      4. Choose "Open new terminal tab here" in any terminal.
   2. Way 2 - open Terminal and change the directory to the mounted volume – depending on the version of the client.
   1. 1. BASH

         cd "/Volumes/YSoft SafeQ Client v3.0"

      2. BASH

         cd "/Volumes/untitled"

4. Run the installation script in the current folder (for more installation options check the documentation)
   1. BASH

      sudo ./install.rb --siteserver-hosts=[JOB SERVICE HOST]

5. Verify that the client is running. You can verify it by the icon in the taskbar or in the Activity Monitor application.

Example of script usage

Script has to be run using sudo as YSoft SafeQ Spooler does not run under user account but it runs under the system account.

BASH

sudo ./install.rb --siteserver-hosts=10.0.10.50,10.0.10.51

By default, the YSoft SafeQ Client v3 is installed with automatic restart. It will restart after 60s after a crash. If you want to change the value you can update the values in /Library/LaunchDaemons/com.ysoft.safeq.spooler.plist for YSoft SafeQ Spooler or in /Library/LaunchAgents/com.ysoft.safeq.client.plist for YSoft SafeQ Client v3 (desktop application). Either set KeepAlive parameter to false in order to disable this feature completely or change the ThrottleInterval which configures intervals between restarts. For additional details run

BASH

man launchd.plist

in Terminal on macOS.

Uninstallation instructions for macOS workstations:

The client application contains the uninstallation script uninstall.rb. The script is located in the installation folder of the client application. 

cd /Library/Application\ Support/YSoft.Spooler
sudo ./uninstall.rb --force

Installation instructions for Windows workstations:

The client application package contains the installation script install.ps1. Two components will be installed: YSoft SafeQ Spooler service and YSoft SafeQ Client. The script has following arguments

Example of script usage

Following is an example that will install the client with 2 Site Servers.

BASH

powershell -executionpolicy unrestricted .\install.ps1 -SiteServerHosts "10.0.10.50,10.0.10.51"

Uninstallation instructions for Windows workstations:

Uninstallation is available via Windows' Apps & features under the name YSoft SafeQ Client.

The application also contains an uninstallation script - uninstall.ps1. The script is located in the installation folder of the client application.

cd C:\SafeQ6\Spooler\
powershell -executionpolicy unrestricted .\uninstall.ps1 -Force