Cannot change the default search port in Content Analytics with Enterprise Search

Technote (troubleshooting)


I installed IBM Content Analytics with Enterprise Search (ICA) and successfully applied fix pack 1. During the installation, I changed the default search server port to 21102. However, when I try to start the system or verify the installation with first steps, I see an error message.


FFQG0024E An internal error occurred. Exception message: FFQQ0133E An error occurred while opening a connection to the servlet at host and port 21102. Exception text:


The specified port number isn't passed to the search server configuration during installation.

Resolving the problem

Apply the following workaround steps:

  1. Stop ICA with the command esadmin system stopall.
  2. Modify the SearchServerPort property in the ES_INSTALL_ROOT/nodeinfo/es.cfg file to the new port value (21102) on all servers.
  3. Modify the nodeN.searchserverport property in the ES_NODE_ROOT/master_config/nodes.ini file.
  4. Change the port numbers as shown in the following example in the $ES_NODE_ROOT/master_config/searchserver/dock/dock.xml file:
          <acceptorFactory ...>
              <property name="defaultPort" value="21102"/>
  5. Edit the hostname and port properties in $ES_NODE_ROOT/master_config/searchapp/{search, analytics}/ (2 files). For example:
    (Note that #hostname=localhost should be there; remove the # character.)
  6. Restart ICA. (If ICA is installed with WebSphere Application Server (WAS) or in a WAS clustering environment, also restart WAS instances.) For example, run the esadmin system stopall command and then the esadmin system startall command.

Document information

More support for:

Watson Content Analytics

Software version:


Operating system(s):

AIX, Linux, Windows

Reference #:


Modified date:


Translate my page

Content navigation