README.linux May 1994 Jan 1995 This is the modified source of cmu-snmp2.1.2.tar.Z for Linux (Linux v1.1.60 or above with libc v4.6.20 or above). >> If you are installing the binary version, simply do: >> cd / ; tar xvzf .../cmu-snmp2.1.2.l3-bin.tar.gz >> If you install it the first time, do >> cd tmp/cmu-snmp2.1.2.l3/etc ; ./installconf >> Edit at least /etc/snmpd.conf and create an entry in /etc/rc.local: >> /usr/sbin/snmpd >/dev/null 2>&1 & This distribution is the third release and named cmu-snmp2.1.2l3-src.tar.gz and cmu-snmp2.1.2l3-bin.tar.gz. It is avail at ftp.ibr.cs.tu-bs.de (134.169.34.15) in /pub/local and i guess it will be avail on sunsite and tsx-11. The original cmu code (cmu-snmp2.1.2.tar.Z) is hopefully avail at your nearest, well assorted ftp-server. The changes belongs mostly to the agent/*.[ch] files for the snmpd agent and snmplib/snmp.c for the snmpd.conf reading. The linux version of snmpd uses mainly the /proc/* files, /etc/mtab and some ioctl's for the interface parameters. Setting the writeable system group variables now works (the values are saved in the snmpd.conf file) and the `private' community string for V1 is now configurable via the config file (other communities than `public' and the private community string are now disabled). The host-mib (RFC 1514) is partially added. To be on the secure side, hostSWRun{Perf} requests are only answered for V1 ``private''requests, and the configured V2 views. INSTALLATION: Now there is a ./configure script to change the installation path. Use ./configure --prefix= ; default is --prefix=/usr For a Capt'n Default installation, the Makefiles are prepared and no changes should be neccessary. To compile run ``make'' and to install run ``make install'' (installation will probably need root access). To install only the client or server part (the agent) you may choose to run ``make install-client'' or ``make install-agent'' instead. The *.conf files for the agent are in ./etc/* and will be installed in /etc, if these are not present. The files may be used for SNMPv1 without modification; a ./etc/installconf script is provided for installation with modification for V2. Since l2 there is an /etc/snmpd.conf file to set unusual installation paths, add system.Location and system.Contact strings, to set interface parameters and to set the private community string for V1. INSTALL CONFIG FILES: A default set of config files is installed (from ./etc/*.conf), if they are not present in /etc/. You may run ``./etc/installconf '' to install V2 config files (replacing existent files). Files installed for the agent: /usr/sbin/snmpd /usr/lib/mib.txt /etc/{snmpd,acl,context,party,view}.conf (if not already installed) /usr/man/man8/snmpd.8 /usr/man/man5/variables.5 Files installed for the applications: /usr/bin/snmpwalk /usr/bin/snmptest /usr/bin/snmptranslate /usr/bin/snmpget /usr/bin/snmptrapd /usr/bin/snmpnetstat /usr/bin/mib.txt /etc/{snmpd,acl,context,party,view}.conf (if not already installed) /usr/man/man1/snmpwalk.1 /usr/man/man1/snmptest.1 /usr/man/man1/snmptranslate.1 /usr/man/man1/snmpset.1 /usr/man/man1/snmpget.1 /usr/man/man1/snmpnetstat.1 /usr/man/man5/variables.5 /usr/man/man8/snmptrapd.8 Change `install-apps' in the Makefile, if not all applications are of your interest. STARTUP AT BOOTTIME: To run ``snmpd'' at boottime add a line to /etc/rc.local containing: /usr/sbin/snmpd >/dev/null 2>&1 & You may test it with ``snmpwalk -v 1 localhost public'' or choose tkined's SNMP Trouble-Shooter or SNMP-Browser to contact the agent. Please have a look at the original README file too and for the copyright refer to agent/snmpd.c. Please Note: The snmptcl/* stuff is left as-is and will surely not work. It is not included in compilation and installation. Please allow me to point to ftp://ftp.ibr.cs.tu-bs.de/pub/local/tkined/ with tkined and scotty. Tkined is a tk/tcl based network management tool and scotty a tcl based interpreter, which allows beside other funcionality easy access to snmp queries and monitoring. If you are running a CD-based Linux-system (/usr/lib mounted readonly from CD), you may copy mib.txt to /etc and it will be used instead. NEWS: * cmu-snmp2.1.2l3 wrapped. * ipNetToMediaType now should distinguish between static, dynamic and other arp entries, instead of telling always dynamic. * V2 communication with MD5 authentication seems to work fine. * man/{snmpset.1,snmpget.1,snmpnetstat.1,snmptrapd.8} and apps/snmpset.c added from cmu-snmp2.1.2.1.tar.gz, which was created/modified by dpz@noc.rutgers.edu, 15 July 1994 for SunOS 5.x. * snmpnetstat failed due to a uninitialized variable, when running the optimized version; fixed. * at least gcc v2.6.2 miscompiles snmplib/snmp_acl.c with optimisation switched on; harmless workaround added. * hrSWRun[Perf] restricted to V1 ``private'' requests. * from the host resources mib (rfc1514) the hrSystem group and parts of hrStorage, hrDevice, hrSWRun and hrSWRunPerf are added. * sysName, sysContact, sysLocation are now setable, and remembered in /etc/snmpd.conf (if present); the real hostname is not changed. * system.sysUpTime now returns the ticks up the uptime of the agent, not the system (host.hrSystem.hrSystemUptime tells this). * Interface_Scan_By_Index() in agent/snmp_vars.c tries to optimize identical consecutive requests; timeout added, because identical answers after long intervals are simplely wrong. * cmu-snmp2.1.2l2 wrapped. * MIB-II snmp group added (nearly complete). * ipNetToMedia added; udpEntry added. * ifSpecific added; ipRouteMask added (ipRouteInfo prepared). * /etc/snmpd.conf added - this means setable Location and Contact. * cmu-snmp2.1.2l1 wrapped. BUGS and TODO: * snmpwalk into the party mib shows objectid's with reversed ip-adresses. * add nfs-mounted volumes to hrFSRemoteMountPoint. * setting of routing entries run in an encoding error. haven't tracked this down yet; the code is a mess... patches are welcome. * speedup: the complete reading of the ifnet is very expensive. * byte-order: the code was written for network-byte-order; i guess there are some missing conversions in the applications. * still for harware-adresses only ethernet is assumed. * manpages/docs: aeh, umm - beam me up. Have fun. -- Juergen Schoenwaelder (schoenw@ibr.cs.tu-bs.de) Erik Schoenfelder (schoenfr@ibr.cs.tu-bs.de)