In addition to the overall state, all datasources have a specific status
that indicates the current health and operation, rather than the
configured state for that datasource. For example, a datasource can be in
the online state, but have a
DIMINISHED status if there is a
recoverable problem with one of the datasource components.
The purpose of the STATUS field is to provide
standard, datasource-state-specific values for ease of parsing and
backwards-compatibility with older versions of the
cctrl command.
The STATUS field is effectively the same information
as the datasource state that appears on the first
line after the colon (:), just presented slightly differently.
Here are the possible values for STATUS, showing the
Datasource State first, and the matching STATUS second:
| Datasource State | Alert STATUS |
|---|---|
| ONLINE | OK |
| OFFLINE | WARN (for non-composite datasources) |
| OFFLINE | DIMINISHED (for composite passive replica) |
| OFFLINE | CRITICAL (for composite active primary) |
| FAILED | CRITICAL |
| SHUNNED | SHUNNED |
Any other datasource status sets the
STATUS to UNKNOWN.
The OK status indicates that the
datasource is currently operating correctly.
A DIMINISHED status indicates
that there is a problem with one of the dataservice services which is
causing a reduced level of expected service. For example, in the
sample output below, the reason is indicated as a stopped replicator
service.
+----------------------------------------------------------------------------+ |db1(master:ONLINE) | |STATUS [DIMINISHED] [2025/01/24 03:23:02 PM UTC] | |REASON[REPLICATOR STOPPED] | +----------------------------------------------------------------------------+ | MANAGER(state=ONLINE) | | REPLICATOR(state=STOPPED) | | DATASERVER(state=ONLINE) | | CONNECTIONS(created=195, active=0) | +----------------------------------------------------------------------------+
The underlying service fault should be fixed and the status rechecked.
If all the services are ONLINE, but
one node is in the DIMINISHED state,
you should let the auto-recovery process complete. To do this:
Place the cluster into AUTOMATIC mode:
[LOGICAL] /alpha > set policy automatic
Set the status of the node in the
DIMINISHED state to
OFFLINE:
[LOGICAL] /alpha > datasource db1 offlineAutomatic recovery will then recover the node for you.