CDIST-TYPE__XYMON_CONFIG

NAME

cdist-type__xymon_config - Deploy a Xymon configuration-directory

DESCRIPTION

This cdist type deploys a full Xymon configuration directory from the files-dir to the host. This type requires an installed Xymon server, e.g. deployed by __xymon_server.

WARNING: This type _replaces_ the /etc/xymon/-directory! The previous contents is replaced/deleted!

REQUIRED PARAMETERS

confdir

The directory in ./files/ that contains the /etc/xymon/-content to be deployed.

OPTIONAL PARAMETERS

	owner		passed as-is as --owner to __rsync
	group		passed as-is as --group to __rsync

OPTIONAL MULTIPLE PARAMETERS

rsync-opts

identical to __rsync type, only ---options are supported

REQUIRED FILES

The directory specified by confdir has to contain a valid xymon-configuration (/etc/xymon/) _plus_ the ext/-directory that normally resides in /usr/lib/xymon/server/.

EXAMPLES

__xymon_config --confdir=xymon.example.com
# this will replace /etc/xymon/ on the target host with
# the contents from __xymon_config/files/xymon.example.com/

## the same but set ownership to `xymon:xymon` and exclude
## the `netrc`-file:
__xymon_config --confdir=xymon.example.com \
--owner xymon --group xymon \
--rsync-opts "exclude=netrc"

SEE ALSO

cdist__xymon_server(7), cdist__rsync(7), xymon(7)

AUTHORS

Thomas Eckert <tom--@--it-eckert.de>

COPYING

Copyright (C) 2018-2019 Thomas Eckert. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

COPYRIGHT

ungleich GmbH 2021