IPSWatchDog Aktuelle Version: vom

Transkript

1 IPSWatchDog Aktuelle Version: vom

2 Inhaltsverzeichnis Sinn und Zweck:... 4 Das Konzept:... 4 Unterschiede Version 1.x und Version 2.x von IPSWatchDog... 4 Systemvoraussetzungen:... 5 Installation:... 5 Die Programminstallation:... 5 Installations-Skript anlegen und ausführen Installation ohne Skript Das Setup: Die Programmeinstellungen im Einzelnen: Startparameter: Timeouts und Intervalle: Serviceparameter (experimentell): Logging: iphone Push Parameter: Fehlerbehandlung: IPS: Das Programmfenster: Programmablauf: Programmstart: Das Programmicon in der Infobar: Programm beenden: Programm minimieren: Programm maximieren: Programm manuell pausieren: Programm manuell starten: Fehlerzähler zurücksetzen: Das Setup aufrufen: Das INFO-Fenster: Verhalten bei Fehlern: Das Log: Die Log-Struktur: Jeden Tag ein neues Log:

3 iphone Push Benachrichtigung: Prowl: Prowl Fehlermeldungen: Die Nachrichtenschnittstelle: Die Variablen und Skripte: Variablen: Skripte: IWDAliveSkript IWDAliveFileSkript IWDSendMessage IWDFileMessageON: IWDFileMessageOFF: Disclaimer: Bekannte Probleme: 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. 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. Unterschiede Version 1.x und Version 2.x von IPSWatchDog Nachdem die Version 1.x des Programmes noch ausschließlich per Nachrichtendatei mit IPS kommuniziert hatte, ist die Version 2.x zusätzlich noch fähig, über die SOAP Schnittstelle von IP- Symcon zu reden. Die gewünschte Methode kann im Setup eingestellt werden. Mein besonderer Dank gilt Tonic1024, der mir tatkräftig unter die Arme gegriffen hat und mir mit seiner TRIXI.DLL den Zugriff auf den SOAP Server erst möglich gemacht hat. Es lohnt auf jeden Fall ein Besuch seiner Internetseite 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 TRIXI.DLL (die SOAP Schnittstelle) IPSWatchDog.pdf (die Gebrauchsanleitung) IPSWatchDogInstall.php (Skript zur Installation der notwendigen Eintragungen in IPSymcon) scripts/iwdalivefileskript.php scripts/iwdaliveskript.php scripts/iwdfilemessageoff.php scripts/iwdfilemessageon.php scripts/iwdsendmessage.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. 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): Variablen: 1. IWDAlive Typ: boolean dient zur Überwachung des Servers und wird skriptgesteuert auf TRUE und durch IPSWatchDog wieder auf FALSE gesetzt. Sie kann wegfallen, wenn Sie sich für eine IPS-Serverüberwachung per Datei entscheiden. 2. IWDMessage Typ: string dient zur Übermittlung von Nachrichten an IPSWatchDog. Diese Variable kann entfallen, wenn Sie sich dafür entscheiden keine Nachrichten oder aber Nachrichten per Datei zu übermitteln. 3. IWDFileMessage Typ: boolean dient zur Festlegung, ob Nachrichten auch als Datei übermittelt werden sollen. Diese Variable wird durch das Skript IWDSendMessage ausgewertet und mit den Skripten IWDFileMessageON und IWDFileMessageOFF ein- und ausgeschaltet. Die Variable ist nicht notwendig, wenn Sie Nachrichten nur über das SOAP Interface oder aber gar keine Nachrichten übermitteln wollen. Skripte: 4. IWDAliveSkript Typ: Skript Dieses Skript setzt in regelmäßigen Abständen die Variable IWDAlive auf TRUE, um eine Überwachung des IPS-Servers zu ermöglichen. Der Inhalt des Skripts ist in der Datei scripts/iwdaliveskript.php zu finden. Das Skript ist nicht notwendig, wenn Sie sich für eine IPS-Server Überwachung per Datei entscheiden. 5. 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 ist nicht notwendig, wenn Sie sich für eine IPS-Server Überwachung per SOAP entscheiden. 6. IWDSendMessage Typ: Skript Dieses Skript wird aufgerufen, um Nachrichten an IPSWatchDog zu generieren und dabei je nach Zustand den Variablen IWDFileMessage nur eine Nachricht über SOAP oder aber zusätzlich eine Nachricht über eine Nachrichtendatei zu übermitteln. Der Aufruf erfolgt von einem weitern Skript auf folgende Weise: IPS_RunScriptEx(<ID dieses IWDSendMessageSkriptes>, Array('state' => '<Nachricht>'));. Das Skript benötigt die Variablen IWDMessage und IWDFileMessage. Der Inhalt des Skripts ist in der Datei scripts/iwdsendmessage.php zu finden. Das Skript ist nicht notwendig, wenn Sie keine Nachrichten übermittlen wollen. 7. IWDFileMessageOF Type: Skript Diese Skript wird aufgerufen, um über die Variable IWDFileMessage eine Übermittlung von Nachrichten an IPSWatchDog per Datei einzuschalten. Dabei wertet IWDSendMessage die Variable IWDFileMessage aus und erstellt die Nachrichtendatei. Dieses Skript ist grundsätzlich nur notwendig, wenn Sie das Ein- und Ausschalten der Nachrichtendatei automatisieren wollen (z.b. im Setup, Reiter IPS bei Anklicken der gewünschten Überwachungsmethode: Klick auf SOAP startet das Skript IWDFileMessageOFF, Klick auf Datei IWDFileMessageON). 10

