ITIM Collector fails with 'java.net.BindException: Address already in use' error in RSA Identity Governance & Lifecycle
Originally Published: 2015-11-30
Last Modified: 2023-12-01
Article Number
000043331
Applies To
RSA Product Set: RSA Identity Governance & Lifecycle
RSA Version/Condition: All
 
Issue
The ITIM Collector fails and reports the following error message in the aveksaAgent.log file (/home/{remoteagentuser}/AveksaAgent):
 
ERROR (Thread-4) [com.aveksa.client.component.communication.ChangeListHandler] CLH70: com.aveksa.client.datacollector.agent.ServerUnavailableException:
com.aveksa.server.agent.message.ConnectionException: java.net.BindException: Address already in use
  at com.aveksa.client.component.communication.DefaultCommunicationManager.getChangeList(DefaultCommunicationManager.java:203)  at com.aveksa.client.component.communication.ChangeListHandler.getChangesFromServer(ChangeListHandler.java:235)
  at com.aveksa.client.component.communication.ChangeListHandler.run(ChangeListHandler.java:129)
  at com.aveksa.client.component.communication.DefaultCommunicationManager$1.run(DefaultCommunicationManager.java:543) Caused by: com.aveksa.server.agent.message.ConnectionException: java.net.BindException: Address already in use
  at com.aveksa.server.agent.message.HTTPBroker.httpPost(HTTPBroker.java:158)
  at com.aveksa.server.agent.message.HTTPBroker.send(HTTPBroker.java:85)
  at com.aveksa.server.agent.message.ServerBroker.getChanges(ServerBroker.java:296)
  at com.aveksa.client.datacollector.agent.ServiceManager.getChangeList(ServiceManager.java:123)
  at com.aveksa.client.component.communication.DefaultCommunicationManager.getChangeList(DefaultCommunicationManager.java:195) ... 3 more Caused by: java.net.BindException: Address already in use
  at java.net.PlainSocketImpl.socketBind(Native Method)
  at java.net.PlainSocketImpl.bind(PlainSocketImpl.java:398) at java.net.Socket.bind(Socket.java:582)
  at java.net.Socket.<init>(Socket.java:392) at java.net.Socket.<init>(Socket.java:267)
  at org.apache.commons.httpclient.protocol.DefaultProtocolSocketFactory.createSocket(DefaultProtocolSocketFactory.java:79)
  at org.apache.commons.httpclient.protocol.DefaultProtocolSocketFactory.createSocket(DefaultProtocolSocketFactory.java:121)    at org.apache.commons.httpclient.HttpConnection.open(HttpConnection.java:706)
  at org.apache.commons.httpclient.HttpMethodDirector.executeWithRetry(HttpMethodDirector.java:386)
  at org.apache.commons.httpclient.HttpMethodDirector.executeMethod(HttpMethodDirector.java:170)
  at org.apache.commons.httpclient.HttpClient.executeMethod(HttpClient.java:396)
  at org.apache.commons.httpclient.HttpClient.executeMethod(HttpClient.java:324)
  at com.aveksa.server.agent.message.HTTPBroker.httpPost(HTTPBroker.java:155) ... 7 more

 
Cause
The ITIM agent failed to start due to the port being used by another process.
 
Resolution
To resolve this issue, perform one of the following actions:
  • Modify the port used by the other process to avoid conflicting with the ITIM agent.
  • Change the port the ITIM Agent uses by modifying aveksa-plug-ins.xml:
  1. Backup  the aveksa-plug-ins.xml file located under <AVEKSA_WAR_DIR>/WEB-INF/plug-ins/ ITIM2FulfillmentHandler.
  2. Edit the aveksa-plug-ins.xml file and modify the port setting.

For example, on WebLogic and WebSphere you must edit the aveksa-plug-ins.xml file in your customized EAR in the CUSTOMIZATION directory located in:

<CUSTOMIZATION>/aveksa_ear/aveksa.war/WEB-INF/plug-ins/ITIMFulfillmentHandler
  1. Backup the aveksa-plug-ins.xml file:
cd <CUSTOMIZATION>/aveksa_ear/aveksa.war/WEB-INF/plug-ins/ITIMFulfillmentHandler
cp aveksa-plug-ins.xml aveksa-plug-ins.xml.backup_<date>
  1. Edit the aveksa-plug-ins.xml file and modify the port setting:
FROM:
<value>iiop://localhost:2809</value> for name platformURL
TO: 
<value>iiop://ITIM_HOST:ITIM_NEW_PORT</value>
The ear file must be redeployed after the customization has been completed. 

See the RSA Identity Governance & Lifecycle Installation Guide for your version for more information on customizing the RSA Identity Governance & Lifecycle platform.
 
Don't see what you're looking for?