IPSWatchDog Aktuelle Version: Basic vom

Transkript

1 IPSWatchDog Aktuelle Version: Basic vom

2 Inhaltsverzeichnis Sinn und Zweck:... 4 Das Konzept:... 4 Systemvoraussetzungen:... 5 Installation:... 5 Die Programminstallation:... 5 Installations-Skript anlegen und ausführen Installation ohne Skript Das Setup: Die Programmeinstellungen im Einzelnen: Timeouts und Intervalle: Serviceparameter (experimentell): Logging: iphone Push Parameter: Fehlerbehandlung: Programmablauf: Programmstart: Das Programmicon in der Infobar: Programm beenden: Programm minimieren: Programm maximieren: Programm manuell pausieren: Programm manuell starten: Das Setup aufrufen: Das INFO-Fenster: Verhalten bei Fehlern: Das Log: Die Log-Struktur: Jeden Tag ein neues Log: iphone Push Benachrichtigung: Prowl: Prowl Fehlermeldungen: Die Skripte: Skripte:

3 IWDAliveFileSkript StopIPSWatchDog: Disclaimer: Versionshistorie:

4 Sinn und Zweck: IPSWatchDog ist ein Programm zur Überwachung der IP-SYMCON Software zur Automatisierung Ihres Gebäudes, der Firma Computer- und Steuerungstechnik Steiner. Diese ist unter zu finden. Ich habe lange verzweifelt nach einem Programm gesucht, dass mir den IPS-Server überwacht und bei Bedarf neu startet. Zu oft passierte es, dass entweder der IPS-Server-Service ausgestiegen ist oder aber aus irgend einem Grunde keine Skripte mehr ausgeführt wurden. Nach längerer, erfolgloser Suche beschloss ich, mir ein solches WatchDog Programm selbst zu schreiben. Das Ergebnis ist IPSWatchDog. Nach verschiedenen Ansätzen, IPS zu überwachen, bin ich nun auf das Urkonzept zurück gekehrt. Das Ergebnis ist die Version 3.x.x Basic. Das Konzept: Ich bin bei der Nutzung von IPS zwei Serverfehler Zuständen begegnet: 1.) Der IPS-Service läuft nicht mehr (Der Service wurde angehalten oder ist abgestürzt). 2.) Der IPS-Service läuft aber ist fehlerhaft und es werden keine IPS-Skripte mehr ausgeführt. Um dem ersten Fall zu begegnen, überwacht IPSWatchDog in regelmäßigen den Status des IPS- Service. Um dem zweiten Fall zu begegnen, mache ich mir die Tatsache zu Nutzen, dass keine Skripte mehr ausgeführt werden. Entsprechend wird die Alive-Variable (SOAP Variante) nicht mehr aktualisiert, bzw. die Alive-Datei (Dateivariante) nicht mehr erstellt. 4

5 Systemvoraussetzungen: Windows XP oder höher IP-Symcon Administratorrechte Installation: Die Programminstallation: Die Installationsdatei für ISPWatchDog ist hier zu finden: Zur Installation einfach SetupIWD.exe ausführen. 5

6 Sie werden aufgefordert, ein Zielverzeichnis zu bestimmen. Dieses muss das selbe Verzeichnis sein, in dem ip-symcon installiert wurde und das die Datei ips.exe enthält. Es werden folgende Dateien in das Verzeichnis installiert: IPSWatchDog.exe (das Hautpprogramm) IWDSetup.exe IPSWatchDog3.pdf (die Gebrauchsanleitung) Scripts\IWDAliveFileSkript.php Scripts\StartIPSWatchDog.php Scripts\StopIPSWatchDog.php reboot.cmd libeay32.dll & ssleay32.dll Außerdem werden Links zum Hauptprogramm und dem Setup-Programm auf dem Desktop angelegt. 6

7 Installations-Skript anlegen und ausführen. Man muss in ip-symcon ein Skript anlegen: das Installations-Skript, welches in der Datei IPSWatchDogInstall.php zu finden ist. Diesem Skript gibt man irgend einen Namen: 7

8 Dann ein Klick auf Weiter und Skript hochladen. Nach einem Klick auf wählt man nun die Datei IPSWatchDogInstall.php aus und klickt auf Öffnen. 8

