----------------------------------------------------------------------
How to install UMLMON version 1.0.3
----------------------------------------------------------------------

In general, there are currently two options to install UMLMON:

- Use the binary package

- Build UMLMON from sources

As the latter is quite complicated, we only discuss the first option
here. The binary package can be downloaded here:

http://www.ocaml-programming.de/packages/lsb-2.0/lsb-gerd-stolpmann.de-umlmon-1.0.3-1.i386.rpm

This is a so-called Linux Standard Base (LSB) package, for LSB
version 2.0. LSB is a new way to distribute Linux applications in
binary form such that they can be installed on most Linux distributions.
As LSB is not yet well known among sysadmins, here a few words how
to perform the installation.

First, which Linux distros are supported. To my knowledge, the 
following distros are conforming to LSB-2.0:

- SuSE Linux 9.2
- SuSE Enterprise Linux 9 with Service Pack 1 
- Novell Linux Desktop 9 with Service Pack 1
- Mandriva Corporate Server 3.0
- Mandriva Linux 10.1
- Debian 3.1 (Sarge)
- Ubuntu 5.04 (Hoary Hedgehog)

(Sorry, Redhat & Fedora only support LSB-1.3. Use the TAR installation
method sketched below.)

Now, how to do the installation. As LSB is an optional feature for
many Linux distributions, one must install LSB first.

----------------------------------------------------------------------
RPM-based systems (SuSE, Novell, Mandriva etc.)
----------------------------------------------------------------------

Install the package "lsb" first (using the normal package management
tools, e.g. yast2).

Install UMLMON:

$ rpm -i lsb-gerd-stolpmann.de-umlmon-1.0.3-1.i386.rpm

If you want to do bridged networking, you also need the
"bridge-utils" package of your distribution.

----------------------------------------------------------------------
DEB-based systems (Debian, Ubuntu)
----------------------------------------------------------------------

Install the package "lsb" first:

$ apt-get install lsb

Install UMLMON:

$ alien -i lsb-gerd-stolpmann.de-umlmon-1.0.3-1.i386.rpm

If you want to do bridged networking, you also need the
"bridge-utils" package of your distribution:

$ apt-get install bridge-utils

----------------------------------------------------------------------
Installation from TAR
----------------------------------------------------------------------

In addition to the RPM method there is also the possibility to
install a tar file. Download

http://www.ocaml-programming.de/packages/linux-glib-2.3/umlmon-1.0.3-1.i386.tar.gz

and unpack this file as root user in /:

$ cd /
$ tar xzf umlmon-1.0.3-1.i386.tar.gz

Note: The programs are installed into /usr/local and not into /usr as
for the RPM method.

Execute the postinstall script:

$ /usr/local/sbin/umlmon-postinstall

Note: Packages installed by this method can also be uninstalled if you
keep the tar.gz file at a safe place:

$ cd /
$ tar tf umlmon-1.0.3-1.i386.tar.gz | grep -v "/\$" | xargs rm -f
$ tar tf umlmon-1.0.3-1.i386.tar.gz | grep "/\$" | tac | xargs rmdir

----------------------------------------------------------------------
Power UMLMON on!
----------------------------------------------------------------------

Start UMLMON by:

$ /etc/init.d/umlmon start

The rpm package already installs links in the rc directories so
UMLMON will be started at boot time.

See the manual pages for documentation:

- umlmon(7) - "Concepts and Architecture" is the best starting point.
  It also includes a section how to get started.

- umlmon(5) "Configuration file of the UMLMON monitor" explains
  the parameters that can be used in /etc/umlmon.

- umlwatch(1) - "User interface for the UMLMON monitor" is the
  interactive command to control UMLMON when it is running.

- umladmin(8) - "Administrative interface to UMLMON" is the
  utility to start and stop UMLMON instances.

----------------------------------------------------------------------
The Web Interface
----------------------------------------------------------------------

Currently, the web interface is only available in German language.
There is a CGI in /usr/lib/umlmon_web/cgi-bin. To activate it, 
install the Apache web server, configure it, and include the 
file /usr/share/umlmon_web/httpd.conf. You may also want to
customize /usr/share/umlmon_web/ui/umlmon_web-config.xml, and
maybe the .ui file in the same directory.