KB0017430 – License error on 2 NIC server

KB Article # 0017430

Applies to: v4.1.x


After setting up a multi-server environment where the servers have more than one Network Interface Controller (NIC) the following error occurs:

[ERROR] [http-apr-8080-exec-1] [com.ephesoft.license.aspect.LicenseAspect] – Error occured while verifying license.
java.rmi.ConnectIOException: Exception creating connection to: <IP address>; nested exception is:
java.net.SocketException: Network is unreachable: connect

Where <IP address> stands for the IP address on the acting license server that is not the interface that Ephesoft Transact is configured on.
Root Cause:

This is a known issue with RMI. The algorithm used to decide which IP to connect to does not always provide the correct result.


Set the java.rmi.server.hostname=<<license server IP>> property on the license server side.

This can be included in the JAVA_OPTS parameter in <EphesoftDirectory>\JavaAppServer\bin\startup.bat by adding    “-Djava.rmi.server.hostname=<<license server IP>>” at the very end of the JAVA_OPTS line.

For Ephesoft running as a service, you will need to add the JAVA_OPTS parameter for the service through the following steps:

  1. Double click <EphesoftDirectory>\JavaAppServer\bin\EphesoftEnterprise.exe
  2. Open Java Tab and in Java Options add -Djava.rmi.server.hostname=<<license server IP>>
  3. Restart Ephesoft Transact service