.\" Man page generated from reStructuredText.
.
.TH "CDIST-TYPE__XYMON_SERVER" "7" "Feb 07, 2021" "6.9.4" "cdist"
.
.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
..
.SH NAME
.sp
cdist\-type__xymon_server \- Install a Xymon server
.SH DESCRIPTION
.sp
This cdist type installs a Xymon (\fI\%https://www.xymon.com/\fP) server and (optional)
required helper packages.
.sp
This includes the Xymon client as a dependency, so NO NEED to install
\fI__xymon_client\fP separately.
.sp
To access the webinterface a webserver is required.  The cdist\-type
\fI__xymon_apache\fP can be used to install and configure the apache webserver for
the use with Xymon.
.sp
Further and day\-to\-day configuration of Xymon can either be done manually in
\fI/etc/xymon/\fP or the directory can be deployed and managed by \fI__xymon_config\fP\&.
.SH REQUIRED PARAMETERS
.sp
None.
.SH OPTIONAL PARAMETERS
.INDENT 0.0
.TP
.B state
\(aqpresent\(aq, \(aqabsent\(aq, defaults to \(aqpresent\(aq. If \(aq\-\-install_helpers\(aq is
specified for \(aqabsent\(aq the helper packages will be un\-installed.
.UNINDENT
.SH BOOLEAN PARAMETERS
.INDENT 0.0
.TP
.B install_helpers
Install helper packages used by Xymon (fping, heirloom\-mailx, traceroute,
ntpdate).
.UNINDENT
.SH EXAMPLES
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
# 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
# \(gaxymon.example.com\(ga 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"
.ft P
.fi
.UNINDENT
.UNINDENT
.SH SEE ALSO
.sp
\fBcdist__xymon_apache\fP(7), \fBcdist__xymon_config\fP(7),
\fBcdist__xymon_client\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 2020
.\" Generated by docutils manpage writer.
.