mailcow-dockerized-docs/docs/third_party/checkmk/u_e-checkmk.en.md

54 Zeilen
2,1 KiB
Markdown

2023-01-13 18:16:08 +01:00
mailcow provides the ability to check for updates using its own update script.
2022-07-17 15:27:36 +02:00
If you want to check for mailcow updates using checkmk, you can create an executable file in the `local` directory of the checkmk agent (typically `/usr/lib/check_mk_agent/local/`) with the name `mailcow_update` and the following content:
````
#!/bin/bash
cd /opt/mailcow-dockerized/ && ./update.sh -c >/dev/null
status=$?
if [ $status -eq 3 ]; then
echo "0 \"mailcow_update\" mailcow_update=0;1;;0;1 No updates available."
elif [ $status -eq 0 ]; then
echo "1 \"mailcow_update\" mailcow_update=1;1;;0;1 Updated code is available.\nThe changes can be found here: https://github.com/mailcow/mailcow-dockerized/commits/master"
else
echo "3 \"mailcow_update\" - Unknown output from update script ..."
fi
exit
````
If the mailcow installation directory is not `/opt/`, adjust this in the 2nd line.
After that re-inventory the services for your mailcow host in checmk and a new check named `mailcow_update` should be selectable.
2022-11-04 21:38:16 +01:00
This will run the `mailcow_update` everytime checkmk agent is checked, you can cache the result by placing the script in a subfolder named the number of seconds you wish to cache it. \
`/usr/lib/check_mk_agent/local/3600/` will cache the response for an 3600 seconds (1 hour).
2022-07-17 15:27:36 +02:00
## Screenshots
### No updates available
If there are no updates available, `OK` is displayed.
![No update available](../../assets/images/checkmk/no_updates_available.png)
### New updates available
If updates are available, `WARN` is displayed.
![Updates available](../../assets/images/checkmk/updates_available.png)
If `CRIT` is desired instead, replace the 7th line with the following:
````
echo "2 \"mailcow_update\" mailcow_update=1;1;;0;1 Updated code is available.\nThe changes can be found here: https://github.com/mailcow/mailcow-dockerized/commits/master"
2022-07-17 15:27:36 +02:00
````
### Detailed check output
![Long check output](../../assets/images/checkmk/long_check_output.png)
- This provides a link to mailcow's GitHub commits, if updates are available.
- Metrics are also displayed ( not only when updates are available):
- 0 = No updates available
- 1 = New updates available