Changing the system port number

If the port number that the Watson Explorer Content Analytics system uses conflicts with a port number that is used by another product, you must change the port number.

About this task

A port number for the system is specified when Watson Explorer Content Analytics is installed. In a multiple server configuration, the same port number is specified on all servers.

If the port number is unusable (for example, the port number might be assigned to another product on the same server), the conflict results in the following error message in the CCLServer_date.log file, where date specifies the date that the log file was created:

FFQO0273W An internal warning occurred - Exception Message: {0}
 at java.net.PlainSocketImpl.socketBind(Native Method)
 at java.net.PlainSocketImpl.bind(PlainSocketImpl.java:357)
 at java.net.ServerSocket.bind(ServerSocket.java:341)
 at java.net.ServerSocket.<init>(ServerSocket.java:208)
 at java.net.ServerSocket.<init>(ServerSocket.java:120)

Procedure

To change the port number that is used by Watson Explorer Content Analytics:

Go to the computer where the port number needs to be changed, log in as the default Watson Explorer Content Analytics administrator, and stop the system:
esadmin system stopall

Important: When the system is stopped, users cannot query collections.
Edit the ES_INSTALL_ROOT/nodeinfo/es.cfg file, locate the following property, specify a new port number value, and then save and close the file:
```
CCLPort=new_port_number
```
Restart the common communication layer (CCL):
AIX® or Linux®

startccl.sh

Windows command prompt

startccl

Windows Services administrative tool
To start CCL in the background:
1. Launch Windows Services: Start > Programs > Administrative Tools > Services.
2. Right-click IBM® Watson Explorer Content Analytics and click Start.
Log in as the default Watson Explorer Content Analytics administrator on the master server, and stop the CCL:
AIX or Linux

stopccl.sh

Windows command prompt

stopccl

Windows Services administrative tool
1. Launch Windows Services: Start > Programs > Administrative Tools > Services.
2. Right-click IBM Watson Explorer Content Analytics and click Stop.
Edit the ES_NODE_ROOT/master_config/nodes.ini file:
1. Locate the following property, where computer_name is the name of the computer where you modified the port number in step 2. The N in the nodeN property is a number that identifies the server.
```
nodeN.destination=computer_name
```
2. Locate the following subproperty, specify the same port number here that you specified for the server in step 2, and then save and close the file:
```
nodeN.port=new_port_number
```
Restart the Watson Explorer Content Analytics system:
esadmin system startall