Difference between revisions of "Snmpd"

From ArchWiki
Jump to: navigation, search
m (replacing <tt>text</tt> with {{Codeline|text}})
(Testing: Remove start service from sysvinit. Systemd version written just above.)
(5 intermediate revisions by 5 users not shown)
Line 1: Line 1:
[[Category:Daemons and system services (English)]]
+
[[Category:Status monitoring and notification]]
 
+
 
'''''[http://en.wikipedia.org/wiki/Simple_Network_Management_Protocol SNMP]''' is a tool designed for the management and monitoring of network devices. The Net-SNMP package is one implementation of SNMP that is available for Arch Linux. This article discusses the configuration and testing of the snmpd daemon that ships with Arch's net-snmp package.
 
'''''[http://en.wikipedia.org/wiki/Simple_Network_Management_Protocol SNMP]''' is a tool designed for the management and monitoring of network devices. The Net-SNMP package is one implementation of SNMP that is available for Arch Linux. This article discusses the configuration and testing of the snmpd daemon that ships with Arch's net-snmp package.
 
''
 
''
Line 11: Line 10:
 
== Configuration ==
 
== Configuration ==
  
Note that it is crucial that the snmpd service is not running while editing configuration files for it, especially {{Codeline|/var/net-snmp/snmpd.conf}}.
+
Note that it is crucial that the snmpd service is not running while editing configuration files for it, especially {{Ic|/var/net-snmp/snmpd.conf}}.
  
 
=== Daemon ===
 
=== Daemon ===
  
Add the daemon to {{Codeline|/etc/rc.conf}}:
+
Enable the daemon
  
  DAEMONS=(syslog-ng network netfs crond httpd '''snmpd''')
+
  systemctl enable snmpd
  
 
=== SNMP 1 and 2c ===
 
=== SNMP 1 and 2c ===
  
There are three versions of SNMP which are supported by net-snmp: 1, 2c and 3. Versions 1 and 2c start with the same basic configuration, using {{Codeline|/etc/snmp/snmpd.conf}}.
+
There are three versions of SNMP which are supported by net-snmp: 1, 2c and 3. Versions 1 and 2c start with the same basic configuration, using {{Ic|/etc/snmp/snmpd.conf}}.
  
  # mkdir -p /etc/snmp/
+
  mkdir /etc/snmp/
  # echo rocommunity ''read_only_user'' >> /etc/snmp/snmpd.conf
+
  echo rocommunity ''read_only_user'' >> /etc/snmp/snmpd.conf
  
 
The above commands will add a user that can be used for monitoring. Optionally, you can add another user used for management. This is not recommended unless you have a specific reason.
 
The above commands will add a user that can be used for monitoring. Optionally, you can add another user used for management. This is not recommended unless you have a specific reason.
  
  # echo rwcommunity ''read_write_user'' >> /etc/snmp/snmpd.conf
+
  echo rwcommunity ''read_write_user'' >> /etc/snmp/snmpd.conf
  
 
=== SNMP 3 ===
 
=== SNMP 3 ===
  
SNMP v3 adds security and encrypted authentication/communication. It uses different configuration in {{Codeline|/etc/snmp/snmpd.conf}}, plus additional configuration in {{Codeline|/var/net-snmp/snmpd.conf}}.
+
SNMP v3 adds security and encrypted authentication/communication. It uses different configuration in {{Ic|/etc/snmp/snmpd.conf}}, plus additional configuration in {{Ic|/var/net-snmp/snmpd.conf}}.
  
  # mkdir -p /etc/snmp/
+
  mkdir /etc/snmp/
  # echo rouser ''read_only_user'' >> /etc/snmp/snmpd.conf
+
  echo rouser ''read_only_user'' >> /etc/snmp/snmpd.conf
  # mkdir -p /var/net-snmp/
+
  mkdir -p /var/net-snmp/
  # echo createUser ''read_only_user'' SHA ''password1'' AES ''password2'' > /var/net-snmp/snmpd.conf
+
  echo createUser ''read_only_user'' SHA ''password1'' AES ''password2'' > /var/net-snmp/snmpd.conf
  
