Windows Terminal Services Plugin

Eine detailierte Beschreibung und Beispiele wie Windows Dienste Plugins erstellt werden finden sich in der offiziellen Hyperic Dokumentation.

Es folgt ein Beispiel wie ein Plugin zur Ueberwachung eines Windows Dienst bereitgestellt, konfiguriert und Windows Performance Daten ausgewertet werden.

Die Bereitstellung des Windows Terminal Services Plugin:

1. Die Datei terminalservices-plugin.xml wird aus dem Ordner C:\hyperic\agent-3.0\pdk\examples nach C:\hyperic\agent-3.0\pdk\plugins kopiert. Der Agent muss neu gestartet werden. In der Agent-Logdatei findet sich ein Eintrag, das das neue Plugin registriert wurde.
2. Auf dem HQ Server hat man die Moeglichkeit das Plugin an zwei Stellen abzulegen:
   HQ_SERVER_HOME\hq-engine\server\default\deploy\hq.ear\hq-plugins
   oder in
   HQ_SERVER_HOME\hq-plugins
   Waehlt man die erste Variante muss der Server neu gestartet werden.

Das zweite Verzeichnis existiert standardmaessig nicht. Nach dem Anlegen des Verzeichnis und einem Neustart des Servers werden ab sofort alle Plugins die in das Verzeichnis kopiert werden automatisch zur Laufzeit des Servers entdeckt und eingebunden ("hot" server-side deployments). Ein Neustart des Servers ist nicht mehr notwendig.

Ist das Plugin korrekt auf dem Server eingebunden, finden sich auch im Server-Log entsprechende Eintraege:

2007-02-09 15:51:35,193 INFO [org.hyperic.hq.product.server.mbean.ProductPlugin Deployer] HQ plugin terminalservices registered
2007-02-09 15:51:35,452 INFO [org.hyperic.hq.product.server.session.ProductManagerEJBImpl] terminalservices unknown – registering
2007-02-09 15:51:41,996 INFO [org.hyperic.hq.product.server.session.ProductManagerEJBImpl] terminalservices deployment took: 1.865 seconds
2007-02-09 15:51:42,725 INFO [org.hyperic.hq.product.server.mbean.ProductPluginDeployer] HQ plugin terminalservices deployed

Um das Terminal Services Plugin zu verwenden sind folgende Schritte notwendig:

1. Die Platform Seite fuer die Windows Maschine auf der die Ueberwachung aktiviert werden soll muss ausgewaehlt werden. Dies kann z.B. ueber "Browse Resources" erfolgen.
2. Im oberen rechten Bildschirmbereich klickt man auf "New Server" aus dem "Tools Menu"
3. Das Pflichtfeld Name sollte ausgefuellt werden, z.B. mit HOSTNAME Terminal Services.
4. Beim Drop-Down Feld "Server Type" wird das Terminal Services Plugin ausgewaehlt, welches dort angezeigt werden sollte wenn es korrekt eingerichtet wurde. "Install Path" ist ein Pflichtfeld und muss auf svchost verweisen, z.B. C:\WINDOWS\System32\svchost. Mit OK werden die Eingaben bestaetigt.
5. Es erfolgt eine Meldung das in "Configuration Properties" Einstellungen zu machen sind. In diesem Menu sollte "Auto-Discovery for Sessions" auf On gesetzt werden. Zum Abschluss auf OK klicken.

Nach wenigen Minuten werden auf der Monitor-Seite des Dienstes vie Verfuegbarkeit (Availability) und die aktiven Sitzungen (Active Sessions) angezeigt. Weitere Indikatoren koennen ueber hinzugefuegt werden. Dazu klickt man auf die Schaltflaeche Metric Data, Show All Metrics und definiert ein Collection Intervall.

Der neu hinzugefuegte Dienst Terminal Service Server wird auf der Plattform Seite als neuer Server angezeigt.