About to upgrade from 2.3 to 2.5 - any gotchas?

General
1

We are upgrading our Enterprise Checkmk multi site installation from 2.3 to 2.4 and then to 2.5 in more-or-less one hit.

Any gotchas with agents or anything else? I’m not seeing any significant red flags in the release notes, other than the additional resources needed.

2

Couple of things we usually do when upgrading through multiple versions:

  • Startup and activate changes at each version update. Ie..when you upgrade 2.3 → 2.4 startup the site, activate changes and let it run a few minutes.
  • Usually manually disable all mkp’s at the start of the upgrade sequence.
  • Move any local checks on the CMK host out of the $OMD_ROOT/local/share/check_mk/checks/ to a backup location.
  • Agent Bakery - optionally you could bake the agents at each step but disable the auto-update from applying until you get to the target release.
  • Patch each release to the latest before upgrading..ie..you want to go from 2.3 latest → 2,4 latest, 2.4 latest → 2.5 latest.

High level approach is to exercise the main parts of Checkmk being used at each version level as a gate before proceeding to the next. Take an approach of using more incremental steps than one big bang.

Depending on your footprint you will see additional RAM usage 2.3 → 2.4.

I always take a config copy of the main site (exclude logs and RRD) as a minimum, test the upgrade path on the “upgrade” site before going anywhere near prod.

Any custom checks or plugins that were written on the old API will need to be recoded to run on the new API.

3

Hey rdm,

From 2.4p23 to latest at that moment 2.4p33 we had to increase the nbt of fetchers into one of our remote site, so might be the same for you.

Old http checks have been deprecated so you will have to rework them if you have any. 2.5 comes with windows time check and Stratum value being critical at 5, we had to “disable” it at 3 different places.

Do not forget to first upgrade remote sites before the “master” in distributed env.

Don’t recall any other funny stuff, it was pretty smooth.

Regards,

Vincent