Stand-alone text search server fails to start

If the stand-alone text search server fails to start when you try starting it using the startup.bat startup script, set the port number to a new value and try starting the stand-alone server again.

Symptoms

When you try starting the standalone text search server by running the startup.bat script, the server might fail to start and you might see the following error message:

IQQD0056E An error occurred when starting the server at port 8191.
IQQG0335E The server cannot start. See the error log file for more details.
ExtendedException: D0056E.CONNECT_ERROR - D0056E.CONNECT_ERROR

You can also check for a similar error message in the ecmts_install_directory/log/trace0.log log file. The error message in this log file looks like as follows:

IQQD0056E An error occurred when starting the server at port 8191.
Causes of the problem:
  IQQG0020E java.net.SocketException: Unrecognized Windows Sockets error: 0: JVM_Bind
      java.net.PlainSocketImpl.socketBind(Native Method)
      java.net.PlainSocketImpl.bind(PlainSocketImpl.java:415)
      java.net.ServerSocket.bind(ServerSocket.java:330)
      java.net.ServerSocket.(ServerSocket.java:196)
      java.net.ServerSocket.(ServerSocket.java:152)
      com.ibm.es.nuvo.inyo.common.InyoServer.run(InyoServer.java:188)

Resolving the problem

To resolve this error message, perform either of the following steps:

Set the port number to a new value by issuing the following command:configTool configureParams -adminHTTPPort new_port_value -configPath ecmts_install_directory\config\config.xml.
After setting the port number to a new value, try running the startup.bat script again.
Uninstall the standalone server and then reinstall the server by setting the port number to a new value that is defined in the ecmts_response.txt response file.