---
name: "cdist-type__xymon_config"
section: "7"
platform: "linux"
package: "cdist"
version: "7.0.0-5"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/cdist-type__xymon_config"
---

# cdist-type\_\_xymon\_config(7)

Deploy a Xymon configuration-directory

## 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)](/xymon/7.md)

## 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