Skip to main content
Kofax

Convert Standalone VRS on a KTA Scan Station into a Client to pull Licensing from KTA license server

3029025

Question / Problem: 

How to convert a Standalone Kofax VRS 5.1.2 or 5.2 installation on a KTA scan station into a Client installation so that it pulls its licensing from the KTA License Server without having to install a VRS Server Installation.

Answer / Solution: 

The Best Practice for installing Kofax VRS 5.1.2 or 5.2 on a KTA scan station so that it gets its VRS licensing from the KTA license is to install VRS as a server installation on the KTA license server and install VRS has a Client installation on the scan station.  However, in cases where Kofax VRS 5.1.2 or 5.2 have already been installed on a fleet of scan stations as Standalone installations, and where VRS Profile Sharing is not required, the Standalone installations can be manually converted into a client installation and pointed to a KTA License Server.

A Kofax VRS Server installation performs two major functions:  centralized VRS licensing using the Kofax License Service and VRS Profile Sharing using the VRS Repository Service.  The procedure documented in this article does NOT provide VRS Profile Sharing.  If VRS Profile Sharing is requierd, a server installation of VRS must be installed.

To convert the standalone installation of Kofax VRS into a Client and point it to the KTA License Server:

  1. Make sure that the scan station is able to communicate with the KTA license server on port 3581
     
  2. Stop the WebCapture Service to ensure that Kofax VRS is not still loaded
     
  3. Navigate to
    C:\ProgramData\Kofax\Vrs
     
  4. Create a new text file called SALConfig.xml
     
  5. Open SALConfig.xml in a text editor such as Notepad
     
  6. Enter the following into SALConfig.xml, replacing mylicenseserver.mycompany.com with the hostname, IP Address or Fully Qualified Domain Name of the KTA license server.
    <licensing>
      <servers>
        <server port="3581" isEnterprise="False">mylicenseserver.mycompany.com</server>
      </servers>
      <opts>
        <delaySeconds>30</delaySeconds>
        <totalTimeoutSeconds>300</totalTimeoutSeconds>
        <useDefaultWebProxy>False</useDefaultWebProxy>
        <remoteSite>False</remoteSite>
      </opts>
    </licensing>
    

     
  7. Save the changes to SALConfig.xml and close the file
     
  8. Open KofaxReg.xml in a text editor such as Notepad.
     
  9. Locate the INSTALLTYPE and ORIGINALINSTALLTYPE values under Registry | HKEY_LOCAL_MACHINE | SOFTWARE | KOFAX | VIRTUALRESCAN
    <Registry>
         <HKEY_LOCAL_MACHINE>
              <SOFTWARE>
                   <KOFAX>
                        <VIRTUALRESCAN>
                        ...
                             <INSTALLTYPE Value="Standalone" />
                             <ORIGINALINSTALLTYPE Value="Standalone" />
                        </VIRTUALRESCAN>
    

     
  10. Change the INSTALLTYPE and the ORIGINALINSTALLTYPE values to Workstation
    <Registry>
         <HKEY_LOCAL_MACHINE>
              <SOFTWARE>
                   <KOFAX>
                        <VIRTUALRESCAN>
                        ...
                             <INSTALLTYPE Value="Workstation" />
                             <ORIGINALINSTALLTYPE Value="Workstation" />
                        </VIRTUALRESCAN>
    

     
  11. Save the changes to KofaxReg.xml
     
  12. Restart the WebCapture Service

 

Applies to:  

Product Version
VRS 5.1.2
  5.2