11 8. IWDFileMessageOFF Type: Skript Diese Skript wird aufgerufen, um über die Variable IWDFileMessage eine Übermittlung von Nachrichten an IPSWatchDog per Datei auszuschalten. Dabei wertet IWDSendMessage die Variable IWDFileMessage aus und erstellt keine Nachrichtendatei. Dieses Skript ist grundsätzlich nur notwendig, wenn Sie das Ein- und Ausschalten der Nachrichtendatei automatisieren wollen (z.b. im Setup, Reiter IPS bei Anklicken der gewünschten Überwachungsmethode: Klick auf SOAP startet das Skript IWDFileMessageOFF, Klick auf Datei IWDFileMessageON). 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! 11

12 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.. 12

13 Die Programmeinstellungen im Einzelnen: Startparameter: Minimiert starten: [Standard: nicht ausgewählt] legt fest, ob IPSWatchDog minimiert startet. Ist diese Einstellung aktiviert, so wir IPSWatchDog nach dem Start nicht auf dem Desktop angezeigt, sondern erscheint nur als Icon im Infobereich unten rechts. Ohne Rahmen: [Standard: nicht ausgewählt] blendet den Rahmen um das IPSWatchDog Fenster ein oder aus. Ist mehr eine Spielerei. 13

14 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. 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. 14

15 Serviceparameter (experimentell): Computer Name: [Standard: leer] hier kann der Netzwerkname des Computers, der überwacht werden soll festgelegt werden. Dadurch ist es möglich, nicht nur den lokalen, sondern auch andere Rechner im selben Netzwerk zu überwachen. ACHTUNG: Wird ein entfernter Computer überwacht, muss IPS-Server überwachen deaktiviert sein! Außerdem muss unter Fehlerbehandlung der Punkt Service beenden erzwingen deaktiviert sein! 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! IPS-Server überwachen: [Standard: aktiviert] legt fest, ob das Vorhandensein der Nachrichtendatei alive.ips oder der Nachrichtenvariable für SOAP überwacht werden soll. Dies ist notwendig, damit festgestellt werden kann, ob der IPSServer-Dienst noch korrekt funktioniert. Bitte unbedingt deaktivieren, wenn ein fremder Computer oder ein anderer Dienst überwacht werden soll! 15

