Zum Inhalt springen
Stundenhüter

11 Hilfe bei Problemen

Diagnose erstellen

Wenn etwas auf dem Server nicht läuft, hilft die Diagnose. Sie sammelt alle Angaben, die eine Fachperson braucht, in einer Textdatei.

  1. Öffne auf dem Server das Startmenü.
  2. Wähle Stundenhüter → Diagnose erstellen.
  3. Bestätige die Rückfrage von Windows (Administrator) mit „Ja“.
  4. Ein Fenster schreibt Systeminfos, Dienst- und Portstatus, Firewall, Health-Check, Logzeilen und die Dateiliste des Datenordners. Datenbankinhalt ist nicht dabei.
  5. Das Fenster bleibt offen, bis Du Enter drückst. Auf dem Desktop liegt jetzt die Textdatei.
  6. Gib diese Datei weiter.

Scheitert schon die Erstinstallation, bietet das Setup die Diagnose direkt an.

Support per E-Mail: contact@softblade.de

Setup, Update, Deinstallation und „Port ändern“ schreiben außerdem ein Protokoll nach C:\ProgramData\Zeiterfassung\logs. Die letzten Zeilen stehen auch in der Diagnose-Datei.

Häufige Fragen

„Unbekannter Servername“ (Fehler 421)

