---
name: "cdist-type__xymon_server"
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_server"
---

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

Install a Xymon server

## NAME

cdist-type\_\_xymon\_server - Install a Xymon server

## DESCRIPTION

This cdist type installs a Xymon (*https://www.xymon.com/*) server and (optional) required helper packages.

This includes the Xymon client as a dependency, so NO NEED to install *\_\_xymon\_client* separately.

To access the webinterface a webserver is required.  The cdist-type *\_\_xymon\_apache* can be used to install and configure the apache webserver for the use with Xymon.

Further and day-to-day configuration of Xymon can either be done manually in */etc/xymon/* or the directory can be deployed and managed by *\_\_xymon\_config*.

## REQUIRED PARAMETERS

None.

## OPTIONAL PARAMETERS

- **state**

  'present', 'absent', defaults to 'present'. If '--install\_helpers' is specified for 'absent' the helper packages will be un-installed.

## BOOLEAN PARAMETERS

- **install\_helpers**

  Install helper packages used by Xymon (fping, heirloom-mailx, traceroute, ntpdate).

## EXAMPLES

```
# minmal
__xymon_server
# the same
__xymon_server --state present
# also install helper packages:
__xymon_server --install_helpers
# examples to give a more complete picture: __xymon_server installed on
# `xymon.example.com` w/ IP 192.168.1.1:
#
# install webserver and grant 2 private subnets access to the webinterface:
__xymon_apache --ipacl "192.168.0.0/16 10.0.0.0/8"
# deploy server-configuration with __xymon_config:
__xymon_config --confdir=xymon.example.com
# install xymon-client on other machines (not needed on the server):
__xymon_client --servers "192.168.1.1"
```

## SEE ALSO

**cdist\_\_xymon\_apache**(7), **cdist\_\_xymon\_config**(7), **cdist\_\_xymon\_client**(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