9 Mit einem Klick auf Ausführen oder der Tastenkombination Ctrl-E wird das Skript ausgeführt und installiert die notwendigen Variablen und Skripte. Danach löscht sich das Skript wieder selbst und kann geschlossen werden. Außerdem wird während der Installation eine Datei namens install.ips angelegt, die die ID s der erstellten Variablen und Skripte enthält. Sie kann von IPSWatchDog ausgewertet werden und dient zur automatischen Eintragung der ID s im Setup. Übrigens: wenn Sie das Installationsskript wiederholt aufrufen, erkennt es, das alle notwendigen Skripte und Variablen schon vorhanden sind und erstellt lediglich die Datei install.ips erneut. Abschließend müssen die Skripte StartIPSWatchDog und StopIPSWatchDog noch unter Kerninstanzen im Event Handler (Doppelklicken) im Start-Skript und Herunterfahr-Skript eingetragen werden (auf Auswählen klicken). 9

10 Installation ohne Skript Selbstverständlich ist niemand zur Benutzung des Installationsskriptes gezwungen. Sollte Sie sich entscheiden, die notwendigen Variablen und Skripte per Hand anlegen zu wollen, so erstellen Sie bitte folgendes (die Benennung ist dabei Ihnen überlassen, wichtig sind später nur die IDs. Ich habe hier nur zur Verdeutlichung meine eigene Namensgebung gewählt): Skripte: 1. IWDAliveFileSkript Type: Skript Dieses Skript erstellt in regelmäßigen Abständen eine Alive-Datei (alive.ips), um eine Überwachung des IPS-Servers zu ermöglichen. Der Inhalt des Skripts ist in der Datei scripts/iwdalivefileskript.php zu finden. Das Skript muss mit einem zyklischen Ereignis versehen werden, damit es regelmäßig ausgeführt wird. Die Zeit muss dabei kürzer sein, als die Zeit, die zwischen zwei Überprüfungen von IPSWatchDog liegt. Ich empfehle das Skript alle Sekunden ausführen zu lassen und die Überprüfungszeit von IPSWatchDog auf 60 Sekunden zu stellen. 2. StartIPSWatchDog Typ: Skript Dieses Skript wird durch den IPS-Eventhandler aufgerufen, wenn der IPS-Service und Server bereit ist. IWD beginnt dann mit seiner Arbeit. Das Skript muss in IPS unter Kerninstanzen im Event Handler (Doppelklicken) im Start-Skript eingetragen werden (auf Auswählen klicken). 3. StopIPSWatchDog Type: Skript Dieses Skript wird durch den IPS-Eventhandler aufgerufen, wenn der IPS-Service und Server normal heruntergefahren wird. IWD pausiert dann mit seiner Arbeit. Das Skript muss in IPS unter Kerninstanzen im Event Handler (Doppelklicken) im Herunterfahr-Skript eingetragen werden (auf Auswählen klicken). 4. Nach dem Anlegen der gewünschten Variablen und Skripte müssen die zugeordneten IDs in die entsprechenden Felder im Setup, Reiter IPS, eingetragen werden. Ich empfehle auf jeden Fall die Nutzung des Installationsskriptes, das erspart eine Menge Arbeit! 10

11 Das Setup: Die Einstellungen für IPSWatchDog können entweder vor Programmstart im Standalone-Setup (IWDSetup) oder in IPSWatchDog selber vorgenommen werden. Beide Setups sind identisch. Im Standalone-Setup wird lediglich ein zusätzlicher Reiter mit Programminformationen angezeigt. Dieser ist im Setup-Fenster von IPSWatchDog nicht vorhanden. Aufgerufen wird das Setup durch Doppelklicken des IWDSetup Icons auf dem Desktop oder Anklicken der Schaltfläche oder des Popmenueintrages des Taskleistensymbols Das Setup wird durch Klicken auf OK (Einstellungen werden gespeichert) oder Abbrechen (Einstellungen werden NICHT gespeichert) beendet.. 11

12 Die Programmeinstellungen im Einzelnen: Timeouts und Intervalle: IPS Service starten Timeout: [Standard: 180] die Zeit in Sekunden, die dem IPS Service gegeben wird, normal zu starten, bevor ein Timeout ausgelöst wird. Stellt IPSWatchDog fest, dass der IPS Service nicht mehr läuft oder hat es den Service aufgrund einer Fehlerfeststellung gestoppt, so wird es ihn wieder starten. Dabei überwacht es, ob der Service wieder korrekt läuft. Kommt innerhalb der hier festgelegten Zeit keine positive Rückmeldung, so wird ein Reboot ausgelöst. Dabei kann es zu Datenverlusten kommen! IPS Service stoppen: [Standard: 180] die Zeit in Sekunden, die dem IPS Service gegeben wird, sich normal zu beenden, bevor ein Timeout ausgelöst wird. Stellt IPSWatchDog fest, dass der IPS Service nicht mehr läuft oder fehlerhaft ist, so versucht es, den Service zu stoppen. Dabei überwacht es, ob der Service korrekt beendet wird. Kommt innerhalb der hier festgelegten Zeit keine positive Rückmeldung, so wird es gegebenenfalls das Beenden des Services erzwingen. Dabei kann es zu Datenverlusten kommen! Check-Intervall: [Standard: 60] IPSWatchDog überprüft in dem hier festgelegten Zeitintervall, ob der IPS Service korrekt funktioniert. 12

