|
Packit |
667938 |
MRTG-IPV6(1) mrtg MRTG-IPV6(1)
|
|
Packit |
667938 |
|
|
Packit |
667938 |
|
|
Packit |
667938 |
|
|
Packit |
667938 |
N?NA?AM?ME?E
|
|
Packit |
667938 |
mrtg-ipv6 - IPv6 support in MRTG
|
|
Packit |
667938 |
|
|
Packit |
667938 |
O?OV?VE?ER?RV?VI?IE?EW?W
|
|
Packit |
667938 |
MRTG and cfgmaker support SNMP over IPv6. IPv6 targets can be specified
|
|
Packit |
667938 |
by hostname or IPv6 address, and if the required libraries are present
|
|
Packit |
667938 |
(see below), queries will use IPv6.
|
|
Packit |
667938 |
|
|
Packit |
667938 |
U?US?SA?AG?GE?E
|
|
Packit |
667938 |
E?En?na?ab?bl?li?in?ng?g I?IP?Pv?v6?6
|
|
Packit |
667938 |
IPv6 is currently disabled by default and must be explicitly enabled.
|
|
Packit |
667938 |
In MRTG this is done by turning on the E?En?na?ab?bl?le?eI?IP?Pv?v6?6 global option in the
|
|
Packit |
667938 |
configuration file. In cfgmaker, it is enabled with the -?--?-e?en?na?ab?bl?le?e-?-i?ip?pv?v6?6
|
|
Packit |
667938 |
command-line option.
|
|
Packit |
667938 |
|
|
Packit |
667938 |
If IPv6 is disabled, MRTG and cfgmaker should behave in exactly the
|
|
Packit |
667938 |
same way as previous versions. So the addition of IPv6 support should
|
|
Packit |
667938 |
have no effect on existing MRTG setups unless IPv6 is enabled.
|
|
Packit |
667938 |
|
|
Packit |
667938 |
IPv6 support requires the Socket6 and INET6 libraries (see below). If
|
|
Packit |
667938 |
MRTG can't find them, IPv6 is disabled.
|
|
Packit |
667938 |
|
|
Packit |
667938 |
S?Sp?pe?ec?ci?if?fy?yi?in?ng?g I?IP?Pv?v6?6 t?ta?ar?rg?ge?et?ts?s
|
|
Packit |
667938 |
IPv6 targets may be specified by name or IPv6 address. Numeric IPv6
|
|
Packit |
667938 |
addresses may be used with both cfgmaker and MRTG, but they must be
|
|
Packit |
667938 |
enclosed in square brackets.
|
|
Packit |
667938 |
|
|
Packit |
667938 |
For example, a target could be specified as:
|
|
Packit |
667938 |
|
|
Packit |
667938 |
public@[2001:760:4::]:161
|
|
Packit |
667938 |
|
|
Packit |
667938 |
Hostnames work as expected: first an IPv6 name lookup is tried, then an
|
|
Packit |
667938 |
IPv4 lookup.
|
|
Packit |
667938 |
|
|
Packit |
667938 |
T?Ta?ar?rg?ge?et?ts?s t?th?ha?at?t d?do?o n?no?ot?t s?su?up?pp?po?or?rt?t S?SN?NM?MP?P o?ov?ve?er?r I?IP?Pv?v6?6
|
|
Packit |
667938 |
Many targets (this currently includes all Cisco routers) do not yet
|
|
Packit |
667938 |
support SNMP over IPv6 and must be monitored over IPv4. This can cause
|
|
Packit |
667938 |
problems if you specify a target through its DNS name and the name maps
|
|
Packit |
667938 |
to both the IPv6 address and the IPv4 address of the target: MRTG will
|
|
Packit |
667938 |
only try IPv6, and will fail.
|
|
Packit |
667938 |
|
|
Packit |
667938 |
To query these targets, use the I?IP?Pv?v4?4O?On?nl?ly?y per-target option, which tells
|
|
Packit |
667938 |
MRTG not to use SNMP over IPv6 for the target.
|
|
Packit |
667938 |
|
|
Packit |
667938 |
MRTG does not fall back to IPv4 for performance and correctness
|
|
Packit |
667938 |
reasons. If there are many routers to query, a timeout for every router
|
|
Packit |
667938 |
would make MRTG take too long to query them all. And if, for some
|
|
Packit |
667938 |
reason, IPv6 connectivity to the target is lost, MRTG's error messages
|
|
Packit |
667938 |
can help figure out what is wrong.
|
|
Packit |
667938 |
|
|
Packit |
667938 |
cfgmaker does fall back from IPv6 to IPv4. If IPv6 is enabled and
|
|
Packit |
667938 |
cfgmaker is given a hostname that resolves to both an IPv6 and an IPv4
|
|
Packit |
667938 |
address, it first tries to query the target over IPv6. If it receives
|
|
Packit |
667938 |
no answer, it tries again using IPv4. If the target answers, cfgmaker
|
|
Packit |
667938 |
sets the IPv4Only option in the generated config file.
|
|
Packit |
667938 |
|
|
Packit |
667938 |
I?IP?Pv?v6?6 L?LI?IB?BR?RA?AR?RI?IE?ES?S
|
|
Packit |
667938 |
L?Li?ib?br?ra?ar?ri?ie?es?s r?re?eq?qu?ui?ir?re?ed?d
|
|
Packit |
667938 |
IPv6 support requires the S?So?oc?ck?ke?et?t6?6 and I?IN?NE?ET?T6?6 Perl modules. Both can be
|
|
Packit |
667938 |
downloaded from CPAN:
|
|
Packit |
667938 |
|
|
Packit |
667938 |
http://search.cpan.org/author/UMEMOTO/Socket6/
|
|
Packit |
667938 |
|
|
Packit |
667938 |
http://search.cpan.org/author/MONDEJAR/INET6/
|
|
Packit |
667938 |
|
|
Packit |
667938 |
If you use Debian, you will need the packages l?li?ib?bs?so?oc?ck?ke?et?t6?6-?-p?pe?er?rl?l and
|
|
Packit |
667938 |
l?li?ib?bi?io?o-?-s?so?oc?ck?ke?et?t-?-i?in?ne?et?t6?6-?-p?pe?er?rl?l, which are (or should soon be) in unstable.
|
|
Packit |
667938 |
|
|
Packit |
667938 |
So far, IPv6 support has been tested on Linux only, and only with
|
|
Packit |
667938 |
Socket6 version 0.12. Also note that IPv6 won't work at all if you
|
|
Packit |
667938 |
don't have INET6.pm version 2.00 or newer.
|
|
Packit |
667938 |
|
|
Packit |
667938 |
I?In?ns?st?ta?al?ll?li?in?ng?g t?th?he?e l?li?ib?br?ra?ar?ri?ie?es?s
|
|
Packit |
667938 |
Building and installing Socket6 and INET6 is very simple. For each
|
|
Packit |
667938 |
module, just unpack the archive and then do:
|
|
Packit |
667938 |
|
|
Packit |
667938 |
perl Makefile.PL
|
|
Packit |
667938 |
make
|
|
Packit |
667938 |
|
|
Packit |
667938 |
and then:
|
|
Packit |
667938 |
|
|
Packit |
667938 |
su
|
|
Packit |
667938 |
make install
|
|
Packit |
667938 |
|
|
Packit |
667938 |
If you have installed the libraries successfully, cfgmaker and mrtg
|
|
Packit |
667938 |
should automatically detect them and allow IPv6 support to be enabled.
|
|
Packit |
667938 |
|
|
Packit |
667938 |
A?AU?UT?TH?HO?OR?R
|
|
Packit |
667938 |
Lorenzo Colitti <lorenzo location colitti.com>
|
|
Packit |
667938 |
|
|
Packit |
667938 |
|
|
Packit |
667938 |
|
|
Packit |
667938 |
2.17.7 2018-07-13 MRTG-IPV6(1)
|