Directory Watcher v1.1 Dokumentation

Transkript

1 Directory Watcher v1.1 Dokumentation WHS Add-In von Daniel Buschke Version: 1.1 Stand: Status: Release

2 Copyright by Daniel Buschke Alle Rechte, auch die des auszugsweisen Nachdrucks, der fotomechanischen Wiedergabe (einschließlich Mikrokopie) sowie der Auswertung durch Datenbanken oder ähnliche Einrichtungen, vorbehalten. Directory Watcher Dokumentation.docx Version 1.1 Seite i

3 Änderungshistorie Version Datum Autor Änderung / Kommentar Daniel Buschke Initiale Erstellung für Version 1.1 Directory Watcher Dokumentation.docx Version 1.1 Seite ii

4 Inhaltsverzeichnis 1 Einleitung Zweck Funktionen Erstellen und Löschen von Dateien Überwachung für einen Ordner hinzufügen Filter setzen Benachrichtigungen für Events Programm ausführen Komponenten Bereitstellungsleitfaden Voraussetzungen Installation Konfiguration Deinstallation Anhang Abbildungsverzeichnis Tabellenverzeichnis Weiterführende Links Begriffe und Abkürzungen... 6 Directory Watcher Dokumentation.docx Version 1.1 Seite iii

5 1 Einleitung 1.1 Zweck Directory Watcher ist ein Windows Home Server Add-In. Es wurde bei der Add-In Idea Challenge von Adam Swift vorgeschlagen, aber es belegte nicht den TOP Rang der benötigt wurde, damit das Add-In von den Initiatoren kostenlos für die Community entwickelt wird. Das Add-In überwacht Verzeichnisstrukturen auf neue oder gelöschte Dateien. Im Falle eines eintretenden Events kann mit verschiedenen Ereignissen darauf reagiert werden. 2 Funktionen 2.1 Erstellen und Löschen von Dateien Das Add-In behandelt beide Ereignisse gleichwertig. Wird ein Ordner zur Überwachung hinzugefügt, so wird dieser anhand der eingestellten Kriterien überwacht. Sollte eine Datei in diesem Ordner erstellt, hinein kopiert, ausgeschnitten oder gelöscht werden, so findet eine Überprüfung des Dateityps statt. Ist diese Prüfung positiv, schlagen alle konfigurierten Events zu und werden verarbeitet. 2.2 Überwachung für einen Ordner hinzufügen Über Neuer Ordner kann ein neuer Ordner zur Überwachung hinzugefügt werden. Dafür wird ein Auswahldialog angezeigt, der alle Ordner des Home Servers darstellt. Nach der Bestätigung mit OK wird dieser zur Liste hinzugefügt und der Ordner wird erst einmal generell anhand der weiteren Konfigurationen überwacht. Abbildung 1 - Ordner hinzufügen Um weitere Einstellungen wie z.b. den versand für diesen Ordner zu hinterlegen, muss der eben hinzugefügte Ordner in der Liste markiert werden und anschließend der Button hinzufügen geklickt werden. Alternativ kann ein Doppelklick in der Liste auf den gewünschten Ordner ausgeführt werden. Directory Watcher Dokumentation.docx Version 1.1 Seite 1

6 Abbildung 2 - Adressen für Ordner Über den Button Adresse hinzufügen können nun beliebig viele adressen hinterlegt werden. Ein Klick auf Adresse entfernen löscht die aktuell markierte Adresse wieder. Anschließend kann der Dialog über den Schließen Button geschlossen werden. Hinweis: Alle vorgenommenen Änderung sind nur temporär. Es muss im Konfigurationsdialog der Speichern Button geklickt werden, um alle Änderungen endgültig zu übernehmen. 2.3 Filter setzen Im Konfigurationsdialog kann nun bestimmt werden, welche Dateitypen überwacht oder ignoriert werden sollen. Dazu muss der Filter entweder für einzuschließende Dateitypen oder auszuschließende Dateitypen gesetzt werden. Im Textfeld darunter können dann spezielle Dateitypen hinterlegt werden. Eventtabelle auszuschließende Dateitypen Filter Event positiv/negativ *.* Negativ txt,dat bmp,jpg,jpeg,gif Positiv Negativ Datei: <Neues Bitmap.bmp> wird erstellt oder gelöscht Directory Watcher Dokumentation.docx Version 1.1 Seite 2

7 Eventtabelle einzuschließende Dateitypen Datei: <Neues Bitmap.bmp> wird erstellt oder gelöscht Filter Event positiv/negativ *.* Positiv txt,dat bmp,jpg,jpeg,gif Negativ Positiv 2.4 Benachrichtigungen für Events Es gibt 3 verschiedene Benachrichtigungen die gewählt werden können. Abbildung 3 - Benachrichtigungen konfigurieren RSS Feed intern Der interne RSS Feed ist über den geschützten Bereich (nach Login) erreichbar und bietet daher den Schutz vor unerlaubten Blicken. Der Link öffne Feed führt direkt zum Feed, welcher unter der Adresse erreichbar ist. (Der Link erscheint erst, wenn der Feed existiert -> Es muss also mindestens einmal ein Event erfolgreich ausgeführt worden sein) RSS Feed extern Der externe RSS Feed ist frei über das Internet ohne Login erreichbar und bietet daher keinen Schutz vor unerlaubten Blicken. Der Link öffne Feed führt direkt zum Feed, welcher unter der Adresse erreichbar ist. (Der Link erscheint erst, wenn der Feed existiert -> Es muss also mindestens einmal ein Event erfolgreich ausgeführt worden sein) senden Wird der versand gewählt, wird ein weiterführender Konfigurationsdialog auf der rechten Seite des Add-Ins eingeblendet. Hier muss eine Absenderadresse inklusive alle benötigten Serverangaben hinterlegt werden. Diesen können bei den meisten Providern in den FAQs nachgeschlagen werden. (Konfiguration eines externen Programms, Konfiguration unter Outlook, ) Wichtig sind hier die Outgoing Settings. Bevor eine Testmail verschickt werden kann, müssen alle Angaben gespeichert worden sein. Directory Watcher Dokumentation.docx Version 1.1 Seite 3