13 Message-Intervall: [Standard: 15] IPSWatchDog überprüft in dem hier festgelegten Zeitintervall, ob eine Nachricht oder ein Befehl von IPS vorliegt. Dieser Eintrag ist deaktiviert, wenn in den Einstellungen IPS Message Variable nicht aktiviert ist. Serviceparameter (experimentell): Service Name: [Standard: IPSServer] hier wird der Name des zu überwachenden Service festgelegt. Dadurch ist es möglich, auch andere, als den IPSServer zu überwachen. ACHTUNG: Wird ein anderer als der IPSServer überwacht, muss IPS-Server überwachen deaktiviert sein! Service Datei: [Standard: ips.exe] hier wird die EXE-Datei des zu überwachenden Service festgelegt. Dies ist notwendig, um das Beenden des Service gegebenenfalls erzwingen zu können. ACHTUNG: wird ein entfernter Computer überwacht, muss unter Fehlerbehandlung der Punkt Service beenden erzwingen deaktiviert sein! 13

14 Logging: Debug: [Standard: nicht ausgewählt] legt fest, ob IPSWatchDog zur Fehlersuche im Programm, erweiterte Informationen ins Log schreiben soll. Dadurch wird die Log-Datei eventuell sehr groß! Jeden Tag ein neues Log beginnen: [Standard: ausgewählt] legt fest, ob IPSWatchDog jeden Tag eine neue Logdatei anlegen soll. Dabei wird die alte umbenannt (aus IPSWatchDog.log wird z.b. IPSWatchDog log) eine neue IPSWatchDog.log angelegt. iphone Push mit Prowl: [Standard: nicht ausgewählt] legt fest, ob Logeinträge als Push-Meldung auf das iphone geschickt werden sollen. Dazu ist die kostenpflichtige iphone App Prowl notwendig. Ist dieses Feld aktiviert, werden zusätzliche Einstellungen sichtbar: 14

15 iphone Push Parameter: Prowl Api Key: [Standard: leer] hier wird der Api Key von Prowl eingetragen. Dazu mehr unter iphone Push Benachrichtigungen weiter unten. Absendername: [Standard: IPSWatchDog] hier wird der Absender der Prowl Nachricht festgelegt. Betreff: [Standard: Nachricht] hier wird ein Betreff für die Prowl Nachricht festgelegt. Die beide letzten Parameter sind für jene Nutzer interessant, die mehrere Server mit IPS betreiben und die Meldungen auf das selbe iphone pushen lassen. Dadurch kann besser kenntlich gemacht werden, von welchem der vielen Server die Nachricht kommt. 15

16 Fehlerbehandlung: Bei Fehler maximieren: [Standard: nicht ausgewählt] legt fest, ob IPSWatchDog bei Erkennen eines IPS Fehlers maximieren soll, falls es minimiert ist. Service Beenden erzwingen: [Standard: ausgewählt] legt fest, das Beenden des IPS-Service erzwungen werden darf (der Service wird abgeschossen ), wenn sich dieser nicht auf normalem Wege beenden lässt. Dabei kann es zu Datenverlusten kommen! Ist diese Funktion nicht angewählt, so verfällt IPSWatchDog in den Wartemodus und wartet auf der Bereitschaftsmeldung des IPS- Service. Wurde Auf Server warten deaktiviert, so wird eine Meldung ausgegeben und auf manuelle Bestätigung gewartet, bevor IPSWatchDog wieder aktiv wird. Externes Service-Beenden-Skript: [Standard: nicht ausgewählt] alternativ zu den internen Service Beenden-Routinen, kann hier das externe Skript killservice.cmd ausgeführt werden. In diesem kann jeder selber festlegen, welches Programm zum Beenden des IPS-Service ausgeführt werden soll. Computer Neustart erzwingen: [Standard: ausgewählt] legt fest, ob ein Computer-Neustart erzwungen werden darf. Dabei werden auch hängende Anwendungen, die einen Neustart verhindern würden, abgeschossen. Dabei kann es zu Datenverlusten kommen! Ist diese Funktion nicht angewählt, so wird ein normaler Computer-Neustart versucht. Hängende Anwendungen können diesen jedoch verhindern. 16

