----------------------------------------------------------------------
Wie man UMLMON version 1.0.4 installiert
----------------------------------------------------------------------

Prinzipiell gibt es zur Zeit zwei Möglichkeiten, UMLMON zu 
installieren:

- Verwende das Binärpaket

- Übersetze UMLMON aus den Quellen

Da Letzteres recht kompliziert ist, diskutieren wir hier nur die
erste Möglichkeit. Das Binärpaket kann hier heruntergeladen werden:

- LSB 2.0-Paket:

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

- LSB 3.0-Paket:

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

Dies ist ein sogenanntes "Linux Standard Base (LSB)"-Paket, für LSB
Version 2.0 bzw. 3.0. LSB ist ein neuer Weg, um Linux-Anwendungen in
binärer Form zu vertreiben, so dass sie auf den meisten Linux-
Distributionen installierbar sind. Da LSB noch keinen weiten
Bekanntheitsgrad unter Sysadmins hat, hier nun einige Worte, wie man
die Installation durchführt.
 
Zunächst welche Linux-Distributionen unterstützt werden. Nach meinem
Wissen entsprechen die folgenden Distributionen dem LSB-2.0-Standard:

- 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)

Folgende Distributionen entsprechen dem LSB-3.0-Standard:

- SuSE Linux 10.0 und 10.1
- RedHat RHEL 4 Update 2
- Fedora Core 5
- Mandriva 2006 PowerPack 
- Ubuntu 6.06 LTS 

Nun, wie man die Installation durchführt. Da LSB eine optionale
Komponente der meisten Linux-Distributionen ist, muss man zuerst
LSB installieren.

----------------------------------------------------------------------
RPM-basierte Systeme (RedHat, SuSE, Novell, Mandriva etc.)
----------------------------------------------------------------------

Installieren Sie zuerst das Paket "lsb" (mit den normalen
Paket-Management-Tools, z.B. yast2).

Installieren Sie UMLMON:

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

Falls Sie "bridged networking" verwenden wollen, benötigen Sie
auch das "bridge-utils"-Paket Ihrer Distribution.

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

Installieren Sie zuerst das Paket "lsb":

$ apt-get install lsb

Installieren Sie UMLMON:

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

Falls Sie "bridged networking" verwenden wollen, benötigen Sie
auch das "bridge-utils"-Paket Ihrer Distribution.

$ apt-get install bridge-utils

----------------------------------------------------------------------
Installation mittels TAR
----------------------------------------------------------------------

Es gibt auch die Möglichkeit, ein tar-File zu installieren. Besorgen
Sie sich

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

und packen Sie diese Datei als root-Benutzer unter / aus:

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

Hinweis: Die Programme werden nach /usr/local installiert, nicht nach
/usr wie bei RPM.

Führen Sie das Postinstall-Skript aus:

$ /usr/local/sbin/umlmon-postinstall

Hinweis: Mit dieser Methode installierte Pakete können nur deinstalliert
werden, wenn Sie die tar.gz-Datei aufheben:

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

----------------------------------------------------------------------
Schalten Sie UMLMON ein!
----------------------------------------------------------------------

Starten Sie UMLMON mit dem Kommando:

$ /etc/init.d/umlmon start

Das RPM-Paket installiert bereits Links in den rc-Verzeichnissen,
so dass UMLMON zum Boot-Zeitpunkt hochgefahren wird.

Die folgenden Handbücher enthalten Dokumentation (leider nur in
Englisch):

- umlmon(7) - "Concepts and Architecture" ist der beste Einstieg.
  Es enthält auch einen Abschnitt, wie man mit UMLMON anfängt.

- umlmon(5) "Configuration file of the UMLMON monitor" erläutert
  die Parameter, die man in /etc/umlmon verwenden kann.

- umlwatch(1) - "User interface for the UMLMON monitor" ist
  das interaktive Kommando, um UMLMON zur Laufzeit zu steuern.

- umladmin(8) - "Administrative interface to UMLMON" ist das
  Werkzeug, um UMLMON-Instanzen zu starten und zu stoppen.

Die Bedienungsanleitung erhalten Sie in deutscher Sprache auf der
Homepage:

http://www.gerd-stolpmann.de/umlmon

----------------------------------------------------------------------
Das Web-Interface
----------------------------------------------------------------------

Zur Zeit ist das Web-Interface nur in Deutsch erhältlich.
Es gibt ein CGI in /usr/lib/umlmon_web/cgi-bin. Um es zu aktivieren,
installieren Sie den Apache-Web-Server, konfigurieren Sie ihn,
und binden Sie die Datei /usr/share/umlmon_web/httpd.conf ein.
Sie wollen wahrscheinlich auch /usr/share/umlmon_web/ui/umlmon_web-config.xml
an Ihre Bedingungen anpassen, und ggf. auch die .ui-Dateien in dem
selben Verzeichnis.