8 Abbildung 4 - Absenderadresse konfigurieren Um die an die Adressen, welche zu jedem Ordner hinterlegt wurden, direkt zu verschicken muss direkt zum Event ausgewählt sein. Soll lieber eine Tagesstatistik gesendet werden, müssen die jeweiligen Tage und die Uhrzeit gewählt werden. 2.5 Programm ausführen Es ist die Möglichkeit gegeben, ein weiteres Programm nach dem Event auszuführen. Dazu muss der jeweilige Ordner in der Liste ausgewählt werden (Doppelklick). Im sich öffnenden Dialog kann eine ausführbare Datei über einen Dialog gewählt werden. Als Argumente können beliebige, vom Programm erwartete Parameter hinterlegt werden. Diese werden beim Aufruf direkt übergeben. Als Platzhalter liefert das Add-In 2 Platzhalter mit, die zur Laufzeit automatisch getauscht werden: {FILE} - Dateiname {FULLNAME} kompletter Pfad zur Datei inkl. Dateiname Nach der Wahl, zu welchem Event die Datei ausgeführt werden soll, kann der Dialog geschlossen und die Änderungen gespeichert werden. Um eine neu erstellte/kopierte Datei umzubenennen, wäre folgender Weg möglich: - Erstellung einer rename.bat Datei in einem beliebigen Ordner mit dem Inhalt ren %1 %2 - Auswahl der rename.bat - Argumente: {FULLNAME} dasisteintest.txt - Haken setzen bei nachdem die Datei erstellt wurde Directory Watcher Dokumentation.docx Version 1.1 Seite 4

9 3 Komponenten 4 Bereitstellungsleitfaden 4.1 Voraussetzungen Der Windows Home Server sollte alle aktuellen Updates installiert haben um eine einwandfreie Funktion zu garantieren. 4.2 Installation Das Add-In muss als msi Paket heruntergeladen werden und in dem Ordner \\SERVER\Software\Add- Ins kopiert werden. Anschließend wird die Konsole geöffnet und das Add-In über den normalen Weg hinzugefügt. Ein Restart der Konsole schließt die Installation ab. Installiert werden: Add-IN (HomeServerConsoleTab.WHSDirectoryWatcher.dll) Service (WHSDirectoryWatcherService.exe) Task (WHSDirectoryWatcherTask.exe) Sonstige Dateien (DB.WHS.Helper.dll, Taskscheduler.dll) Konfigurationseinträge sind in der Registry im Schlüssel HKEY_LOCAL_MACHINE\SOFTWARE\Daniel Buschke\WHSDirectoryWatcher gespeichert. Ein ApplicationFolder, welcher für das Log und für den Versand einer Tageszusammenfassung Dateien beinhaltet findet sich unter D:\folders\{A51A10F2-0CE0-48ED-81CC-55D BE} 4.3 Konfiguration Um das Add-In zu konfigurieren, navigieren Sie in der Konsole zum Directory Watcher Add-In und klicken Sie in der oberen Leiste auf Einstellungen. 4.4 Deinstallation Die Deinstallation des Add-Ins erledigen Sie über den gewohnten Weg in der Konsole. Öffnen Sie die Einstellungen und navigieren Sie zu den installierten Add-Ins. Bestätigen Sie die Deinstallation des Directory Watcher mit einen Klick auf deinstallieren. Directory Watcher Dokumentation.docx Version 1.1 Seite 5

10 5 Anhang 5.1 Abbildungsverzeichnis Abbildung 1 - Ordner hinzufügen... 1 Abbildung 2 - Adressen für Ordner... 2 Abbildung 3 - Benachrichtigungen konfigurieren... 3 Abbildung 4 - Absenderadresse konfigurieren Tabellenverzeichnis Es konnten keine Einträge für ein Abbildungsverzeichnis gefunden werden. 5.3 Weiterführende Links Nr Beschreibung Link 1 Add-In Seite z&ref=whs&whslist=directorywatcher 2 Add-In Download ads&referrer=doku&file=whsdirectorywatcherins taller.msi 3 Add-In Konfigurationsvideo 4 WHS Add-In Idea Challenge 09 Finalisten &vid=directorywatcher blog.de/2009/06/14/whs-add-in-idea-challenge- 09-finalisten/ 5.4 Begriffe und Abkürzungen Begriff / Abkürzung Erläuterung Directory Watcher Dokumentation.docx Version 1.1 Seite 6