coDiagnostiX Knowledge Base

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== How to set up a network dongle installation ======

The network dongle setup allows to use coDiagnostiX on several computers in a local network without having to plug the dongle into each PC. This means the dongle is plugged in a central computer or server and a special network license service distributes its information over the local network.

===== Requirements =====

  * Server or Workstation PC (VMs are supported)
  * Windows 7 SP1 or newer / Windows Server 2008 SP2 or newer
  * Free USB 2.0 slot

===== Setup =====

To set up the dongle in the local network, put the coDiagnostiX installation disk in to a central computer or server and open the installation wizard. After having agreed to the license terms, the setup type can be selected.

Choose Network License Service Installation (Server) and click Next until the installation is finished. This will only install the eToken drivers and license service without coDiagnostiX. When finished, plug in the Dongle.

{{:license:etoken_network_installation.png?nolink|}}

If the network clients don't see the distributed dongle information, the firewall on the server might be blocking
the network license service from communicating over the network. In this case, the network license service executable
needs to be added to the whitelist of the firewall. To do this, a firewall exclusion rule has to be defined.

Create a rule for the following file:
  * 32-Bit Windows ''C:\Windows\System32\STMSLMSrv.exe''
  * 64-Bit Windows ''C:\Windows\SysWOW64\STMSLMSrv.exe''

===== Setup over Router boundaries =====

The clients will look for the Server via broadcasts.

If there is a NAT translation between client and server you need to setup the clients to connect to a specified IP address instead of using broadcasts.

To bind the license service of a client/workstation to a fixed IP address of a server:

  * **IMPORTANT** This only works with STMSlmSrv.exe v3.0.4.25 or newer (coDiagnostiX 9.5+)
  * Start the application ''C:\Program Files (x86)\coDiagnostiX\coDiagnostiX.App\eToken\STMSLMSrv.exe'' and click Uninstall.
  * Open Windows Explorer and navigate to ''C:\ProgramData\coDiagnostiX\LicenseManager''
  * Open the file ''STMSlmSrv.ini'' in notepad and change the options according to the list below:

  EnabledBroadcasts=''
  DisabledBroadcasts='*'
  RemoteServers='123.123.123.123'

  * The IP address ''123.123.123.123'' needs to be replaced by your dongle server's IP address
  * Save the file, open the ''STMSLMSrv.exe'' again and click Install
Now the client should be able to receive the dongle information through the network via TCP/IP (and can now communicate over router boundaries).

The following network ports are used. This can be helpful for VPN tunnels.
  * ''TCP 54237 (incomming)'' (Server and Clients)
  * ''UDP 21945 (incomming)'' (Server and Clients)