https://github.com/cloudlinux/kcare-scripts
Kernelcare scripts
https://github.com/cloudlinux/kcare-scripts
Last synced: 26 days ago
JSON representation
Kernelcare scripts
- Host: GitHub
- URL: https://github.com/cloudlinux/kcare-scripts
- Owner: cloudlinux
- License: apache-2.0
- Created: 2021-02-01T07:49:05.000Z (about 5 years ago)
- Default Branch: master
- Last Pushed: 2025-08-04T11:26:10.000Z (6 months ago)
- Last Synced: 2025-10-11T05:47:16.787Z (4 months ago)
- Language: Python
- Size: 27.3 KB
- Stars: 1
- Watchers: 2
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# KernelChecker
## kernelcheker.py
KernelChecker was created to allow control panels to easily detect & advise
users on updating running kernel. It can be used to promote KernelCare
through the control panel. One of the goals behind creating this script was to to make it easier for control
panel providers to setup effective affiliate program with KernelCare to generate extra income.
If you are interested in affiliate program, contact us at sales@kernelcare.com
The purpose of KernelChecker is to determine if:
* newer kernel is available
* if update / reboot is needed
* if KernelCare (http://kernelcare.com) is installed
* if latest patches are installed using KernelCare
The script should work on dpkg & RPM based distributions. It should be able to detect if it is running inside container (Virtuozzo & LXC)
By defalt it produces YAML output. Additionally it understands --json / -j command line options that causes it to produce output in JSON
Usage:
```bash
python kernelchecker.py [--json]
```
Example output:
```YAML
latest : 3.13.0-79-generic
current : 3.13.0-79-generic
distro : dpkg
needs_update : False
latest_installed : True
latest_available : True
inside_container : False
kernelcare :
installed : False
up2date : False
supported : True
```
* latest --> Latest available kernel
* current --> current booted kernel
* distro --> more like package manager, possible values: dpkg, rpm & unknown
* needs_update --> newer kernel exits, reboot will be needed
* latest_installed --> latest kernel already installed, no need to run yum update/etc...
* inside_container --> if True, other values could be ignored, as we are running inside container and cannot update kernel
* kernelcare : installed --> if True, KernelCare installed
* kernelcare : up2date --> if True, kernel is patched with all the security patches, no need to update kernel (even if needs_update shows up)
* kernelcare : supported --> if True, KernelCare supports this kernel, if False - KernelCare doesn't support this kernel
Some example of usages / advising customer based on results:
```
if inside_container == True: do nothing
// customer should not be advised to update/reboot no matter what
// as customer doesn't have ability to do so.
// Also, node kernel might be patched using KernelCare or other tools.
else if needs_update == False : customer running latest kernel, nothing needs to be done
else if kernelcare.up2date == True: nothing needs to be done, Kernel is patched with KernelCare
else if needs_update == False {
if kernelcare.installed: ask customer to run kcarectl --update
else if kernelcare.supported: ask customer to deploy KernelCare
else if latest_installed: ask customer to reboot
else: ask customer to update using yum update/apt-get update, and reboot_
}
```
## kc-compat.py
Checks if server is running kernel compatible with KernelCare.
Usage:
```bash
python kc-compat.py [--silent|-q]
```
Outputs:
- `COMPATIBLE` if kernel supported
- `NEEDS REVIEW` manual validation is required
- `UNSUPPORTED; INSIDE CONTAINER` if running inside a container
- `CONNECTION ERROR; HTTP ` or `CONNECTION ERROR; ` for network issues
- `SYSTEM ERROR; ` for file system issues
- `UNEXPECTED ERROR; ` for other errors
If --silent flag is provided -- doesn't print anything
Exit codes:
- 0: compatible
- 1: needs review
- 2: unsupported, inside container
- 3: connection error
- 4: system error
- 5: unexpected error
Alternatively you can use:
```bash
curl -s https://raw.githubusercontent.com/cloudlinux/kcare-scripts/master/kc-compat.py | python
```
or
```bash
wget -qq -O - https://raw.githubusercontent.com/cloudlinux/kcare-scripts/master/kc-compat.py | python
```
_Note: You cannot use exit code in this case, only output_