1MUNIN-NODE-CONFIGURE(1)User Contributed Perl DocumentatioMnUNIN-NODE-CONFIGURE(1)
2
3
4

NAME

6       munin-node-configure - View and modify which plugins are enabled.
7

SYNOPSIS

9         munin-node-configure [options]
10

DESCRIPTION

12       munin-node-configure reports which plugins are enabled on the current
13       node, and suggest changes to this list.
14
15       By default this program shows which plugins are activated on the
16       system.
17
18       If you specify "--suggest", it will present a table of plugins that
19       will probably work (according to the plugins' autoconf command).
20
21       If you specify "--snmp", followed by a list of hosts, it will present a
22       table of SNMP plugins that they support.
23
24       If you additionally specify "--shell", shell commands to install those
25       same plugins will be printed. These can be reviewed or piped directly
26       into a shell to install the plugins.
27

OPTIONS

29       --help
30           Show this help page.
31
32       --version
33           Show version information.
34
35       --debug
36           Print debug information on the operations of
37           "munin-node-configure".  This can be very verbose.
38
39           All debugging output is printed to STDOUT, and each line is
40           prefixed with '#'.  Only errors are printed to STDERR.
41
42       --pidebug
43           Plugin debug.  Sets the environment variable MUNIN_DEBUG to 1 so
44           that plugins may enable debugging.
45
46       --config <file>
47           Override configuration file [/etc/munin/munin-node.conf]
48
49       --servicedir <dir>
50           Override plugin directory [/etc/munin/plugins/]
51
52       --sconfdir <dir>
53           Override plugin configuration directory [/etc/munin/plugin-conf.d/]
54
55       --libdir <dir>
56           Override plugin library [/usr/share/munin/plugins/]
57
58       --exitnoterror
59           Do not consider plugins that exit non-zero exit-value as error.
60
61       --suggest
62           Suggest plugins that might be added or removed, instead of those
63           that are currently enabled.
64
65   OUTPUT OPTIONS
66       By default, "munin-node-configure" will print out a table summarising
67       the results.
68
69       --shell
70           Instead of a table, print shell commands to install the new plugin
71           suggestions.
72
73           This implies "--suggest", unless "--snmp" was also enabled.  By
74           default, it will not attempt to remove any plugins.
75
76       --remove-also
77           When "--shell" is enabled, also provide commands to remove plugins
78           that are no longer applicable from the service directory.
79
80   PLUGIN SELECTION OPTIONS
81       --families <family,...>
82           Override the list of families that will be used (auto, manual,
83           contrib, snmpauto).  Multiple families can be specified as a comma-
84           separated list, by repeating the "--families" option, or as a
85           combination of the two.
86
87           When listing installed plugins, the default families are 'auto',
88           'manual' and 'contrib'.  Only 'auto' plugins are checked for
89           suggestions.  SNMP probing is only performed on 'snmpauto' plugins.
90
91       --newer <version>
92           Only consider plugins added to the Munin core since <version>.
93           This option is useful when upgrading, since it can prevent plugins
94           that have been manually removed from being reinstalled.  This only
95           applies to plugins in the 'auto' family.
96
97   SNMP Options
98       --snmp <host|cidr,...>
99           Probe the SNMP agents on the host or CIDR network (e.g.
100           "192.168.1.0/24"), to see what plugins they support. This may take
101           some time, especially if the many hosts are specified.
102
103           This option can be specified multiple times, or as a comma-
104           separated list, to include more than one host/CIDR.
105
106       --snmpversion <ver>
107           The SNMP version (1, 2c or 3) to use. ['2c']
108
109       --snmpport <port>
110           The SNMP port to use [161]
111
112       --snmpdomain <domain>
113           The Transport Domain to use for exchanging SNMP messages. The
114           default is UDP/IPv4. Possible values: 'udp', 'udp4', 'udp/ipv4';
115           'udp6', 'udp/ipv6'; 'tcp', 'tcp4', 'tcp/ipv4'; 'tcp6', 'tcp/ipv6'.
116
117       SNMP 1/2c authentication
118           SNMP versions 1 and 2c use a "community string" for authentication.
119           This is a shared password, sent in plaintext over the network.
120
121       --snmpcommunity <string>
122           The community string for version 1 and 2c agents.  ['public'] (If
123           this works your device is probably very insecure and needs a
124           security checkup).
125
126       SNMP 3 authentication
127           SNMP v3 has three security levels. Lowest is "noAuthNoPriv", which
128           provides neither authentication nor encryption.  If a username and
129           "authpassword" are given it goes up to "authNoPriv", and the
130           connection is authenticated.  If "privpassword" is also given the
131           security level becomes "authPriv", and the connection is
132           authenticated and encrypted.
133
134           Note: Encryption can slow down slow or heavily loaded network
135           devices.  For most uses "authNoPriv" will be secure enough -- the
136           password is sent over the network encrypted in any case.
137
138           ContextEngineIDs are not (yet) supported.
139
140           For further reading on SNMP v3 security models please consult
141           RFC3414 and the documentation for Net::SNMP.
142
143       --snmpusername <name>
144           Username.  There is no default.
145
146       --snmpauthpassword <password>
147           Authentication password.  Optional when encryption is also enabled,
148           in which case defaults to the privacy password
149           ("--snmpprivpassword").
150
151       --snmpauthprotocol <protocol>
152           Authentication protocol.  One of 'md5' or 'sha' (HMAC-MD5-96,
153           RFC1321 and SHA-1/HMAC-SHA-96, NIST FIPS PIB 180, RFC2264).
154           ['md5']
155
156       --snmpprivpassword <password>
157           Privacy password to enable encryption.  There is no default.  An
158           empty ('') password is considered as no password and will not
159           enable encryption.
160
161           Privacy requires a privprotocol as well as an authprotocol and a
162           authpassword, but all of these are defaulted (to 'des', 'md5', and
163           the privpassword value, respectively) and may therefore be left
164           unspecified.
165
166       --snmpprivprotocol <protocol>
167           If the privpassword is set this setting controls what kind of
168           encryption is used to achieve privacy in the session.  Only the
169           very weak 'des' encryption method is supported officially.  ['des']
170
171           munin-node-configure also supports '3des' (CBC-3DES-EDE, aka
172           Triple-DES, NIST FIPS 46-3) as specified in IETF
173           draft-reeder-snmpv3-usm-3desede.  Whether or not this works with
174           any particular device, we do not know.
175

FILES

177           /etc/munin/munin-node.conf
178           /etc/munin/plugin-conf.d/*
179           /etc/munin/plugins/*
180           /usr/share/munin/plugins/plugins.history
181           /usr/share/munin/plugins/*
182

VERSION

184       This is munin-node-configure (munin-node) v2.0.49.
185
186       $Id$
187

AUTHORS

189       Jimmy Olsen, Nicolai Langfeldt, Matthew Boyle
190

BUGS

192       Please see <http://munin-monitoring.org/report/1>.
193
195       Copyright (C) 2003-2006 Jimmy Olsen, Nicolai Langfeldt.
196
197       Copyright (C) 2009-2010 Matthew Boyle
198
199       This is free software; see the source for copying conditions. There is
200       NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR
201       PURPOSE.
202
203       This program is released under the GNU General Public License
204
205
206
207perl v5.28.2                      2019-05-16           MUNIN-NODE-CONFIGURE(1)
Impressum