.\" Man page generated from reStructuredText.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "CDIST-TYPE__XYMON_CONFIG" "7" "Sep 26, 2023" "7.0.0" "cdist"
.SH NAME
.sp
cdist\-type__xymon_config \- Deploy a Xymon configuration\-directory
.SH DESCRIPTION
.sp
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
\fI__xymon_server\fP\&.
.sp
WARNING: This type _replaces_ the \fI/etc/xymon/\fP\-directory! The previous
contents is replaced/deleted!
.SH REQUIRED PARAMETERS
.INDENT 0.0
.TP
.B confdir
The directory in \fI\&./files/\fP that contains the \fI/etc/xymon/\fP\-content to be
deployed.
.UNINDENT
.SH OPTIONAL PARAMETERS
.INDENT 0.0
.TP
.B owner
passed as\-is as \fI\-\-owner\fP to \fI__rsync\fP
.TP
.B group
passed as\-is as \fI\-\-group\fP to \fI__rsync\fP
.UNINDENT
.SH OPTIONAL MULTIPLE PARAMETERS
.INDENT 0.0
.TP
.B rsync\-opts
identical to __rsync type, only \fI\-\-\fP\-options are supported
.UNINDENT
.SH REQUIRED FILES
.sp
The directory specified by \fIconfdir\fP has to contain a valid xymon\-configuration
(\fI/etc/xymon/\fP) _plus_ the \fIext/\fP\-directory that normally resides in
\fI/usr/lib/xymon/server/\fP\&.
.SH EXAMPLES
.INDENT 0.0
.INDENT 3.5
.sp
.EX
__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 \(gaxymon:xymon\(ga and exclude
## the \(ganetrc\(ga\-file:
__xymon_config \-\-confdir=xymon.example.com \e
   \-\-owner xymon \-\-group xymon \e
   \-\-rsync\-opts \(dqexclude=netrc\(dq
.EE
.UNINDENT
.UNINDENT
.SH SEE ALSO
.sp
\fBcdist__xymon_server\fP(7), \fBcdist__rsync\fP(7), \fBxymon\fP(7)
.SH AUTHORS
.sp
Thomas Eckert <\fI\%tom\-\-@\-\-it\-eckert.de\fP>
.SH COPYING
.sp
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.
.SH COPYRIGHT
ungleich GmbH 2021
.\" Generated by docutils manpage writer.
.