pywares-benutzerhandbuch

Transkript

1 pywares-benutzerhandbuch Lock Your World GmbH & Co.KG Alle Rechte vorbehalten. Hinweis Obwohl angemessene Bemühungen unternommen wurden, um sicherzustellen, dass die Informationen in diesem Dokument zum Zeitpunkt der Drucklegung vollständig und akkurat waren, übernimmt keine Haftung für eventuelle Fehler. In zukünftigen Versionen können an den in diesem Dokument enthaltenen Informationen Änderungen und Korrekturen angebracht werden. Haftungsausschluss für die Dokumentation übernimmt keine Haftung für Änderungen, Zusätze oder Löschungen an der ursprünglich veröffentlichten Version dieser Dokumentation, außer wenn diese von durchgeführt wurden. Der Kunde und/oder der Endbenutzer willigen ein, sowie die Vertreter, Bediensteten und Angestellten von gegenüber allen Klagen, Gerichtsverfahren, Forderungen und Urteilen, die aus Änderungen, Zusätzen oder Löschungen an dieser Dokumentation oder im Zusammenhang damit entstehen, in dem vom Kunden oder Endbenutzer vorgenommenen Umfang der Änderungen, Zusätze oder Löschungen zu entschädigen und schadenfrei zu halten. Haftungsausschluss für Links übernimmt keine Verantwortung für den Inhalt oder die Zuverlässigkeit von durch Links verknüpften Websites und billigt nicht unbedingt die darin beschriebenen oder angebotenen Produkte, Dienste oder Informationen. Es wird keine Garantie übernommen dafür, dass diese Links in jedem Fall funktionieren und dass die verknüpften Seiten immer verfügbar sind. Copyright Sofern nicht explizit anders angegeben, ist das Produkt durch Urheber- und andere Eigentumsrechte geschützt. Die unberechtigte Vervielfältigung, Übertragung oder Verwendung kann entsprechend dem anwendbaren Gesetz strafrechtlich und auch zivil verfolgt werden. Seite 1 von 11

2 Inhalt 1. Einleitung System-Voraussetzungen Installation Programmstart Funktionen Suche Schloss Rücksetzen des Schlosses (Reset) Auftrag ausführen Windows Explorer Synchronisiere Verzeichnis Seite 2 von 11

3 1. Einleitung Das pylocx-service-tool»pywares«ermöglicht die Abarbeitung von Service- bzw. Verwaltungsaufträgen für pylocx-schließsysteme vor Ort. Diese Aufträge werden im pylocx- Management-Tool»pyware«generiert. Im Gegensatz zum pylocx-management-tool»pyware«benötigt das Service-Tool»pywareS«keine Verbindung zur pyware-management-datenbank. Alle für die Abarbeitung der Aufträge notwendigen Informationen/Daten werden dem Service-Tool»pywareS«in einer Datei übergeben. Zur Aktualisierung des Datenbestandes der pylocx-management-datenbank werden nach erfolgreicher Ausführung des Auftrages sogenannte»result«-dateien zum Import in das Management-Tool»pyware«generiert. pyware-management-tool Konfi- Daten Service-Code Manager Service-Code Manager Administrator PostgreSQL Pyware-DB pywares- Service-Tool Service (Übersicht der Komponenten) Hauptanwendungsfälle sind: Aktualisierung der Schloss-Konfiguration Aktualisierung der Schließpläne im Schloss Auslesen der Schließprotokolle Komplette Konfiguration eines Schlosses (Austausch eines Schlosses im Reparaturfall) Seite 3 von 11

