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
languagepowershell
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 PowerShell as an administrator!


The problem is , that the python Python module either 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 Added

...


or Or the folder is completety completely empty

...

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

...

Image Removed

A possible workaround

...

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
languagepowershell
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
languagepowershell
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
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

Reinstall

...

the Python (if the folder is empty)

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

...

Increase the timeout of the updater

Via bakery

Go to Setup → Agents → Windows, Linux, Solaris, AIX → AIXAgent rules → Set Set timeouts for plugins and local checks

...

Screenshot of set timeouts for plugins and local checks. The script patterns is cmk_update_agent.checkmk.pyImage Added

Script Pattern: cmk_update_agent.checkmk.py


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

Here we described in a detailed way detail how to configure caching and timeout for Windows plugins:    Asynchronous execution of Windows plugins. 

Via config file

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

...

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

Code Block
languagepowershell
themeRDark
C:\ProgramData\checkmk
C:\Program Files (x86)\checkmk

...

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

...

Filter by label (Content by label)
showLabelsfalse
max5
spacesKB
showSpacefalse
sortmodified
reversetrue
typepage
cqllabel in ( "agent_bakery","python","agentwindows" , "windows_agent" , "windowspython" ,"updater" ) and type = "page" and space = "KB"
labelswindows updater agent agent_bakery windows_agent pythonsecurity

Page Properties
hiddentrue


Related issues


...