Windows installer is provided as an executable file, SAFEQ Cloudclient-x.x.x-setup.exe. A couple of steps are required to perform the installation:

1. Welcome screen of the installer

2. License text

3. Server connectivity parameters

  • Server address or host name – address or host name of the SAFEQ Cloud server to connect to. For “Local storage mode” the address should be the DNS of the SAFEQ Cloud primary server.
  • Account domain name – domain name of the target account. It can be found from SAFEQ Cloud Web UI
  • API keyAPI key from the account settings. If omitted the default (restricted) API key will be used. Default API key will be removed in the future product versions.
  • User authentication – user authentication type
  • Enable local storage and direct print job delivery – enable local storage operation mode
  • Enable offline installation – install PC client without registering or checking server connectivity. Please see section 7.9 for details.

4. Advanced options

  • Use pre-configured system certificate for secure communication – for TLS connectivity use the default certificate from the PC certificate store. NOTE: This option requires a managed public key infrastructure environment or a manually configured private key chain in the certificate store.
  • Certificate subject or issuer – search pattern to choose for a client certificate from the Windows certificate store.
  • Install AGPL Ghostscript – install AGPL Ghostscript software which is necessary for PCL6 printing
  • Create desktop icons for login and logout – create login and logout icons on the desktop. Clicking on login icon will prompt the user to login to PC client (if custom login type is activated). Clicking on logout button will perform PC client logout and delete the printers.
  • Automatically delete printers on PC session logout – when user logs out from the operating system or shuts down PC the printers will be removed.

5. Target directory selection

Windows installer also accepts several command-line parameters for unattended installation:

  • /S – Run the installer in unattended mode
  • /GATEWAYADDRESS=xxx – chooses SAFEQ Cloud server address
  • /ACCOUNTDOMAIN=yyy – chooses account domain name
  • /SYNCPERIOD=nn – automatic sychronization period, in minutes. The default period is 60 minutes.
  • /AUTHTYPE=0|1|2|3|4|5 – User authentication type: 0=Session user (default), 1=Session user + domain name, 2=Custom login, 3=User principal name, 4=Microsoft Azure OAuth2, 5=OpenID Connect
  • /ALLOWCONFIGURATION=true|false – enable or disable the ability for the end-user to configure the PC client after installation. The default value is true.
  • /ALLOWREMEMBERLOGIN=true|false – enable or disable the ability for the end-user to remember custom login information. The default value is true.
  • /ALLOWLOCALSTORAGE=true|false – enable or disable local storage operation mode. The default value is false.
  • /REMEMBERLOGIN=true|false – turn on or off login remembering option. The default value is false.
  • /LOGINPOPUPTYPE=0|1|2 – specify the type of the login popup: 0=no popup, 1=informational bubble, 2=dialog. The default value is 0.
  • /STORAGETYPE=0|1 – switch between gateway storage (0) and local storage (1) mode (only applies if ALLOWLOCALSTORAGE flag is true). The default value is 1.
  • /CERTSTORE=true|false – enable or disable using TLS certificate from system certificate store. The default value is false.
  • /CERTSUBJECT=xxx – choose a system certificate with X.509 subject or issuer matching xxx (partial string match can be used). Only relevant with /CERTSTORE=true option.
  • /APIKEY=xxx – Specify a custom API key. The default is to use built-in restricted API key.
  • /AGPLGHOSTSCRIPT=true|false – Accept AGPL license and install Ghostscript software which is needed for PCL6 printing. The default value is false.
  • /DUPLEX=true|false – set default value to duplex (true) or simplex (false). The default value is true.
  • /COLOR=true|false – set default value to color (true) or BW (false). The default value is false.
  • /DELETEPRINTERSONLOGOUT=true|false – enable or disable printer deletion on PC session logout (e.g. user logout from Windows). The default is false. Manual logout from PC Client application will still remove the printers
  • /D=fullpath – install application to an alternate path (e.g. /D=d:\SAFEQ Cloud). The default is C:\Program Files (x86)\YSoft\SAFEQ Cloud Client
  • /DESKTOPICONS=true|false – installer will create Windows desktop login and logout buttons for Custom Login (authtype=2). The default is false
  • /PDFA=none/2u – Choose whether to disable PDF/A-2U document conversion in the driver. Default is to enabled it.
  • /PAPER=A3|A4|A5|Letter – Choose default paper format for the driver (if different from Windows system locale)
  • /SERVERCHECK=true|false – installer will skip connection to SAFEQ Cloud during the installation. Please see section 7.9 for details. This option is deprecated in favor of /OFFLINE option.
  • /OFFLINE=true|false – installer will skip connection to SAFEQ Cloud during the installation. Please see section 7.9 for details. This option is an opposite for /SERVERCHECK. The default value is “false”.
  • /DIRECTOFFLINEPRINT=true|false – enable direct offline printing functionality. The default is false.

The parameters /GATEWAYADDRESS and /ACCOUNTDOMAIN are mandatory when installing PC Client in unattended mode.

Examples of SAFEQ Cloud Client usage:

  • Unattended installation of SAFEQ Cloud Client to D:\Programs\SAFEQ CloudClient directory: SAFEQ Cloudclient-3.0.0-xxxx-setup.exe /S /GATEWAYADDRESS=x.x.x.x /ACCOUNTDOMAIN=acc1 /D=D:\Programs\SAFEQ CloudClient
  • Installation of SAFEQ Cloud Client with Trusted certificate: SAFEQ Cloudclient-3.0.0-xxxx-setup.exe /S /GATEWAYADDRESS=x.x.x.x /ACCOUNTDOMAIN=acc1 /SYNCPERIOD=60 /SYNCDRIVER=true /AUTHTYPE=0 /ALLOWCONFIGURATION=true /ALLOWREMEMBERLOGIN=true /ALLOWLOCALSTORAGE=true /REMEMBERLOGIN=false /LOGINPOPUPTYPE=0 /STORAGETYPE=1 /CERTSTORE=true /DUPLEX=true /COLOR=true

NOTE: After installation the application will be started automatically. There is no need to restart the computer.

SAFEQ Cloud Client can be installed by any type of user defined on the windows machine. After installation of SAFEQ Cloud Client, it should be visible in Apps and features for all the users. If other user was logged in during PC client installation, the icon corresponding to SAFEQ Cloud Client will appear only after a re-login.

Feedback

Was this helpful?

Yes No
You indicated this topic was not helpful to you ...
Could you please leave a comment telling us why? Thank you!
Thanks for your feedback.

Post your comment on this topic.

Post Comment