----------------------------------------------------------------------
Installation of UMLMON
----------------------------------------------------------------------

UMLMON relies heavily on third-party software. Currently, there isn't
any Linux distribution that has all that software in the required
versions.

There is a very simple way to install UMLMON: Get the GODI distribution
of Objective Caml (http://godi.ocaml-programming.de), and install the
apps-umlmon package. The following few commands suffice to do that:

$ wget http://www.ocaml-programming.de/packages/godi-bootstrap-XXX.tar.gz
$ tar xzf godi-bootstrap-XXX.tar.gz

(Replace XXX with the latest version, currently 20050829.)

$ cd godi-bootstrap-XXX
$ ./bootstrap -prefix /opt/umlmon
$ export PATH=/opt/umlmon/bin:/opt/umlmon/sbin:$PATH
$ ./bootstrap_stage2
$ godi_console perform -build apps-umlmon

Optionally:

$ godi_console perform -build apps-umlmon-web

This should need only < 30 minutes on a modern computer. Of course,
you also have then all the development files on your system. With

$ godi_info -L apps-umlmon

you get the list of files of the UMLMON package.

----------------------------------------------------------------------
The hard way: Prerequisites
----------------------------------------------------------------------

You need:

- The Objective Caml 3.08.4 compiler
  (http://caml.inria.fr)

- The findlib package manager, version 1.0.4 or better
  (http://www.ocaml-programming.de/packages)

- The equeue library for event-driven programming, version 2.1.4 or better
  (http://www.ocaml-programming.de/packages)

- The OcamlNet library for network-related stuff, version 1.1 or better
  (http://sf.net/projects/ocamlnet)

- The RPC library for the RPC stuff, version 0.4.4 or better
  (http://www.ocaml-programming.de/packages)

- The Cryptokit library for cryptography, version 1.2 or better
  (http://pauillac.inria.fr/~xleroy/software.html)

- For the web interface only: The PXP XML parser, version 1.1.95 or
  better (http://www.ocaml-programming.de/packages)

- For the web interface only: The WDialog web framework, version 2.1.1
  or better (http://sf.net/projects/wdialog)

----------------------------------------------------------------------
The hard way: Building
----------------------------------------------------------------------

If you have all that, you can build UMLMON:

$ ./configure -prefix /where/to/install

The prefix defaults to /usr/local if not given.

$ make all opt
$ make install

You can install into a local hierarchy by setting the IPREFIX
variable:

$ make install IPREFIX=$PWD/root

This might be useful to create rpms.