4 Der grundsätzliche Ablauf stellt sich wie folgt dar: pyware pywares Auftrag erzeugen Generierung Übergabedatei: <Schloss-SerialID.sps> in Verzeichnis: pyware- Home\Export\pywareS Übergabedatei: <Schloss-SerialID.sps> in Verzeichnis: pywares-home\transfer kopieren pylocx-service-tool pywares starten, Auftrag ausführen Übergabedateien: <Schloss-SerialID.rsps> <Schloss-SerialID.rspp> in Verzeichnis: pyware- Home\Import\pywareS kopieren Import der Übergabedatei <Schloss-SerialID.rsps> Update in der pyware- Management-Datenbank - Schlossstatus - Firmware Generierung Übergabedatei für Update der Konfiguration <Schloss-SerialID.rsps> und Generierung Übergabedatei für das Schließprotokoll <Schloss-SerialID.rspp> in Verzeichnis: pywares-home\transfer\ Rückmeldungen Status der Übergabedatei modifizieren Import der Übergabedatei <Schloss-SerialID.rspp> Update des Schließprotokolls in der pyware- Management-Datenbank Update des pywares- Auftragsstatus in der pyware-management- Datenbank Status der Übergabedateien modifizieren und ins Archiv verschieben Seite 4 von 11

5 Verwendete Datei-Endungen: sps: rsps: rspp: asps: aspp: pywares-auftrag Rückmeldung zu einem pywares-auftrag zum Aktivieren/Synchronisieren des Schlosses (nur pyware) Rückmeldung zu einem pywares-auftrag zum Auslesen des Schließprotokolls Archiv-Files zu einem pywares-auftrag zum Aktivieren/Synchronisieren des Schlosses (nur pyware) Archiv-Files zu einem pywares-auftrag zum Auslesen des Schließprotokolls (nur pyware) Zur Definition des pyware-home-verzeichnisses siehe»pyware_benutzerhandbuch«im Kapitel»Installation«, für das pywares-home siehe Kapitel 3. Der konkrete Auftragsumfang Aktivierung / Synchronisierung des Schlosses Auslesen des Schließprotokolls oder beides wird bei Erstellung des Auftrages im pyware-management-tool definiert. Seite 5 von 11

6 2. System-Voraussetzungen In der aktuellen Version werden nur 32 Bit-Windows-Versionen (XP/VISTA/WIN7) unterstützt. 64 Bit Unterstützung ist in Vorbereitung. Die HW-Anforderung an den PC, auf dem pyware oder pywares betrieben wird, ist identisch mit den Anforderungen, die von Microsoft für Windows XP/Vista/WIN7 angegeben werden. Es gibt hier keine zusätzlichen Anforderungen durch die Applikation. Prozessor (CPU) Hauptspeicher (RAM) Festplattenplatz (HDD) Anzeige/Grafikkarte Eingabegeräte DVD-ROM Laufwerk Diskettenlaufwerk Netzwerkkarte 1 GHz - 32 Bit (x86) 1 GByte RAM (Empfehlung 4 GB) 40 GB Festplatte mit 15 GB freiem Festplattenspeicher Grafikprozessor, der Windows Aero ausführen kann und über 128 MB RAM Grafikkartenspeicher verfügt Minimal Auflösung 1024x768 Tastatur und Maus Optional Optional Optional 10/100/1000 Mbit/s Für den PC, auf dem das pylocx-service-tool»pywares«betrieben wird, sind keine sonstigen Erweiterungen, wie z. B. das.net-framework, notwendig. Die Größe der benötigten Daten auf dem PC für pyware beträgt ca. 10 Mbyte im Programmverzeichnis. In diesem Verzeichnis können bei Betrieb auch Log-Files entstehen, so dass mit einer Gesamtgröße von 20 Mbyte gerechnet werden sollte. Seite 6 von 11

7 3. Installation Für die Nutzung von pyware sind folgende Dateien im PLXM-Programmverzeichnis erforderlich: - pywares.exe - pywares.ini enthält globale pywares-konfigurationsdaten - pymgtv3.dll Standardmäßig werden alle weiteren Daten wie - Log-Files - Importdateien - Exportdateien anwenderbezogen, d. h. <Windows-Login> bezogen, abgelegt. WindowsXP und Windows2003: C:\Dokumente und Einstellungen\<Windows-Login>\eigene Dateien\pywareS Windows7: C:\Users\<Windows-Login>\Documents\pywareS Dieses Verzeichnis wird im Weiteren als pywares-home bezeichnet. Die zum Betrieb des USB-Systemkabels notwendigen Treiber werden bei der Installation bzw. Erstinbetriebnahme installiert. Für weitere Informationen zur Installation von pywares siehe Dokument PYWARE_Installation.pdf. Seite 7 von 11

