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.



Panel
borderColor#CCCCCC
bgColor#e3fcef

LAST 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
languagebash
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 selectedImage RemovedScreenshot of the Checkmk agent modules directory within windows. The python-3.8.zip file is selectedImage Added



Or the folder is completely empty

Screenshot of the Checkmk agent modules directory within windows. The folder is empty.Image RemovedScreenshot of the Checkmk agent modules directory within windows. The folder is empty.Image Added



A possible workaround

If you have only a python_x.cap file 

For some reason, you may have only one python_x.cap file in your folder. In that case, you have these two options:

Reinstall the Python (if the folder is zipped)

Code Block
languagebash
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

Reinstall the Python (if the folder is empty)

Code Block
languagebash
themeRDark
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

Reinstall the Python (if the folder is zipped)

Code Block
languagebash
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

Reinstall the Python (if the folder is empty)

Code Block
languagebash
themeRDark
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

Solutions

Increase the timeout of the updater

Via bakery

Go to Setup → Agents → Windows, Linux, Solaris, AIXAgent rulesSet timeouts for plugins and local checks
Screenshot of set timeouts for plugins and local checks. The script patterns are cmk_update_agent.checkmk.pyImage RemovedScreenshot of set timeouts for plugins and local checks. The script patterns are cmk_update_agent.checkmk.pyImage Added


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
languagebash
themeRDark
 plugins:
enabled: true
execution:
cache_age: 86400
pattern: $CUSTOM_PLUGINS_PATH$\cmk_update_agent.checkmk.py
timeout: 180


Create an exception for the AV

Please create an exception for the following paths for the AV:

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

Reinstall python

Code Block
languagebash
themeRDark
:: 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

Related articles

Filter by label
showLabelsfalse
max5
spacesKB
showSpacefalse
sortmodified
reversetrue
typepage
cqllabel = "windows" and type = "page" and space = "KB"
labelsagent_bakery user_roles_permissions roles user

Page Properties
hiddentrue


Related issues