17 Externes Neustart Skript: [Standard: nicht ausgewählt] alternativ zu den internen Neustart Routinen, kann hier das externe Skript reboot.cmd ausgeführt werden. In diesem kann jeder selber festlegen, welches Programm zum Neustart des Computers ausgeführt werden soll (die beigefügte reboot.cmd greift dabei auf das Windows eigene shutdown.exe zurück). Ist diese Option angewählt, ist Computer Neustart erzwingen nicht mehr verfügbar. Bei Fehler immer neu starten: [Standard: nicht ausgewählt] legt fest, ob IPSWatchDog bei Erkennen eines IPS Fehlers sofort einen Rechnerneustart ausführen soll, ohne erst eine Reparatur (Service stoppen und neu starten) zu versuchen. Ab der Version ist es nun auch möglich, Status- und Fehlermeldungen per zu versenden. Dies kann zusätzlich zu dem iphone-push per Prowl oder alternativ dazu geschehen. senden: [Standard: nicht aktiviert] hier kann man das Senden von s aktivieren. Es erscheinen dann zusätzliche Eingabeoptionen: 17

18 Host: [Standard: leer] hier wird die Hostadresse des SMTP Servers eingegeben. Port: [Standard: 25] hier wird der Port des SMTP Servers eingegeben. Der Standardport 25 kann normalerweise stehen bleiben. Absender: [Standard: leer] hier wird die Absenderadresse eingegeben. Manche provider benötigen hier eine real existierende Adresse, ansonsten kann hier irgendetwas stehen. Empfänger: [Standard: leer] hier wird der die adresse des Meldungsempfängers eingegeben. SMTP Login: [Standard: nicht aktiviert] benötigt der provider auch für das Versenden von Mails ein Login (das ist mittlerweile fast Standard), so muss dieses Feld aktiviert werden. Es erscheinen dann weitere Eingabeoptionen: 18

19 Benutzer: [Standard: leer] hier wird der Benutzername für den SMTP Server eingegeben. Passwortt: [Standard: leer] hier wird das Passwort für den SMTP Server eingegeben. ACHTUNG: Benutzername und Passwort werden unverschlüsselt in der Setupdatei (IPSWatchDog.cfg) gespeichert! 19

20 Programmablauf: IPSWatchDog sollte mit Administratorrechten gestartet werden. Programmstart: Es ist sinnvoll, einen Link im Autostartordner von Windows anzulegen damit es sofort beim Systemstart ausgeführt wird. Nach dem Start wartet IPSWatchDog darauf, dass der IPS- Service (oder ein anderer zu überwachender Service) läuft. Dabei ist das Setup noch nicht verfügbar. Eine blinkende gelbe Kontrolllampe oben rechts zeigt an, das IPSWatchDog aktiv ist. Im Statusfeld unten werden Informationen über die derzeitige Tätigkeit angezeigt. 20

21 Sobald festgestellt wurde, dass der IPS-Service korrekt läuft, nimmt IPSWatchDog seine Arbeit auf. Das Programmicon in der Infobar: In der Infobar des Desktops befindet sich das Programmicon von IPSWatchDog Dieses nimmt je nach Programmzustand verschiedene Farben an: Braun: IPSWatchDog wurde soeben gestartet und wartet auf den Service Weiß: IPSWatchDog wird pausiert Grün: Service und Server laufen einwandfrei Rot blinkend: Serice und/oder Server sind fehlerhaft Gelb: IPSWatchDog führt gerade Aktionen zum Reparieren von Service und/oder Server durch Ein Klick auf das Icon, egal, ob Rechts- oder Linksklick, öffnet ein Popupmenu mit weiteren Wahlmöglichkeiten. Programm beenden: Man kann IPSWatchDog auf zwei Arten beenden: 1. Durch Klick auf die Schaltfläche 21

22 2. Durch Klick auf Beenden im Popupmenu 22