Note that once snmpd is restarted, {{Codeline|/var/net-snmp/snmpd.conf}} will be rewritten, and the clear-text passwords that you have entered will be encrypted. If this file is modified while snmpd is running, any changes will be reset when the daemon is stopped. Therefore, it is crucial that snmpd is not running while this file is being updated.
+
Note that once snmpd is restarted, {{Ic|/var/net-snmp/snmpd.conf}} will be rewritten, and the clear-text passwords that you have entered will be encrypted. If this file is modified while snmpd is running, any changes will be reset when the daemon is stopped. Therefore, it is crucial that snmpd is not running while this file is being updated.
  
== Testing ==
+
=== Start Daemon ===
  
The above configuration will suffice for a basic installation. To begin testing, start the snmpd service:
+
After configuring the daemon, start it
  
  # /etc/rc.d/snmpd start
+
  systemctl start snmpd
 +
 
 +
== Testing ==
  
 
If using SNMP 1 or 2c, use one of the following commands to test configuration:
 
If using SNMP 1 or 2c, use one of the following commands to test configuration:

Revision as of 10:10, 13 November 2013

SNMP is a tool designed for the management and monitoring of network devices. The Net-SNMP package is one implementation of SNMP that is available for Arch Linux. This article discusses the configuration and testing of the snmpd daemon that ships with Arch's net-snmp package.

Installation

There is one package for net-snmp in Arch Linux which contains both the snmpd daemon, and the accompanying utilities.

# pacman -S net-snmp

Configuration

Note that it is crucial that the snmpd service is not running while editing configuration files for it, especially /var/net-snmp/snmpd.conf.

Daemon

Enable the daemon

systemctl enable snmpd

SNMP 1 and 2c

There are three versions of SNMP which are supported by net-snmp: 1, 2c and 3. Versions 1 and 2c start with the same basic configuration, using /etc/snmp/snmpd.conf.

mkdir /etc/snmp/
echo rocommunity read_only_user >> /etc/snmp/snmpd.conf

The above commands will add a user that can be used for monitoring. Optionally, you can add another user used for management. This is not recommended unless you have a specific reason.

echo rwcommunity read_write_user >> /etc/snmp/snmpd.conf

SNMP 3

SNMP v3 adds security and encrypted authentication/communication. It uses different configuration in /etc/snmp/snmpd.conf, plus additional configuration in /var/net-snmp/snmpd.conf.

mkdir /etc/snmp/
echo rouser read_only_user >> /etc/snmp/snmpd.conf
mkdir -p /var/net-snmp/
echo createUser read_only_user SHA password1 AES password2 > /var/net-snmp/snmpd.conf

Note that once snmpd is restarted, /var/net-snmp/snmpd.conf will be rewritten, and the clear-text passwords that you have entered will be encrypted. If this file is modified while snmpd is running, any changes will be reset when the daemon is stopped. Therefore, it is crucial that snmpd is not running while this file is being updated.

Start Daemon

After configuring the daemon, start it

systemctl start snmpd

Testing

If using SNMP 1 or 2c, use one of the following commands to test configuration:

# snmpwalk -v 1 -c read_only_user localhost | less
# snmpwalk -v 2c -c read_only_user localhost | less

If using SNMP 3, use the following command to test configuration:

# snmpwalk -v 3 -u read_only_user -a SHA -A password1 -x DES -X password2 -l authNoPriv localhost | less

Either way, you should see several lines of data looking something like:

SNMPv2-MIB::sysDescr.0 = STRING: Linux myhost 2.6.37-ARCH #1 SMP PREEMPT Sat Jan 29 20:00:33 CET 2011 x86_64
SNMPv2-MIB::sysObjectID.0 = OID: ccitt.1
DISMAN-EVENT-MIB::sysUpTimeInstance = Timeticks: (307772) 0:51:17.72
SNMPv2-MIB::sysContact.0 = STRING: root@localhost
SNMPv2-MIB::sysName.0 = STRING: myhost
...SNIP...