libs-ec/README.SNMP
Richard Frith-MacDonald 2f8730a81c fix typo and add a couple of notes
git-svn-id: svn+ssh://svn.gna.org/svn/gnustep/libs/ec/trunk@38860 72102866-910b-0410-8b05-ffd578937521
2015-08-07 18:17:59 +00:00

106 lines
4.1 KiB
Text

Here's the sort of thing you might do to set up SNMP support on your
system, assuming that you have net-snmp installed in the normal
locations for something like RedHat Linux.
0. Edit the example GNUSTEP-MIB.txt to contain your own organisation's
Private Enterprise Number. This stage is optional, you may use the
MIB 'as-is' with the GNUstep PEN if you wish. You only need to use
an edited version if your organisation wishes to use its own MIB
with additional features not in the GNUstep one.
If you are using your own MIB, replace all ocurrances below of
GNUSTEP-MIB.txt with the name of your own MIB file.
1. install GNUSTEP-MIB.txt in /usr/share/snmp/mibs or wherever net-snmp
keeps its MIBs on your system. This manual installation is required
for a system-wide installation, but if you only want to have access
to the MIB yourself, the default installation process will have put
the MIB in your local directory(~/.snmp/mibs) which is correct for
net-snmp on most systems.
2. For diagnosing problems in snmpd (revert when not debugging),
edit '/etc/sysconfig/snmpd' to contain:
OPTIONS="-Dgnustep -Lf /var/log/snmpd"
so that any debug for the gnustep MIB would be logged
in /var/log/snmpd
or use '-Dgnustep -LS0-6d' for logging via syslog.
3. For diagnosing problems in snmptrapd (revert when not debugging),
edit '/etc/sysconfig/snmptrapd' to contain:
OPTIONS="-Dgnustep -Lf /var/log/snmptrapd"
so that any debug for the gnustep MIB would be logged
in /var/log/snmptrapd
or use '-Dgnustep -LS0-6d' for logging via syslog.
4. edit /etc/snmp/snmpd.conf to get it to send traps to snmptrapd ...
rwcommunity public
trap2sink localhost public
and to accept agentx connections via tcp ...
agentxsocket tcp:localhost:705
master agentx
having the snmp daemon listening on port 705 for agentx connections is
essential for the default setup of alarming, but you can use a different
host and port if you wish (see the EcAlarmSinkSNMP initialisation for
details).
NB. Your system may be configured to disallow access via 'public', in
which case the line
rwcommunity public
will not be sufficient to grant access to the alarm tables and you will
need to either configure appropriate snmp access control settings for
your system, or completely replace the file (but that would give
unrestricted access, and therefore be a security problem ... so you
should only do it for temporary testing of an isolated system).
5. restart with '/sbin/service snmpd restart'
If you are starting snmp for the first time on a RedHat system then:
# /sbin/chkconfig snmpd on
# /sbin/service snmpd start
should enable the snmp service and then start it.
6. For diagnostics and control of the net-snmp copmponent, you can use a
gnustep.conf file in any of the standard locations read by netsnmp.
Typically ~/.snmp/gnustep.conf (where ~ is the home directory of the
account running the Control server).
The contents of the file to enable debug logging would typically be
[snmp]
doDebugging 1
debugTokens gnustep
7. build/install/run the Control server
8. test with snmpwalk ...
To look at EVERYTHING:
snmpwalk -v 1 -c public localhost GNUSTEP-MIB::gnustep
To look at the current alarms table:
snmpwalk -v 1 -c public localhost GNUSTEP-MIB::gnustep.alarms.alarmsTable
To look at the current alarms table in a tabular format (rows of columns) which will be far too wide to view in a normal terminal window:
snmptable -v 1 -c public localhost GNUSTEP-MIB::gnustep.alarms.alarmsTable
To look at the managed objects table:
snmpwalk -v 1 -c public localhost GNUSTEP-MIB::gnustep.objects
You should be able to get the heartbeat poll interval with:
snmpget -v 1 -c public localhost GNUSTEP-MIB::pollHeartBeat.0
You should be able to set the heartbeat poll interval to two minutes with
snmpset -v 1 -c public localhost GNUSTEP-MIB::pollHeartBeat.0 i 2
You should be able to set the resync flag interval with
snmpset -v 1 -c public localhost GNUSTEP-MIB::resyncFlag.0 i 1
and set it back to normal with
snmpset -v 1 -c public localhost GNUSTEP-MIB::resyncFlag.0 i 0