Der Server antwortet nur unter bekannten Namen. Der Aufruf per IP-Adresse (z. B. http://192.168.1.20/) funktioniert immer. Soll ein anderer Name gelten, trage ihn in die Umgebungsvariable ZE_HOSTS ein (mehrere mit Komma) und starte den Dienst neu (Kapitel 2, „Update auf 1.21.2“), oder trage ihn unter Einstellungen → Server-Adresse ein.

Die Verwaltung meldet sich nach einer Pause ab

Nach 60 Minuten ohne Bedienung endet die Sitzung der Verwaltung, spätestens nach 8 Stunden. Melde Dich einfach neu an.

Die Seite lässt sich auf dem Tablet nicht öffnen

  1. Ist das Tablet im richtigen WLAN?
  2. Stimmt die Adresse? Nach einer Port-Änderung hat sie sich geändert.
  3. Öffne auf dem Server http://localhost/ (oder mit Port). Geht es dort, liegt es am Netzwerk oder an der Firewall.
  4. Läuft der Dienst? Starte den Server bei Zweifeln neu. Der Dienst startet von selbst mit Windows.
  5. Erstelle die Diagnose.

Geht es auch auf dem Server nicht, ist der Dienst nicht gestartet. Häufigste Ursache: Der Installationsordner liegt nicht auf einer lokalen Festplatte (Netzlaufwerk, subst-Laufwerk). Starte das Setup erneut und wähle C:\Zeiterfassung. Die Daten bleiben erhalten.

Geräte erreichen den Server nicht mehr (Netzprofil)

Ab 1.70.0 gilt die Firewall-Regel „Zeiterfassung“ nur für die Netzwerkprofile „Domäne“ und „Privat“ (Kapitel 2). Stuft Windows die Verbindung des Servers später als „Öffentlich“ ein (etwa nach einem Router-Tausch oder mit einem neuen Netzwerkadapter), erreichen Tablets und PCs den Server nicht mehr; auf dem Server selbst (http://localhost/) geht es weiter.

  1. Erstelle die Diagnose. Der Abschnitt Netzprofil zeigt das Profil jeder aktiven Verbindung und das Profil der Firewall-Regel und nennt bei „Öffentlich“ den passenden Befehl.
  2. Ist die Verbindung das Praxisnetz, stelle sie in PowerShell als Administrator auf „Privat“: Set-NetConnectionProfile -InterfaceAlias "<Name>" -NetworkCategory Private (den Namen zeigt Get-NetConnectionProfile).

Domänen-Server: Manche Server stehen nach dem Neustart kurz auf „Öffentlich“, bis sie die Domäne erreichen; meist wechselt das Profil nach wenigen Minuten von selbst auf „Domäne“. Bleibt es hängen, starte den Dienst „Netzwerkstandortkenntnis“ (NlaSvc) neu und lass eine Fachperson prüfen, ob der Server den Domänencontroller (DNS) beim Start erreicht. Auf „Domäne“ lässt sich ein Netz nicht mit Set-NetConnectionProfile stellen.

Port 80 ist belegt

Meist belegt IIS den Port. Das Setup weicht dann auf den ersten freien Port ab 8080 aus. Die Adresse enthält dann die Portnummer. Willst Du später wechseln, wähle im Startmenü Port ändern. Wird IIS nicht gebraucht, kann eine Fachperson es beenden.

Der Browser warnt: „Verbindung ist nicht privat“

Das Gerät vertraut der Zertifizierungsstelle des Servers noch nicht. Öffne http://Servername/einrichten und richte das Gerät ein (Kapitel 2). Ist das Gerät gerade erst eingerichtet worden und zeigt der Browser in der Adresszeile noch „Nicht sicher“, obwohl das Zertifikat als gültig angezeigt wird, starte den Browser einmal ganz neu (in Edge edge://restart) oder den Rechner. Browser merken sich eine frühere Warnung, bis sie neu starten. Kommt die Warnung trotz eingerichtetem Gerät, nutzt Du einen Namen, der nicht im Zertifikat steht (zum Beispiel servername.fritz.box). Nimm die IP-Adresse, den Rechnernamen oder trage den Namen in ZE_HOSTS bzw. unter Einstellungen → Server-Adresse ein; das Zertifikat wird dann neu ausgestellt. Die Namen im Zertifikat stehen unter Einstellungen → Sicherheit.

Die Verwaltung leitet auf https:// um oder meldet „nur über https:// erreichbar“

Läuft HTTPS, geht die Verwaltung ab 1.41.0 nur über https:// (Kapitel 8, „Verwaltung nur über HTTPS“). Richte den PC unter http://Servername/einrichten ein und öffne dann https://Servername/admin. Geht das gerade nicht, schalte auf dem Server über das Startmenü „Notfall – Nur noch HTTPS ausschalten“ beide HTTPS-Schalter aus.

Die Ersteinrichtung fragt nach einem Einrichtungscode

Von einem anderen Gerät als dem Server braucht die Ersteinrichtung den Code aus dem Protokoll des Servers (Zeile „Einrichtungscode: …“). Am Server selbst unter http://localhost geht es ohne Code (Kapitel 2).

HTTPS ist nicht aktiv oder der HTTPS-Port ist belegt

Unter Einstellungen → Sicherheit steht sinngemäß „HTTPS ist nicht aktiv: …“ mit dem Grund, zum Beispiel einem belegten HTTPS-Port. Stundenhüter läuft dann weiter über HTTP, „Nur noch HTTPS“ wirkt nicht. Wähle im Startmenü „Port ändern“ einen freien HTTPS-Port (z. B. 8443). Kommt nach dem Umschalten auf „Nur noch HTTPS“ niemand mehr hinein, schalte es auf dem Server mit „Notfall – Nur noch HTTPS ausschalten“ ab; danach geht http:// sofort wieder (Stundenhüter setzt kein HSTS).

Die Uhrzeit stimmt nicht

Stundenhüter stempelt mit der Uhr des Servers. Eine falsche Serveruhr verfälscht alle Zeiten. Ein Server ohne Internet kann die Zeit nicht selbst holen.

  • Ist der Server Mitglied einer Domäne, kommt die Zeit vom Domänencontroller.
  • Sonst braucht er eine Zeitquelle im Haus, z. B. Router oder NAS mit eingeschaltetem NTP-Dienst. Das richtet eine Fachperson mit den Befehlen aus dem README ein.
  • Gibt es keine Quelle, vergleiche die Uhr z. B. wöchentlich und stelle sie bei Abweichung nach.

Die Zeitzone des Servers soll „(UTC+01:00) Amsterdam, Berlin, Bern, Rom, Stockholm, Wien“ sein.

Jemand hat vergessen auszustempeln

Der Eintrag steht als „unvollständig“ unter Zeiten / Monat und zählt nicht in die Summen. Die Verwaltung trägt das Ende nach (Kapitel 5). Hat der Betrieb es erlaubt, geht das auch die Person selbst (Kapitel 4). Ein Monat mit offenem Eintrag lässt sich nicht abschließen.

Jemand hat nach Mitternacht ausgestempelt

Das ist in Ordnung. Die Schicht zählt zum Starttag, solange sie nicht länger als die „Längste Schicht“ dauert (Standard 14 Stunden). Ist die Schicht länger offen geblieben, gilt das Ausstempeln als vergessen.

PIN vergessen oder Anmeldung gesperrt

Nach 5 Fehlversuchen ist die Anmeldung an diesem Gerät gesperrt, erst 5 Minuten, danach jeweils 30 Minuten; an einem anderen Gerät geht sie meist weiter. Ab 1.70.0 hat jede Person auf unbekannten Geräten zusammen nur 10 PIN-Versuche, danach einen je 4 Tage („Zu viele Fehlversuche. Bitte am Stempelgerät anmelden oder die Verwaltung fragen.“). Am Server, an eingerichteten Stempelgeräten und auf Geräten, an denen sich die Person in den letzten 120 Tagen angemeldet hat, gilt diese Sperre nicht. Kommen von einem Gerät 30 Fehlversuche in 15 Minuten (gleich für wen), sperrt Stundenhüter das ganze Gerät für 15 Minuten. Admins heben Sperren unter Einstellungen → Anmeldeschutz auf (Kapitel 8); eine neue PIN hebt sie ebenfalls auf. Ist die Verwaltung selbst gesperrt: Kapitel 9, „Verwaltung gesperrt“.

PINs gelten nach dem Einspielen auf einem anderen Server nicht mehr

Ab 1.70.0 sind PINs zusätzlich mit der Schlüsseldatei pin.key im Datenordner geschützt (Kapitel 9). Fehlt sie oder gehört sie nicht zu dieser Datenbank, zum Beispiel nach dem Einspielen einer Sicherung auf einem neuen Server, melden diese PINs „Die PIN kann gerade nicht geprüft werden“, und die Übersicht nennt unter „Zu erledigen“ ihre Zahl. Kopiere pin.key vom alten Server in den Datenordner oder vergib die PINs neu.

Das Admin-Passwort ist vergessen

Siehe Kapitel 9, „Notfall: Admin-Passwort vergessen“.

Eine Person fehlt auf der Startseite

  • Ist die Person aktiv?
  • Ist „Auf der Startseite anzeigen“ eingeschaltet?
  • Hat sie eine PIN? Ohne PIN erscheint auch ein Admin nicht.
  • Ist ihr Austritt vorbei? Dann fehlt die Kachel (ab 1.70.0).
  • Ist die Lizenzstufe erreicht? Dann legt Stundenhüter keine weiteren Personen an (Kapitel 3).

Wurde für die Person „Neuen Link erzeugen“ gewählt oder hat sie ihn in „Mein Bereich“ mit „Link erneuern“ ersetzt, gilt der alte Link nicht mehr. Nach dem Austritt endet der Link automatisch. Zeigt „Link & QR“ statt des Links den Hinweis „Der Link kann nicht angezeigt werden …“, fehlt die Schlüsseldatei link.key (zum Beispiel nach dem Einspielen einer Sicherung auf einem anderen Server): Der alte Link funktioniert weiter, für die Anzeige „Neuen Link erzeugen“. Gib den neuen aus. Hat sich die Server-Adresse oder der Port geändert, sind alte Links und QR-Codes ebenfalls ungültig. Gib sie neu aus.

„Monat ist abgeschlossen.“

Der Monat wurde im Stundenkonto abgeschlossen. Buchungen, Abwesenheiten, Pläne und Anträge sind für diesen Monat gesperrt. Nur ein Admin kann den zuletzt abgeschlossenen Monat mit einem Grund wieder öffnen (Kapitel 5).

„Die Lizenz ist abgelaufen. Die Verwaltung ist nur lesbar …“

Die Verwaltung kann nichts mehr ändern, bis ein gültiger Lizenzschlüssel eingetragen ist. Stempeln, Mein Bereich, Exporte und Sicherung funktionieren weiter. Ein Admin trägt den Schlüssel unter Einstellungen → Lizenz ein (Kapitel 3).

„Die Lizenz gilt für bis zu … Personen“

Die Stufe Deiner Lizenz ist voll. Bestehende Personen bleiben. Neue Personen mit Zeiterfassung brauchen eine größere Stufe (Kapitel 3). Du kannst auch Personen deaktivieren, die nicht mehr im Betrieb sind.

Ich sehe keinen Saldo oder keinen Lohn

Das ist gewollt, wenn man ohne PIN angemeldet ist. Am Tablet erscheint der Lohn nur, wenn der Admin „Lohn am Tablet anzeigen“ eingeschaltet hat. Die Rolle Verwaltung sieht in der Verwaltung nie Löhne und keine persönlichen Links.

Ich kann meine eigenen Zeiten nicht ändern

Das ist das Vier-Augen-Prinzip (Kapitel 1). Als Verwaltung änderst Du Deine eigenen Zeiten, Regelzeiten, Urlaubsanspruch und Stundenkonto nicht selbst. Bitte eine andere Person mit Zugang zur Verwaltung. Ab 1.70.0 gilt das auch für Deine eigenen Abwesenheiten und bezahlten Stunden: Urlaub beantragst Du und Krankheit meldest Du in „Mein Bereich“, alles andere trägt ein Admin ein. Eigene Plan-Tage bis heute bleiben im Dienstplan als Entwurf stehen, bis eine andere Person sie veröffentlicht. Admins sind davon nicht betroffen.

Eine Funktion fehlt in der Verwaltung

Prüfe unter Einstellungen → Funktionen, ob sie eingeschaltet ist. Das gilt für Stundenkonto, Dienstplan, Lohn und Lexware. Ausschalten löscht keine Daten.

Das Stempeln am Tablet geht bei einer Person nicht

Die Person hat vielleicht Mutterschutz eingetragen. Dann ist das Stempeln gesperrt; nach dem Antippen erscheint „Abwesend – Stempeln nicht möglich“. Ab 1.70.0 ist die Kachel nicht mehr ausgegraut (sie verriet sonst den Grund). „Mein Bereich“ bleibt erreichbar. Ist der Austritt der Person vorbei, enden PIN-Anmeldung und persönlicher Link automatisch, und die Kachel fehlt.

Ein Update ist schiefgegangen

Das Setup stellt bei einem Fehler die alte Version selbst wieder her. Klappt die Sicherung nicht, bricht es ab und die bisherige Version läuft weiter. Erstelle die Diagnose und gib sie weiter. Mit der Sicherung unter C:\ProgramData\Zeiterfassung\backup\vor-update-… kommst Du zurück (Kapitel 9).

Der Dienst lässt sich nicht stoppen

Update und Deinstallation versuchen es sauber, nach 30 Sekunden beenden sie die Programme hart. Hilft das nicht, starte den Server neu. Die Daten bleiben erhalten.

Unter Linux

Diagnose erstellen

Gib im Terminal sudo stundenhueter diagnose ein. Die Textdatei Stundenhueter-Diagnose-<Datum>-<Zeit>.txt liegt danach in Deinem Home-Verzeichnis. Sie enthält Dienststatus, die letzten 200 Zeilen aus dem Journal, Version, Prozessor, Speicher und Port, aber keinen Inhalt der Datenbank. Gib diese Datei weiter.

Stundenhüter antwortet nicht

stundenhueter zeigt, ob der Dienst läuft. journalctl -u stundenhueter -n 50 zeigt die letzten Meldungen. sudo stundenhueter reparieren richtet Systemkonto, Rechte und Dienst neu ein und startet ihn.

Port 80 ist belegt

Das Paket nimmt dann Port 8080. Einen anderen Port setzt Du mit sudo stundenhueter port <Nummer>.

Ein Update ist schiefgegangen

Das Paket legt die alte Version selbst zurück und startet sie; apt meldet einen Fehler. stundenhueter zeigt danach „Nach einem fehlgeschlagenen Update läuft die Version …“. Die Sicherung liegt unter /var/lib/stundenhueter/backup/vor-update-…. Erstelle die Diagnose und gib sie weiter. Um den Paketstand aufzuräumen, installierst Du die bisherige Datei erneut: sudo apt install --allow-downgrades ./stundenhueter_<alte Version>_amd64.deb.

Admin-Passwort vergessen oder Anmeldung gesperrt

sudo stundenhueter notfall-admin <Anmeldename> setzt das Passwort neu (Eingabe verdeckt, zweimal). Der Dienst läuft dabei weiter. sudo stundenhueter sperren-zuruecksetzen hebt alle Anmeldesperren auf.

Lizenz zeigt „eingeschränkt“, obwohl sie gültig ist

Stand einmal die Uhr des Rechners in der Zukunft (zum Beispiel durch eine falsche Zeiteinstellung), merkt sich Stundenhüter das spätere Datum als Schutz vor zurückgestellten Uhren. Auch mit richtiger Uhr zeigt die Lizenz dann „abgelaufen“ oder „eingeschränkt“. Stelle zuerst die Uhr des Rechners richtig. Danach setzt Du den Uhrstand auf dem Server zurück: Rufe das Programm einmal mit --lizenz-uhr-zuruecksetzen auf (unter Windows in PowerShell als Administrator im Programmordner: .\zeiterfassung.exe --lizenz-uhr-zuruecksetzen). Das Programm meldet „Lizenz-Uhrstand zurückgesetzt“; der Vorgang steht im Änderungsprotokoll.

Wenn nichts hilft

  1. Erstelle die Diagnose (siehe oben).
  2. Notiere, was Du getan hast und welche Meldung erschienen ist.
  3. Melde Dich beim Support.

Support per E-Mail: contact@softblade.de

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