Security client configuration utility

After removing a security framework node from the datacenter, a client configuration tool has to be run on each workstation that is pointing to the security framework node being removed in order to redirect the workstations to another available node. Consider running this tool at login to ensure that users can continue to use ControlSuite without interruption.

When installing the ControlSuite 1.3 Fix Pack 3 Print Client, the security client configuration folder is created in C:\Program Files\Kofax\Equitrac\Client\NDI.SecClientConfig, with the following client configuration files:

  • NDI.SecClientConfig.exe - a universal client configuration utility.
  • NDI.SecClientConfig.ps1 - a PowerShell script used to repoint workstation clients to different security framework nodes in the same security framework cluster.

To redirect the workstations to a live node, do the following:

  1. Generate an 'Install Token' on one of the live security framework nodes using the following command: C:\Program Files\Kofax\Shared Services\SecurityFrameworkService\NDISecTool>NDISecTool.exe -clientinstalltoken -u nuance\SecurityAdmin -p pwd >MyToken.txt.
    Where:
    • nuance\SecurityAdmin is the admin user.
    • pwd is the admin password.
    • MyToken.txt is the token file name.
  2. On the client workstation, run the following NDI.SecClientConfig.ps1 PowerShell script command: .\NDI.SecClientConfig.ps1 <token file text> <SFS_datacenter_name> <new_SFS_node_host_FQDN> -RePoint.
    Where:
    • token file text is the name of the generated Install Token.
    • SFS_datacenter_name is the name of the datacenter where the Security Framework Service is running.
    • new_SFS_node_host_FQDN is the fully qualified domain name of the new host that the security framework node is redirected to. This is name of the system where security framework is installed on.
    This tool can be run on any workstation to ensure that it is not pointing to a dead node.
  3. On the client workstation, verify that the 'ssdsUri' is updated in: C:\ProgramData\Nuance\NDISecurity\ndisecurity.config.