| Cause Category | Specific Issue | |----------------|----------------| | | Outbound port 443 or 8443 (license server port) blocked by firewall | | DNS Resolution | Cannot resolve license.eve-ng.net or custom on-prem license server | | Proxy Configuration | EVE cannot use the corporate proxy for outbound HTTPS | | Server Overload | EVE license server temporarily rate-limiting (rare) | | Date/Time Skew | System clock offset > 5 minutes from NTP | 4. Immediate Diagnostic Steps 4.1 Test Basic Connectivity # From EVE Pro host ping license.eve-ng.net telnet license.eve-ng.net 443 4.2 Check License File Integrity sudo cat /opt/unetlab/platform/eve.lic # Look for: "host":"license.eve-ng.net" or custom IP 4.3 Validate System Time date # Compare with current UTC. If offset > 300 sec -> fix NTP timedatectl 4.4 Review License Daemon Logs sudo tail -f /var/log/unetlab/license_daemon.log # Look for: "ERROR -97" or "Connection refused" 5. Resolution Steps Step 1 – Allow Outbound Access Ensure the EVE Pro host can reach the license server on TCP port 443 (HTTPS). If using on-prem license server , allow TCP port 8443 or custom port defined in eve.lic .
sudo systemctl restart unetlab-license sudo eve-check-license --force sudo systemctl restart unetlab Step 4 – Switch to Offline License (Temporary Workaround) If network isolation is permanent, request an offline license file from EVE support and install: eve license host error -97-
sudo eve-check-license --debug > /tmp/license_debug.txt sudo tcpdump -i eth0 host license.eve-ng.net -c 100 -w /tmp/license.pcap | Error Code | Meaning | |------------|---------| | -15 | License expired | | -97 | License host unreachable | | -102 | Invalid MAC address | | -110 | Clock skew detected | Last Updated: [Current Date] Affected Versions: EVE Pro 4.0 and above Workaround Rating: Medium complexity – requires network/firewall access Resolution Steps Step 1 – Allow Outbound Access
sudo iptables -A OUTPUT -p tcp --dport 443 -d license.eve-ng.net -j ACCEPT Edit /opt/unetlab/platform/eve.lic and add proxy settings: Overview When attempting to launch a node or
"proxy": "host": "proxy.company.com", "port": 8080
Then restart license service:
Product: EVE-NG (Professional/Enterprise Edition) / EVE Pro Error Code: -97 Severity: Critical (Service Interruption) 1. Overview When attempting to launch a node or access licensed features in EVE-NG Pro, the platform may fail validation with the error: License host unreachable: Error -97 .