Zum Inhalt springen
Stundenhüter

9 Datensicherung

Alle Daten liegen in einer Datenbank auf dem Server, im Ordner C:\ProgramData\Zeiterfassung. Dieses Kapitel zeigt, wie sie gesichert werden und wie Du sie zurückholst.

Automatische Sicherungen

Du musst nichts einrichten.

  • Täglich legt Stundenhüter eine Sicherung an: backup\zeiterfassung-JJJJ-MM-TT.db im Datenordner. Die letzten 30 Tage bleiben erhalten.
  • Vor jedem Update sichert das Setup die Daten nach backup\vor-update-<Version>-<Zeit>.
  • Vor einer Datenbankänderung (nach manchen Updates) entsteht backup\vor-migration-…. Bricht der Start mehrmals ab, entstehen mehrere solche Sicherungen mit derselben Schemanummer – die älteste ist maßgeblich, sie enthält den Stand vor dem Update.
  • Vor dem Einspielen einer Sicherung entsteht backup\vor-wiederherstellung-<Zeit>.db.

Die letzten drei Sorten löscht das Programm nicht von selbst.

Wichtig: Diese Sicherungen liegen auf demselben Server. Fällt die Festplatte aus, sind sie mit weg. Kopiere deshalb regelmäßig eine Sicherung auf ein anderes Medium (externe Festplatte, NAS) – oder richte das zweite Sicherungsziel ein (siehe unten). Dafür lädst Du sie wie unten beschrieben herunter oder kopierst den Ordner backup aus dem Datenordner.

Speicherplatz: Jedes Services-Dokument und das Firmenlogo liegen in der Datenbank und damit in jeder täglichen Sicherung und in jeder Kopie auf dem zweiten Sicherungsziel. Mit vielen Dokumenten werden die Sicherungen entsprechend größer: 200 MB Services × 30 tägliche Sicherungen sind etwa 6 GB. Behalte den freien Platz auf dem Server und auf dem Stick im Auge. Auch das WLAN-Passwort für Gäste (Team → Services) steht in der Datenbank und damit in den Sicherungen; bewahre sie entsprechend sicher auf.

Sicherung herunterladen

  1. Melde Dich als Admin an.
  2. Öffne Einstellungen → Sicherung.
  3. Klicke auf „Sicherung herunterladen“. Du bekommst eine aktuelle Sicherung. Dort kannst Du auch jede automatische Sicherung aus dem Ordner backup herunterladen.

Bewahre die Datei sicher auf. Sie enthält alle personenbezogenen Daten (Kapitel 10). Ab 1.39.0 enthält sie außerdem die Zertifizierungsstelle des Servers (und ein eingespieltes eigenes Zertifikat). Ab 1.70.0 liegen die privaten Schlüssel darin nur verschlüsselt. Der Schlüssel dazu steht in der Datei tls\sicherung.key im Datenordner, nicht in der Sicherung. Sicherungen aus älteren Versionen enthalten die Schlüssel noch im Klartext: Wer so eine Datei hat, könnte Geräten, die der Stelle vertrauen, einen falschen Stundenhüter-Server vortäuschen. Die Stelle beglaubigt nur Namen des Praxisnetzes (Rechnername, Domäne des Servers, .local, .lan, .intern, .fritz.box usw.); Aufrufe per IP-Adresse sind nicht beschränkt. Bewahre Sicherungen deshalb sicher auf.

Zweites Sicherungsziel

Stundenhüter kann jede tägliche Sicherung zusätzlich verschlüsselt in einen zweiten Ordner kopieren, z. B. auf einen USB-Stick am Server. Fällt die Festplatte aus, liegt so eine aktuelle Kopie woanders.

  1. Stick vorbereiten (nur am Raspberry Pi oder Linux-Server mit Stundenhüter-Paket): Formatiere den Stick am Mac oder PC als exFAT und gib ihm die Bezeichnung SICHERUNG. Steck ihn am Server ein – er wird automatisch unter /media/stundenhueter/sicherung eingebunden. Unter Windows nimmst Du einfach den Laufwerksbuchstaben des Sticks, z. B. E:\. Netzwerkpfade wie \\server\freigabe nimmt Stundenhüter nicht an: Der Dienst würde sich sonst mit dem Konto des Servers bei einem fremden Rechner anmelden. Für eine Kopie auf ein NAS nimmst Du die Tagessicherungen mit einem eigenen Sicherungsprogramm mit.
  2. Einstellungen → Zweites Sicherungsziel: Zielordner eintragen, ein Kennwort mit mindestens 12 Zeichen festlegen, einschalten und speichern.
  3. „USB-Stick einrichten“ wählen. Stundenhüter legt eine Markierungsdatei auf den Stick und kopiert sofort die neueste Sicherung. Für einen neuen Stick wählst Du die Schaltfläche erneut.

Schreib das Kennwort auf den Notfallzettel und bewahre ihn getrennt vom Server auf. Ohne Kennwort ist keine Kopie lesbar – auch nicht für den Support.

