From 37e577907076733c71214ed9c033f5205c903482 Mon Sep 17 00:00:00 2001 From: FTBZ Date: Wed, 21 Sep 2016 15:18:39 +0200 Subject: [PATCH 1/3] New documentation with SNMP configuration examples --- doc/Support/SNMP-Configuration-Examples.md | 150 +++++++++++++++++++++ 1 file changed, 150 insertions(+) create mode 100644 doc/Support/SNMP-Configuration-Examples.md diff --git a/doc/Support/SNMP-Configuration-Examples.md b/doc/Support/SNMP-Configuration-Examples.md new file mode 100644 index 0000000000..328c6ec582 --- /dev/null +++ b/doc/Support/SNMP-Configuration-Examples.md @@ -0,0 +1,150 @@ +source: Support/SNMP-Configuration-Examples.md + +# SNMP configuration examples + +Table of Content: +- [Devices](#devices) + - [Cisco](#cisco) + - [Adaptive Security Appliance (ASA)](#adaptive-security-appliance-asa) + - [IOS](#ios) + - [IOS](#ios) + - [IOS XE](#ios-xe) + - [NX-OS](#nx-os) + - [Wireless LAN Controller (WLC)](#wireless-lan-controller-wlc) + - [Infoblox](#infoblox) + - [NIOS 7.x](#nios-7x) + - [Juniper](#juniper) + - [Junos OS](#junos-os) + - [Palo Alto](#palo-alto) + - [PANOS 6.x/7.x](#panos-6x7x) +- [Operating systems](#operating-systems) + - [Linux (snmpd)](#linux-snmpd) + - [Windows Server 2012 R2](#windows-server-2012-r2) + +## Devices + +### Cisco +#### Adaptive Security Appliance (ASA) +1. Launch ASDM and connect to your device +2. Go to Configuration > Management Access > SNMP +3. Add your community string +4. Add in the "SNMP Host Access List" section your LibreNMS server IP address +5. Click Apply and Save + +#### IOS + +``` +snmp-server community YOUR-COMMUNITY RO +snmp-server contact YOUR-CONTACT +snmp-server location YOUR-LOCATION +``` + +#### IOS XE +``` +snmp-server community YOUR-COMMUNITY RO +snmp-server contact YOUR-CONTACT +snmp-server location YOUR-LOCATION +``` + +#### NX-OS +``` +snmp-server community YOUR-COMMUNITY RO +snmp-server contact YOUR-CONTACT +snmp-server location YOUR-LOCATION +``` + +#### Wireless LAN Controller (WLC) +1. Access the web admin page and log in +2. If you are running version 8.1 and later, on the new dashboard click "Advanced" +3. Go to management Tab +4. On SNMP sub-menu, select "Communities" +5. Click "New..." +6. Add your community name and leave IP addresses empty +7. Click Apply and Save + +### Infoblox +#### NIOS 7.x +1. Access the web admin page and log in +2. Go to Grid tab > Grid Manager +3. In the right menu select "Grid properties" +4. Select "SNMP" menu +5. Click "Enable SNMPv1/SNMPv2 Queries" +6. Add your community +7. Click Save & Close + +### Juniper +#### Junos OS +``` +set snmp description description +set snmp location location +set snmp contact contact +set snmp community YOUR-COMMUNITY authorization read-only +``` + +### Palo Alto +#### PANOS 6.x/7.x +1. Access the web admin page and log in +2. Go to Device tab > Setup +3. Go to the sub-tab "Operations" +4. Click "SNMP Setup" +5. Enter your SNMP community and then click "OK" +6. Click Apply + +Note that you need to allow SNMP on the needed interfaces. To do that you need to create a network "Interface Mgmt" profile for standard interface and allow SNMP under "Device > Management > Management Interface Settings" for out of band management interface. + + +## Operating systems +### Linux (snmpd) + +Replace your snmpd.conf file by the example below and edit it with appropriate community in "RANDOMSTRINGGOESHERE". + +``` +vi /etc/snmp/snmpd.conf +``` + +``` +# Change RANDOMSTRINGGOESHERE to your preferred SNMP community string +com2sec readonly default RANDOMSTRINGGOESHERE + +group MyROGroup v2c readonly +view all included .1 80 +access MyROGroup "" any noauth exact all none none + +syslocation Rack, Room, Building, City, Country [GPSX,Y] +syscontact Your Name + +#Distro Detection +extend .1.3.6.1.4.1.2021.7890.1 distro /usr/bin/distro +``` +The LibreNMS server include a copy of this example here: + +``` +/opt/librenms/snmpd.conf.example +``` + +#### Restart the snmpd service: + +##### CentOS 6 / Red hat 6 +``` +service snmpd restart +``` +##### CentOS 7 / Red hat 7 +``` +systemctl restart snmpd +``` +##### Ubuntu +``` +service snmpd restart +``` +### Windows Server 2012 R2 +1. Log in to your Windows Server 2012 R2 +2. Start "Server Manager" under "Administrative Tools" +3. Click "Manage" and then "Add Roles and Features" +4. Continue by pressing "Next" to the "Features" menu +5. Install (if not installed) "SNMP Service" +6. Start "Services" under "Administrative Tools" +7. Edit "SNMP Service" properties +8. Go to the security tab +9. In "Accepted community name" click "Add" to add your community string and permission +10. In "Accept SNMP packets from these hosts" click "Add" and add your LibreNMS server IP address +11. Validate change by clicking "Apply" From abe25614dd19848913665afa6ad4d459415787f9 Mon Sep 17 00:00:00 2001 From: FTBZ Date: Wed, 21 Sep 2016 21:00:56 +0200 Subject: [PATCH 2/3] New documentation with SNMP configuration examples --- doc/Support/SNMP-Configuration-Examples.md | 35 ++++++++++------------ 1 file changed, 16 insertions(+), 19 deletions(-) diff --git a/doc/Support/SNMP-Configuration-Examples.md b/doc/Support/SNMP-Configuration-Examples.md index 328c6ec582..351116d840 100644 --- a/doc/Support/SNMP-Configuration-Examples.md +++ b/doc/Support/SNMP-Configuration-Examples.md @@ -6,10 +6,7 @@ Table of Content: - [Devices](#devices) - [Cisco](#cisco) - [Adaptive Security Appliance (ASA)](#adaptive-security-appliance-asa) - - [IOS](#ios) - - [IOS](#ios) - - [IOS XE](#ios-xe) - - [NX-OS](#nx-os) + - [IOS / IOS XE / NX-OS](#ios--ios-xe--nx-os) - [Wireless LAN Controller (WLC)](#wireless-lan-controller-wlc) - [Infoblox](#infoblox) - [NIOS 7.x](#nios-7x) @@ -19,6 +16,7 @@ Table of Content: - [PANOS 6.x/7.x](#panos-6x7x) - [Operating systems](#operating-systems) - [Linux (snmpd)](#linux-snmpd) + - [Windows Server 2008 R2](#windows-server-2008-r2) - [Windows Server 2012 R2](#windows-server-2012-r2) ## Devices @@ -31,7 +29,7 @@ Table of Content: 4. Add in the "SNMP Host Access List" section your LibreNMS server IP address 5. Click Apply and Save -#### IOS +#### IOS / IOS XE / NX-OS ``` snmp-server community YOUR-COMMUNITY RO @@ -39,20 +37,6 @@ snmp-server contact YOUR-CONTACT snmp-server location YOUR-LOCATION ``` -#### IOS XE -``` -snmp-server community YOUR-COMMUNITY RO -snmp-server contact YOUR-CONTACT -snmp-server location YOUR-LOCATION -``` - -#### NX-OS -``` -snmp-server community YOUR-COMMUNITY RO -snmp-server contact YOUR-CONTACT -snmp-server location YOUR-LOCATION -``` - #### Wireless LAN Controller (WLC) 1. Access the web admin page and log in 2. If you are running version 8.1 and later, on the new dashboard click "Advanced" @@ -136,6 +120,19 @@ systemctl restart snmpd ``` service snmpd restart ``` + +### Windows Server 2008 R2 +1. Log in to your Windows Server 2008 R2 +2. Start "Server Manager" under "Administrative Tools" +3. Click "Features" and then click "Add Feature" +5. Check (if not checked) "SNMP Service", click "Next" until "Install" +6. Start "Services" under "Administrative Tools" +7. Edit "SNMP Service" properties +8. Go to the security tab +9. In "Accepted community name" click "Add" to add your community string and permission +10. In "Accept SNMP packets from these hosts" click "Add" and add your LibreNMS server IP address +11. Validate change by clicking "Apply" + ### Windows Server 2012 R2 1. Log in to your Windows Server 2012 R2 2. Start "Server Manager" under "Administrative Tools" From e6ad42e1bb039be771472cab361d58facccbe2ef Mon Sep 17 00:00:00 2001 From: Neil Lathwood Date: Fri, 23 Sep 2016 20:03:34 +0100 Subject: [PATCH 3/3] Added link to support section in mkdocs.yml --- mkdocs.yml | 1 + 1 file changed, 1 insertion(+) diff --git a/mkdocs.yml b/mkdocs.yml index 32d486973a..54144e5b09 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -91,6 +91,7 @@ pages: - Support/Performance.md - Support/Poller Support.md - Support/Support-New-OS.md + - Support/SNMP-Configuration-Examples.md - hidden: - Ubuntu 14.04 (Nginx): Installation/Installation-Ubuntu-1404-Nginx.md - Ubuntu 14.04 (Apache): Installation/Installation-Ubuntu-1404-Apache.md