8 4. Programmstart Das pylocx-service-tool» wird gestartet über die Datei»pywareS.exe«. Beim Programmstart wird der Inhalt des pywares-home\transfer-verzeichnisses gelesen und es werden alle darin enthaltenen Dateien auf gültige pyware-s-aufträge überprüft. Im linken Teil des Formulars werden die Seriennummern der Schlösser dargestellt, für die gültige pywares-aufträge existieren. Im rechten Teil werden zusätzliche Statusausgaben bzw. Informationen ausgegeben. Seite 8 von 11

9 5. Funktionen 5.1. Suche Schloss Mittels dieser Funktion wird die Seriennummer aus dem Schloss ausgelesen und es wird geprüft, ob es für dieses Schloss einen gültigen pywares-auftrag gibt. Dazu muss das Schloss mit dem Systemkabel am PC angeschlossen sein. Im Beispiel wurde das Schloss mit der Seriennummer erkannt, für dieses Schloss existiert ein gültiger Auftrag zum»auslesen des Schließprotokolls«. Hinweis: Da sich ein Schloss, für das nur der Auftrag zum»auslesen des Schließprotokolls«existiert, im Status»aktiviert und synchronisiert«befindet, steht die Funktion»Schloss Reset«nicht zur Verfügung. Seite 9 von 11

10 5.2. Rücksetzen des Schlosses (Reset) Beim Auftreten gravierender Fehlfunktionen kann das Schloss in einen definierten Ausgangszustand versetzt werden. Dabei werden alle Daten, inklusive des Passwortes, initialisiert. Eine Nutzung des Schlosses ist erst nach erneuter Aktivierung/Synchronisierung möglich. Hinweis: Hierzu muss das Schloss mit dem Systemkabel am PC angeschlossen sein Auftrag ausführen Mittels dieser Funktion erfolgt die eigentliche Abarbeitung des gesamten Auftrages. Dazu muss das Schloss mit dem Systemkabel am PC angeschlossen sein. Im Beispiel wurde das Schließprotokoll aus dem Schloss mit der Seriennummer ausgelesen (26 Protokolleinträge), und es wurde eine Übergabedatei für pyware im pywares- Home\Transfer\Rückmeldungen unter dem Namen rspp generiert. Seite 10 von 11

11 Hinweise: Aufträge zum»auslesen des Schließprotokolls«können mehrfach ausgeführt werden. Es ist aber zu beachten, dass nach jedem Auslesen die existierenden Daten im Schloss gelöscht, die Uhr des Schlosses neu gestellt und ein gegebenenfalls bereits existierendes Protokoll- File im pywares-home\transfer überschrieben wird. Aufträge, die nur die Aufgabe»Aktivierung/Synchronisierung«des Schlosses beinhalten, berechtigen nach erfolgreicher Abarbeitung des Auftrages automatisch zum»auslesen des Schließprotokolls«. Dies ist notwendig, um gegebenenfalls weitere Prüfungen am Schloss durchführen zu können. Bei der Aktivierung des Schlosses wird das»alte«schließprotokoll gelöscht. Aufträge, die die Aufgabe»Aktivierung/Synchronisierung des Schlosses«beinhalten, können nach erfolgreichem Abschluss nicht erneut ausgeführt werden Windows Explorer Zur Vereinfachung des Kopiervorganges der Übergabedateien kann direkt aus pywares der Windows Explorer aufgerufen werden. In diesem Fall wird automatisch der Inhalt des pywares-home\transfer angezeigt. Im Unterverzeichnis»Rückmeldungen«befinden sich die Übergabedateien an das pylocx- Management-Tool»pyware« Synchronisiere Verzeichnis Beim Starten des Programmes wird der Inhalt des Verzeichnisses pywares-home\transfer gelesen. Wenn während des laufenden Service-Tools»pywareS«weitere Aufträge in das Verzeichnis pywares- Home\Transfer kopiert werden, muss eine Synchronisierung des Verzeichnisinhaltes mit pywares erfolgen. Dies geschieht über die Schaltfläche. Seite 11 von 11