Version information
This version is compatible with:
- Puppet Enterprise 2023.2.x, 2023.1.x, 2023.0.x, 2021.7.x, 2021.6.x, 2021.5.x, 2021.4.x, 2021.3.x, 2021.2.x, 2021.1.x, 2021.0.x, 2019.8.x
- Puppet >= 6.21.0 < 8.0.0
- ,
Start using this module
Add this module to your Puppetfile:
mod 'zaben-checkmk', '0.1.0'
Learn more about managing modules with a PuppetfileDocumentation
checkmk
Description
Provision CheckMK server and client.
Usage
To set up a CheckMK server:
class { '::checkmk':
mode => 'server',
download_url => 'https://download.checkmk.com/checkmk/2.1.0p14/check-mk-raw-2.1.0p14_0.jammy_amd64.deb', # Where to download the CheckMK server package from
sha256_hash => '8804c0291e897f6185b147613a5fc86d61c0bcf73eaac5b11d90afe58af10c9f', # SHA256 hash of the downloaded package
automation_user_password => '', # Password for the `automation` user, this can be configured after the server has been started
}
This will provision a CheckMK server with default configuration. This can be accessed from: http://<server-ip>/default
.
To login, the cmkadmin
user password must be set by running htpasswd /omd/sites/default/etc/htpasswd cmkadmin <password>
on the server.
Once logged in the automation
user password can be set by going to Setup
-> Users
-> Users
-> automation
-> Automation secret for machine accounts
.
To set up a CheckMK agent:
class { '::checkmk':
mode => 'agent',
agent_download_protocol => 'http', # The protocol that should be used when talking to the CheckMK server
agent_download_host => 'checkmk.example.com', # The hostname or IP address of the CheckMK server
}
All configurations can be set using Hiera.
---
checkmk::mode: 'server'
checkmk::download_url: 'https://download.checkmk.com/checkmk/2.1.0p14/check-mk-raw-2.1.0p14_0.jammy_amd64.deb'
checkmk::sha256_hash: '8804c0291e897f6185b147613a5fc86d61c0bcf73eaac5b11d90afe58af10c9f'
checkmk::automation_user_password: ''
Limitations
Currently only tested and supported Debian based systems.
Development
To contribute to this module, please fork the repository and submit a pull request. All commits should be squashed into a single commit and the commit message should follow the Conventional Commits specification.