summaryrefslogtreecommitdiffabout
path: root/README
blob: 49f5704c546a00d964167690c48c02ad74677217 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
* Overview

Mangemange is a remote management system for Ping903. It allows the user
to inspect configuration of the running server, add or remove IP
addresses, synchronize the monitored IP list with the Nagios
configuration or an SQL database etc.

* Examples

** Identify the running serever

   $ mangemanche ident
   package ping903
   pid 3864
   version 0.4.90

** Inspect the server configuration

   $ mangemanche inspect

** Inspect a particular configuration setting

   $ mangemanche inspect ip-list

** Add an IP address to monitoring

   $ mangemanche ipadd 198.51.100.2

** Import IP addresses from the Nagios configuration

   $ mangemanche nagios

* Installation

The usual incantations apply:

  perl Makefile.PL
  make install

* Documentation

Run "mangemanche --help" for a detailed help.
Run "mangemanche -?" for a list of available subcommands.
Run "mangemanche COMMAND --help" for a detailed help for a particular
COMMAND.

Manual pages are also installed, so "man mangemanche" will give you
the manual for the tool, and, e.g. "man inspect" will give you a
manpage for the "mangemanche inspect" subcommand.

* Notes

If you plan to use "mangemanche nagios" and your Nagios configuration
makes use of multiple template inheritance[1], you will need a modified
version of the Nagios::Config module, available from [2].  The authors
of the module have been informed about a proposed change[3], so
hopefully it will be included in the next release.

* References

[1] https://assets.nagios.com/downloads/nagioscore/docs/nagioscore/3/en/objectinheritance.html
[2] https://github.com/graygnuorg/perl-nagios-object
[3] https://rt.cpan.org/Ticket/Display.html?id=132053


* Copyright information:

Copyright (C) 2020 Sergey Poznyakoff

   Permission is granted to anyone to make or distribute verbatim copies
   of this document as received, in any medium, provided that the
   copyright notice and this permission notice are preserved,
   thus giving the recipient permission to redistribute in turn.

   Permission is granted to distribute modified versions
   of this document, or of portions of it,
   under the above conditions, provided also that they
   carry prominent notices stating who last changed them.

Local Variables:
mode: outline
paragraph-separate: "[	]*$"
version-control: never
End:

Return to:

Send suggestions and report system problems to the System administrator.