IBM Tivoli Netcool OMNIbus WebGUI Konfiguration durch WAAPI

Transkript

1 IBM Tivoli Netcool OMNIbus WebGUI Konfiguration durch WAAPI GSE (Guide Share Europe) Arbeitsgruppe Systems Management Tivoli Tagung Mainz, 15/ DICOS GmbH Kommunikationssysteme

2 Agenda WebGUI - Grundlagen im Schnelldurchgang Was ist WAAPI? Wo finde ich WAAPI und wie nutze ich es? Struktur und Funktion der xml-dateien Ein simpler MAP-Generator Exkurs 1: Der WebGUI Exporter (ncw_export) Exkurs 2: Exportieren/Importieren der TIP-Konfiguration DICOS GmbH Kommunikationssysteme 2

3 WebGUI Grundlagen im Schnelldurchgang Fakten WebGUI ist das User-Interface für Netcool/Omnibus WebGUI ist eine Applikation innerhalb der TIP Die Konfiguration des WebGUI erfolgt getrennt von der Konfiguration der TIP Elemente der WebGUI Konfiguration Filter = gespeicherte SQL-where-Bedingungen Views = Spalten-Layout für Eventlisten AEL = Active Event List Anzeige basiert auf Filtern MAPs = Anordnung von Icons graphischen Darstellung der Zustände. Jedes (aktive) Icon basiert auf einem Filter Tool = Aktion aus der AEL über Menü der rechten Maustaste DICOS GmbH Kommunikationssysteme 3

4 WebGUI Grundlagen im Schnelldurchgang Elemente der WebGUI Konfiguration Filter Category = Einstufung nach Nutzung/Nutzbarkeit Private = Persönlich / je User Global = Alle User System = Feste Filter, für Admin oder User dann fest mit AEL verknüpft Filter Collection = Gruppierung der Filter Konfiguration des WebGUI Über die Administration im WebGUI selbst Flexibel, leicht zu nutzen Aber bei größeren Mengen sehr mühsam Aber zurzeit können Filter Collections nicht bearbeitet werden DICOS GmbH Kommunikationssysteme 4

5 Was ist WAAPI? WebGUI Administration Application Programming Interface Erlaubt die Konfiguration des WebGUI ohne Nutzung des Administration-GUI Java-basierte Utility, die sich lokal oder remote mit dem WebGUI-Server verbindet Steuerung über Steuerfiles in XML-Syntax Abfrage der Konfiguration Erstellen/Ändern/Löschen der Konfigurationsdaten Administrations-Funktionen Sehr einfache XML-Syntax Scriptgesteuerte Erstellung sehr leicht DICOS GmbH Kommunikationssysteme 5

6 Wo finde ich WAAPI - und wie nutze ich es? WAAPI wird mit WebGUI mit installiert Installations-Struktur bei WebGUI 7.3.1: runwaapi das Ausführungskommando waapi.init das Properties-Files *.xml Direkt nutzbare Beispiele Log-Dateien von runwaapi Zugangsparameter auf Kommandozeile oder in waapi.init Zugriff erfordert Rolle ncw_admin des genutzten User DICOS GmbH Kommunikationssysteme 6

7 Wo finde ich WAAPI - und wie nutze ich es? Die wichtigsten Kommandozeilen-Optionen (gekürzt!) Kommando-Beispiele (Zugriff lokal und remote) DICOS GmbH Kommunikationssysteme 7

8 Wo finde ich WAAPI - und wie nutze ich es? Einfaches Einstiegs-Beispiel: DICOS GmbH Kommunikationssysteme 8

9 Wo finde ich WAAPI - und wie nutze ich es? Zusammengefasst: Zugang zum WebGUI lokal oder remote User-Berechtigung ncw_admin Zusammenstellung aller Aktionen in xml-datei(en) Ausführung über Kommando runwaapi DICOS GmbH Kommunikationssysteme 9

10 xml-dateien Grundlegendes Format Es handelt sich um ein sehr einfaches xml-format <methodcall> <method methodname="name der Methode"> <methodenspezifische Parameter/> </method> </methodcall> Gute, detaillierte Dokumentation aller Methoden und Parameter im Handbuch SC WebGUI Administration and User s Guide Chapter 2. Remotely administering the Web GUI server Appendix G. WAAPI data reference DICOS GmbH Kommunikationssysteme 10

11 xml-dateien Beispiel Anlegen eines globalen Filters Auf Sonderzeichen achten! DICOS GmbH Kommunikationssysteme 11

12 xml-dateien Mitgelieferte Beispiele Eine Reihe von guten Beispielen werden mitgeliefert Directory./waapi/etc/samples list*.xml Ausgabe von Konfigurationsdaten stamplerequest*.xml Anlegen, Löschen, Ändern von Filter, Views Maps und Map-Resources Menus, Tools, Prompts Benutzer (Nur Ändern der User-preferences) DICOS GmbH Kommunikationssysteme 12