23 Programm minimieren: Ist IPSWatchDog maximiert, so steht im Popupmenu der Eintrag Minimieren zur Verfügung. Man kann nun auf zwei verschiedene Arten minimieren: 1. Durch Klick auf die Schaltfläche 2. Durch Klick auf Pause im Popupmenu Programm maximieren: Ist IPSWatchDog minimiert, so steht im Popupmenu der Eintrag Maximieren zur Verfügung. Ein Klick darauf maximiert das Programm. 23

24 Programm manuell pausieren: Läuft IPSWatchDog, so steht im Popupmenu der Eintrag Pause zur Verfügung. Man kann nun auf zwei verschiedene Arten pausieren: 1. Durch Klick auf die Schaltfläche 2. Durch Klick auf Pause im Popupmenu Während des manuellen Pausierens blinkt oben rechts eine rote Kontrolllampe. 24

25 Programm manuell starten: Ist IPSWatchDog pausieert, so steht im Popupmenu der Eintrag Start zur Verfügung. Man kann nun auf zwei verschiedene Arten starten: 1. Durch Klick auf die Schaltfläche 2. Durch Klick auf Start im Popupmenu Das Setup aufrufen: Das Setup lässt sich auf zwei verschiedene Arten aufrufen: 1. Durch Klick auf die Schaltfläche 2. Durch Klick auf Setup im Popupmenu 25

26 Das INFO-Fenster: Durch einen Klick auf Info im Popupmenu werden ein paar Programminformationen angezeigt. 26

27 Verhalten bei Fehlern: Stellt IPSWatchDog einen Fehler fest, so wird es darauf reagieren. Dabei blinkt oben rechts eine gelbe Kontrollleuchte Nach Beendigung der Reparaturaktion sollten alle Kontrolllampen wieder auf grün stehen: 27

28 Das Log: IPSWatchDog legt ein Log an (IPSWatchDog.log) und protokolliert hierin Fehler und das Starten und Beenden des Programmes. Im Setup kann außerdem festgelegt werden, ob ein erweitertes Debugging aktiviert werden soll. Dadurch werden eine Vielzahl weiterer Informationen in das Log geschrieben. Dies dient nur der Programmfehlerfindung und sollte nur auf meine Aufforderung genutzt werden. 28

29 Die Log-Struktur: Jeder Log-Eintrag wird nach einer festen Struktur angelegt, damit man sie gegebenenfalls per Software auswerten kann: DATUM; UHRZEIT; ART_DES_EINTRAGS: AUSFÜHRENDE_ROUTINE: MELDUNG Dabei bedeutet: DATUM: das Datum des Eintrages UHRZEIT: die Uhrzeit des Eintrages ART_DES_EINTRAGS; dieser kann vier verschiedene Arten haben: o INFO; es folgt ein informativer Eintrag o ACTION; eine Aktion (z.b. Service starten) wird protokolliert o ERROR; ein Fehler ist aufgetreten. Dies betrifft hauptsächlich Fehler des IPS-Servers (IPSAlive Datei fehlt) aber auch Fehler im IPSWatchDog Programmablauf (z.b. Ko- Datei konnte nicht umbenannt werden). o RESULT; folgt zumeist auf eine ACTION; und protokolliert das Ergebnis (z.b. Serverstart erfolgreich) AUSFÜHRENDE_ROUTINE; hier wird der Name der Prozedur oder Funktion im Programm angegeben, die die Meldung produziert. Der Name ist hauptsächlich zur Programmfehlersuche interessant, erklärt aber auch, was diese Prozedur macht (z.b. StartIPSService). MELDUNG enthält die eigentliche Meldung. 29

30 Jeden Tag ein neues Log: Um die Logs übersichtlicher zu gestalten, kann im Setup durch Jeden Tag ein neues Log beginnen festgelegt werden, dass, ja was nur, jeden Tag eine neue Logdatei angelegt wird. Dabei wird die alte Datei mit dem alten Datum umbenannt (z.b. aus IPSWatchDog.log wird PSWatchDog_ log) und eine neue angelegt. 30

