Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Info

This article helps troubleshoot the Python module that is used for the updater.

Status
colourGreen
titleLAST TESTED ON CHECKMK 2.3.0P1

Panel
borderColorblack
bgColor#f8f8f8
titleTable of Contents
Table of Contents

Tip

This will be fixed in Checkmk version 2.4. Werk #17202: Distributed piggyback: Piggyback data for distributed setups

Problem: zipped Python module

During the registration of the Check_MK Updater on Windows, you may face this issue:

Code Block
languagepowershellnone
themeRDark
C:\Program Files (x86)\checkmk\service>check_mk_agent.exe updater -vv
       You must install Python Module to use the updater with parameters '-vv'. 
       To install Python Module you should use Bakery.

Note

Please make sure that you open the cmd/PowerShell as an administrator!

The problem is that the Python module was not successfully unzipped during the updater process:Screenshot of the checkmk agent modules directory within windows. The python-3.8.zip file is selected.Image Removed

...


Or the folder is completely emptyScreenshot of the checkmk agent modules directory within windows. The folder is empty.Image Removed

...

A possible workaround

If you have only a python_x.cap file 

...

Reinstall the Python (if the folder is zipped)

Code Block
languagepowershellnone
themeRDark
mkdir C:\ProgramData\checkmk\agent\modules\python-3 & expand C:\ProgramData\checkmk\agent\install\modules\python-3.cab -F:* C:\ProgramData\checkmk\agent\modules\python-3 && cd C:\ProgramData\checkmk\agent\modules\python-3 && call postinstall.cmd

...

Code Block
theme
languagepowershellRDark
expand C:\ProgramData\checkmk\agent\install\modules\python-3.cab -F:* C:\ProgramData\checkmk\agent\modules\python-3 && cd C:\ProgramData\checkmk\agent\modules\python-3 && call postinstall.cmd

...

Code Block
languagepowershell
themeRDark
mkdir C:\ProgramData\checkmk\agent\modules\python-3.8 & expand C:\ProgramData\checkmk\agent\install\modules\python-3.8.zip -F:* C:\ProgramData\checkmk\agent\modules\python-3.8 && cd C:\ProgramData\checkmk\agent\modules\python-3.8  && call postinstall.cmd

...

Code Block
theme
languagepowershellRDark
expand C:\ProgramData\checkmk\agent\install\modules\python-3.8.zip -F:* C:\ProgramData\checkmk\agent\modules\python-3.8 && cd C:\ProgramData\checkmk\agent\modules\python-3.8  && call postinstall.cmd

...

Increase the timeout of the updater

Via bakery

Go to Setup → Agents → Windows, Linux, Solaris, AIXAgent rulesSet timeouts for plugins and local checksScreenshot of set timeouts for plugins and local checks. The script patterns is cmk_update_agent.checkmk.pyImage Removed

...

Script Pattern: cmk_update_agent.checkmk.py

...

After saving the rule, you must bake and sign the new agent!

Here, we described in detail how to configure caching and timeout for Windows plugins:  Asynchronous execution of Windows plugins

Via config file

...

...

C:\ProgramData\checkmk\check_mk.user.yml
Code Block
languagepowershell
plugins:
enabled: true
execution:
cache_age: 86400
pattern: $CUSTOM_PLUGINS_PATH$\cmk_update_agent.checkmk.py
timeout: 180

...

Code Block
languagepowershell
themeRDark
{code:title=test|theme=RDark}
C:\ProgramData\checkmk
C:\Program Files (x86)\checkmk
{code}

Reinstall python

Code Block
languagebashthemeRDark
:: Reinstall Checkmk Python module for Windows agent
@echo off
if not exist "%ProgramData%\checkmk\agent\install\modules\python-3.8.zip" (
echo "%ProgramData%\checkmk\agent\install\modules\python-3.8.zip" is absent, impossible to reinstall
exit  /b 1
)
cd %ProgramData%\checkmk\agent || echo "Windows agent is not installed" && exit /b 11
net stop checkmkservice
mkdir modules\python-3.8
cd modules\python-3.8
expand %ProgramData%\checkmk\agent\install\modules\python-3.8.zip -F:* %ProgramData%\checkmk\agent\modules\python-3.8 1>nul
call postinstall.cmd
net start checkmkservice

Filter by label (Content by label)
showLabelsfalse
max5
spacesKB
showSpacefalse
sortmodified
reversetrue
typepage
cqllabel in ( "windows" , "windows_agent" , "python" ) and type = "page" and space = "KB"
labelssecurity
Page Properties
hiddentrue

Related issues