|
| 1 | +[//]: # (werk v3) |
| 2 | +# Fix system executables failing due to Checkmk's OpenSSL being loaded via LD_LIBRARY_PATH |
| 3 | + |
| 4 | +key | value |
| 5 | +---------- | --- |
| 6 | +date | 2026-04-10T17:16:28.506025+00:00 |
| 7 | +version | 2.6.0b1 |
| 8 | +class | fix |
| 9 | +edition | community |
| 10 | +component | omd |
| 11 | +level | 2 |
| 12 | +compatible | yes |
| 13 | + |
| 14 | +Previously, Checkmk's site environment included `$OMD_ROOT/lib` in `LD_LIBRARY_PATH` |
| 15 | +so that Checkmk's own processes could find the bundled shared libraries. The unintended |
| 16 | +side effect: system executables invoked from within the site environment (e.g. `ssh`, |
| 17 | +`curl`, `openssl`, `zypper`, `systemctl`, `php`) would also pick up Checkmk's bundled |
| 18 | +OpenSSL instead of the system's version. On distributions where the two versions were |
| 19 | +incompatible, those commands would fail with errors such as: |
| 20 | + |
| 21 | +``` |
| 22 | +/usr/bin/systemctl: /omd/sites/mysite/lib/libcrypto.so.3: version OPENSSL_3.4.0 not found |
| 23 | +``` |
| 24 | + |
| 25 | +As a workaround, Checkmk shipped wrapper scripts that unset `LD_LIBRARY_PATH` before |
| 26 | +invoking the real system executable for a list of commonly affected commands. |
| 27 | + |
| 28 | +We have now fixed the root cause: all Checkmk-shipped ELF binaries have their RUNPATH |
| 29 | +correctly set so they locate their bundled libraries directly, without relying on |
| 30 | +`LD_LIBRARY_PATH`. As a result, `$OMD_ROOT/lib` is no longer added to `LD_LIBRARY_PATH`, |
| 31 | +and the workaround wrapper scripts have been removed. |
| 32 | + |
| 33 | +`LD_LIBRARY_PATH` still includes `$OMD_ROOT/local/lib` to support native libraries |
| 34 | +installed by site users (e.g. via MKPs). If you have placed a native shared library in |
| 35 | +`local/lib` that is incompatible with a system executable, that executable may still fail |
| 36 | +— but this is a rare edge case and can be resolved by removing the conflicting library. |
0 commit comments