Stundenhüter behält auf dem Stick die Kopien der letzten 30 Tage (zeiterfassung-<Datum>.db.enc). Fehlt der Stick, ist er voll oder ist die letzte Kopie älter als zwei Tage, erscheint unter Zu erledigen ein Hinweis.

Einspielen: Wähle unter „Sicherung einspielen“ die .db.enc-Datei vom Stick. Stundenhüter fragt nach dem Kennwort, entschlüsselt die Datei und zeigt sie zur Prüfung an wie jede andere Sicherung.

Sicherung einspielen

Das Einspielen ersetzt alle aktuellen Daten durch den Stand der Sicherung. Alles, was danach eingetragen wurde, ist weg.

  1. Öffne Einstellungen → Sicherung.
  2. Wähle bei „Sicherung einspielen“ die Datei aus (bis 500 MB, ab 1.52.0; vorher 200 MB, denn Services-Dokumente zählen zur Sicherung).
  3. Das Programm prüft die Datei zuerst und zeigt Personen, Zeiteinträge und Version. Sicherungen einer neueren Version lehnt es ab. Ebenso eine Sicherung ohne Admin-Konto (z. B. eine Tagessicherung von vor der Einrichtung), weil sich danach niemand anmelden könnte.
  4. Bestätige. Erst dann wird eingespielt.

Vorher legt das Programm automatisch backup\vor-wiederherstellung-<Zeit>.db an. Ältere Sicherungen werden auf den aktuellen Stand der Datenbank gebracht. Sicherungen, die Trigger oder Ansichten enthalten, lehnt das Programm ab. Danach enden alle Sitzungen der Verwaltung, Du meldest Dich neu an.

Der Lizenzstand ist Teil der Daten. Eine ältere Sicherung bringt einen älteren Lizenzstand mit. Trage danach den aktuellen Lizenzschlüssel neu ein (Kapitel 3). Das Einspielen geht auch bei abgelaufener Lizenz.

Die Zertifizierungsstelle aus der Sicherung wird übernommen, wenn die Sicherung von diesem Server stammt (gleicher Datenordner mit tls\sicherung.key). So vertrauen eingerichtete Geräte dem Server weiter. Stammt die Sicherung von einem anderen Server oder fehlt die Schlüsseldatei (neue Hardware, neu installiert), übernimmt Stundenhüter Stelle und eigenes Zertifikat aus der Sicherung nicht: Die Stelle dieses Servers bleibt oder wird neu angelegt. Unter Einstellungen → Sicherheit und im Änderungsprotokoll steht dann, dass die Geräte neu eingerichtet werden müssen; ein eigenes Zertifikat spielst Du neu ein. Willst Du beim Umzug auf neue Hardware die Stelle behalten, kopiere den ganzen Datenordner samt Ordner tls statt nur die Sicherung einzuspielen.

Sicherungen aus Versionen vor 1.70.0 enthalten die Stelle im Klartext. Stundenhüter übernimmt eine solche Stelle nicht; sie gilt nur weiter, wenn sie die aktive Stelle dieses Servers ist. Sonst bleibt die Stelle dieses Servers (Eintrag „verworfen“ im Änderungsprotokoll); eingerichtete Geräte funktionieren weiter. Ein eigenes Zertifikat aus so einer Sicherung wird nie übernommen. Hat sich die Stelle geändert, trage sie auch auf dem Server selbst ein: Führe das Setup erneut aus (es trägt sie in LocalMachine\Root ein). Die Diagnose zeigt, ob das nötig ist („Stelle nicht in LocalMachine\Root“). Eine Sicherung aus einer Version vor 1.39.0 enthält keine Stelle; dann bleibt die aktuelle unverändert.

Persönliche Links (ab 1.41.0): Neue Sicherungen enthalten die Stempel-Links nicht im Klartext, sondern nur einen Prüfwert und eine verschlüsselte Kopie. Der Schlüssel liegt in der Datei link.key im Datenordner und gehört nicht zu den Sicherungen der Anwendung (Sicherung, Download). Die Update-Kopien backup\vor-update-… sind etwas anderes: Sie enthalten den ganzen Datenordner, also auch link.key. Spielst Du eine Sicherung auf einem anderen Server ein, funktionieren die bisherigen Links und QR-Codes weiter; „Link & QR“ zeigt sie aber erst nach „Neuen Link erzeugen“. Ziehst Du den Server um, kopiere link.key mit, dann bleibt auch die Anzeige. Ältere Sicherungen (vor 1.41.0) enthalten die Links noch im Klartext. Das gilt auch für die Sicherungen, die das Update auf 1.41.0 selbst anlegt (backup\vor-migration-… und backup\vor-update-…), und für Kopien davon auf Sticks oder dem NAS: Bewahre sie sicher auf oder lösche sie, sobald die Aufbewahrungsfrist abgelaufen ist.

PINs (ab 1.70.0): Die Prüfwerte der PINs sind zusätzlich mit der Schlüsseldatei pin.key im Datenordner geschützt. Wie link.key gehört sie nicht zu den Sicherungen der Anwendung; eine Sicherung allein reicht so nicht, um PINs durchzuprobieren. Bestehende PINs stellt Stundenhüter bei der nächsten richtigen Eingabe um. Spielst Du eine Sicherung auf einem anderen Server ein, gelten die PINs dort erst wieder, wenn Du pin.key vom alten Server in den Datenordner kopierst; sonst vergib die PINs neu. Ziehst Du den Server um, kopiere pin.key, link.key und geraete.key mit.

