1. Overview
2. Module Description
3. Usage - Configuration options and additional functionality
4. Reference
5. Limitations
6. Development
7. Copyright

This module installs, configures, and manages kernelcare for rebootless kernel upgrades.

The kernelcare module installs, configures, and manages kernelcare to update your kernel without needing to reboot.

A license key from cloudlinux is required to use kernelcare longer than 30 days.

The module will install the kernelcare repository, install the kernelcare package, and manage the kernelcare configuration file.

This module follows semantic versioning.

If you have a license key and want to check for kernel updates every 30 minutes and automatically install them. This is what the normal manual installation of kernelcare will do.

class { '::kernelcare':
  config_managekey => true,
  config_accesskey => 'YOUR_LICENSE_KEY',
}

By default kcarectl runs every 30 minutes unless you give it a custom cron time.

class { '::kernelcare':
  config_managekey => true,
  config_accesskey => 'YOUR_LICENSE_KEY',
  cron_minute      => '13',
  cron_hour        => '03',
  cron_month       => '*',
  cron_monthday    => '*',
  cron_weekday     => '*',
}

• kernelcare::repo: Installs the package repository on the server
• kernelcare::install: Installs the kernelcare package on the server
• kernelcare::config: Manages the configuration for kernelcare
• kernelcare::cron: Manages the cron job for kernelcare
• kernelcare::service: Manages the kcare service

Can be used to remove kernelcare. Acceptable values being undef and absent. Default value: 'undef'

Specifiy if kcare.conf and freezer.modules.blacklist should exist. Default value: 'present'

Specify a custom template to use for /etc/sysconfig/kcare/kcare.conf. Default value: 'kernelcare/kcare.conf.erb'

Specify a custom template to use for /etc/sysconfig/kcare/freezer.modules.blacklist. Default value: 'kernelcare/freezer.modules.blacklist.erb'

Specify kernel modules to insert into /etc/sysconfig/kcare/freezer.modules.blacklist. Default value: ['vxodm', 'vxportal', 'vxfen', 'vxspec', 'vxio']

Specify if the license should be managed. Default value: false

Specify your license. Default value: 'INSERT_ACCESS_KEY'

Specify if the server should be registered. Default value: 'present'

kcarectl --auto runs in a cron job to check for and download new updates. You can can configure this cron job to automatically install new updates as they become available. Default value: 'true'

Specify a hash of options used in the kcare.conf template. Default value: {}

Specify if you want the module to manage the kernelcare cron job. Default value: true

Specify if you want the cron job to be present. Default value: 'present'

Specify a custom cron_minute. Default value: [fqdn_rand(30) , fqdn_rand(30) + 30]

Specify a custom cron_hour. Default value: '*'

Specify a custom cron_month. Default value: '*'

Specify a custom cron_monthday. Default value: '*'

Specify a custom cron_weekday. Default value: '*'

Specify if you want the module to install the kernelcare repo. Default value: 'true'

Specify a custom name for the yum and apt repo. Default value: 'kernelcare'

Specify a custom description for the yum repo. Default value: 'kernelcare'

Specify a baseurl_prefix for the yum repo. Default value: 'https://repo.cloudlinux.com/kernelcare'

Specify a baseurl_prefix for the apt repo. Default value: 'https://repo.cloudlinux.com/kernelcare-debian/8'

Specify the release branch to use for the apt repo. Default value: 'stable'

Specify the repos (space delimited) to use for the apt repo. Default value: 'main'

Specify the enable value for the yum and apt repo. Default value: true

Specify the gpgcheck value for the yum repo. Default value: true

Specify a custom url or path for the GPG key for the packages in the yum repo. Default value: 'https://repo.cloudlinux.com/kernelcare/RPM-GPG-KEY-KernelCare'

Specify a custom key id for the apt repo. Default value: '6DC3D600CDEF74BB'

Specify a custom url for the apt key. Default value: 'https://repo.cloudlinux.com/kernelcare-debian/8/conf/kcaredsa_pub.gpg'

Specify the name of the kernelcare package. Default value: 'kernelcare'

Specify a version of status for the kernelcare package. Default value: 'present'

Specify if the service should be managed. Default value: 'true'

Specify the name of the kernelcare service. Default value: 'kcare'

Specify if the service should be running/stopped. Default value: 'running'

kcare-uname will print out the effective version of kernel after patching. It accepts uname(1) command-line options and produces compatible output. There are facts, using kcare-uname, corresponding to the kernel facts that already come with facter.

• kernelcare_kernelrelease: effective kernel release
• kernelcare_kernelversion: effective kernel version
• kernelcare_kernelmajversion: effective kernel major version

Install necessary gems:

bundle install --path vendor/bundle

Check syntax of all puppet manifests, erb templates, and ruby files:

bundle exec rake validate

Run puppetlint on all puppet files:

bundle exec rake lint

Run spec tests in a clean fixtures directory

bundle exec rake spec

Run acceptance tests with a kernelcare license:

KERNELCARE_LICENSE=abc123 PUPPET_INSTALL_TYPE=agent BEAKER_set=centos-7-x64 bundle exec rake acceptance

Run acceptance tests on docker without a kernelcare license (faster):

PUPPET_INSTALL_TYPE=agent BEAKER_set=docker/centos-7-x64 bundle exec rake acceptance

Copyright 2017 Nexcess

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.