13 xml-dateien Ausführung von Aktionen Herantasten an die Syntax der Parameter Nutzung der Beispiele samplerequest_* Maps: Elemente mit dem Java-Map-Editor von Hand anlegen und mit dem HTML-Map-Editor wieder anschauen *) Handbuch Hinweis zum Löschen Löschen über Wildcards geht leider nicht *) Kommas durch Leerzeichen ersetzen! Bei Filtern muss man den Type des Filters zur Löschung angeben Lösung über Script: erst filter.getlist; dann filter.deletefilter Siehe einfaches Beispielscript deletefilter.sh DICOS GmbH Kommunikationssysteme 13

14 xml-dateien Ausführung von Aktionen Mehrere Aktionen dürfen in einem xml-file liegen Sequentielle Ausführung Reihenfolge beachten Erst die Filter und Views definieren Dann die MAP definieren, die diese nutzt Vorgehensweise im Prinzip wie beim manuellen Anlegen DICOS GmbH Kommunikationssysteme 14

15 xml-dateien Administrations-Kommandos Mitgeliefert werden folgende Beispieldateien webtop_report.xml Ausgabe von Properties, Version, Java-Version, usw.. resync_os.xml Abgleich zwischen WebGUI und ObjectServer (User, Conversions, ) Häufig benötigt, wenn sich die Konfiguration im ObjectServer ändert reloadfiltersandviews.xml Erzwingt ein Neuladen der Filter/Views in allen offenen AELs maintain_users.xml Entfernt Preferences, private Filter, etc. von gelöschten Usern cluster_removenode.xml Entfernt ein WebGUI aus einem Load-Balancing Cluster DICOS GmbH Kommunikationssysteme 15

16 Ein simpler MAP-Generator Automatisches Erstellen einer MAP Anlegen der Map, Zuordnung eines Hintergrundbildes Anlegen von Icons Zuordnung von Filter & Doppelklick-Aktion zu jedem Icon Definition der zugehörigen Filter PERL-Script Liest Eingabedatei Erzeugt alle notwendigen Filter Erzeugt die MAP, ordnet Hintergrundbild zu Definiert die Buttons in der MAP, ordnet Filter zu Doppelklick-Aktion: Öffnen einer AEL mit dem zugeh. Filter DICOS GmbH Kommunikationssysteme 16

17 Ein simpler MAP-Generator Mit dem PDF dieser Folien erhalten Sie im Download: Perl-Script genmap.pl Eingabedatei input Hintergrundbild gse_bg.png Script deletefilter.sh Nur für Demo-Zwecke! Keine Gewährleistung, kein Support! Hinweis: Der Download der Script ist nur für GSE- Mitglieder möglich. Andere Interessenten wenden sich bitte direkt an die DICOS GmbH ( DICOS GmbH Kommunikationssysteme 17

18 Exkurs 1: WebGUI Exporter Mit dem Tool ncw_export kann die WebGUI-Konfiguration ganz oder teilweise exportiert werden Reines export-tool Re-Import erfolgt durch waapi Erlaubt auch die (Aufwärts-)Migration zwischen verschiedenen WebTOP/WebGUI-Versionen (ab Version 1.x) Nicht im Lieferumfang; verfügbar über Offered on an as-is basis Kein Support verfügbar! Aktuelle Version: 2.4 Release 1 Windows, Linux, Solaris Dokumentation in readme-file oder /tmp/ncw_export -help DICOS GmbH Kommunikationssysteme 18

19 Exkurs 1: WebGUI Exporter Export (Beispiel: Komplette WebGUI-Konfig / 7.3.1) /tmp/ncw_export.exe -tar /tmp/exp.tar common -maps -allfilters allviews -filltercollections -tiphome /opt/ibm/tivoli/tipv2 (cd /tmp; tar xvf exp.tar) Bei Bedarf kann das File export.xml vor dem Import nachbearbeitet werden! Import (Beispiel: Kompletter Re-Import).../waapi/bin>runwaapi -host <host> -user tipadmin -password netcool file /tmp/import/export.xml Migration Näheres unter ncw_export help migration DICOS GmbH Kommunikationssysteme 19

20 Exkurs 2: WebGUI Import/Export Ab WebGUI stehen ein offizielles Tools zur Verfügung:./tipcli.sh Export./tiplci.sh Import Je nach Einstellungen können nur die WebGUI-Daten oder die WebGUI- und TIP-Daten im-/exportiert werden Nur zwischen identischen Versionen von TIP/WebGUI! Keine Kompatibilität mit WAAPI! Gut geeignet für Cloning und Backup Details hierzu siehe Manual SC WebGUI Administration and User s Guide, Kapitel DICOS GmbH Kommunikationssysteme 20

21 Vielen Dank für Ihr Interesse Welche Fragen darf ich Ihnen noch beantworten? DICOS GmbH Kommunikationssysteme