Benutzerhandbuch easynms 0.7 beta 8.4.2005
Inhaltsverzeichnis 1 Abkürzungsverzeichnis 3 2 Allgemeines 4 2.1 Inhalt der CD 4 2.2 Systemvoraussetzung 4 2.3 Installation 4 3 Benutzerführung 5 3.1 Oberflächenaufbau 5 3.2 Allgemeines über das Programm 6 3.2.1 Programmstart 6 3.2.2 Programmeinstellungen 7 3.2.3 Projekt 8 3.3 Netzwerkbaum 9 3.3.1 Netzteilnehmer automatisch hinzufügen 9 3.3.2 Netzwerk durchsuchen 10 3.3.3 Manuell Netzteilnehmer hinzufügen 11 3.3.4 Netzteilnehmer ändern 12 3.3.5 Netzteilnehmer löschen 12 3.3.6 Portview 12 3.4 MIB-Baums 13 3.5 Komponentenbaum 14 3.6 Darstellung der Objektvariablen 15 3.6.1 Tabellarische Darstellung 16 3.6.2 Graphische Darstellung 17 4 Abbildungsverzeichnis 19
1 Abkürzungsverzeichnis DNS LAN MIB NMS OID RMON SNMP TCP/IP Domain name service Local area network Management information base Network management station Object identifier Remote monitoring Simple network management protocol Transmission control protocol / Internet protocol easynms 0.7 beta 8.4.2005 Seite 3
2 Allgemeines 2.1 Inhalt der CD Dieses Dokument Sun Java Runtime 1.5 SNMP-Programm "easynms" 2.2 Systemvoraussetzung Windows PC mit mindestens 1GHz und 256 MB RAM Sun Java Runtime 1.5 (auf der CD) 2.3 Installation Falls Sun Java Runtime 1.5 noch nicht installiert, bitte zuerst installieren: von der CD "jre-1_5_0-windows-i586.exe" starten und Anweisungen folgen Von der CD "easynmsinstall.exe" aufrufen. Das Programm wird auf den Ordner C:\easyNMS installiert (bitte den Ordner nicht ändern) Nach der Installation wird das Programm automatisch gestartet. easynms 0.7 beta 8.4.2005 Seite 4
3 Benutzerführung 3.1 Oberflächenaufbau Die Oberfläche des Programms ist in mehreren Bereichen geteilt 1 (siehe Abbildung 1 Oberflächenaufbau) Hauptmenüleiste Hauptsymbolleiste Objektsymbolleiste Netzwerkbaum Komponenten/MIB-Baum Objektvariablen Tabelle/Grafik Objektinformation Meldungsfenster Abbildung 1 Oberflächenaufbau Die Hauptmenüleiste und Hauptsymbolleiste bieten vorrangig die Hauptfunktionen des Programms an. Das Netzwerkfenster stellt die Geräte in dem lokalen Netzwerk dar. Die Geräte werden in dem Subnetzen unterteilt. Die Objektinformation zeigt den Path des Objektes im MIB-Baum und Beschreibung des Objektes aus dem MIB-Baum (siehe Abbildung 2 Objektinformation) Das Komponenten/MIB-Fenster zeigt Auswahlmöglichkeiten, um Objektvariablen eines SNMP-Agent darzustellen oder zu manipulieren. Der Komponentenbaum und MIB-Baum 1 Noch nicht alle Funktionen der Software in der Version 0.7 beta 8.4.2005 können korrekt laufen. easynms 0.7 beta 8.4.2005 Seite 5
kann umgeschaltet werden. Der Komponentenbaum stellt die wichtigen Verweise zu den Objektvariablen aus dem MIB-Baum zur Verfügung. Die Variablen des SNMP-Agent werden in dem Objektvariablen-Fenster in tabellarischer oder graphischer Form dargestellt. Die Objektsymbolleiste stellt die Bedienung des Objektvariablen-Fensters zurverfügung. Das Meldungsfenster zeigt Programmmeldungen und Fehler (rot markiert) während der Laufzeit. Abbildung 2 Objektinformation 3.2 Allgemeines über das Programm 3.2.1 Programmstart Das Programm wird automatisch nach der Installation gestartet oder kann manuell mit "C:\easyNMS\easyNMS.bat" gestartet werden. In dem Netzwerkfenster ist noch kein Netzteilnehmer im Netzwerkbaum dargestellt. Es gibt nur eine Meldung im Meldungsfenster, dass die Software gestartet wurde (siehe Abbildung 3 Programmstart zum ersten Mal) easynms 0.7 beta 8.4.2005 Seite 6
Abbildung 3 Programmstart zum ersten Mal 3.2.2 Programmeinstellungen Das Programm speichert dessen Einstellungen in eine eigene Datei. Die Einstellungen sind nur für die aktuelle Station (NMS) gedacht. Die Einstellungen können per Dialog Program properties geändert werden. Der Dialog wird durch den Menüpunkt Config/Program properties oder den Schalter aus der Hauptsymbolleiste gestartet werden (siehe Abbildung 4 Programmeinstellungen) easynms 0.7 beta 8.4.2005 Seite 7
Abbildung 4 Programmeinstellungen Standardmäßig werden Meldungen des Programms in die Datei easynms.log und Datenbank für den MIB-Baum in die Datei MibTree.image gespeichert. Andere Namen für die Dateien können auch gewählt werden. Die Auswahl des Schalters Saving current project by exit bewirkt, dass das aktuelle Projekt beim Beenden des Programms gespeichert wird. Die Abwahl des Schalters veranlasst den Aufruf eines Dialogs beim Verlassen des Programms, wo gefragt wird, ob das aktuelle modifizierte Projekt gespeichert werden soll. 3.2.3 Projekt Ein Projekt verwaltet die Einstellungen des Benutzers und kann in verschiedenen Stationen (NMS) benutzt werden. Projekteigenschaften können im Dialog Projekteigenschaften eingestellt werden (siehe Abbildung 5 Projekteigenschaften) Der Dialog kann über den Menüpunkt Project/Project properties erreicht werden. Das Feld Project name zeigt den Namen des Projektes an. Das Feld Port ist die Portnummer beim Senden von SNMP. Die Felder Default community for read, Default community for write und Default community for trap sind voreinstellte Schlüssel für neue Netzteilnehmer. Abbildung 5 Projekteigenschaften Schedule time ist die Zeit in Millisekunden, wonach zyklisch die Tabellen oder Diagramme für Objektvariablen abgefragt werden. Reaching timeout ist die Zeit in Millisekunden für die easynms 0.7 beta 8.4.2005 Seite 8
Abfrage eines Netzteilnehmers, ob er noch am Netz ist. Max. ports pro row konfiguriert die Anzahl der Port pro Zeile im Dialog Portview. Der Schalter OK bestätigt die Änderungen und Cancel verwirft sie. Netzwerkbaum und Komponentenbaum werden mit dem Projekt mitabgespeichert. Das letzte Projekt wird automatisch beim Programmstart geladen. Falls die Projektdatei nicht existiert, generiert das Programm eine neuee Projektdatei mit Standardeinstellungen. Das aktuelle Projekt kann explizit auch über den Menüpunkt Project/Save, Project/Save as oder den Schalter abgespeichert werden. Menüpunkt Project/New bzw. generiert ein neues Projekt. Um vorhandenes Projekt zu öffnen wird das Menü Project/Open bzw. der Schalter gestätigt. 3.3 Netzwerkbaum Der Netzwerkbaum ist dafür gedacht, Netzteilnehmer zu verwalten. Der Baum wird in einem oder mehreren LAN untergliedert. Jedes LAN beinhaltet im LAN verfügbare Netzteilnehmer (siehe Abbildung 6 Netzwerkbaum) Jeder Netzteilnehmer wird mit seinen Symbol, Name und IP im Baum dargestellt. Es gibt grundsätzlich drei Möglichkeiten, Geräte im lokalen Netzwerk in das Programm aufzunehmen. - Netzteilnehmer werden automatisch hinzugefügt - Programm durchsucht auf Wunsch das Netz nach Teilnehmern - Manuell Netzteilnehmer hinzufügen Abbildung 6 Netzwerkbaum Die Netzteilnehmer müssen das TCP/IP-Protokoll verstehen. Alle anderen Netzteilnehmer, die mit anderen Protokollen fahren, werden ignoriert. 3.3.1 Netzteilnehmer automatisch hinzufügen Das Programm durchsucht das Netz automatisch nach Teilnehmern. Die gefundenen Teilnehmer werden automatisch in den Netzwerkbaum hingefügt. easynms 0.7 beta 8.4.2005 Seite 9
Außerdem wird der Netzteilnehmer automatisch in den Netzbaum hinzugefügt, wenn eine Nachricht vom dem z.b. SNMP-Trap gekommen ist 2. Die gefundenen Netzteilnehmer werden dann in SNMP-Host und Non-SNMP-Host unterteilt, welcher einen und keinen SNMP-Agent besitzen. Ein SNMP-Agent liefert auf Anfrage eigene object identifier im MIB-Baum z.b. 1.3.6.1.4.1.17412.1.1. Aus dieser ObjektID versucht das Program entsprechendes Symbol für die Darstellung der Host auf dem Netzwerkbaum zu finden z.b. für das oben genannte object identifier. Wenn kein passendes Symbol für die Host gefunden, wird das Standardsymbol angenommen. Non-SNMP-Host bekommt standardmäßig das Symbol. Das Programm versucht anschließend über DNS, den Namen des Hosts zu bekommen. Die neue Host wird unter dem Knoten LAN entsprechend der Host- IP hinzugefügt. 3.3.2 Netzwerk durchsuchen Auf Wunsch kann das Netzwerk durchgesucht werden. Die gefundenen Netzteilnehmer werden analog wie im Abschnitt 3.3.1 Netzteilnehmer automatisch hinzufügen behandelt. Der Dialog Scanning network aus dem Menüpunkt network/scan network... oder Schalter in der Hauptsymbolleiste aufgerufen (siehe Abbildung 7 Scanning Network) Abbildung 7 Scanning Network Das Feld LAN begrenzt, in welchem lokalen Netzwerk nach Teilnehmern gesucht wird. Felder From und To begrenzen den IP-Breich im LAN. Falsche LAN- oder IP-Eingabe bzw. From grösser als To quittiert das Programm mit Fehler. Der Schalter Scan führt die Durchsuchung aus und Cancel bricht der Dialog ab. Der Durchsuchungsvorgang kann je nach Grösse und Aufbau des Netzwerkes ein paar Minuten dauern. Der gefundene Teilnehmer wird zuerst im Meldungsfenster gezeigt. Dann wird geprüft, ob der Teilnehmer ein SNMP-Agent ist (siehe Abbildung 8 Scan-Network Meldungen) 2 Die Funktion ist noch nicht verfügbar. easynms 0.7 beta 8.4.2005 Seite 10
Abbildung 8 Scan-Network Meldungen Anschließend wird der Teilnehmer spezifiziert und in den Netzwerkbaum hinzugefügt. Die gefundenen Netzteilnehmer werden strukturiert im Netzwerkbaum dargestellt (siehe Abbildung 6 Netzwerkbaum) 3.3.3 Manuell Netzteilnehmer hinzufügen Ein Netzwerkteilnehmer kann auch manuell hingefügt werden. Dazu wird der Dialog Add new host über den Menüpunkt Network/Add host aufgerufen (siehe Abbildung 9 Add new host) Abbildung 9 Add new host Hier können Name und IP des Hosts eingegeben werden. Icon für die Darstellung des Teilnehmers im Netzwerkbaum kann durch den Mausklick in das Rechteck rechts neben dem Name-Feld gewählt werden. Community for read, Community for write bzw. Community for trap sind die Schlüssel für den Zugriff auf den Netzteilnehmer, falls er einen SNMP-Agent besitzt. Der Schalter Check host überprüft die Verfügbarkeit des Netzteilnehmers und ob er einen SNMP-Agent besitzt. Mit dem Schalter OK wird der easynms 0.7 beta 8.4.2005 Seite 11
Netzteilnehmer in den Netzwerkbaum hinzugefügt, falls er im Baum noch nicht vorhanden ist. Der Schalter Cancel bricht den Vorgang ab. 3.3.4 Netzteilnehmer ändern Ein Doppelmausklick auf einen Knoten im Netzwerkbaum öffnet den Dialog Teilnehmer ändern, wo die Parameter eines Teilnehmers analog wie im Kapitel 3.3.3 Manuell Netzteilnehmer hinzufügen geändert werden können. Abbildung 10 Teilnehmer ändern 3.3.5 Netzteilnehmer löschen Der gewählte Netzteilnehmer kann durch die Taste Entf von der Tastatur gelöscht werden. Ein Dialog fordert dann das Löschen zu bestätigen. 3.3.6 Portview Der Schalter eröffnet den Dialog Portview, wo die alle physikalische und logische Ports des SNMP-Agent dargestellt werden (siehe Abbildung 11 Portview) Abbildung 11 Portview easynms 0.7 beta 8.4.2005 Seite 12
Pro Port werden die Portnummer, Geschwindigkeit, Admin status als A und Operation status als O dargestellt. Die Zustände werden grün bzw. rot dargestellt, wenn sie up bzw. down sind. Die Anzahl der Port pro Zeile wird durch die Variable Port pro row vom Projekt beeinflusst (siehe Kapitel 3.2.3 Projekt) 3.4 MIB-Baums Standardmäßig wird das Programm mit einem MIB-Baum aus ausgewählten Dateien geliefert (siehe Abbildung 12 MIB-Baum) Der MIB-Baum wird in einer internen Datenbank gespeichert. Bei der Auswahl eines Knotens des MIB-Baums wird die zugehörige object identifier und deren Beschreibung in der Objektinformation gezeigt. Der MIB-Baum kann auch manuell geändert werden. Dazu wird über den Menüpunkt Config/Build MIB database der Dialog MIB database aufgerufen (siehe Abbildung 13 MIB database) Abbildung 12 MIB-Baum easynms 0.7 beta 8.4.2005 Seite 13
Abbildung 13 MIB database In dem Dialog werden die MIB-Dateien aufgelistet. Der Schalter Insert MIBfile öffnet einen Dialog, wo andere MIB-Dateien ausgewählt und in die Liste eingefügt werden können. Der Schalter Remove MIB-file entfernt die gewählten MIB-Dateien aus der Liste. Abschließend muss der Schalter Compile bestätigt werden, damit eine neu MIB-Datenbank aufgebaut werden kann. Fehler oder Fortschrittmeldungen werden in Messages gezeigt. Mit dem Schalter OK wird die neue MIB- Datenbank in den MIB-Baum aufgenommen. Vorhandene MIB- Datenbank wird ersetzt. Der Schalter Cancel verwirft die neue MIB- Datenbank. 3.5 Komponentenbaum Der Komponentenbaum ermöglicht einen schnelleren Zugriff auf den MIB-Baum. Einzelner Knoten des Komponentenbaum kann einen Verweis auf einen Knoten im MIB-Baum beinhalten (siehe Abbildung 14 Komponentenbaum) Die Auswahl eines Knotens zeigt die Objektinformation die zugehörige object identifier und deren Beschreibung. Im Installationszustand wird ein Komponentenbaum für generelle Verweise geliefert. Der Baum wird mit dem aktuellen Projekt gespeichert. Man kann den Komponentenbaum auch manuell konfigurieren, indem der Dialog Editing component tree über den Menüpunkt Config/Component tree aufgerufen wird (siehe Abbildung 15 Component tree) Abbildung 14 Komponentenbaum easynms 0.7 beta 8.4.2005 Seite 14
Abbildung 15 Component tree Im Dialog wird im oberen Fenster der Komponentenbaum und untern Fenster MIB-Baum abgebildet. Wenn ein Knoten in dem Komponentenbaum gewählt ist, wird unten in dem MIB-Baum der entsprechende Knoten oder kein Knoten, wenn kein object identifier verlinkt wird, ausgewählt. In den mittleren Feldern können Name und object identifier für den gewählten Komponentknoten geändert werden. Durch den Mausklick auf einem MIB-Knoten kann der object identifier auch geändert werden. Die Auswahl soll ein übergeordneter MIB- Knoten des scala object identifier bzw. überübergeordneter MIB-Knoten der columnar object identifier sein. Dies ermöglicht die Darstellung der Objektvariablen in den entsprechenden Tabellen und Diagrammen, die später erläuter werden. Der Schalter Change bestätigt die Änderung. Schalter Insert fügt einen Komponentenknoten mit den gezeigten Namen und object identifier als Verweis unter den aktuell gewählten Komponentenknoten hinzu. Der Komponentenknoten kann durch den Schalter Remove auch entfernt werden, wobei alle Unterknoten auch mitgelöscht werden. Zum Schluss muss der Schalter OK gestätigt werden, wenn die Änderungen übernommen werden sollen, oder Cancel, wenn die Änderungen verworfen werden. 3.6 Darstellung der Objektvariablen Wie oben schon erläutert, werden die Objektvariablen eines SNMP-Agent in tabellarischer oder graphischer Form dargestellt. Zuerst wird ein Teilnehmer im Netzwerkbaum gewählt. Ein Knoten aus dem Komponentenbaum oder MIB-Baum wird ausgewählt. In dem rechten easynms 0.7 beta 8.4.2005 Seite 15
Objektvariablenfenter werden Objektvariablen zu dem ausgewählten Teilnehmer dargestellt. Mit dem Schalter oder in der Objektsymbolleiste kann die Darstellung zwischen tabellarisch und graphisch umgeschaltet werden. Der Schalter in der Objektsymbolleiste für zu dem Knoten des verbundenen object identifier. Der Schalter aktualisiert die Tabelle bzw. Diagramm explizit. Und durch den Schalter in der Objektsymbolleiste können die Daten der Tabelle bzw. des Diagramms in eine CSV-konforme Datei ausgeschrieben werden. 3.6.1 Tabellarische Darstellung Die Tabellen werden automatisch aktualisiert, wenn Schedule time abgelaufen ist (siehe Kapitel 3.2.3 Projekt) Wenn Fehler beim Abrufen der Variablen vorkommen, werden sie im Meldungsfenster gezeigt. Es gibt zwei Typen von Tabellen, scalar und columnar Tabellen. Scalar Tabellen zeigen die Liste der scalar Objektvariablen, die unter dem Knoten im MIB- Baum sind (siehe Abbildung 16 Scalar Tabelle) Abbildung 16 Scalar Tabelle Die Spalte Name stellen die Namen der Objekte dar. Die Spalte Value zeigen die aktuellen Variablen auf der SNMP-Agent. Blaudargestellte Variablen können geändert werden. Wenn ein Objekt ein Auflistungstyp ist, kann die Variable bequem über die Kombobox gewählt werden. Andere Variablen sind schreibgeschützt. Die Auswahl einer Zelle in der Tabelle zeigt die entsprechende object identifier bzw. Beschreibung in der Objektinformation. Columnar-Tabellen stellen die Columnar Objektvariablen unter den gewählten MIB-Knoten dar. Da die Columnar Objekte eine oder mehren Instanzen besitzen können, werden deren Namen als Tabellenüberschrift gezeigt. Pro Zeile der Tabelle wird eine Instanz dargestellt (siehe Abbildung 17 Columnar Tabelle) easynms 0.7 beta 8.4.2005 Seite 16
Abbildung 17 Columnar Tabelle Wie bei den Scalar Tabellen werden editierbare Variablen blau dargestellt. Um Variablen zu ändern, werden eine oder mehrere Variablen editiert. Danach werden durch die Bestätigung des Schalters die Variablen in die SNMP-Agent gesendet. Eine erfolgreiche Änderung wird dann im Meldungsfenster quittiert. Fehler beim Vorgang werden auch gezeigt. 3.6.2 Graphische Darstellung Hier werden nur die Variablen von Typen Integer, Gauge und Counter abgerufen und gezeigt. Pro Variable wird eine Kurve generiert. Die Werte der Variablen werden gemäß Schedule time automatisch abgerufen. Das Fenster wird automatisch zu den gezeigten maximalen und minimalen Werten angepasst, damit sie im Fenster darstellbar sind (siehe Abbildung 18 Graphische Darstellung der Objektvariablen) Zu dem graphischen Teil gehört unten eine Tabelle, wo jede Variable eine Zeile beansprucht. Dort ist es möglich die Darstellung der Variable ein oder ausschalten, Skalierungsfaktor für den Wert oder Farbe für die Kurve zu ändern. Außerdem werden die minimalen, maximalen bzw. aktuellen Werten der Variablen zur Verfügung gestellt. Falls das Gerät die Objektvariablen oder überhaupt SNMP nicht unterstützt oder nicht mehr verfügbar ist, wird ein Fehler im Meldungsfenster gezeigt. easynms 0.7 beta 8.4.2005 Seite 17
Abbildung 18 Graphische Darstellung der Objektvariablen easynms 0.7 beta 8.4.2005 Seite 18
4 Abbildungsverzeichnis Abbildung 1 Oberflächenaufbau 5 Abbildung 2 Objektinformation 6 Abbildung 3 Programmstart zum ersten Mal 7 Abbildung 4 Programmeinstellungen 8 Abbildung 5 Projekteigenschaften 8 Abbildung 6 Netzwerkbaum 9 Abbildung 7 Scanning Network 10 Abbildung 8 Scan-Network Meldungen 11 Abbildung 9 Add new host 11 Abbildung 10 Teilnehmer ändern 12 Abbildung 11 Portview 12 Abbildung 12 MIB-Baum 13 Abbildung 13 MIB database 14 Abbildung 14 Komponentenbaum 14 Abbildung 15 Component tree 15 Abbildung 16 Scalar Tabelle 16 Abbildung 17 Columnar Tabelle 17 Abbildung 18 Graphische Darstellung der Objektvariablen 18 easynms 0.7 beta 8.4.2005 Seite 19