[Mon-commit] mon INSTALL,1.1.1.1.2.2,1.1.1.1.2.3
Brought to you by:
trockij
|
From: Jim T. <tr...@us...> - 2004-07-09 03:19:08
|
Update of /cvsroot/mon/mon In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv2708 Modified Files: Tag: mon-1-0-0pre1 INSTALL Log Message: some clarifications in INSTALL documentation submitted by Eric Sorenson <er...@tr...> minor addition to alert behavior explanation in mon.8 in dialin.monitor.wrap.c, return the exit status of execv (if it fails, that is) fixed path to perl in file_change.monitor and smtp3.monitor Index: INSTALL =================================================================== RCS file: /cvsroot/mon/mon/INSTALL,v retrieving revision 1.1.1.1.2.2 retrieving revision 1.1.1.1.2.3 diff -C2 -d -r1.1.1.1.2.2 -r1.1.1.1.2.3 *** INSTALL 18 Jun 2004 14:40:10 -0000 1.1.1.1.2.2 --- INSTALL 9 Jul 2004 03:18:52 -0000 1.1.1.1.2.3 *************** *** 1,61 **** $Id$ ! INSTALLATION ! ------------ ! ! Several parts: ! ! 1. mon, the server ! 2. Mon::Client, the Perl library used by some clients. 3. C programs in mon.d ! REQUIREMENTS ! ------------ ! The "mon" daemon uses Perl 5.n, where n >= 005_01. Older versions of Perl had ! problems with Sys::Syslog under Linux, and had dated versions of ! Text::ParseWords. Mon also requires that *.ph be created from the system ! header files. If you're using a pre-packaged Perl (such as from RedHat) then ! this has been done for you already. Otherwise, this is done manually during ! Perl installation by these means: cd /usr/include ! h2ph *.h sys/*.h ! However, if you're running Linux you may need to run ! cd /usr/include ! h2ph *.h sys/*.h asm/*.h - If you try to run mon and Perl complains with the "did you run h2ph?" - message, then chances are this step wasn't done. ! You'll need the following modules for the server to function, all of ! which are available from your nearest CPAN archive, or the place ! where you got mon: ! -Time::Period (the one written by Patrick Ryan) ! -Time::HiRes ! -Convert::BER ! -Mon::* All of the monitor and alert scripts that are packaged with mon are actually *optional*. However, this is what you'll need for each special ! monitor: ! freespace.monitor ! The disk space monitor requires the "Filesys::DiskSpace" Perl ! module from CPAN. ! fping.monitor ! Requires the "fping" code, probably available from the same ! place that you got this package. ! telnet.monitor ! This requires the Net::Telnet Perl module, available from ! CPAN. reboot.monitor --- 1,87 ---- $Id$ ! OVERVIEW ! -------- ! There are several components you'll need to get working to ! have a fully functional mon installation. + 1. mon, the server + 2. Mon::Client, the Perl library used by some clients 3. C programs in mon.d + 4. Optional (but highly useful) monitors + 5. A customized mon.cf to make the server do what you want ! 1. MON SERVER ! ------------- ! The "mon" daemon uses Perl 5.n, where n >= 005_01. ! ! Mon requires that *.ph be created from the system header files. If you try to ! run mon and Perl complains with the "did you run h2ph?" message, then chances ! are this step wasn't done, either by your package manager or manually after ! Perl installation. You can fix it by doing the following, as root: cd /usr/include ! h2ph -r -l . ! You'll need the following modules for the server to function, all of ! which are available from your nearest CPAN archive. The listed ! CPAN paths relative to /cpan/modules/by-authors/id/ -- versions of ! modules on CPAN change quickly, so there may be newer versions available, ! but the following are known to work: ! Time::Period PRYAN/Period-1.20.tar.gz ! Time::HiRes J/JH/JHI/Time-HiRes-1.59.tar.gz ! Convert::BER G/GB/GBARR/Convert-BER-1.3101.tar.gz ! 2. INSTALLING THE PERL CLIENT MODULE ! ------------------------------------ ! The Perl client module is distributed as a separate package. It is named ! "mon-client-*.tar.gz". Refer to that for installation instructions. ! It is available on kernel.org mirrors in the /pub/software/admin/mon directory, ! and in CVS on sourceforge.net. Be sure to match the version of mon-client with ! the version of mon you are using. At this time, branch "mon-1-0-0pre1" of the ! mon CVS module matches the "mon-client-1-0-0pre1" branch of the mon-client CVS ! module. See http://sourceforge.net/projects/mon/ for information on CVS access. ! ! ! 3. COMPILING THE C CODE (optional) ! ---------------------------------- ! ! Some of the monitors included with mon are written in C and need to ! be compiled for your system. If you want to use the RPC monitor or the ! dialin.monitor wrapper, ! ! cd mon.d ! (edit Makefile) ! make ! make install ! cd .. ! ! Keep in mind that although this is known to work on Linux, Solaris, and AIX, ! it may not compile on your system. It is not required for the operation of mon ! itself. ! ! ! 4. MONITORS ! ----------- All of the monitor and alert scripts that are packaged with mon are actually *optional*. However, this is what you'll need for each special ! monitor, with CPAN paths relative to /cpan/modules/by-author/id/ ! freespace.monitor - requires Filesys::Diskspace from CPAN, ! in FTASSIN/Filesys-DiskSpace-0.05.tar.gz ! ! fping.monitor - requires the 'fping' binary, from http://www.fping.com ! RPM packages available at http://dag.wieers.com/packages/fping/ ! telnet.monitor - requires the Net::Telnet from CPAN, ! in J/JR/JROGERS/Net-Telnet-3.03.tar.gz reboot.monitor *************** *** 64,78 **** process.monitor hpnp.monitor ! All use the UCD SNMP 3.6.3, along with G.S. Marzot's ! Perl module. ! ! ldap.monitor ! requires the Net::LDAPapi Perl module, available from CPAN. ! dialin.monitor ! requires the Perl Expect module, available from CPAN. ! dns.monitor ! requires the Net::DNS Perl module. msql-mysql.monitor --- 90,104 ---- process.monitor hpnp.monitor ! Use the 'net-snmp' package (formerly UCD SNMP), from ! http://sourceforge.net/projects/net-snmp ! with G.S. Marzot's Perl module G/GS/GSM/SNMP-4.2.0.tar.gz ! ldap.monitor - requires Net::LDAPapi from CPAN, ! CDONLEY/Net-LDAPapi-1.42.tar.gz ! dialin.monitor - requires the Perl Expect module from CPAN, ! R/RG/RGIERSIG/Expect-1.15.tar.gz ! dns.monitor - requires Net::DNS from CPAN, ! C/CR/CREIN/Net-DNS-0.47.tar.gz msql-mysql.monitor *************** *** 83,110 **** details. ! ! 1. INSTALLING THE PERL CLIENT MODULE ! ------------------------------------ ! ! The Perl client module is distributed as a separate package. It is named ! "mon-client-*.tar.gz". Refer to that for installation instructions. This ! module is available in CPAN (http://www.perl.com/CPAN/), on kernel.org mirrors ! in the /pub/software/admin/mon directory, and in CVS on sourceforge.net. ! Be sure to match the version of mon-client with the version of mon you ! are using. ! ! If you are using a CVS release of the mon server, you will want ! to be sure to match it with the corresponding version from the ! "mon-client" module. At this time, branch "mon-1-0-0pre1" of the ! mon CVS module matches the "mon-client-1-0-0pre1" branch of the ! mon-client CVS module. See http://sourceforge.net/projects/mon/ for ! information on CVS access. ! ! ! 2. MON SERVER INSTALLATION ! -------------------------- -Read the man page for "mon" and "moncmd" in the doc/ directory to get ! an overview about the directories involved, i.e. the configuration, alert, monitors, state, and run directories. --- 109,117 ---- details. ! 5. MON.CF CUSTOMIZATION AND STARTUP ! ----------------------------------- -Read the man page for "mon" and "moncmd" in the doc/ directory to get ! an overview of the directories involved, i.e. the configuration, alert, monitors, state, and run directories. *************** *** 169,182 **** - 3. COMPILING THE C CODE (optional) - ---------------------------------- - - -cd mon.d - (edit Makefile) - make - make install - cd .. - - to build the RPC monitor and the dialin.monitor wrapper. Keep in mind - that if this may fail for some reason (it works under Linux, Solaris, - and AIX), it is not required for the operation of mon itself. --- 176,177 ---- |