omdclient 1.4.2__tar.gz → 2.0.0__tar.gz

omdclient-2.0.0/LICENSE

@@ -0,0 +1,4 @@
+Copyright 2015-2026, Fermi National Accelerator Laboratory
+
+This program is free software; you may redistribute it and/or modify
+it under the same terms as Perl.

{omdclient-1.4.2 → omdclient-2.0.0}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.1
 Name: omdclient
-Version: 1.4.2
-Summary: omdclient check_mk + WATO/OMD interface
+Version: 2.0.0
+Summary: omdclient check_mk API interface
 Home-page: https://github.com/tskirvin/omdclient/
 Author: Tim Skirvin
 Author-email: tskirvin@fnal.gov
@@ -13,12 +13,12 @@ Description: # omdclient
         omdclient provides a suite of command-line tools to interact with the APIs
         associated with the `check_mk`/Open Monitoring Distribution tool suite.
         
-        ## WATO APIs
+        ## check\_mk API
         
-        WATO is used to create, remove, and modify entries within the OMD user
-        suite.  This is documented at:
+        <https://docs.checkmk.com/latest/en/rest_api.html>
         
-        <http://mathias-kettner.com/checkmk_wato_webapi.html>
+        This interface has been standard since about check\_mk 2.0.  It's more
+        powerful and more complex than their old WATO API.
         
         ### omd-activate
         
@@ -41,10 +41,6 @@ Description: # omdclient
         
         Reinventory a host in OMD.
         
-        ## Multisite/Nagios
-        
-        <https://mathias-kettner.de/checkmk_multisite_automation.html>
-        
         ### omd-nagios-ack
         
         Acknowledges host/service alerts from the command-line.
@@ -81,38 +77,6 @@ Description: # omdclient
         
             OMDCONFIG=/tmp/myconfig.yaml omd-activate
         
-        ### Configuration of 'expanded views'
-        
-        The report scripts depend on 'expanded view' versions of the
-        `hostproblems` and `svcproblems` views, which add comments.  In order to
-        add these, you generally have to:
-        
-        1.  Edit view `hostproblems` - it's a default view, so you'll go to 'clone'.
-            * Change the name from `hostproblems` to `hostproblems_expanded`.
-            * Update the list of columns to read:
-                1. Hostname
-                2. Host icons
-                3. Host state
-                4. Output of host check plugin
-                5. Number of services in state OK
-                6. Number of services in state WARN
-                7. Number of services in state UNKNOWN
-                8. Number of services in state CRIT
-                9. Number of services in state PENDING
-                10. The age of the current host state
-                11. Host comments
-            * (newer versions) set to 'public' and 'hidden'.
-            * Save.
-        2.  Edit the view `svcproblems` and created `svcproblems_expanded`, same
-            as above but just add the column `Service Comments`.
-        
-        In newer versions of check\_mk, you may also need to make these views
-        Public (check `Visibility` / `Make this view available for other users` /
-        `Publish to all users`).  Also, the `hostproblems` base view may have
-        changed: I have for `hostproblems_expanded`:
-        
-        (Thanks to Christian Bryn - https://github.com/epleterte - for the docs!)
-        
         ## How To Build
         
         There is a `Makefile.bak` and a `*.spec` file that mirrors my local build
@@ -125,12 +89,18 @@ Description: # omdclient
         `pod2man` if you're ambitious; and run `python setup.py install` to
         install the python library.
         
+        Also possible to do it all with pipx:
+        
+            pipx install .
+            pipx runpip omdclient install -r requirements.txt
+        
         ### Debian
         
             make -f Makefile.deb build
         
         That should build a full .deb package.
         
-Keywords: check_mk,omd,nagios,api,wato
+Keywords: check_mk,omd,nagios,api
 Platform: UNKNOWN
 Description-Content-Type: text/markdown
+License-File: LICENSE

{omdclient-1.4.2 → omdclient-2.0.0}/README.md

@@ -3,12 +3,12 @@
 omdclient provides a suite of command-line tools to interact with the APIs
 associated with the `check_mk`/Open Monitoring Distribution tool suite.
 
-## WATO APIs
+## check\_mk API
 
-WATO is used to create, remove, and modify entries within the OMD user
-suite.  This is documented at:
+<https://docs.checkmk.com/latest/en/rest_api.html>
 
-<http://mathias-kettner.com/checkmk_wato_webapi.html>
+This interface has been standard since about check\_mk 2.0.  It's more
+powerful and more complex than their old WATO API.
 
 ### omd-activate
 
@@ -31,10 +31,6 @@ update/remove a given host tag in OMD
 
 Reinventory a host in OMD.
 
-## Multisite/Nagios
-
-<https://mathias-kettner.de/checkmk_multisite_automation.html>
-
 ### omd-nagios-ack
 
 Acknowledges host/service alerts from the command-line.
@@ -71,38 +67,6 @@ configs, e.g.:
 
     OMDCONFIG=/tmp/myconfig.yaml omd-activate
 
-### Configuration of 'expanded views'
-
-The report scripts depend on 'expanded view' versions of the
-`hostproblems` and `svcproblems` views, which add comments.  In order to
-add these, you generally have to:
-
-1.  Edit view `hostproblems` - it's a default view, so you'll go to 'clone'.
-    * Change the name from `hostproblems` to `hostproblems_expanded`.
-    * Update the list of columns to read:
-        1. Hostname
-        2. Host icons
-        3. Host state
-        4. Output of host check plugin
-        5. Number of services in state OK
-        6. Number of services in state WARN
-        7. Number of services in state UNKNOWN
-        8. Number of services in state CRIT
-        9. Number of services in state PENDING
-        10. The age of the current host state
-        11. Host comments
-    * (newer versions) set to 'public' and 'hidden'.
-    * Save.
-2.  Edit the view `svcproblems` and created `svcproblems_expanded`, same
-    as above but just add the column `Service Comments`.
-
-In newer versions of check\_mk, you may also need to make these views
-Public (check `Visibility` / `Make this view available for other users` /
-`Publish to all users`).  Also, the `hostproblems` base view may have
-changed: I have for `hostproblems_expanded`:
-
-(Thanks to Christian Bryn - https://github.com/epleterte - for the docs!)
-
 ## How To Build
 
 There is a `Makefile.bak` and a `*.spec` file that mirrors my local build
@@ -115,6 +79,11 @@ in `*.spec`.  Scripts from `usr/bin/*` go into your path; create
 `pod2man` if you're ambitious; and run `python setup.py install` to
 install the python library.
 
+Also possible to do it all with pipx:
+
+    pipx install .
+    pipx runpip omdclient install -r requirements.txt
+
 ### Debian
 
     make -f Makefile.deb build