PAWS: replication status and Network Diagnostic Service

[mb2855]

Hello.
Can anyone explain the difference in the two replication status available from the CUCM PAWS API?

PAWS - ClusterNodeService: "isClusterReplicationOK"

PAWS - DataBaseReplicationStatusService: "getDataBaseReplicationStatus"

Is there any documentation that explains what is going on behind each of these commands?

As the example above, is one or both equivalent to the OS CLI command "utils dbreplication runtimestate" and each node having a (2) Setup Completed status?

What is happening for PAWS - NetworkDiagnosticService: "checkNetworkStatus"?

Is it the "test - validate_network" of the OS CLI command "utils diagnose test"?

Thanks in advance for all your assistance. 

[prittell1]

I had the exact same question.  One option I think we could do is enable debugging and then execute the API call.  Maybe we can see what it is doing or what services it is accessing in the logs. 

[BjoernMartin]

Hello!

isClusterReplicationOK provides a quick overview of the general state of database replication in the cluster, while getDataBaseReplicationStatus delivers detailed insights into the replication status of each individual node.

NetworkDiagnosticService
"checkNetworkStatus" returns a simple true or false. Nothing more.
For a more in-depth diagnostic test, I can only recommend using an SSH client. For example, with the Python module Paramiko.

PAWS - NetworkDiagnosticService: Check Network Status
***************************************************************
2025-03-21 13:52:30,238 - MainThread - getCucmNetworkDiagnostic - INFO - Check network status from CUCM ....
NetworkDiagnosticService
{
'remoteMessages': [],
'result': 'internal.request.complete',
'status': True
}

PAWS - ClusterNodeService: "isClusterReplicationOK"
***************************************************************
2025-03-21 13:52:22,586 - MainThread - getCucmIsClusterReplicationOk - INFO - Get IsClusterReplicationOk from CUCM ....
ClusterNodesService
{
'remoteMessages': [],
'result': 'internal.request.complete',
'clusterReplicationStatusOK': True
}
***************************************************************

PAWS - DataBaseReplicationStatusService: "getDataBaseReplicationStatus"
***************************************************************
2025-03-21 13:52:20,420 - MainThread - getCucmClusterStatus - INFO - Get getCucmClusterStatus from CUCM ....
ClusterNodesService
{
'remoteMessages': [],
'result': 'internal.request.complete',
'clusterNodeStatus': [
{
'address': 'x.x.x.82',
'alias': 'cucm15sub',
'hostname': 'cucm15sub.example.com',
'primaryNode': 'x.x.x.81',
'type': 'cluster.node.type.secondary',
'dbRole': 'cluster.node.type.secondary',
'role': 1,
'status': 'cluster.node.status.online'
},
{
'address': 'x.x.x.83',
'alias': 'imp15pub',
'hostname': 'imp15pub.example.com',
'primaryNode': 'x.x.x.81',
'type': 'cluster.node.type.secondary',
'dbRole': 'cluster.node.type.primary',
'role': 2,
'status': 'cluster.node.status.online'
},
{
'address': 'x.x.x.84',
'alias': 'imp15sub',
'hostname': 'imp15sub.example.com',
'primaryNode': 'x.x.x.81',
'type': 'cluster.node.type.secondary',
'dbRole': 'cluster.node.type.secondary',
'role': 2,
'status': 'cluster.node.status.online'
},
{
'address': 'x.x.x.81',
'alias': 'cucm15pub',
'hostname': 'cucm15pub.example.com',
'primaryNode': 'x.x.x.81',
'type': 'cluster.node.type.primary',
'dbRole': 'cluster.node.type.primary',
'role': 1,
'status': 'cluster.node.status.online'
}
]
}
***************************************************************