31 iphone Push Benachrichtigung: Als iphone Besitzer suchte ich nach einer Möglichkeit, mich zeitnah über die Aktivitäten von IPSWatchDog informieren zu lassen. Dies realisiert ich zunächst einmal durch ein Skript in IPS, das mir bei Änderungen im IPSWatchDogLog, dieses per zuschickte, die mir dann auf das Handy gepusht wurde. Der Nachteil: hier handelte es sich immer um das komplette Log (auch alte Meldungen), es geschah nur in festgelegten Zeitabständen und, sollte der IPS Service mal nicht funktionieren und aus irgend einem Grunde nicht wieder repariert werden können, so kämen gar keine Meldungen mehr. Prowl: Im IPS Forum ( fand ich einen Hinweis auf die iphone App Prowl. Hiermit lassen sich recht einfach Nachrichten auf das iphone pushen und ich konnte meinen Wunsch realisieren. Jede einzelne Meldung von IPSWatchDog wird nun sofort vom Programm auf das iphone geschickt. Damit dies auch klappt, müssen einige Voraussetzungen erfüllt sein: 1. Die Prowl App muss auf dem iphone installiert sein. Sie ist über den Apple App-Store erhätlich und leider kostenpflichtig (derzeit 2,39). 2. Man benötigt einen Api Key. Diesen kann man nach der kostenlosen Registrierung auf der Prowl Website ( unter dem Menupunkt Settings generieren lassen. 3. Die Anmeldedaten für die Prowl Website muss man in die Prowl App eingeben 4. iphone Push muss im Setup von IPSWatchDog aktiviert werden 5. Der Api Key muss im Setup von IPSWatchDog eingetragen werden 31

32 Eingehende Meldungen werden nach erfolgreicher Einrichtung dann zunächst auf dem Home- Bildschirm des iphone gemeldet und können in Prowl im Einzelnen angesehen werden. Prowl Fehlermeldungen: Unter bestimmten Umständen kann es dazu kommen, dass ein Fehler beim Versand von Nachrichten an Prowl auftreten. Tritt ein solcher Fehler auf, so erfolgt ein Eintrag im Log von IPSWatchDog. Es wird dabei ein Fehlertext angegeben, der einen Code enthält. Dabei dürfte es sich zumeist um den Code 401 handeln, ein Zeichen dafür, dass der Prowl-API-Key fehlerhaft ist. Mögliche Codes: 400 Bad request, the parameters you provided did not validate. 401 Not authorized, the API key given is not valid, and does not correspond to a user. 405 Method not allowed, you attempted to use a non-ssl connection to Prowl. 406 Not acceptable, your IP address has exceeded the API limit. 500 Internal server error, something failed to execute properly on the Prowl side. 32

33 Die Skripte: Bei der Aufzählung der Variablen und Skripte gehe ich davon aus, dass Sie das Installationsskript IPSWatchDogInstall.php benutzt haben. Eine Erklärung zu den Variablen und Skripten fand schon weiter oben unter der Rubrik Installation ohne Skript statt. Skripte: IWDAliveFileSkript <? // Dieses Skript erstellt die Alive-Datei zur Übermittlung der Alive-Meldung // an IPSWatchDog per Datei // Hier wird der Dateiname der Alive-Datei festgelegt. // Er ist standardmäßig auf "alive.ips" gesetzt und muss, falls geändert, im // Setup von IPSWatchDog angepasst werden! $DateiName = 'alive.ips'; // ab hier nichts mehr verändern!!! define("dateiname", "..\\".$DateiName); //Dateiname für alive Datei definieren //Datei vorhanden? $dateifehlt =!file_exists(dateiname); //falls die Datei fehlt, neu anlegen if ($dateifehlt) { $inhalt = date("d.m.y - H:i"); $datei = fopen(dateiname, "a"); fwrite ($datei, $inhalt); fclose($datei); }?> 33

34 StartIPSWatchDog: <? // Parent-ID der Kategorie ermitteln $parentid = IPS_GetObject($IPS_SELF); $parentid = $parentid['parentid']; // ID der Skripte ermitteln $IWDAliveFileSkriptScID = IPS_GetScriptIDByName("IWDAliveFileSkript", $parentid); $IWDSendMessageScID = IPS_GetScriptIDByName("IWDSendMessage", $parentid); IPS_RunScript($IWDAliveFileSkriptScID); IPS_RunScriptEx($IWDSendMessageScID, Array('state' => 'start'));?> StopIPSWatchDog: <? // Parent-ID der Kategorie ermitteln $parentid = IPS_GetObject($IPS_SELF); $parentid = $parentid['parentid']; // ID der Skripte ermitteln $IWDSendMessageScID = IPS_GetScriptIDByName("IWDSendMessage", $parentid); IPS_RunScriptEx($IWDSendMessageScID, Array('state' => 'stop'));?> 34

35 Disclaimer: IPSWatchDog, 2011 by Andreas Pieroth Windows, by Microsoft ip-symcon, by Computer- und Steuerungstechnik Steiner, Michael Steiner Das Programm darf ohne meine Zustimmung nicht entgeltlich angeboten werden! Ich stelle das Programm kostenlos zur Verfügung und übernehme keinerlei Garantie für die korrekte Funktion. Ich garantiere nur, dass es auf der Festplatte Platz belegen wird. Für Datenverluste oder Schäden durch das Programm übernehme ich keine Haftung. Das Programm kann hier heruntergeladen werden: Fragen, Anregungen, Probleme kann man unter los werden. Viel Freude mit IPSWatchDog wünscht, Andreas Pieroth 35

36 Versionshistorie: erste Releaseversion unter bestimmten Umständen konnte IPSWotchDog die Kontrolldatei nicht finden behoben unter bestimmten Umständen erzeugt IPSWotchDog das Log an falscher Stelle - behoben Fehler in der Behandlung von TimeOuts behoben unter bestimmten Umständen konnte IPSWatchDog die Dateien kill.cmd und reboot.cmd nicht starten - behoben Log-Einträge sinnvoller gestaltet 1.0.3a Logging nochmals verfeinert IPSWatchDog wird nun als Icon in den Infobereich (SysTray) minimiert Logging nochmals angepasst Neues Programmicon Icons nochmals angepasst Das Programm ist nun fähig, IPS.exe den Rechner neu zu starten, ohne die Nutzung von psshutdown.exe und reboot.cmd. Leider ist es mir noch nicht gelungen, unter Delphi eine Routine zu programmieren, die hängende Prozesse zuverlässig "abschiesst". Daher wird pskill.exe weiterhin benötigt. kill.cmd hingegen kann gelöscht werden IPSWatchDog überprüft nun, ob der IPS-Service überhaupt installiert ist. Wenn nicht, beendet sich das Programm mit einer Fehlermeldung kosmetische Änderungen Überprüfungsroutinen verbessert Fehlerzähler eingebaut Start mit Parametern (-d = Debugmodus -> ausführlicheres Logging, -m = minimiert starten) 36

37 IPSWatchDog nutzt nun das Windows eigene TASKKILL.EXE, um gegebenenfalls den IPS Service zu beenden -> pskill.exe kann gelöscht werden a neue Ampeln IPSWatchDog kann IPS-Servergesteuert gestartet und pausiert werden. Dazu sind die beiden Skripte StartIPSWatchDog.php und StopIPSWatchDog.php zu erstellen und im EventHandler in den Kerninstanzen als Start- bzw. Hrunterfahr-Skript einzutragen. Zur Nutzung dieses Features, muss IPSWatchDog mit dem Parameter -a gestartet werden. ist IPSWatchDog minimiert, so wird es bei auftretendem Fehler automatisch maximiert Das Programm ist nun mit einem richtigen Installer versehen! IPSWatchDog kann bei Nutzung des Parameters -a (das Programm wartet auf Servermeldungen zum Starten und Stoppen) nun auch manuell per Buttonklick gestartet und gestoppt werden Kleinere Schönheitskorrekturen, den Start- und Pause-Button betreffend Beim automatischen Reboot sollten nun auch hängende Tasks, die ein Reboot verhindert hätten, geschlossen werden Der Start mit den Parametern a, -d und m ist nicht mehr möglich. Es gibt dafür nun ein Setup Fenster, in dem diverse Parameter festgelegt werden können Unveröffentlichter Zwischenschritt mit kleineren Fehlerbehebungen. ACHTUNG: das Format der INI-Datei hat sich geändert. Beim ersten Start der neuen Version wird die alte INI-Datei ersetzt. Dabei gehen die alten Einstellungen verloren. ACHTUNG: das Format der INI-Datei hat sich geändert. Beim ersten Start der neuen Version wird die alte INI-Datei ersetzt. Dabei gehen die alten Einstellungen verloren. Es kann eingestellt werden, ob das Beenden des IPS-Service und der Computer-Neustart erzwungen werden darf oder nicht. Ist das Programm minimiert, so wird nun die Anzahl der gefundenen Serverfehler als Tooltip im Infobereich angezeigt. Neuer Punkt im Einstellungs-Menu: Jeden Tag ein neues Log beginnen Bugfix für die Erstellung von täglich neuen Logs 37

38 Unveröffentlichter Release kleiner Fixe hauptsächlich Testplattform für iphone Push Fixe in der Serverfehler-Erkennung Fixe in der Jeden Tag ein neues Log Funktion Splash Screen beim Programmstart hinzugefügt. iphone Push per Prowl möglich Logging überarbeitet Interne Korrekturen und Fixe Möglichkeit, zum Rechnerneustart ein externes Programm aufzurufen, hinzugefügt Möglichkeit, iphone Pushnachrichten mit individuellem Absender und Betreff zu versehen, hinzugefügt Deutsche Umlaute werden nun in Prowl korrekt dargestellt Erscheinungsbild verändert Möglichkeit, den Fensterrahmen des Programmes zu entfernen, hinzugefügt Minimieren-Button hinzugefügt Programmicon nun permanent im Infobereich verfügbar Interne Entwicklungsversion (nicht veröffentlicht) Interne Entwicklungsversion (nicht veröffentlicht) Einstellungsdialog überarbeitet Format der Konfigurationsdatei überarbeitet. Sie heißt nun ipswatchdog.cfg und ist eine normale Textdatei. Dadurch müssen die Einstellungen bei hinzukommenden Parametern nicht ständig komplett neu eingegeben werden. Die alte Datei (ipswatchdog.ini) kann gelöscht werden. Aussehen des Info Fensters verändert Es können nun entfernte Computer im selben Netzwerk überwacht werden (experimentell) Es können nun auch andere, als der IPSServer-Service überwacht werden (experimentell) Gefixt: Access Violation bei Programmende Fixed: das Beenden des Programms wird nun wieder ins Log geschrieben, wenn auch der ProwlPush nicht 100% zuverlässig ist. Das Programm kann nun mit dem Parameter s gestartet werden, um die Überprüfung auf installierten IPSServer-Dienst zu übergehen. (Notwendig, wenn ein anderer als der IPSServer Dienst und/oder ein entfernter Computer im Netzwerk überwacht werden sollen) Im Setup kann nun festgelegt werden, ob die Überprüfung auf installierten IPSServer-Dienst übergangen werden soll. (Notwendig, wenn ein anderer als der IPSServer Dienst und/oder ein entfernter Computer im Netzwerk überwacht werden sollen) 38

39 Fixed: nun wird auch beim Beenden des Programmes eine Prowl Nachricht geschickt iphone Meldungen bleiben auf wichtige Servermeldungen beschränkt. Die Nachricht über den Logaustausch um Mitternacht, wird nun - sehr nervenschonend ;-) nicht mehr über Prowl an das iphone gesendet. fixed: ich hatte versehentlich in der Version das Stoppen und Starten des IPS-Service lahmgelegt. Das resultierte in einem Neustart des Systems, jedes Mal, wenn ein Serverfehler aufgetreten ist. Das sollte nun behoben sein kleinere Fixe IPSWatchDog kann nun durch eine Rebootanforderung von IPS dazu aufgefordert werden, IPS zu beenden und dann den Rechner neu zu starten. Komplette Umstellung von Nachrichtendateien auf Serverüberwachung per SOAP Interface IPSWatchDog kann nicht mehr auf Server-Start oder Server-Stop Nachrichten reagieren. Eine Übermittlung solcher Nachrichten ist nur per Datei möglich. Zeitintervalle der Überprüfung verringert Rote Kontrollampe beim Pausieren Bugfixes Komplette Überarbeitung Überwachung per Datei oder SOAP möglich Übermittlung von Befehlen von IPS an IWD möglich Standalone Setup Diverse Fixes IWD sollte nun erkennen, wenn Fehler beim Zugriff auf IPS-Variablen oder -Skripte via SOAP aufgetreten ist. Dann werden zwei weitere Versuche unternommen. Kompatibilitätsproblem mit WindowsXP beseitigt Unter WindowsXP kam es beim Start von IPSWatchDog zu Abstürzen -> behoben Prowl-Interface neu programmiert. Neu: Möglichkeit, den Prowl-API-Key aus IPS zu importieren Eine Reihe Bugfixes Jetzt schlankeres Programm dank Delphi 2007 (vorher 2010) (nicht veröffentlicht) Kleineres Bugfix 39

40 2.2.5 Neuste TRIXI.DLL integriert Hotkeys im Setup unter Reiter IPS eingefügt Möglichkeit des sofortigen Rechnerneustarts bei Fehlern im Setup eingefügt Meldungsversand jetzt per möglich Aktualisierte SSL Dateien (libeay32.dll und ssleay32.dll) Verschlankung des Programms Zurück zur reinen Überwachung per Datei Möglichkeit zur Ausführung eines externen Skriptes zum Beenden des IPS-Service hinzugefügt Fehler bei automatischen Programmstart behoben 40