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. |