1 Sep
2020
1 Sep
'20
10:52 a.m.
Branch: refs/heads/master
Home: https://github.com/tribe29/checkmk
Commit: edb687483863bf1b37858d41297bb0ebcda34b98
https://github.com/tribe29/checkmk/commit/edb687483863bf1b37858d41297bb0ebc…
Author: Joerg Herbel <joerg.herbel(a)tribe29.com>
Date: 2020-09-01 (Tue, 01 Sep 2020)
Changed paths:
A .werks/11363
M checkman/if64
M checkman/if64adm
M checks/if.include
R checks/if64
R checks/if64adm
M cmk/base/api/agent_based/utils.py
M cmk/base/config.py
M cmk/base/plugins/agent_based/agent_based_api/v0/__init__.py
A cmk/base/plugins/agent_based/if64.py
A cmk/base/plugins/agent_based/if64adm.py
M cmk/base/plugins/agent_based/lnx_if.py
A cmk/base/plugins/agent_based/utils/if64.py
M cmk/base/plugins/agent_based/utils/interfaces.py
M cmk/gui/plugins/wato/check_parameters/if.py
M cmk/utils/defines.py
M tests/testlib/base.py
M tests/unit/checks/test_generic_legacy_conversion.py
M tests/unit/cmk/base/plugins/agent_based/test_lnx_if.py
M tests/unit/cmk/base/plugins/agent_based/utils/test_interfaces.py
Log Message:
-----------
11363 if64, if64adm: Monitoring of the admin status <tt>ifAdminStatus</tt>
for switch ports
The 64-bit version of the interface check for switch ports can be configured
to also monitor the admin status <tt>ifAdminStatus</tt>. If this option is
activated, checkmk uses the check plugin <tt>if64adm</tt> instead of
<tt>if64</tt>. Up to now, only an <tt>ifAdminStatus</tt> of 2 was
reported by
setting the port state to <i>9 - admin down</i>. With this werk, the admin
status is now monitored completely separately from the port state. Consequently,
the port state <i>9 - admin down</i> is not available any more.
Previously, the monitoring of the admin state was activated implicitly by configuring
checkmk to discover ports in the state <i>9 - admin down</i> (rule
"Network Interface
and Switch Port Discovery"). Now, this is handled in a separate rule: "SNMP
Interface
check: Monitor <tt>ifAdminStatus</tt> (use <tt>if64adm</tt>
instead of <tt>if64</tt>)".
If and only if this rule is activated, the admin status will be monitored, independently
of the configuration in "Network Interface and Switch Port Discovery".
Furthermore, since the admin status is now reported separately from the port state,
it can also be used to configure 1) the discovery of network interfaces (rule
"Network
Interface and Switch Port Discovery"), 2) the monitoring state (rule "Network
interfaces
and switch ports"). For example, you can make checkmk discover only interfaces with
an admin status of 2 or you can set the monitoring state of all interfaces with an
amdin status of 1 to WARNING. Note that these configuration options only have an
effect if the admin status is actually monitored, i.e., if the new rule mentioned
above is activated.
This change is incompatible for all users who are currently monitoring the admin
status using <tt>if64adm</tt>. These users should follow these steps:
<ul>
<li>Activate the monitoring of the admin status using the new rule "SNMP
Interface
check: Monitor <tt>ifAdminStatus</tt> (use <tt>if64adm</tt>
instead of <tt>if64</tt>)".
</li>
<li>Check the discovery configuration (rule "Network Interface and Switch Port
Discovery"). As mentioned above, the admin state can now be used to further refine
the
discovery of network interfaces. On the other hand, the port state <i>9 - admin
down</i>
is not available any more, so users might have to adjust their configurations.</li>
<li>Re-discover the services of affected hosts.</li>
<li>Check the monitoring configuration (rule "Network interfaces and switch
ports").
Analogously to the discovery configuration, the admin state can now be used to set
the monitoring state of network interfaces and the port state <i>9 - admin
down</i>
is not available any more.</li>
</ul>
This change also migrates the check plugins if64 and if64adm to the new
API.
CMK-5181
Change-Id: Iae7b05f1a201a7a2490f827cd5d3d70d26902caa