mirror of
git://git.code.sf.net/p/dhcpd-pools/code
synced 2025-12-15 15:27:00 +00:00
135 lines
6 KiB
HTML
135 lines
6 KiB
HTML
<?xml version="1.0"?>
|
|
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<html>
|
|
<head>
|
|
<meta name="viewport" content="width=device-width, initial-scale=1">
|
|
<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
|
|
<meta name="author" content="Sami Kerola" />
|
|
<meta name="contact_addr" content="kerolasa@iki.fi" />
|
|
<meta name="distribution" content="global" />
|
|
<meta name="keywords" content="dhcpd, dhcp, pool, leases, analyzer, reporting, alarming, nagios" />
|
|
<meta name="abstract" content="ISC dhcpd lease analysis and reporting software" />
|
|
<meta name="language" content="en" />
|
|
<meta name="owner" content="Sami Kerola" />
|
|
<meta name="rating" content="general" />
|
|
<meta name="revisit-after" content="15" />
|
|
<meta name="robots" content="index, follow" />
|
|
<title>ISC dhcpd lease analysis and reporting</title>
|
|
<style xml:space="preserve" type="text/css">
|
|
BODY {
|
|
background-color:#ffffff;
|
|
margin:20px;
|
|
max-width:700px;
|
|
}
|
|
DIV.tt {
|
|
font-family: Lucida Sans Typewriter,Lucida Console,monaco,Bitstream Vera Sans Mono,monospace;
|
|
font-size: 12px;
|
|
font-style: normal;
|
|
font-variant: normal;
|
|
}
|
|
</style>
|
|
</head>
|
|
<body>
|
|
<div itemscope itemtype="https://schema.org/SoftwareApplication">
|
|
<h1>ISC dhcpd lease analysis and reporting</h1>
|
|
<p>This is <span itemprop="name">dhcpd-pools</span>
|
|
<a href="https://www.isc.org/software/dhcp" itemprop="applicationSuite">ISC dhcp</a>
|
|
shared network and pool range
|
|
<span itemprop="applicationCategory">usage analysis</span>.
|
|
<span itemprop="description">Purpose of command is to count usage ratio of
|
|
each IP range and shared network pool which ISC dhcpd is in control
|
|
of.</span> Users of the command are most likely ISPs and other organizations
|
|
that have large IP space.</p>
|
|
<p>Program is written C. Design goal is to get analysis done quickly where
|
|
there is lots of data. On cheap laptop the speed of analysis is more than
|
|
100k leases per second. Number of ranges, or shared networks, does not make
|
|
any significant difference in getting analysis done.</p>
|
|
<hr />
|
|
<div class="tt">
|
|
prompt> ./dhcpd-pools --config=/etc/dhcpd.conf
|
|
--leases=/var/lib/dhcp/dhcpd.leases --format=H
|
|
--color=always --warning=40 --critical=50 --output=<a
|
|
href="https://dhcpd-pools.sourceforge.net/sampleoutput.html">sampleoutput.html</a>
|
|
</div>
|
|
<hr />
|
|
<h3>Is dhcpd-pools still developed?</h3>
|
|
<p>In short no, it is not.</p>
|
|
<p>
|
|
<a href="https://www.isc.org/blogs/isc-dhcp-eol/">ISC DHCPD has reached
|
|
EOL</a>. Users are Kea DHCP server instead. Kea has <a
|
|
href="https://kea.readthedocs.io/en/kea-2.2.0/arm/stats.html">native
|
|
statistics</a>, so it does not require this tool and therefore the
|
|
dhcpd-pools is obsolte.
|
|
</p>
|
|
<h3>Where I can get dhcpd-pools?</h3>
|
|
<p>Download
|
|
<a href="https://sourceforge.net/projects/dhcpd-pools/files/" itemprop="downloadUrl">release package</a>
|
|
or clone from git. Build instructions are in
|
|
<a href="https://sourceforge.net/p/dhcpd-pools/code/ci/master/tree/README">README</a>
|
|
file.
|
|
<br /></p>
|
|
<div class="tt">git clone git://git.code.sf.net/p/dhcpd-pools/code dhcpd-pools</div>
|
|
<p>See also
|
|
<a href="https://sourceforge.net/projects/dhcpd-pools">SourceForge</a> project page.</p>
|
|
<h3>Documentation</h3>
|
|
<p>The dhcpd-pools
|
|
<a href="https://dhcpd-pools.sourceforge.net/man.html">manual page</a>, and
|
|
<a href="https://dhcpd-pools.sourceforge.net/doxygen/">Doxygen</a> software
|
|
reference documentation are available online.</p>
|
|
<h3>Getting the output you need</h3>
|
|
<ol>
|
|
<li>Start with:<br />
|
|
<span style="font-family:monospace">dhcpd-pools --config=path
|
|
--leases=path --color=always --format=text</span></li>
|
|
<li>Play with options and see how output changes. Options to
|
|
try:<br />
|
|
<span style="font-family:monospace">--all-as-shared --crit-count
|
|
--critical --minsize --snet-alarms --warn-count
|
|
--warning</span></li>
|
|
<li>Start filtering output. Options to try:<br />
|
|
<span style="font-family:monospace">--skip --limit</span></li>
|
|
<li>Change <span style="font-family:monospace">--format</span>
|
|
option to what you need, and maybe include <span style="font-family:monospace">
|
|
--perfdata</span> if you want nagios alarm
|
|
format.</li>
|
|
<li>Done.</li>
|
|
</ol>
|
|
<h3>Reference information</h3>
|
|
<p>
|
|
<script type='text/javascript' src='https://www.openhub.net/p/dhcpd-pools/widgets/project_factoids_stats?format=js'></script>
|
|
</p>
|
|
<p>The program was written because
|
|
<a href="https://dhcpstatus.sourceforge.net/">DHCPStatus</a>,
|
|
<a href="https://freshmeat.net/projects/dhcpusestats/">DHCP Usage Statistics</a>,
|
|
<a href="https://www.omar.org/opensource/reportdhcp/">reportdhcp.pl</a>,
|
|
<a href="https://www.ofb.net/%7Ejheiss/lease_analyzer">lease_analyzer</a> and
|
|
<a href="https://www.net-track.ch/opensource/dhcpd-snmp/">dhcpd-snmp</a>
|
|
where too slow to handle huge number of leases. There is also difference in
|
|
printed details. The dhcpd-pools does not print quite as much information as
|
|
some other tools.</p>
|
|
<p>Notice that this utility is not the same as
|
|
<a href="https://folk.uio.no/trondham/software/dhcpd-pool.html">dhcpd-pool</a>
|
|
that is maintained by Trond Hasle Amundsen.</p>
|
|
<p>Just for laugh, obsolete awk proof of concept (version 1.4)
|
|
<a href="https://dhcpd-pools.sourceforge.net/dhcpd-pools.awk">dhcpd-pools.awk</a></p>
|
|
<h3>Where to send questions, bug reports, code contributions...</h3>
|
|
<p><a href="https://kerolasa.iki.fi/" itemprop="copyrightHolder">Sami Kerola</a>
|
|
<<a href="mailto:kerolasa@iki.fi">kerolasa@iki.fi</a>></p>
|
|
<div style="visibility:hidden">
|
|
<span itemprop="datePublished" datetime="2006-03-13T00:00:00+0000">Mon Mar 13 00:00:00 GMT 2006</span>
|
|
<span itemprop="dateModified" datetime="2022-11-26T09:58:28+0000">Sat Nov 26 09:58:28 GMT 2022</span>
|
|
<span itemprop="version">3.0</span>
|
|
<span itemprop="license">FreeBSD License</span>
|
|
<a href="https://dhcpd-pools.sourceforge.net/" itemprop="url"></a>
|
|
<div itemprop="offers" itemscope itemtype="https://schema.org/Offer">
|
|
<span itemprop="price">0</span>
|
|
<meta itemprop="priceCurrency" content="EUR" />
|
|
</div>
|
|
<div itemprop="aggregateRating" itemscope itemtype="https://schema.org/AggregateRating">
|
|
<span itemprop="ratingValue">5</span> (
|
|
<span itemprop="ratingCount">2</span> ratings )
|
|
</div>
|
|
</div>
|
|
</div>
|
|
</body>
|
|
</html>
|