16 Auf installierten IPS-Service prüfen: [Standard: aktiviert] legt fest, ob beim Start von IPSWatchDog überprüft werden soll, ob der IPSServer-Dienst auf dem lokalen Computer installiert wurde. Ist dieser Dienst nicht installiert, so bricht IPSWatchDog mit einer Fehlermeldung ab. Bitte unbedingt deaktivieren, wenn Dienst überwacht werden soll! GANZ WICHTIG: Man kann IPSWatchDog zur Überwachung des IPSServer-Service auf einem entfernten Computer im selben Netzwerk Überwachung von anderen Servicen nutzen. Allerdings fragt IWD beim Programmstart ab, ob der IPSServer-Service auf dem lokalen Rechner installiert ist und verweigert bei Nichtvorhandensein den Dienst. Somit lassen sich auch keine Einstellungen vornehmen. Um diese Abfrage zu umgehen, muss IPSWatchdog mit dem Parameter s gestartet werden. 16

17 Logging: Erweitertes Debugging: [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: 17

18 iphone Push Parameter: Prowl Api Key: [Standard: leer] hier wird der Api Key von Prowl eingetragen. Dazu mehr unter iphone Push Benachrichtigungen weiter unten. ID: [Standard: leer] wenn in IPS eine String-Variable mit dem Prowl-API-Key angelegt wurde, so kann mit hier die ID dieser Variablen eingeben und Importieren anklicken. Der Key wird dann automatisch übernommen. VORAUSSETZUNG: im Reiter IPS muss Soap Überwachung aktiviert sein. Prowl Anwendung: [Standard: IPSWatchDog] hier wird der Absender der Prowl Nachricht festgelegt. Prowl 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. 18

19 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. 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. 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. 19

20 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. 20

21 IPS: In der Version 2.x neu hinzugekommen, sind nun Einstellungen für den IPS-SOAP-Server. Wurden die notwendigen Variablen und Skripte durch das oben erwähnte Installationsskript (IPSWatchDogInstall.php), so wird eine Datei namens install.iwd erstellt und diese beim Programmstart ausgewertet. Die notwendigen Eintragungen erfolgen dann automatisch. Server-IP: [Standard: ] hier hinein kommt die IP-Adresse des Servers im lokalen Netzwerk. Da IPSWatchDog idealerweise auf dem selben Rechner läuft, wie IP-Symcon, kann man getrost die Adresse des Localhost ( ) stehen lassen. Server-Port: [Standard: 3773] hier hinein kommt die Port für IPS. Dieser muss nur geändert werden, wenn in IPS ein abweichender Port eingestellt wurde. Methode: [Standard: SOAP Überwachung] hier kann gewählt werden, ob der IPS-Server direkt über die SOAP Schnittstelle von IPS oder durch eine Alive-Datei überwacht werden soll. Je nach Wahl sind einige Eingabefelder deaktiviert. Alive Skript triggern, ID: [Standard: deaktiviert] hier wird festgelegt, ob IPSWatchDog die IPS-Skripte zur Alive-Meldung des IPS-Servers auslösen soll. Ist dieses Feld aktiviert, so müssen noch die IDs der jeweiligen IPS-Skripte in die darauffolgenden Felder eingegeben werden. Wurde die Datei install.iwd ausgewertet, so werden hier automatisch die IDs der Skripte IWDAliveSkript.php und IWDAliveFileSkript.php eingetragen. 21

22 Ist dieses Feld nicht aktiviert, so muss in IPS für die entsprechenden Skripte ein Timer gesetzt werden, der die Skripte ausführt (idealerweise wählt man hier eine Zeit die der Hälfte des in Timeouts/Intervalle in Check Intervall eingestellten Parameters entspricht (als bei 60 Sekunden, sollte man das Skript alle 30 Sekunden ausführen lassen). Alive Variable ID: [Standard: 00000] hier hinein kommt die ID der Alive-Variable (IWDAlive) in IPS. Diese wird zur Überwachung des IPS-Servers abgefragt. Wurde die Datei install.iwd ausgewertet, wird der Wert automatisch eingetragen. Wurde als Überwachungsmethode Dateiüberwachung gewählt, so muss der Dateiname der Alive-Datei in das entsprechende Feld eingegeben werden. Der Standard hier ist alive.ips. Message Variable, ID: [Standard: deaktiviert] hier wird festgelegt, ob IPSWatchDog Nachrichten von IPS empfangen soll. Diese können z.b. Einstellungsbefehle oder der Befehl zum Neustart des Servers enthalten. Dazu später mehr. Ist dieses Feld aktiviert, so müssen noch die IDs der jeweiligen IPS- Variablen (IWDMessage), bzw. der Nachrichtendatei (message.iwd) in die darauffolgenden Felder eingegeben werden. Wurde die Datei install.iwd ausgewertet, so werden hier automatisch die IDs der Variablen eingetragen. Automatische Ein- und Ausschaltung der Dateinutzung: [Standard: deaktiviert] hier wird festgelegt, ob IPS automatisch mitgeteilt werden soll, dass eine Nachrichtendatei erstellt werden muss. Wird beim Klick auf SOAP Überwachung das Skript IWDFileMessageOFF aufgerufen und somit die Variable IWDFileMessage auf FALSE gesetzt. Beim Klick auf Dateiüberwachung wird das Skript IWDFileMessageON aufgerufen und somit die Variable IWDFileMessage auf TRUE gesetzt. Wurde diese Schaltfläche aktiviert, müssen in die Felder Dateinutzung ein ID und Dateinutzung aus ID: die IDs der genannten Skripte eingetragen werden. Wurde die Datei install.iwd ausgewertet, so werden hier automatisch die IDs der Skripte eingetragen. IPS Nachrichten per Prowl bestätigen: [Standard: deaktiviert] hier wird festgelegt, ob eine Bestätigung der übermittelten Nachrichten an IPSWatchDog per Prowl erfolgen soll. Ist diese Schaltfläche aktiviert, so sendet IPSWatchDog beim Empfang einer gültigen Nachricht eine Bestätigung an Ihr iphone. Ist unter Logging die Schaltfläche iphone-push mit Prowl deaktiviert, so ist diese Schaltfläche nicht anwählbar. Buttons: reine SOAP Überwachung, reine Dateiüberwachung, Dateiüberwachung mit SOAP: hiermit lassen sich mit einem Klick auf den Button diverse Einstellungen durchführen: Reine SOAP Überwachung: die Einstellungen SOAP Überwachung, Alive Skript triggern und Message Variable ID werden aktiviert Reine Dateiüberwachung: die Einstellung Dateiüberwachung wird aktiviert, alles andere deaktiviert Dateiüberwachung mit SOAP: die Einstellung Dateiüberwachung, Alive Skript triggern und automatisches Ein- und Ausschalten der Dateinutzung wird aktiviert. 22

23 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: 23

24 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: 24

25 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! 25

26 Das Programmfenster: 26

27 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. 27

28 Sobald festgestellt wurde, dass der IPS-Service korrekt läuft, nimmt IPSWatchDog seine Arbeit auf. Die Kontrolllampe oben rechts blinkt nun grün, die Schaltfläche für das Setup ist verfügbar und es ist eine zusätzliche Schaltfläche für das manuelle Anhalten von IPSWatchDog hinzu gekommen. Erst nach dem ersten regulären Check stehen Informationen über den Zustand des IPS-Servers zur Verfügung. 28

29 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 2. Durch Klick auf Beenden im Popupmenu 29

30 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. 30

31 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. 31

32 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 Fehlerzähler zurücksetzen: IPSWatchDog zählt die Service- und Serverfehler vom Zeitpunkt des letzten Resets an. Es wird dabei über Datum und Uhrzeit des letzten Resets, sowie die Anzahl der Fehler seither informiert. Ein Klick auf die Reset-Schaltfläche setzt den Zähler auf 0 und trägt das aktuelle Datum und Uhrzeit ein. 32

33 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 Das INFO-Fenster: Durch einen Klick auf Info im Popupmenu werden ein paar Programminformationen angezeigt. 33

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

35 35

36 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. 36

37 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. 37

38 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. 38

39 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 39

40 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. 40