<chapter id="installation"><title>Installation</title><sect1 id="general_instructions"><title>Allgemeine Anweisungen</title><para> Sehr einfach kann man Umbrello installieren, indem man ein vorkompiliertes Paket (rpm, deb) für sein System nutzt. Zieht man es vor seine Anwendungen selber zu kompilieren oder gibt es für das Zielsystem keine binäres Paket, dann kann man die Quellen herunterladen und muss den Anleitungen zur Installation der Quellen folgen. </para><para> Es ist uns bewusst, dass es für sehr viele Nutzer schwierig ist das Programm aus den Quellen selber zu installieren, weshalb wir versuchen eine Vielzahl von vorkompilierten Paketen für verschiedene uns verfügbare Systeme/Distributionen anzubieten. Will man Umbrello mittels eines binären Paketes installieren, sollte man auf <ulink url="http://uml.sourceforge.net/">Umbrellos Homepage</ulink> nach einem passenden Paket suchen. Dort werden wir alle Pakete ablegen, die wir selber erstellt haben oder die uns von Dritten zur Verfügung gestellt werden. </para><para> Wenn sie selber ein Paket für eine Plattform erstellen können, für die es momentan noch kein Paket gibt, kontaktieren sie bitte die Entwickler, damit wir dieses Paket veröffentlichen können und so andere Nutzer unterstützen! </para></sect1><sect1 id="binary_installation"><title>Binärpaket Installation</title><para> Um ein vorkompiliertes Umbrello Paket zu installieren, muss man die mit dem System mitgelieferte Paketverwaltung verwenden. Oftmals kann man die Paketverwaltung auch direkt über die Kommandozeile aufrufen. Um zum Beispiel ein Debian (deb) Paket zu installieren, muss man in das Verzeichnis mit dem runtergeladenen Paket wechseln und folgendes Kommando eingeben: <screen width="40"><prompt>% </prompt><userinput>dpkg -i umbrello-1.1-i386.deb</userinput></screen> </para><para> Im Fall eines rpm Paketes muss das Kommando lauten: <screen width="40"><prompt>% </prompt><userinput>rpm -i umbrello-1.1-i386.rpm</userinput></screen> </para><para> Für andere Plattformen muss die entsprechende Dokumentation zu Rate gezogen werden. </para></sect1><sect1 id="source_installation"><title>Installation der Quellen</title><para> Will man Umbrello direkt aus den Quellen installieren, sollte man zuerst die README und INSTALL Datei für die letzten Informationen lesen. </para><para> Der erste Schritt bei der Quelleninstallation ist es, die Quellen zu entpacken. Dazu muss man in das Verzeichnis mit dem heruntergeladenem Quellarchiv wechseln und folgendes Kommando ausführen: <screen width="40"><prompt>% </prompt><userinput>tar -xvzf umbrello-1.1.tar.gz</userinput></screen> </para><para> Dadurch wird ein neues Verzeichnis angelegt, welches die eigentlichen Quelldateien enthält. </para><para> Im nächsten Schritt muss man in dieses Verzeichnis wechseln und den Kompilierungsprozess konfigurieren und danach starten. Dazu sind prinzipiell folgende Kommandos erforderlich: <screen width="40"><prompt>% </prompt><userinput>./configure --prefix=&lt;Pfad zum KDE Basisverzeichnis&gt;</userinput><prompt>% </prompt><userinput>make</userinput></screen> </para><para> Dabei ist der korrekte Pfad zum KDE Basisverzeichnis bei dem Parameter<quote>--prefix</quote> einzusetzen. Dadurch wird sichergestellt, dass Umbrello alle Dateien und Bibliotheken für einen korrekten Betrieb später finden kann. </para><para> Wurde der Kompilierungsprozess beendet, müssen abschließend die erzeugten Dateien installiert werden. Normalerweise braucht man dazu Systemverwalterrechte. Um diese zu erlangen, nutzt man prinzipiell folgenden Befehl: <screen width="40"><prompt>% </prompt><userinput>su</userinput></screen> </para><para> Danach muss man das Passwort des Systemverwalters eingeben. Um nun das Programm endgültig zu installieren, ist folgender Aufruf notwendig: <screen width="40"><prompt>% </prompt><userinput>make install</userinput></screen> </para></sect1><sect1 id="running_program"><title>Programm starten</title><para> Nachdem man Umbrello installiert hat, kann man es von der Kommandozeile aus starten indem man schreibt: <screen width="40"><prompt>% </prompt><userinput>umbrello</userinput></screen> </para><para> Ein Start über das KDE Menu ist ebenfalls möglich. Man findet das Programm unter <guimenu>Entwicklung</guimenu> als <emphasis>Umbrello UML Modeller </emphasis>. </para><para> <screenshot> <screeninfo>Umbrellos Hauptfenster</screeninfo> <mediaobject> <imageobject> <imagedata fileref="pics/umbrello-main-screen.png" format="PNG"/> </imageobject> <textobject> <phrase>das Hauptfenster von Umbrello</phrase> </textobject> <caption> <para>das Hauptfenster von Umbrello </para> </caption> </mediaobject> </screenshot> </para></sect1></chapter>