Geräte (ab 1.70.0): Die Cookies, mit denen Stundenhüter eingerichtete Stempelgeräte und Geräte mit früherer Anmeldung wiedererkennt, sind mit der Schlüsseldatei geraete.key im Datenordner signiert. Stundenhüter legt sie selbst an; auch sie gehört nicht zu den Sicherungen. Fehlt sie (Sicherung auf einem neuen Server eingespielt), legt Stundenhüter eine neue an: Alle Geräte gelten dann einmal als unbekannt, und Du richtest die Stempelgeräte neu ein (Kapitel 8, „Anmeldeschutz“). Die PINs sind davon nicht betroffen.

Wiederherstellen von Hand

Das brauchst Du nur, wenn die Verwaltung gar nicht mehr erreichbar ist. Lass Dir dabei am besten von einer IT-Fachperson helfen. Genau in dieser Reihenfolge, im Programmordner (z. B. C:\Zeiterfassung) in PowerShell als Administrator:

  1. Dienst stoppen: .\zeiterfassung-service.exe stop
  2. Im Datenordner die Dateien zeiterfassung.db-wal und zeiterfassung.db-shm löschen, falls es sie gibt.
  3. Die bisherige zeiterfassung.db umbenennen (z. B. in zeiterfassung-alt.db).
  4. Die gewünschte Sicherung aus backup\ als zeiterfassung.db in den Datenordner kopieren.
  5. Dienst starten: .\zeiterfassung-service.exe start

Schritt 2 ist wichtig. Bleibt die -wal-Datei liegen, spielt die Datenbank beim Start alte Änderungen auf die Sicherung ein und ist danach unbrauchbar.

Notfall: Admin-Passwort vergessen

Kennt niemand mehr ein Passwort für die Verwaltung, setzt Du es auf dem Server neu. Du brauchst dazu Zugriff auf den Server selbst, nicht übers Netzwerk.

Unter Windows geht das über das Startmenü:

  1. Wähle Stundenhüter → Notfall – Admin-Passwort setzen und bestätige die Rückfrage von Windows (Administrator).
  2. Gib den Anmeldenamen ein (Vorgabe: admin) und zweimal das neue Passwort (mindestens 8 Zeichen).

Der Dienst muss dafür nicht gestoppt werden.

Alternativ von Hand, falls das Startmenü nicht zur Verfügung steht: Öffne PowerShell als Administrator und gib ein:

cd C:\Zeiterfassung
Read-Host "Neues Passwort" | .\zeiterfassung.exe --admin-passwort Admin

Ersetze Admin durch den Anmeldenamen der Person. Tippe das neue Passwort (mindestens 8 Zeichen) ein und bestätige mit Enter.

Das Programm aktiviert die Person, gibt ihr die Rolle Admin, hebt ihre Sperre auf und beendet ihre Sitzungen. Gibt es den Anmeldenamen nicht, entsteht eine neue Person mit der Rolle Admin ohne Zeiterfassung. Anrede und Nachname ergänzt Du dann unter Mein Konto.

Nutzt Dein Dienst einen anderen Datenordner, setze vorher $env:ZE_DATA_DIR="<Pfad>".

Verwaltung gesperrt

Nach 5 falschen Anmeldeversuchen an einem Gerät sperrt die Anmeldung dort bis zu 30 Minuten; an einem anderen Gerät geht sie meist weiter. Nach 30 Fehlversuchen gegen denselben Namen innerhalb von 24 Stunden (über alle Geräte) ist dieser Name 15, danach 30 Minuten gesperrt. Nach 30 Fehlversuchen von einem Gerät (gleich für welchen Namen oder welche PIN) ist dieses Gerät 15 bis 30 Minuten gesperrt. Am Server selbst gibt es keine Gerätesperre, und ab 1.70.0 gilt dort und auf PCs, an denen Du Dich in den letzten 120 Tagen angemeldet hast, auch die Sperre über alle Geräte nicht. Ein anderer Admin hebt Sperren unter Einstellungen → Anmeldeschutz auf. Wartest Du nicht, hebst Du alle Sperren auf dem Server auf:

cd C:\Zeiterfassung
.\zeiterfassung.exe --sperren-zuruecksetzen

Das Programm meldet „Sperren zurückgesetzt.“.

Demo-Modus lässt sich nicht beenden

Ist in den Beispieldaten kein Admin mehr anmeldbar, beendest Du den Demo-Modus auf dem Server (PowerShell als Administrator):

cd C:\Zeiterfassung
.\zeiterfassung.exe --demo-beenden
.\zeiterfassung-service.exe restart

Erst nach dem Neustart des Dienstes arbeitet Stundenhüter wieder mit den echten Daten.

Herausgegeben von Softblade GmbH, 91056 Erlangen · Stand: Version 1.93.0 · Fragen an contact@softblade.de · Impressum