How to setup clients to use a concurrent (network) license server

After configuring and starting the license servers, client systems need to be able to connect to the server in order to obtain licenses when performing comparison or other operations.

Step-by-step guide

  1. Copy the license file to your client machine
  2. The license file can be placed in exactly one of the following locations:
    1. The same directory as the DeltaXML .jar or .dll files.  This is typically the directory created when unzipping the release download or a /bin subdirectory.
    2. The user's home directory
    3. A user specified directory may be used by calling the API method setLicenseFile
  3. You will need to change this_host so that clients can contact the server - use an IP address or hostname (simple or fully qualified).  When editing, be careful to ensure that the second argument on the server line is used to contact the host and the third is the hostid used for locking.
  4. Alternatively, to steps 1-3 above, specify the server through the setLicenseServer API method.
  5. To ensure the license server is running, test that you can obtain a license. Open a command terminal, navigate to the product folder, and run the main product jar file with the license argument.  The name of the jar file depends on the product being used, here are some examples:-

    $ java -jar deltaxml.jar license
    $ java -jar deltaxml-docbook.jar license

    This will display the version of the product and the license details.  If you observe the license server logs you will also see a checkout followed by an immediate checkin corresponding to the license report.

#content .code