-
Notifications
You must be signed in to change notification settings - Fork 3
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
1 parent
291dd74
commit 9cfca89
Showing
5 changed files
with
19 additions
and
19 deletions.
There are no files selected for viewing
Large diffs are not rendered by default.
Oops, something went wrong.
Large diffs are not rendered by default.
Oops, something went wrong.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -49,11 +49,11 @@ | |
</code></pre></div></p> </li> <li> <p>Restart snmpd on the host in question.</p> </li> </ol> <p>The application should be auto-discovered as described at the top of the page. If it is not, please follow the steps set out under <code>SNMP Extend</code> heading top of page.</p> <h3 id=agent_2>Agent</h3> <ol> <li> <p><a href=../Agent-Setup/ >Install the agent</a> on this device if it isn't already and copy the script to <code>/usr/lib/check_mk_agent/local/bind</code> via <code>wget https://raw.githubusercontent.com/librenms/librenms-agent/master/snmp/bind -O /usr/lib/check_mk_agent/local/bind</code></p> </li> <li> <p>Make the script executable <div class=highlight><pre><span></span><code>chmod +x /usr/lib/check_mk_agent/local/bind | ||
</code></pre></div></p> </li> <li> <p>Set the variable 'agent' to '1' in the config.</p> </li> </ol> <h2 id=bird2>BIRD2</h2> <p>The BIRD Internet Routing Daemon (BGP) </p> <p>Due to the lack of SNMP support in the BIRD daemon, this application extracts all configured BGP protocols and parses it into LibreNMS. This application supports both IPv4 and IPv6 Peer processing.</p> <h3 id=snmp-extend_5>SNMP Extend</h3> <ol> <li>Edit your snmpd.conf file (usually /etc/snmp/snmpd.conf) and add:</li> </ol> <div class=highlight><pre><span></span><code>extend bird2 '/usr/bin/sudo /usr/sbin/birdc -r show protocols all' | ||
</code></pre></div> <ol> <li>Edit your sudo users (usually <code>visudo</code>) and add at the bottom:</li> </ol> <div class=highlight><pre><span></span><code>Debian-snmp ALL=(ALL) NOPASSWD: /usr/sbin/birdc | ||
</code></pre></div> <p><em>If your snmp daemon is running on a user that isnt <code>Debian-snmp</code> make sure that user has the correct permission to execute <code>birdc</code></em></p> <ol> <li>Verify the time format for bird2 is defined. Otherwise <code>iso short ms</code> (hh<img alt=🇲🇲 class=twemoji src=https://cdn.jsdelivr.net/gh/jdecked/[email protected]/assets/svg/1f1f2-1f1f2.svg title=:mm:>ss) is the default value that will be used. Which is not compatible with the datetime parsing logic used to parse the output from the bird show command. <code>timeformat protocol</code> is the one important to be defibned for the bird2 app parsing logic to work.</li> </ol> <p>Example starting point using Bird2 shorthand <code>iso long</code> (YYYY-MM-DD hh<img alt=🇲🇲 class=twemoji src=https://cdn.jsdelivr.net/gh/jdecked/[email protected]/assets/svg/1f1f2-1f1f2.svg title=:mm:>ss):</p> <div class=highlight><pre><span></span><code>timeformat base iso long; | ||
</code></pre></div> <p><em>If your snmp daemon is running on a user that isnt <code>Debian-snmp</code> make sure that user has the correct permission to execute <code>birdc</code></em></p> <ol> <li>Verify the time format for bird2 is defined. Otherwise <code>iso short ms</code> (hh:mm:ss) is the default value that will be used. Which is not compatible with the datetime parsing logic used to parse the output from the bird show command. <code>timeformat protocol</code> is the one important to be defibned for the bird2 app parsing logic to work.</li> </ol> <p>Example starting point using Bird2 shorthand <code>iso long</code> (YYYY-MM-DD hh:mm:ss):</p> <div class=highlight><pre><span></span><code>timeformat base iso long; | ||
timeformat log iso long; | ||
timeformat protocol iso long; | ||
timeformat route iso long; | ||
</code></pre></div> <p><em>Timezone can be manually specified, example "%F %T %z" (YYYY-MM-DD hh<img alt=🇲🇲 class=twemoji src=https://cdn.jsdelivr.net/gh/jdecked/[email protected]/assets/svg/1f1f2-1f1f2.svg title=:mm:>ss +11:45). See the <a href="https://bird.network.cz/?get_doc&v=20&f=bird-3.html">Bird 2 docs</a> for more information</em></p> <ol> <li>Restart snmpd on your host</li> </ol> <p>The application should be auto-discovered as described at the top of the page. If it is not, please follow the steps set out under <code>SNMP Extend</code> heading top of page.</p> <h2 id=certificate>Certificate</h2> <p>A small python3 script that checks age and remaining validity of certificates</p> <p>This script needs following packages on Debian/Ubuntu Systems:</p> <ul> <li>python3</li> <li>python3-openssl</li> </ul> <p>Content of an example /etc/snmp/certificate.json . Please edit with your own settings. <div class=highlight><pre><span></span><code>{"domains": [ | ||
</code></pre></div> <p><em>Timezone can be manually specified, example "%F %T %z" (YYYY-MM-DD hh:mm:ss +11:45). See the <a href="https://bird.network.cz/?get_doc&v=20&f=bird-3.html">Bird 2 docs</a> for more information</em></p> <ol> <li>Restart snmpd on your host</li> </ol> <p>The application should be auto-discovered as described at the top of the page. If it is not, please follow the steps set out under <code>SNMP Extend</code> heading top of page.</p> <h2 id=certificate>Certificate</h2> <p>A small python3 script that checks age and remaining validity of certificates</p> <p>This script needs following packages on Debian/Ubuntu Systems:</p> <ul> <li>python3</li> <li>python3-openssl</li> </ul> <p>Content of an example /etc/snmp/certificate.json . Please edit with your own settings. <div class=highlight><pre><span></span><code>{"domains": [ | ||
{"fqdn": "www.mydomain.com"}, | ||
{"fqdn": "some.otherdomain.org", | ||
"port": 8443}, | ||
|
Large diffs are not rendered by default.
Oops, something went wrong.
Large diffs are not rendered by default.
Oops, something went wrong.