VNUML Offline Installer Ver 1.6.4-1.1 (27.04.2006) ================================================== entstanden in einem Projekt der Universitaet Koblenz-Landau Andre Volk - avolk@uni-koblenz.de 0. QUICK-INSTALL-GUIDE fuer erfahrene Linuxer ============================================== - Archiv "VNUML-Offline.zip" entpacken - Installation starten mit "./install" (Zum Debuggen kann auch "./install --debug" gewaehlt werden. Die Installation pausiert dann nach jedem Schritt. - Nach der Installation Ausloggen und wieder Einloggen! 1. Ueber VNUML ============= VNUML ist ein in Perl geschriebener, auf UML (User Mode Linux)-basierender Open Source Netzwerk-Simulator. Die gewuenschte Netzwerktopologie wird in einer XML festgelegt. Die offizielle VNUML Projekthomepage findet sich unter: http://jungla.dit.upm.es/~vnuml/ 2. Systemvoraussetzungen ======================== VNUML laedt fuer jeden Teilnehmer im virtuellen Netzwerk (Router oder Hosts) eine virtuelle Maschine mit einem echten Linux-Kernel und einem eigenen Filesystem in den Hauptspeicher. Daher sollte neben einem einigermassen schnellen Prozessor auf jeden Fall genuegend Hauptspeicher (mindestens 256MB, besser mehr) vorhanden sein um mit VNUML arbeiten zu koennen. Ausserdem benoetigen Sie ca. 600MB freien Speicherplatz auf Ihrer Festplatte. Evtl. muessen Sie Ihre Linux Firewall deaktivieren (siehe Punkt 7.3)!!!! 3. Hinweise zur Installation ============================ Bisher bereitete die Installation von VNUML immer einige Schwierigkeiten und war sehr langwierig. Diese Offline Installation bringt nun (hoffentlich) alle Programmpakete und PerlModule mit, die VNUML benoetigt und installiert sie in der richtigen Reihenfolge. Wenn Sie dennoch Schwierigkeiten oder Fehler bei der Installation bemerken, dann schreiben Sie uns bitte eine e-mail an avolk@uni-koblenz.de, damit wir die Offline Installation weiter verbessern koennen. Erfolgreiche Installationen duerfen auch gerne gemeldet werden ;-) 4. Vorraussetzungen fuer die Installation ========================================= - Folgende essentielle Linux-Pakete muessen installiert sein (das ist bei Standard-Linux Installationen lange nicht selbstverstaendlich!!). Der VNUML Offline Installer prueft automatisch, ob diese Pakete installiert sind. Wenn nicht, stoppt die Installation und Sie muessen die entsprechenden Pakete manuell nachinstallieren. - gcc (C-Compiler) - make (Der GNU Make Befehl) - perl (Perl Interpreter) - tar (Das Packprogramm tar) Unter SuSE Linux koennen Sie die Pakete z.B. mit YAST installieren. Vermutlich benoetigen Sie die Installations CDs Ihrer Linux-Distribution. Unter Debian (oder Knoppix,...) installieren Sie Pakete mit dem Befehl "apt-get install PAKETNAME" 5 Installation unter Linux =================================================================== - Entpacken Sie das Archiv "VNUML-Offline.zip" (- Die entpackten Daten koennen Sie z.B. auf eine CD brennen.) - Oeffnen Sie eine Linux Shell (Konsole) - Melden Sie sich mit "su" als Root an. - Wechseln Sie in das Verzeichnis, in dem Sie die Offline Installation entpackt haben (oder auf die Offline Installations CD) - Tippen Sie "./install" ein (bitte die Schreibweise beachten!!) und beachten Sie die Hinweise am Bildschirm. - Loggen Sie sich nach erfolgreicher Installation von Ihrem Linux System aus und wieder ein, damit die bei der Installation angelegten Benutzer- und Benutzergruppen ordnungsgemaess eingerichtet werden. - Normalerweise sollten Sie am Ende ein funktionierendes VNUML auf Ihrem Rechner haben :-) 6. Start und Bedienung von VNUML ================================ Sie koennen VNUML nur als "root" mit voller Funktionalität benutzen. Melden Sie sich also vor dem Start des VNUML-Parsers mit dem Befehl "su" und dem Administrator-Passwort an. Seit VNUML 1.6 gibt es aber auch Möglichkeiten, die Kernfunktionen von VNUML auch mit eingeschränkten Benutzerrechten zu nutzen. Lesen Sie dazu am besten die Dokumentation und das Tutorial auf der offiziellen VNUML Homepage. Die wichtigste Programmdatei von VNUML ist das Perl-Script "vnumlparser.pl". Es befindet sich im Ordner "/usr/local/bin", jedoch kann man das Script auch aus jedem beliebigen Linux Verzeichnis heraus aufrufen. Die Beispieldateien von VNUML befinden sich im Verzeichnis "/usr/local/share/vnuml/examples" Wechseln Sie also in das Verzeichnis in dem sich die XML Datei befindet, die Sie starten moechte z.B.: "cd /usr/local/share/vnuml/examples" Und starten Sie das gewuenschte Szenario: "vnumlparser.pl -t tutorial.xml -vB -u root" (wobei tutorial.xml fuer Ihre gewuenschte XML-Datei steht) "-u root" benötigen Sie nur, wenn Sie das Szenario tatsächlich als Benutzer "root" starten wollen. Wenn das Szenario gestartet ist, koennen Sie sich z.B. mit SSH in die verschiedenen virtuellen Maschinen einwaehlen: "ssh NAME_DER_VIRTUELLEN_MASCHINE" Eine evtl. Passwortabfrage bei der Einwahl mit ssh koennen Sie mit dem Befehl: "ssh -1 NAME_DER_VIRTUELLEN_MASCHINE" umgehen. Oder tippen Sie einfach das Passwort "xxxx" ein. Sie werden gefragt, ob Sie den RSA Fingerprint der virtuellen Maschine akzeptieren moechten. Die Meldung sieht ungefaehr so aus: "RSA1 key fingerprint is 7e:3d:7e:73:22:85:b8:03:ff:0f:b0:07:5b:41:d8:ba. Are you sure you want to continue connecting (yes/no)? " Tippen Sie hier bitte "yes" ein. Beim Herunterfahren eines Szenarios muessen Sie dies evtl. fuer jede einzelne virtuelle Maschine bestaetigen. Das muessen Sie jedoch nur einmalig tun. Die ssh-Sitzung koennen Sie mit dem Befehl "exit" beenden. Das VNUML-Szenario koennen Sie mit dem Befehl "vnumlparser.pl -d tutorial.xml -vB" beenden. 7. PROBLEME / WICHTIGE HINWEISE =============================== 7.0 Fehlersuche bei der Installation ===================================== Um den genauen Verlauf der Installation (und auch evtl. Fehlermeldungen) ansehen zu koennen, starten Sie die VNUML Offline Installation mit "./install --debug". Das Programm stoppt in diesem Fall nach jedem Schritt, damit man die Bildschirmausgabe besser verfolgen kann. Generell gilt: Wenn ein Fehler auftritt und die Installation stoppt, dann sollten Sie zuerst versuchen den Fehler zu beheben (z.B. mit Hilfe der Loesungsvorschlaege, die Ihnen die Installation gibt, oder mit der Installationsanleitung auf dem Server der Uni-Koblenz siehe 7.1) und anschliessend muss die Installation mit "./install" neu gestartet werden!!! Die Installation ist erst vollstaendig, wenn Sie vom Installations-Programm dazu beglueckwuenscht werden :-) 7.1 Dokumentation ================== Bitte beachten Sie die Dokumentation auf http://www.uni-koblenz.de/... Hier finden sich ausfuehrliche Informationen zur Benutzung von VNUML mit umfangreichem Troubleshooting-Guide 7.3 VNUML und eine Linux Firewall ================================= Evtl. koennen sich die virtuellen Maschinen in einem VNUML Szenario untereinander nicht anpingen. Versuchen Sie in diesem Fall die Linux Firewall zu deaktivieren (Unter SuSE geht das in YAST)! 7.4 Nach der Installation ========================= Nach der Installation von VNUML müssen Sie sich aus Ihrem Linux System ausloggen und wieder einloggen! Versionsüberblick ================= - Ver 1.6.1 vom 27.04.2006 installiert zum ersten mal vnuml in der Version 1.6 - Von den PerlModulen und Programmpaketen wurde die neueste Version integriert.