Troubleshooting connection timeouts when running a wsadmin script
Running a wsadmin administrative script that calls an MBean in a network deployment environment results in several connections between sever processes, such as the deployment manager, the node agent, and the cluster member using Java™ Management Extensions (JMX) connectors. Some HCL Connections™ administrative scripts can run for longer than the default connection timeout that is specified for the connector that is used.
Troubleshooting timeouts
This results in messages like the following: WASX7017E:
Exception received while running file "/install_root/ProcessChoreographer/admin/script_name";
exception information: javax.management.JMRuntimeException: ADMN0034E:
The service is unable to obtain a valid administrative client to connect
process "nodeagent" from process "dmgr", because of exception: com.ibm.websphere.management.exception.ConnectorException:
ADMC0009E: The system failed to make the SOAP RPC call: invoke.
Reasoning
- For the call from the wsadmin environment to the deployment manager. The default for is 180 seconds.
- For the connection from the deployment manager to the node agent. The default is 600 seconds.
- For the connection from the node agent to the runtime deployment target. The default is 600 seconds.
Resolution
You have the following options:
- Modify the invocation parameters so that less work is performed, so that the operation completes before the timeout. For example, many scripts have parameters that can be used to select fewer objects.
- Modify the properties for the connector that is used.
Remote JMX connector
- This connector is used between server processes that reside on different physical machines, for example, between the deployment manager and the node agent. The default is the SOAP connector.
Local JMX connector- This connector is used between server processes that reside on the same physical machine, for example, between the node agent and its application servers. The default is the IPC connector.
You must modify the properties in the soap.client.props file, ipc.client.props, or sas.client.prop files, and the custom properties for the deployment manager and the node agents where members of your runtime deployment target are running.
The following example shows how to change the SOAP connector properties.- Modify the com.ibm.SOAP.requestTimeout property by editing the soap.client.props file that is located in the properties subdirectory of the profile_root directory.
- Change the requestTimeout custom property
using the administrative console:
- For servers or cluster members, click requestTimeout custom property, and modify its value. . Then locate the
- For the deployment manager, click requestTimeout custom property, and modify its value. . Then locate the
- For the node agents, click System administrationNode agentsnode_agent_nameAdditional PropertiesAdministration ServicesAdditional propertiesJMX ConnectorsSOAPConnectorAdditional PropertiesCustom properties. Then locate the requestTimeout custom property, and modify its value.