WSO2 Identity Server startup error - Error in initializing thrift transport

Question

I just installed WSO IS and receive this error when starting the server.

ERROR {org.wso2.carbon.identity.entitlement.internal.EntitlementServiceComponent} - Failed to initialize Entitlement Service

ERROR {org.wso2.carbon.identity.entitlement.internal.EntitlementServiceComponent} - Error in initializing thrift transport org.apache.thrift.transport.TTransportException: Could not bind to port 10500

I've verified nothing is using the 10500 port.

Answer 1

In order to test WSO2 locally on my development workstation, I hard-coded a hostname via the hosts file and modified the HostName and MgtHostName entities in ./repository/conf/carbon.xml. One caveat is that my workstation has a dynamic IP address. When the IP does occasionally change, leaving the hostname pointing to an unresponsive IP, starting WSO2 IS fails with the exact same error.

Repairing the host entry and restarting the WSO2 Identity Server resolves it.