Skip to content

Checkmk/cmk-dev-site

Repository files navigation

cmk-dev-site

Easy Install Checkmk

Scripts to install bleeding edge Checkmk in development context.

If you are a regular Checkmk customer you probably don't want to use this, as this tools remove sites without warning.

Installation

sudo apt install pipx
pipx ensurepath
# check output of this command. you might have to open a fresh terminal!
pipx install cmk-dev-site

For updating you can use:

pipx upgrade cmk-dev-site

Usage

# Download and install latest available daily build of 2.5.0
cmk-dev-install 2.5 && cmk-dev-site
# (will fall back to the daily builds of yesterday)

# Download daily build of today and
# setup distributed monitoring with one two sites:
cmk-dev-install 2.5.0-daily && cmk-dev-site -d 1

# Download and install raw edition package
cmk-dev-install --edition=cre 2.5.0-daily

cmk-dev-install

Will download the requested package of Checkmk and install said package.

You might request a daily build (cmk-dev-install 2.5.0-daily), the latest available daily build (handy if there are no daily builds of today) (cmk-dev-install 2.5), or an officially release Checkmk version (cmk-dev-install 2.4.0p9).

Please check the built in help (cmk-dev-install --help) for all options!

cmk-dev-site

Will create a site, install the checkmk agent, and add a single host to the site.

cmk-dev-site uses omd commands and the official REST-API to create one or multiple sites based on the current default omd version (or the version specified on the command line).

You might use -d 1 to create a distributed monitoring with one distributed site.

Please check the built in help (cmk-dev-site --help) for all options!

Cleanup

Currently there is no public available tool to completely cleanup sites and packages create with the presented tools. If you are a Checkmk developer you might make use of the internal tool omd-hauweg, otherwise you have to manually remove the sites using omd rm and uninstall the packages using apt purge.

Contributing

If you'd like to make contributions to the tool, check out our development documentation. Here you'll see steps on how to setup your environment for local development.

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Contributors 8

Languages