MEC Management Software Benutzerhandbuch
Werbung
MEC Management Software Benutzerhandbuch Benutzerhandbuch für MEC Management Software Version 1.2.2 Consulting für Informationstechnologie und EDV-Netz Management Dr. Dipl.-Ing. Manfred R. Siegl A-1090 Wien, Währinger Gürtel 166 Tel.: +43 1 319 59 893, Fax: +43 1 319 59 891 www.citem.at, e-mail: [email protected] Seite 1 von 9 MEC Management Software Benutzerhandbuch Benutzerhandbuch für MEC Management Software Firmware Version 1.2.2 Autor: Manfred Siegl Datum: 22. Aug. 2008 File: MMng_Benutzerhandbuch_1.2.2 Version: 1.0 Erstellung des Dokuments Zusammenfassung Dieses Handbuch beschreibt die Installation und den Betrieb der MEC Management Software. Diese Software ist als Ergänzung zu MEC-Modulen zu verstehen. Sie bietet eine zentrale Sicht über alle im Netz installierten MEC-Module sowie eine Alarmierung bei Schwellwert Über- oder Unterschreitung sowie eine Zeitverlaufsdarstellung der Messwerte. Inhaltsverzeichnis 1 Einleitung.........................................................................................................................................3 2 Installation........................................................................................................................................4 2.1 Installation unter Linux.............................................................................................................4 2.2 Installation unter Windows.......................................................................................................6 3 Einstellungen zur Alarmierung.........................................................................................................8 Seite 2 von 9 MEC Management Software Benutzerhandbuch 1 Einleitung Die Information wird von den MEC-Modulen aus zur MEC Management Software übertragen. Die Daten werden als Bringschuld aktiv von den MEC-Modulen geliefert. Die MEC Management Software pollt nicht nach den Information, sondern bekommt diese geliefert (im Gegensatz zur Kommunikationsstruktur bei SNMP). Die grundsätzliche Struktur einer Installation eines MIMEC ist in Abbildung 1 zu sehen. Der MIMEC ist an ein LAN angeschlossen (gelb). Über einen Web-Browser wird die Konfiguration vorgenommen (rot). Abbildung 1: Prinzipieller Einsatz der MEC Management Software Während des normalen Betriebs übertragen die MEC-Module die aktuellen Betriebskennwerte an einen Management-Server (braun). Über einen Web-Browser wird auf den Web-Server des Management-Servers zugegriffen (violett). Zusätzlich können die Betriebskennwerte vom Management-Server auch mit SNMP abgefragt werden (nicht dargestellt). Der permanente Datentransfer zur Management-Software erfolgt mittels XML-Messages. Die MEC Management Software ist ein Java-Anwendung, die im Java-Archiv mecmng.jar enthalten ist. Die Funktionen dieser Software sind folgende Teile: XML-Server: Die MEC-Module im Netzwerk nehmen mit dem XML-Server Verbindung auf und übertragen periodisch oder ad-hoc die Messwerte zur MEC Management Software. SNMP-Agent: Durch den integrierten SNMP-Agent können alle Informationen von einem SNMP-Manager abgefragt werden. Die diesbezügliche MIB ist im Anhang angeführt. Web-Server: Ein in dieser Software integrierter Web-Server bietet eine übersichtliche Darstellung alle MEC-Module (z.B.: MAMEC-Powerbox, MIMEC) im Netzwerk. Alarmierung: Wenn eingestellte Schwellwerte über- bzw. unterschritten werden, wird eine Alarmmeldung per email versandt. Seite 3 von 9 MEC Management Software Benutzerhandbuch 2 Installation 2.1 Installation unter Linux Zur Einrichtung der MEC Management Software auf dem Betriebsystem Linux ist wie im Folgenden beschrieben vorzugehen. 1. Das Java Runtime Environment Version 1.5 ist zu installieren. 2. Öffnen Sie ein Terminal-Fensters. Die folgenden Eingabe werden in diesem Terminalfenster ausgeführt. 3. Test der Aufrufbarkeit des Java Runtime Environment # java -version Prüfen, ob Java installiert ist java version "1.5.0_12" Java(TM) 2 Runtime Environment, Standard Edition (build 1.5.0_12-b04) Java HotSpot(TM) Client VM (build 1.5.0_12-b04, mixed mode, sharing) Anmerkung: Die bei ubuntu 8.04 automatisch installierte Java-Version gij wird nicht empfohlen. 4. Das Quellmedium mit den Files zur MEC Management Software verfügbar machen. Im Folgenden wird synonym SW-Quelle für den Ort der Files verwendet. 5. Anlegen des Arbeitsverzeichnisses für die MEC Management Software # mkdir ./MecMng # cd ./MecMng # cp SW-Quelle/mecmng.jar . Anlegen des Arbeitsverzeichnisses Wechseln in das Arbeitsverzeichnis Kopieren des Java-Archivs 6. Ausgabe der Versionsinformation – eine erste Funktionskontrolle # java -jar mecmng.jar -v MEC Software Version 1.2.1 vom 2008-04-03 7. Zusätzlich benötigte Archive kopieren # cp -Rv SW-Quelle/lib . „SW-Quelle/lib/activation.jar“ -> „./lib/activation.jar“ „SW-Quelle/lib/comm.jar“ -> „./lib/comm.jar“ „SW-Quelle/lib/jcommon-0.9.6.jar“ -> „./lib/jcommon-0.9.6.jar“ „SW-Quelle/lib/jfreechart-0.9.21.jar“ -> „./lib/jfreechart-0.9.21.jar“ „SW-Quelle/lib/jSMSEngine.jar“ -> „./lib/jSMSEngine.jar“ „SW-Quelle/lib/mail.jar“ -> „./lib/mail.jar“ 8. Das Setup für den Berechtigungsschlüssel: # java -jar mecmng.jar setup Setup - bitte geben Sie Ihre Daten ein: Name / Firma / Adresse / Email Name: Vorname Zuname Firma: Name der Firma Adresse: PLZ, Ort, Strasse, Nummer E-Mail: [email protected] Erledigt; übermitteln Sie bitte die Datei register.crg an Citem. Seite 4 von 9 MEC Management Software Benutzerhandbuch Es wird die Datei register.crg angelegt. Sie enthält Ihre Eingaben sowie einen Schlüssel aus systemspezifischen Kennwerten (die Kennwerte selbst sind nicht enthalten). Diese Datei ist, typischerweise per email, an den Lieferanten bzw. an Citem zu übermitteln. 9. Durch den Lieferanten wird der Schlüssel ergänzt und die Datei wird an Sie retourniert. Ersetzen Sie die ursprüngliche Datei register.crg durch die ergänzte Version; der Dateiname bleibt unverändert. 10. Ausgabe des Hilfetexts – eine erste Funktionskontrolle # java -jar mecmng.jar -h Aufruf: java -jar mecmng.jar <options> Optionen: -h Ausgabe dieses Hilfe-Texts. -v Die Versionsdaten ausgeben. -d Debug-Meldungen werden ausgegeben. -t <timeout in seconds> Das Timeout bis zum Entfernen unverbundener MAMECs. -x [<IP>]:[<port>] Bindet den TCP Port für eingehende CiiemaXML-Nachrichten -s [<IP>]:[<port>] Bindet den UDP Port für eingehende SNMP-Anfragen -w [<IP>]:[<port>] Bindet den TCP Port für eingehende HTTP-Anfragen -l <language-shortcut> Benutzt die Sprache mit dem angegebenen Kürzel -ro <community> Read-Only-Community des SNMP-Agents -rw <community> Read-Write-Community des SNMP-Agents Wenn keine IP oder Port angegeben wird, so werden Defaults verwendet. (XML: tcp *:1075, SNMP: udp *:161, HTTP: *:80). Wird keine Sprache angegeben, so wird die Systemsprache verwendet. Rufen Sie das Setup zur Registrierung auf: java -jar mecmng.jar setup Mit den Optionen -x, -s und -w wird die von den drei Services der Software zu verwendenden IP-Adressen und Ports festgelegt. Für den SNMP-Agent als auch für den Web-Server kann der Wert 0 angegeben werden. In diesem Fall wird der zugehörige Service nicht gestartet. Bei den IP-Adressen ist darauf zu achten, dass bei Linux Ports mit einer Portnummer kleiner 1024 nur vom Benutzer root verwendet werden dürfen. Die Software ist dabei vom Benutzer root oder mit dem Befehl sudo zu starten. 11. Typischer Programmstart mit allen Services und Defaultwerten Der Aufruf muss vom Benutzer root oder mit sudo ausgeführt werden. # java -jar mecmng.jar MamecServer gestartet. Warte auf XML-Nachrichten auf TCP-Port: 1075, SNMP auf UDP-Port: 161, HTTP auf TCP Port: 80 12. Programmaufruf mit allen Services und bestimmten IP-Adressen und Ports # java -jar mecmng.jar -x 192.168.8.102 -s 6161 -w 127.0.0.1:8080 MamecServer gestartet. Warte auf XML-Nachrichten auf TCP-Port: 1075, SNMP auf UDP-Port: 6161, HTTP auf TCP-Port: 8080 XML-Nachrichten an folgende Adresse gebunden: 192.168.8.102 HTTP an folgende Adresse gebunden: 127.0.0.1 Seite 5 von 9 MEC Management Software Benutzerhandbuch 13. Programmaufruf ohne dem HTTP-Server Der Aufruf muss vom Benutzer root oder mit sudo ausgeführt werden. # java -jar mecmng.jar -w 0 MamecServer gestartet. Warte auf XML-Nachrichten auf TCP-Port: 1075, SNMP auf UDP-Port: 161 Es wird empfohlen, in den Startup-Definitionen zum Betriebsystem-Neustart auch den Start der MEC-Software aufzunehmen. Wenn es im Zuge des Programmstarts zu einem Konflikt bei der Nutzung der TCP-Ports oder des UDP-Ports kommt, dann wird eine Fehlermeldung ausgegeben und das Programm beendet. Wenn in den Optionen eine IP-Adresse angegeben wird, die keine lokale Adresse ist, dann wird eine Fehlermeldung ausgegeben und das Programm beendet. 2.2 Installation unter Windows Zur Einrichtung der MEC Management Software auf dem Betriebsystem Windows ist wie im Folgenden beschrieben vorzugehen. 1. Das Java Runtime Environment Version 1.5 ist zu installieren. 2. Öffnen Sie ein Terminal-Fensters. Die folgenden Eingabe werden in diesem Terminalfenster (cmd) ausgeführt. 3. Das Quellmedium mit den Files zur MEC Management Software verfügbar machen. Im Folgenden wird synonym SW-Quelle für den Ort der Files verwendet. 4. Anlegen des Arbeitsverzeichnisses für die MEC Management Software > cd c:\Programme > mkdir MecMng Anlegen des Arbeitsverzeichnisses > cd Wechseln in das Arbeitsverzeichnis Kopieren des Java-Archivs Kopieren der Batch-Files zum einfachen Aufruf MecMng > copy SW-Quelle\mecmng.jar . > copy SW-Quelle\*.bat . 5. Test der Aufrufbarkeit des Java Runtime Environment Ausführen der Datei java_version.bat java version "1.5.0_12" Java(TM) 2 Runtime Environment, Standard Edition (build 1.5.0_12-b04) Java HotSpot(TM) Client VM (build 1.5.0_12-b04, mixed mode, sharing) 6. Zusätzlich benötigte Archive kopieren > > > > mkdir lib cd lib copy SW-Quelle\lib\*.jar . dir Verzeichnis von C:\...\MecMng\lib Seite 6 von 9 MEC Management Software 15.06.2008 15.06.2008 04.06.2008 04.06.2008 04.06.2008 04.06.2008 04.06.2008 Benutzerhandbuch 21:06 <DIR> 21:06 <DIR> 14:49 14:49 14:49 14:49 14:49 5 Datei(en) . .. 54.829 activation.jar 29.770 comm.jar 354.611 jcommon-0.9.6.jar 955.401 jfreechart-0.9.21.jar 327.603 mail.jar 1.722.214 Bytes > cd .. 7. Ausgabe der Versionsinformation – eine erste Funktionskontrolle Ausführen der Datei mecmng_version.bat MEC Software Version 1.2.2 vom 2008-04-03 8. Das Setup für den Berechtigungsschlüssel: Ausführen der Datei mecmng_setup.bat Setup - bitte geben Sie Ihre Daten ein: Name / Firma / Adresse / Email Name: Vorname Zuname Firma: Name der Firma Adresse: PLZ, Ort, Strasse, Nummer E-Mail: [email protected] Erledigt; übermitteln Sie bitte die Datei register.crg an Citem. 9. Es wird die Datei register.crg angelegt. Sie enthält Ihre Eingaben sowie einen Schlüssel aus systemspezifischen Kennwerten (die Kennwerte selbst sind nicht enthalten). Diese Datei ist, typischerweise per email, an den Lieferanten zu übermitteln. 10. Durch den Lieferanten wird der Schlüssel ergänzt und die Datei wird an Sie retourniert. Ersetzen Sie die ursprüngliche Datei register.crg durch die ergänzte Version; der Dateiname bleibt unverändert. 11. Ausgabe des Hilfetexts – eine erste Funktionskontrolle > mecmng_help Aufruf: java -jar mecmng.jar <options> Optionen: -h Ausgabe dieses Hilfe-Texts. -v Die Versionsdaten ausgeben. -d Debug-Meldungen werden ausgegeben. -t <timeout in seconds> Das Timeout bis zum Entfernen unverbundener MAMECs. -x [<IP>]:[<port>] Bindet den TCP Port für eingehende CiiemaXML-Nachrichten -s [<IP>]:[<port>] Bindet den UDP Port für eingehende SNMP-Anfragen -w [<IP>]:[<port>] Bindet den TCP Port für eingehende HTTP-Anfragen -l <language-shortcut> Benutzt die Sprache mit dem angegebenen Kürzel -ro <community> Read-Only-Community des SNMP-Agents -rw <community> Read-Write-Community des SNMP-Agents Wenn keine IP oder Port angegeben wird, so werden Defaults verwendet. (XML: tcp *:1075, SNMP: udp *:161, HTTP: *:80). Wird keine Sprache angegeben, so wird die Systemsprache verwendet. Mit den Optionen -x, -s und -w wird die von den drei Services der Software zu verwendenden IP-Adressen und Ports festgelegt. Für den SNMP-Agent als auch für den Seite 7 von 9 MEC Management Software Benutzerhandbuch Web-Server kann der Wert 0 angegeben werden. In diesem Fall wird der zugehörige Service nicht gestartet. 12. Typischer Programmstart mit allen Services und Defaultwerten > mecmng_start.bat MecServer gestartet. Warte auf XML-Nachrichten auf TCP-Port: 1075, SNMP auf UDP-Port: 161, HTTP auf TCP Port: 80 13. Programmaufruf mit individuellen Parametern Für nutzerspezifische Einstellungen ist das Batch-File mecmng_start.bat zu editieren und die gewünschten Werte einzutragen. Es wird empfohlen, in den Startup-Definitionen zum Betriebssystem-Neustart auch den Start der MEC-Software aufzunehmen. Wenn es im Zuge des Programmstarts zu einem Konflikt bei der Nutzung der TCP-Ports oder des UDP-Ports kommt, dann wird eine Fehlermeldung ausgegeben und das Programm beendet. Wenn in den Optionen eine IP-Adresse angegeben wird, die keine lokale Adresse ist, dann wird eine Fehlermeldung ausgegeben und das Programm beendet. 3 Einstellungen zur Alarmierung Im Zuge des ersten erfolgreichen Starts der MEC Management Software wird automatisch das Unterverzeichnis config angelegt. In diesem Unterverzeichnis wird das Konfigurations-File alarming.properties angelegt. In diesem File sind die notwendigen Parameter für das Absenden von Alarmmeldungen eingetragen. > cat config\alarming.properties Im Folgenden sind nur jene Einträge angezeigt, die für die Funktion relevant sind. Die übrigen Einträge bestimmen das Erscheinungsbild im Web-Interface der Ansicht dieser Konfigurationsdaten (siehe Abbildung 4 auf Seite 9). mail.smtp.host mail.smtp.from mail.smtp.fromName mail.smtp.subject mail.smtp.replyTo = = = = = 192.168.8.100 [email protected] Mec Software Mec Alarm [email protected] mobile.commPort mobile.commSpeed mobile.PIN = /dev/ttyS0 = 9600 = 0000 Seite 8 von 9 MEC Management Software Benutzerhandbuch Abbildung 2: Kopfzeile des Haupt-Web-GUIs mit der Glocke – der Link zur Alarmkonfiguration Abbildung 3: Web-GUI der Alarmkonfiguration Abbildung 4: Anzeige der eingestellten Parameter der Alarmierung. Seite 9 von 9
