Error message
HSF server failed to startThe High-Speed Service Framework (HSF) server could not bind to its designated port and start accepting requests.
Possible causes
Port 12200 is occupied. Another process is already using the default HSF server port, which prevents the server from binding to it.
Incorrect IP binding on multi-NIC hosts. On instances with multiple network interface controllers (NICs) or a public IP address, HSF may attempt to bind to a non-routable or incorrect network interface.
Diagnose and resolve the issue
Cause 1: Port 12200 is occupied
Check whether another process is using port 12200:
# Linux / macOS
netstat -tlnp | grep 12200
# Alternative
lsof -i :12200If a process is listed, stop that process or reassign it to a different port to free port 12200 for HSF.
After you free the port, restart the HSF server and verify that it starts without errors.
Cause 2: Incorrect IP binding on a multi-NIC instance
On instances with multiple NICs or a public IP address, HSF may bind to the wrong interface. Specify the correct local IP address by adding the following JVM startup parameter:
-Dhsf.server.ip=<local-ip-address>Replace <local-ip-address> with the IP address of the network interface that other services can reach, for example 192.168.1.100.
To find the available network interfaces and their IP addresses:
# Linux
ip addr show
# macOS
ifconfigAfter you set the IP address, restart the HSF server and confirm it binds to the correct interface.
Related information
| Parameter | Description |
|---|---|
12200 | Default HSF server port |
-Dhsf.server.ip | Specifies the local IP address for HSF server binding |