To retrieve a detailed report on the current convergence status of a Rhino cluster use the following rhino-console command or associated MBean operation:
Console command: reportconvergencestatus
Command |
reportconvergencestatus [-nodes node1,node2] [-diff] [-o filename]
Description
Report on the current convergence status. If a node list is provided, only the
specified nodes are included in the report. The -diff option will limit the
report to include only entities where the actual state differs from the desired
state. The -o option will output the raw json-formatted report to the specified
file instead of a human-readable report being output to the console.
|
|---|---|
Examples |
To retrieve a full convergence report for the cluster: $ ./rhino-console reportconvergencestatus
In the following report, any desired state that is followed by an asterisk (*)
indicates that that desired state is a per-node override from the default.
In the default namespace:
SLEE status:
Node Desired state Actual state
101 running running
102 running running
103 stopped * stopped
Service status:
service: ServiceID[name=SIS-IN Test Service Composition Selector Service,vendor=OpenCloud,version=0.3]
Node Desired state Actual state
101 active active
102 active active
103 inactive * inactive
service: ServiceID[name=Call Barring Service,vendor=OpenCloud,version=0.3]
Node Desired state Actual state
101 active active
102 active active
103 inactive * inactive
service: ServiceID[name=Call Forwarding Service,vendor=OpenCloud,version=0.3]
Node Desired state Actual state
101 active active
102 active active
103 inactive * inactive
service: ServiceID[name=Call Duration Logging Service,vendor=OpenCloud,version=0.3]
Node Desired state Actual state
101 active active
102 active active
103 inactive * inactive
service: ServiceID[name=VPN Service,vendor=OpenCloud,version=0.3]
Node Desired state Actual state
101 active active
102 active active
103 inactive * inactive
Resource adaptor entity status:
entity name: insis-ptc-1a
Node Desired state Actual state
101 active active
102 active active
103 active active
entity name: insis-ptc-1b
Node Desired state Actual state
101 active active
102 active active
103 active active
entity name: insis-ptc-external
Node Desired state Actual state
101 active active
102 active active
103 active active
To report only on where convergence has not been met, you can use the $ ./rhino-console reportconvergencestatus -diff Rhino is currently converged to desired state, no differences to report To save the report to a file in JSON format: $ ./rhino-console reportconvergencestatus -o convergence-report.json Output written to file: convergence-report.json |
MBean operation: getConvergenceStatus
MBean |
|
|---|---|
Rhino operations |
public String getConvergenceStatus(boolean differencesOnly)
throws ManagementException;
public String getConvergenceStatus(int[] nodeIDs, boolean differencesOnly)
throws InvalidArgumentException, ManagementException;
These operations return a JSON-formatted string that reports the desired state and actual state for each service and resource adaptor entity in the SLEE, along with the desired state and actual state of the SLEE itself, across all namespaces. |
