Obtaining itologmon
-------------------

- Obtain the source code distribution tarball from
  http://sourceforge.net/projects/itologmon/.

- Extract the distribution tarball:
	cd /tmp
	gunzip < itologmon-X.Y.Z.tar.gz | tar -xvf -

- Read the BUGS document.  It contains important warnings about bugs and
  limitations in this software.


Compiling itologmon
-------------------

- Ensure build prerequisites are met:
      o	HP-UX 10.20 or 11.00; Solaris 2.6.  Later versions may work, but
	have not been tested.
      o	ITO version A.05.3x: use 'swlist ITOAgent' (on HP-UX) or 'pkginfo
	OPC' (on Solaris) to check.
      o	Berkeley DB 1.x (or a later version in 1.x compatibility mode) from
	http://sleepycat.com.  Your OS vendor-supplied version of NDBM may
	also work.
      o GNU development utilities:
	- For HP-UX 10.20: gcc 2.95.2, make 3.76.1, binutils 2.9.1
	- For HP-UX 11.00: gcc 2.95.2, make 3.78.1, binutils 2.9.1
	- Solaris 2.6: gcc 2.8.1, make 3.76.1
	The HP-UX versions of the GNU utilities used in developing
	itologmon came from the HP-UX Porting Centre
	<http://hpux.cs.utah.edu>.  Later versions or other compatible
	products may work, but have not been tested.

- Compile itologmon:
	cd itologmon/src
	gmake OS_NAME=`uname -s` <variables>

	The valid variables and their meanings are as follows (default
	values are in brackets):

	    OS_NAME=`uname -s`
		This item must be specified on the command line to enable
		the Makefile to correctly determine the linker flags.
	    PROGNAME=[itologmon]
	    VERSION=[current version]
		Set these to override the name or version number of
		itologmon (e.g. if you wish to distinguish internal build
		numbers or the like).
	    CC=[gcc]
		C compiler to use
	    PREFIX=[/usr/local]
		The installation base directory of the executable.  The
		itologmon executable will be installed in $(PREFIX)/bin.
		Documentation and man pages will be installed in
		$(PREFIX)/doc and $(PREFIX)/man, respectively.
	    DBDIR=[$(PREFIX)]
		The installation base directory of the Berkeley DB
		routines.
	    LOGDIR=[/var/log]
		The directory where application logs are stored.  Itologmon
		will write its log to $(LOGDIR)/$(PROGNAME).log.
	    STATEFILE=[/var/lib/itologmon.state]
		The name of the state file.


Installing itologmon
--------------------

- Switch to the root user (installation as another user is possible, but
  itologmon should always be run as the same user who installed it):
	su -
	cd /tmp/itologmon/src
	gmake PREFIX=<prefix> installdoc install

- Copy (and modify if desired) the startup scripts from
  examples/sbin/init.d to /sbin/init.d.  Create the desired links in
  /sbin/rc3.d and /sbin/rc2.d.

- Copy examples/etc/rc.config.d/itologmon to /etc/rc.config.d/ and modify
  it appropriately for your site.


Starting itologmon
------------------

- Decide which log files you wish to monitor.  Put these in the
  configuration file you referenced in /etc/rc.config.d/itologmon.

- Prune your log files before starting itologmon for the first time.
  Otherwise, all files will be read in their entirety and passed to ITO.
  This could result in duplicate or erroneous messages and unexpected
  results if automatic actions are configured for any conditions in these
  files.

- Create the directories for the itologmon state file and log file.

- Ensure the ITO agent is running:
	opcagt -status

- Start itologmon:
	/sbin/init.d/itologmon start