mir/kea
2
0
Fork 0
mirror of https://gitlab.isc.org/isc-projects/kea synced 2025-08-30 13:37:55 +00:00
Code Issues Releases Wiki Activity

[#1087] Updated status-get description

Browse Source 
The HA specific part of the status-get command was updated.
This commit is contained in:
Marcin Siodelski
2020-05-19 16:36:36 +02:00
parent 9aba538d28
commit 65a956f36d
2 changed files with 56 additions and 32 deletions
Download Patch File Download Diff File Expand all files Collapse all files

31
doc/sphinx/api/status-get.json
View File

@@ -21,20 +21,25 @@
" \"pid\": <integer>,", " \"pid\": <integer>,",
" \"uptime\": <uptime in seconds>,", " \"uptime\": <uptime in seconds>,",
" \"reload\": <time since reload in seconds>,", " \"reload\": <time since reload in seconds>,",
" \"ha-servers\": {", " \"high-availability\": [",
" \"local\": {", " {",
" \"role\": <role of this server as in the configuration file>,", " \"ha-mode\": <HA mode configured for this relationship>",
" \"scopes\": <list of scope names served by this server>,", " \"ha-servers\": {",
" \"state\": <HA state name of the server receiving the command>,", " \"local\": {",
" },", " \"role\": <role of this server as in the configuration file>,",
" \"remote\": {", " \"scopes\": <list of scope names served by this server>,",
" \"age\": <the age of the remote status in seconds>,", " \"state\": <HA state name of the server receiving the command>,",
" \"in-touch\": <indicates if this server communicated with remote>,", " },",
" \"last-scopes\": <list of scopes served by partner>,", " \"remote\": {",
" \"last-state\": <HA state name of the partner>,", " \"age\": <the age of the remote status in seconds>,",
" \"role\": <partner role>", " \"in-touch\": <indicates if this server communicated with remote>,",
" \"last-scopes\": <list of scopes served by partner>,",
" \"last-state\": <HA state name of the partner>,",
" \"role\": <partner role>",
" }",
" }",
" }", " }",
" }", " ]",
" }", " }",
"}" "}"
], ],

57
doc/sphinx/arm/hooks-ha.rst
View File

@@ -1586,29 +1586,48 @@ the HA status of two load balancing servers:
"pid": 1234, "pid": 1234,
"uptime": 3024, "uptime": 3024,
"reload": 1111, "reload": 1111,
"ha-mode": "load-balancing", "high-availability": [
"ha-servers": { {
"local": { "ha-mode": "load-balancing",
"role": "primary", "ha-servers": {
"scopes": [ "server1" ], "local": {
"state": "load-balancing" "role": "primary",
}, "scopes": [ "server1" ],
"remote": { "state": "load-balancing"
"age": 10, },
"in-touch": true, "remote": {
"role": "secondary", "age": 10,
"last-scopes": [ "server2" ], "in-touch": true,
"last-state": "load-balancing", "role": "secondary",
"communication-interrupted": true, "last-scopes": [ "server2" ],
"connecting-clients": 2, "last-state": "load-balancing",
"unacked-clients": 1, "communication-interrupted": true,
"unacked-clients-left": 2, "connecting-clients": 2,
"analyzed-packets": 8 "unacked-clients": 1,
"unacked-clients-left": 2,
"analyzed-packets": 8
}
}
} }
} ]
} }
} }
The ``high-availability`` argument is a list which currently always comprises
one element. There are plans to extend the HA implementation to facilitate
multiple HA relationships for a single server instance. In that case, the
returned list will comprise more elements, each describing the status of
a different relationship in which the server participates. Currently, it
is only one status.
.. note::
In Kea 1.7.8 an incompatible change was introduced to the syntax of the
``status-get`` response. Previously, the HA status for a single relationship
was returned within the ``arguments`` map. Currently, the returned status
is enclosed in the list as described above. Any existing code relying on the
previous syntax must be updated to work with the new Kea versions.
The ``ha-servers`` map contains two structures: ``local`` and ``remote``. The former The ``ha-servers`` map contains two structures: ``local`` and ``remote``. The former
contains the status information of the server which received the command. The contains the status information of the server which received the command. The