getNodeInfo
The getNodeInfo method returns the node information by the node name.
If the Node Name argument is blank, then all ActiveMatrix Service Grid nodes are returned. On providing the Node Name argument, it serves as a regular expression used to filter the nodes returned.
Type
Synchronous, IMPACT_INFO.
Arguments
Name | Type | Description |
---|---|---|
Node Name | String | The node name. |
Returns
Name | Type | Description |
---|---|---|
Process ID | String | The Process ID of the ActiveMatrix Service Grid node (OS Process ID.) Note: Process ID return "-1", if Node is not running. |
Name | String | The name of the node. |
Host | String | The name of the host associated with the node. |
Runtime State | String | The actual state of the node as reported by the host.
|
Stop Mode | String | In which mode the node is stopped. Node can be stopped in abort , immediate or normal mode through the ActiveMatrix Service Grid Admin UI or end the process from the OS or using the API to the Stop Node.
|
Stop Reason | String | Stop the reason text message. If the end process is from the OS, then reason returned is "OSGI Framework is stopping". |
Stop Reason Code | String | Stop reason error code. Note: Most of the time, it is Reason null and reason code -1. |
Time Stamp | String | The time stamp (date and time) of the state changed (for example, from the NOT_RUNNING state to the RUNNING State, the time stamp of the node started and running successfully). Time Stamp returns a long value, which is available in Hawk in a readable format of date and time. Note: If any ActiveMatrix Service Grid node was stopped while starting the Hawk agent, then getNodeInfo() would return 0 in the timestamp column for that particular node. |
Starting in
ActiveMatrix Service Grid Administrator UI, the getNodeInfo()
method does not return the correct node state unless the node is restarted.When the node is restarted (that is, when the microagent receives a Start
notification from ActiveMatrix Service Grid Administrator), the microagent returns the correct state of the node.