How to configure wnSSOclient in an LB environment

How to configure wnSSOclient in an LB environment

Problem:  If your environment has load balanced Unified Workspace servers, you cannot use the load-balancer DNS name in the Single Sign-On Server field for wnSSOclient.



Cause:  Single Sign-On Server field is used for communicating instructions between the wnSSOclient and server with longer instructions.  A load-balancer cannot be between the wnSSOclient and the server.  



Solution(s):  Make instructions to application short enough that the Single Sign-On Server field is not required.  This includes shortening the application path, but still including some instructions like {logoffonexist} and {notimeout}.  This is also helpful for situations where you have multiple versions of same software.


Shorten the Application Path:
  • Check if the application has an App Path to the EXE file in registry
  • HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\App Paths
  • If not, add an entry to registry on all RDS servers for the application


Example configuration for application called Cinema4D:
  • Registry Key for "Cinema4D.exe"
  • Default REG_SZ "C:\Program Files\MAXON\CINEMA 4D R17\CINEMA4D.exe"
  • UW Start Program:  Cinema4D.exe
  • UW Single Sign-on Script:  {logoffonexit}|{notimeout}
  • UW Single Sign-On Server:  (leave it blank)
  • UW wnSSOClient Path:  whatever path it should be


Reference(s):



    Can't find the KB

    Unable to find the KB to address your issue ?  

      • Recent Articles

      • Lenovo Unified Workspace End-of-Life Questions and Answers

        Will the shutdown of LUW servers and access to downloads affect my server licensing? No, the shutdown of the customer servers and access to the product and licensing downloads will not affect your server licensing. This license is downloaded and ...
      • How do I determine my Unified Workspace license expiration date?

        The best method for determining the licensing information including the expiration date of your Unified Workspace license: Login to your 8090 management console on each server This may take remoting into each LUW server and relay, opening a browser, ...
      • Lenovo Unified Workspace 7.0.2.13 Released

        Highlights of Unified Workspace 7.0.2.13 Before you install: Please view the installation notes here. 7.0.2.13 requires a 7.0 license file. Below is a list of enhancements and fixes released in Unified Workspace 7.0.2.13 Fixed external storage ...
      • LanSchool Documentation Guides

        LanSchool Classic Teacher Console The LanSchool Teacher Console is the interface teachers will use to manage their classroom and students. It contains all the tools necessary for a teacher to effectively interact with students and create a ...
      • Lenovo Unified Workspace 7.0.1.41 Released

        Highlights of Unified Workspace 7.0.1.41 Before you install: Please view the installation notes here. 7.0.1.41 requires a 7.0 license file. Below is a list of enhancements and fixes for Unified Workspace 7.0.1.41 Updated Log4j Updated Java Updated ...
      • Related Articles

      • Stoneware Environment Check Utility

        Problem:  Need to run Stoneware Environment Check (Env Check) for pre-installation, troubleshoot issues or general health check of directory and DNS. Solution(s):  Once utility is installed and launched, you will find three options to choose from on ...
      • wnSSOClient.exe can not be started.

        The customer is getting an error that the system cannot find the file specified, wnSSOClient cannot be started error launching TS application. Full error: The system cannot find the file specified. This initial program cannot be started: ...
      • How to test wnSSOClient by hand

        How can I test the wnSSOClient on my Terminal Server to make sure it is working?   From the Terminal Server command prompt type the following: wnSSOClient.exe bogus http://x.x.x.x false Where x.x.x.x is the IP or the DNS of the Stoneware Relay. If it ...
      • Install wnSSOClient on Windows Server 2003/2008/2012

        How do I install the wnssoclient on windows server 2003, 2008/2012? For windows 2003: Copy the wnssoclient.exe and swssolibrary.dll files the c:\windows\system32\ directory on the windows 2003 terminal server. On the stoneware relay: Edit the ...
      • wnSSOClient will not run after upgrading to 6.4.x.x

        Symptoms: The wnSSOClient gives an error when trying to launch RDS webApp after upgrading to 6.4.  Error received is "An exception occurred while trying to connect to the relay" or "The underlying connection was closed: An unexpected error occurred ...