1MUNIN-NODE-CONFIGURE(1)User Contributed Perl DocumentatioMnUNIN-NODE-CONFIGURE(1)
2
6 munin-node-configure - View and modify which plugins are enabled.
7
9 munin-node-configure [options]
10
12 munin-node-configure reports which plugins are enabled on the current
13 node, and suggest changes to this list.
14 By default this program shows which plugins are activated on the
16 system.
17 If you specify "--suggest", it will present a table of plugins that
19 will probably work (according to the plugins' autoconf command).
20 If you specify "--snmp", followed by a list of hosts, it will present a
22 table of SNMP plugins that they support.
23 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
29 --help
30 Show this help page.
31 --version
33 Show version information.
34 --debug
36 Print debug information on the operations of
37 "munin-node-configure". This can be very verbose.
38 All debugging output is printed to STDOUT, and each line is
40 prefixed with '#'. Only errors are printed to STDERR.
41 --pidebug
43 Plugin debug. Sets the environment variable MUNIN_DEBUG to 1 so
44 that plugins may enable debugging.
45 --config <file>
47 Override configuration file [/etc/munin/munin-node.conf]
48 --servicedir <dir>
50 Override plugin directory [/etc/munin/plugins/]
51 --sconfdir <dir>
53 Override plugin configuration directory [/etc/munin/plugin-conf.d/]
54 --libdir <dir>
56 Override plugin library [/usr/share/munin/plugins/]
57 --exitnoterror
59 Do not consider plugins that exit non-zero exit-value as error.
60 --suggest
62 Suggest plugins that might be added or removed, instead of those
63 that are currently enabled.
64 OUTPUT OPTIONS
66 By default, "munin-node-configure" will print out a table summarising
67 the results.
68 --shell
70 Instead of a table, print shell commands to install the new plugin
71 suggestions.
72 This implies "--suggest", unless "--snmp" was also enabled. By
74 default, it will not attempt to remove any plugins.
75 --remove-also
77 When "--shell" is enabled, also provide commands to remove plugins
78 that are no longer applicable from the service directory.
79 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 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 --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 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 This option can be specified multiple times, or as a comma-
104 separated list, to include more than one host/CIDR.
105 --snmpversion <ver>
107 The SNMP version (1, 2c or 3) to use. ['2c']
108 --snmpport <port>
110 The SNMP port to use [161]
111 --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 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 --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 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 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 ContextEngineIDs are not (yet) supported.
139 For further reading on SNMP v3 security models please consult
141 RFC3414 and the documentation for Net::SNMP.
142 --snmpusername <name>
144 Username. There is no default.
145 --snmpauthpassword <password>
147 Authentication password. Optional when encryption is also enabled,
148 in which case defaults to the privacy password
149 ("--snmpprivpassword").
150 --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 --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 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 --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 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
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
184 This is munin-node-configure (munin-node) v2.0.51.
185 $Id$
187
189 Jimmy Olsen, Nicolai Langfeldt, Matthew Boyle
190
192 Please see <http://munin-monitoring.org/report/1>.
193
195 Copyright (C) 2003-2006 Jimmy Olsen, Nicolai Langfeldt.
196 Copyright (C) 2009-2010 Matthew Boyle
198 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 This program is released under the GNU General Public License
204perl v5.30.0 2019-10-19 MUNIN-NODE-CONFIGURE(1)