Update-Zeitplaene
Update-Zeitplaene automatisieren die Wartung Ihrer Hosts. Sie koennen einmalige oder wiederkehrende Updates planen und diese mit Scripts, Playbooks und Health-Checks kombinieren.
Zeitplan erstellen
- Navigieren Sie zum gewuenschten Modul
- Waehlen Sie den Tab Jobs
- Klicken Sie auf Zeitplan erstellen
Konfiguration
| Feld | Beschreibung |
|---|---|
| Name | Bezeichnung des Zeitplans |
| Aktionstyp | Update, Script oder Playbook |
| Update-Typ | Art des Updates (modulspezifisch, siehe unten) |
| Ziel | Wer wird aktualisiert (siehe Ziel-Typen) |
| Zeitplan-Typ | Einmalig, taeglich, woechentlich, monatlich oder Cron |
| Datum/Uhrzeit | Ausfuehrungszeitpunkt |
| Script | Script aus der Bibliothek (bei Aktionstyp "Script") |
| Playbook | Playbook (bei Aktionstyp "Playbook") |
Aktionstypen
Jeder Zeitplan kann einen von drei Aktionstypen haben:
| Typ | Beschreibung |
|---|---|
| Update | System-Update mit dem konfigurierten Update-Typ ausfuehren |
| Script | Ein Script aus der Bibliothek ausfuehren |
| Playbook | Ein Playbook mit allen Steps ausfuehren |
Ziel-Typen
Zeitplaene koennen auf verschiedene Ziele angewendet werden:
| Ziel | Beschreibung |
|---|---|
| Alle Hosts | Alle Hosts des Moduls werden aktualisiert |
| Kunde | Alle Hosts eines bestimmten Kunden, optional nur eines Standorts (ab v3.38.0) |
| Gruppe | Alle Hosts einer bestimmten Host-Gruppe |
| Einzelner Host | Ein bestimmter Host |
Geraetetyp (Windows und macOS)
Windows- und macOS-Jobs haben zusaetzlich das Feld Geraetetyp: Alle Geraetetypen, Nur Server (inkl. Domaenencontroller) oder Nur Arbeitsplaetze. Es wirkt innerhalb des gewaehlten Ziels, zum Beispiel "Alle Hosts" + "Nur Server". Grundlage ist der vom Agent gemeldete Produkttyp; Hosts ohne erkannten Typ werden immer einbezogen.
Damit lassen sich Arbeitsplaetze tagsueber (wenn sie eingeschaltet sind) und Server am Wochenende aktualisieren, ohne Gruppen zu pflegen: zwei Jobs auf "Alle Hosts", einer mit Nur Arbeitsplaetze taeglich um 12:00, einer mit Nur Server woechentlich in der Nacht. In der Jobliste zeigt ein Badge neben dem Ziel den Filter, und "Betroffene anzeigen" beruecksichtigt ihn.
Update-Typen
OPNsense
| Typ | Beschreibung |
|---|---|
| System Update | Nur Pakete, nie ein Reboot; Base/Kernel bleibt als Reboot ausstehend offen |
| Update + Reboot | Vollstaendiges Update inkl. Base/Kernel, Reboot nur wenn noetig; HA-Paare rollierend (BACKUP → MASTER) |
| Major Upgrade | Hauptversionen Sprung fuer Sprung bis zur Zielversion (JJ.1/JJ.7, Business JJ.4/JJ.10) oder Neueste, normales Update dazwischen, zwei Reboots je Sprung (Details) |
OPNsense-spezifische Optionen (seit v3.7.0, Details: OPNsense HA-Updates):
| Option | Beschreibung | Standard |
|---|---|---|
| HA-Modus | Rollierend / HA-Paare ueberspringen / Parallel (gefaehrlich) | Rollierend |
| Settle-Zeit | Wartezeit zwischen BACKUP- und MASTER-Schritt | 300 s |
| Wenn ein Peer offline ist | Paar ueberspringen oder Online-Node trotzdem updaten | ueberspringen |
| Wiederholungen | Erneute Versuche bei Mirror-/Netzfehlern | 3 |
| Health-Check Timeout | Wartezeit auf die Rueckkehr nach dem Reboot | 900 s |
| Wartungsfenster | Danach werden keine neuen Schritte mehr gestartet; Start > 30 min nach Soll = verpasst | 180 min |
Firewalls mit Agent < 3.7.0 werden in Laeufen uebersprungen. Das Ergebnis jedes Laufs (Schritte, Fehlerklasse, Ausgabe) steht im Jobs-Tab; fehlgeschlagene Laeufe koennen dort fortgesetzt werden.
Proxmox VE
| Typ | Beschreibung |
|---|---|
| System Update | apt update && apt dist-upgrade ohne Neustart |
| Update + Reboot | Update mit Neustart |
| Major Upgrade | Proxmox VE Versions-Upgrade (z.B. 7.x → 8.x) |
Proxmox Backup Server
| Typ | Beschreibung |
|---|---|
| System Update | apt update && apt dist-upgrade ohne Neustart |
| Update + Reboot | Update mit Neustart |
| Garbage Collection | Datastore GC ausfuehren |
| Verify | Backup-Integritaet pruefen |
| Prune | Alte Backups bereinigen |
| Sync | Datastore synchronisieren |
Bei PBS-Datastore-Aktionen kann zusaetzlich der Ziel-Datastore angegeben werden.
Linux
| Typ | Beschreibung |
|---|---|
| System Update | apt upgrade -y / dnf upgrade -y |
| Update + Reboot | Update mit Neustart |
Windows
| Typ | Beschreibung |
|---|---|
| Windows Update | Alle verfuegbaren Windows Updates installieren |
| Update + Reboot | Updates mit Neustart |
macOS
| Typ | Beschreibung |
|---|---|
| Sicherheitsupdates | Sicherheitsupdates, schnelle Sicherheitsmassnahmen und XProtect |
| Alle macOS-Updates | Alle angebotenen macOS-Updates |
| Homebrew aktualisieren | brew upgrade inkl. Casks als Besitzer der Homebrew-Installation |
Option Neustart erlauben (nicht bei Homebrew) gilt nur fuer Intel-Macs. Apple Silicon laedt Updates nur herunter und benachrichtigt den angemeldeten Benutzer; ohne MDM kann macOS dort nicht ohne Benutzer installieren. Beim Geraetetyp zaehlen Mac mini, Studio und Pro als Server, MacBooks und iMacs als Arbeitsplaetze (im Detail-Panel umstellbar). Siehe macOS.
Neustart (ab v3.43.0)
Fuer Windows, Linux und macOS gibt es den Update-Typ Neustart. Er startet die Ziel-Hosts zum geplanten Zeitpunkt neu, ohne Updates zu installieren. Typisch sind ein naechtlicher Neustart von Terminalservern oder ein woechentlicher Neustart von Arbeitsplaetzen.
| Option | Wirkung |
|---|---|
| Nur wenn der Rechner seit mindestens X Tagen laeuft | 0 = immer. Mit 14 und taeglichem Job: Neustart, sobald ein Rechner zwei Wochen laeuft |
| Nur wenn ein Neustart aussteht | Windows: ausstehender Neustart von Updates/Installationen; Linux: /var/run/reboot-required bzw. needs-restarting -r. Nicht bei macOS |
| Nicht neu starten, wenn jemand angemeldet ist | Windows: aktive Sitzung (auch RDP); Linux: who; macOS: Benutzer an der Konsole (bei Arbeitsplatz-Macs fast immer) |
| Vorwarnung | 1 bis 120 Minuten. Angemeldete Benutzer sehen die Meldung mit dem eingegebenen Text (Windows) bzw. eine Systemmeldung (Linux) |
Control erzeugt dafuer ein Script, ein Agent-Update ist nicht noetig. Im Log steht, warum ein Host neu gestartet wurde oder warum nicht (z. B. Kein Neustart: angemeldet - anna). Hosts in Wartung oder Ausser Betrieb laesst der Job aus. Neue Hosts werden beim Aufnehmen (Onboarding) nie neu gestartet.
Ab v3.48.2 gilt: War ein Rechner zum geplanten Zeitpunkt aus, holt er den Neustart nicht spaeter nach. Der Auftrag verfaellt nach dem Wartungsfenster des Jobs (ohne Angabe nach 60 Minuten) und steht als abgelaufen im Log. Vorher startete ein morgens eingeschalteter Arbeitsplatz mitten am Tag neu.
Patch-Ringe: Updates verzoegern (ab v3.69.0)
Windows-Update-Jobs (Windows Update, Update + Reboot) haben die Option Updates erst installieren, wenn sie mindestens X Tage alt sind. Massgeblich ist das Freigabedatum von Microsoft (last_deployment_change_time). Virensignaturen gehen trotzdem sofort, ausser du hakst Auch Virensignaturen verzoegern an. Updates ohne Datum laufen ohne Verzoegerung.
So baust du Ringe: ein Job fuer die Pilotgruppe mit 0 Tagen, ein zweiter Job fuer alle anderen mit z. B. 7 Tagen. Zeigt sich in der Pilotgruppe ein Problem, sperrst du das Update in der Patch-Richtlinie, bevor es die anderen bekommen. Die Verzoegerung wirkt mit und ohne Patch-Richtlinie (ohne Richtlinie schickt Control dann eine Liste der alt genug gewordenen Updates statt alles installieren). Ist nichts alt genug, laesst der Job den Rechner aus.
Funktionsupdate (ab v3.68.0)
Der Windows-Typ Funktionsupdate bringt Arbeitsplaetze auf eine neue Windows-11-Version (Inplace-Upgrade, z. B. 23H2 auf 25H2), auf Wunsch auch Windows 10 auf Windows 11. Server werden uebersprungen.
| Option | Wirkung |
|---|---|
| Zielversion | Neueste (Standard, ab v3.68.1) oder eine bestimmte Version wie 24H2. Neueste = Wert der Einstellung windows_feature_latest (Einstellungen > Parameter, derzeit 25H2); bei einer neuen Windows-Version dort hochsetzen. Rechner auf dieser oder einer neueren Version werden uebersprungen. Der Installationsassistent installiert die Version, die Microsoft gerade ueber ihn ausliefert (derzeit 24H2, Build 26100) - siehe unten |
| Auch Windows 10 auf Windows 11 | Standard aus |
| Ueberspringen, wenn jemand angemeldet ist | Standard an (aktive Sitzung, auch RDP) |
| Danach neu starten | Standard an, mit Vorwarnung (1 bis 120 Minuten). Aus: das Upgrade wird beim naechsten Neustart abgeschlossen |
| Mindestens frei auf C: | Standard 25 GB |
| Quelle | Installationsassistent (von Microsoft geladen, Signatur „Microsoft Corporation“ wird geprueft) oder eigene ISO (https://...iso oder Netzwerkfreigabe, z. B. fuer LTSC/Enterprise oder eine feste Version; setup.exe /auto upgrade /quiet /noreboot). Ab v3.72.4 duerfen https-Adressen Parameter hinter .iso haben (bis 2000 Zeichen). Downloadlinks von microsoft.com laufen aber nach 24 Stunden ab - fuer wiederkehrende Jobs die ISO auf eine eigene Freigabe oder einen eigenen Webserver legen |
| Nicht unterstuetzte Hardware erlauben (ab v3.71.2) | Standard aus, nur mit eigener ISO. setup.exe laeuft dann mit /product server (prueft TPM, Secure Boot und Prozessorliste nicht) und setzt AllowUpgradesWithUnsupportedTPMOrCPU. Microsoft gibt dafuer keine Gewaehr, solche Rechner bekommen spaeter unter Umstaenden keine Funktionsupdates mehr. Prozessoren ohne POPCNT/SSE4.2 gehen auch so nicht |
Ablauf: Control erzeugt ein PowerShell-Script (kein Agent-Update noetig). Es prueft Version, Edition, ausstehenden Neustart, Platz, Akku (nur am Netzteil), angemeldete Benutzer sowie TPM 2.0, Secure Boot und 4 GB RAM (ab v3.71.2 auch bei Windows 11, ohne die Umgehung = fehlgeschlagen mit Grund), laedt dann die Quelle nach C:\ProgramData\DATAZONE\FeatureUpdate und bereitet das Upgrade vor. Der Fortschritt steht in der Live-Ausgabe im Log. Danach startet der Rechner neu und installiert die neue Version (30 bis 60 Minuten).
Bricht Windows die Vorbereitung ab (ab v3.71.2), liest das Script den Fehlercode (MoSetup\Volatile\BoxResult, z. B. 0xC1900200 = Hardware nicht geeignet) und die harten Sperren aus CompatData*.xml (z. B. Prozessor nicht freigegeben, kein TPM 2.0, kein UEFI/Secure Boot). Der Versuch steht dann auf fehlgeschlagen mit diesem Grund, und der Rechner startet nicht neu. Vorher stand er auf vorbereitet, startete neu und es passierte nichts.
24H2 und 25H2: Der Installationsassistent liefert 24H2. 25H2 baut darauf auf und kommt danach als kleines Aktivierungspaket ueber Windows Update. Ein Rechner, der beim Ziel 25H2 auf 24H2 landet, zaehlt deshalb als fertig (mit Hinweis). Rechner, die schon auf 24H2 sind, ueberspringt der Assistenten-Weg. Direkt auf 25H2 geht es mit einer 25H2-ISO.
Ob es geklappt hat, entscheidet Control selbst an der gemeldeten Version: Zeigt der Rechner innerhalb von 6 Stunden nach dem Neustart die Zielversion, ist der Versuch fertig, sonst fehlgeschlagen mit Hinweis auf die Protokolle (C:\$WINDOWS.~BT\Sources\Panther\setuperr.log). Die Wartezeit laeuft nur gegen einen Rechner ab, der online ist (nach einem Neustart seit dem Versuch erst nach 1 Stunde Laufzeit) - ein uebers Wochenende ausgeschalteter PC schlaegt nicht fehl. Erreicht ein wegen Zeitablauf fehlgeschlagener Versuch spaeter (bis 30 Tage) doch die Zielversion, wird er auf fertig korrigiert. Akkubetrieb heisst: Akku entlaedt bzw. ist schwach (am Netzteil, voll oder ladend = Netz). Den Verlauf liefert GET /api/windows/feature-updates (je Rechner und Job). Pro Rechner laeuft immer nur ein Versuch; beim Aufnehmen neuer Rechner (Onboarding) laeuft der Job nie.
Tipp: Den Job abends oder am Wochenende planen und zuerst auf einer kleinen Gruppe testen. Ein Lauf dauert je Rechner 1 bis 3 Stunden (Download ca. 4 GB).
Zeitplan-Typen
| Typ | Beschreibung | Konfiguration |
|---|---|---|
| Einmalig | Wird zum geplanten Zeitpunkt einmal ausgefuehrt | Datum + Uhrzeit |
| Taeglich | Jeden Tag zur gleichen Uhrzeit | Uhrzeit |
| Woechentlich | Am gleichen Wochentag zur gleichen Uhrzeit | Wochentag + Uhrzeit |
| Monatlich | Am gleichen Tag des Monats | Tag (1-31) + Uhrzeit |
| Cron | Freie Cron-Expression fuer komplexe Zeitplaene | Cron-Ausdruck |
Cron-Expressions
Fuer erweiterte Zeitplaene steht eine freie Cron-Expression zur Verfuegung:
Minute Stunde Tag Monat Wochentag
* * * * *Beispiele:
| Cron-Expression | Bedeutung |
|---|---|
0 2 * * * | Jeden Tag um 02:00 Uhr |
0 3 * * 0 | Jeden Sonntag um 03:00 Uhr |
0 4 1 * * | Am 1. jeden Monats um 04:00 Uhr |
0 22 * * 1-5 | Montag bis Freitag um 22:00 Uhr |
0 */6 * * * | Alle 6 Stunden |
Scripts kombinieren
Update-Zeitplaene koennen mit Scripts aus der Script-Bibliothek kombiniert werden:
Pre-Update-Script
Wird vor dem Update ausgefuehrt. Typische Anwendungsfaelle:
- Dienste stoppen
- Backup erstellen
- Wartungsmodus aktivieren
Post-Update-Script
Wird nach dem Update (und ggf. Neustart) ausgefuehrt. Typische Anwendungsfaelle:
- Dienste pruefen
- Konfiguration anpassen
- Benachrichtigung senden
OPNsense-Ausnahme
Bei OPNsense-Zeitplaenen sind Scripts ueber den Playbook-Mechanismus verfuegbar, nicht als direkte Pre-/Post-Script-Option.
Zeitplaene verwalten
Uebersicht
In der Modul-Ansicht unter Jobs sehen Sie alle geplanten und ausgefuehrten Zeitplaene:
- Name und Update-Typ
- Naechste geplante Ausfuehrung
- Letzte Ausfuehrung und Status
- Ziel (Host, Gruppe, Kunde, Alle)
- Aktiv/Inaktiv-Status
Zeitplan aendern
- Klicken Sie auf einen Zeitplan in der Liste
- Aendern Sie die Konfiguration
- Speichern
Zeitplan loeschen
Klicken Sie auf das Papierkorb-Symbol neben einem Zeitplan, um ihn zu entfernen.
Offline-Hosts und Nachholen (Catch-up)
Wenn ein Host zum geplanten Zeitpunkt offline ist, geht der Job nicht verloren. DATAZONE Control bietet ein intelligentes Catch-up-System:
Verpasste Jobs nachholen
Bei wiederkehrenden Zeitplaenen koennen Sie konfigurieren, ob verpasste Jobs nachgeholt werden sollen:
| Option | Beschreibung |
|---|---|
| Verpasste Jobs nachholen | Checkbox: Soll der Job bei Reconnect nachgeholt werden? (Standard: Ja) |
| Nachhol-Fenster | Maximale Zeit in Stunden, die ein verpasster Job gueltig bleibt (Standard: 24h) |
Verfuegbare Nachhol-Fenster:
| Fenster | Anwendungsfall |
|---|---|
| 6 Stunden | Kurzfristige Wartungsjobs |
| 12 Stunden | Nachtjobs die am naechsten Morgen noch gelten |
| 24 Stunden (Standard) | Taegliche Jobs |
| 48 Stunden | Wochenend-Ausfaelle abdecken |
| 72 Stunden | Hosts die bis zu 3 Tage offline sein koennen |
| 1 Woche | Langfristige Offline-Szenarien |
Wie funktioniert Catch-up?
- Der Scheduler erstellt den Task zum geplanten Zeitpunkt, auch wenn der Host offline ist
- Wenn der Host offline ist, bleibt der Task als pending in der Warteschlange
- Aeltere pending Tasks fuer den gleichen Schedule werden automatisch als expired markiert (Deduplizierung)
- Sobald der Agent sich erneut verbindet, werden alle gueltigen pending Tasks zugestellt
- Tasks die aelter als das Nachhol-Fenster sind, werden verworfen
Beispiel
Ein woechentlicher Update-Job ist fuer Sonntag 03:00 Uhr geplant. Der Host ist von Freitag bis Montag aus. Am Montag um 08:00 verbindet sich der Agent:
- Nachhol-Fenster 24h: Task wird verworfen (aelter als 24h)
- Nachhol-Fenster 72h: Task wird nachgeholt (juenger als 72h)
- Nachholen deaktiviert: Task wird verworfen
Deduplizierung
Wenn ein Host laengere Zeit offline ist und der Scheduler mehrere Tasks erstellt (z.B. 10 taegliche Updates in 10 Tagen), wird nur der neueste Task nachgeholt. Alle aelteren werden automatisch als expired markiert.
Catch-up deaktivieren
Setzen Sie das Nachhol-Fenster auf 0 (Checkbox deaktivieren), um Catch-up komplett abzuschalten. In diesem Fall werden Tasks nur zugestellt, wenn der Host zum geplanten Zeitpunkt online ist.
Einmalige Jobs warten auf offline Hosts (ab v3.49.0)
Auch einmalige Jobs haben die Option, jetzt unter dem Namen Auf offline Hosts warten mit einer maximalen Wartezeit bis 30 Tage (zusaetzlich 2 Wochen und 30 Tage zur Auswahl):
- Hosts, die beim Start offline sind, bekommen ihren Task trotzdem. Er wartet, bis sich der Host wieder meldet, und laeuft dann - laengstens bis zum Ende der Wartezeit.
- Beim Ziel Alle Hosts zaehlen dann auch offline Hosts, die sich innerhalb der Wartezeit zuletzt gemeldet haben. Hosts, die laenger tot sind, bekommen nie etwas. Ohne die Option (oder bei wiederkehrenden Jobs) nimmt "Alle Hosts" wie bisher nur Hosts, die gerade online sind.
- Bei Kunde, Gruppe, Standort oder einzelnem Host war das schon immer so: der Task entsteht fuer alle Ziel-Hosts, offline Hosts holen ihn nach.
- Die 7-Tage-Bereinigung (siehe unten) schliesst wartende Tasks eines einmaligen Jobs erst nach seiner Wartezeit.
- OPNsense-Update-Laeufe warten nicht: sie planen nur Firewalls, die beim Start online sind.
In der Jobliste zeigt eine Pill wartet auf N Hosts (offline), fuer wie viele offline Hosts noch ein Task des Jobs bereitliegt. Das gilt fuer alle Jobs, auch wiederkehrende mit Nachholen.
Wiederkehrende Jobs bleiben unveraendert: Nachhol-Fenster bis 1 Woche, "Alle Hosts" nur online.
Haengende Tasks werden automatisch geschlossen
Seit 3.13.0 schliesst der Scheduler jede Minute Tasks, die nie mehr fertig werden koennen. So bleiben die Aufgabenleiste, die Host-Logs und die Sperre "auf diesem Host laeuft noch etwas" ehrlich:
| Zustand | Nach | Ergebnis |
|---|---|---|
| In Bearbeitung ohne Ergebnis (z. B. Neustart, Agent-Update oder Absturz mitten im Task) | 24 Stunden | fehlgeschlagen, Fehlertext "Kein Ergebnis vom Agent innerhalb von 24 h - automatisch beendet" |
| Script oder Check in Bearbeitung ohne Ergebnis (ab v3.69.10) | dreifaches Zeitlimit des Scripts + 60 min (Standard-Zeitlimit 5 min = nach 75 min) | fehlgeschlagen, Fehlertext "Keine Rueckmeldung vom Agent ... vermutlich nie beim Agent angekommen"; bei Checks Ergebnis "unbekannt". Der naechste Lauf kommt normal |
| Wartend, nie zugestellt (Host dauerhaft offline) | 7 Tage (einmaliger Job mit Warten: seine Wartezeit, bis 30 Tage) | abgelaufen |
| Task ohne Host (Host wurde geloescht) | sofort | abgelaufen |
| Playbook-Ausfuehrung ohne Fortschritt | 24 Stunden | fehlgeschlagen |
Tasks eines laufenden OPNsense-Update-Laufs sind ausgenommen, dort entscheidet der Lauf selbst mit seinen eigenen Zeitlimits. Jede Schliessung steht mit Grund im Task und als Audit-Eintrag auto_expire_tasks mit den Anzahlen. Meldet der Agent nach dem Schliessen doch noch ein Ergebnis, wird es wie bei jedem abgeschlossenen Task verworfen.
Onboarding neuer Hosts
Wenn ein neuer Host zum ersten Mal in DATAZONE Control registriert wird, muss er normalerweise bis zum naechsten geplanten Zeitpunkt warten. Mit der Onboarding-Funktion kann das umgangen werden.
Bei neuem Host sofort ausfuehren
Aktivieren Sie die Option Bei neuem Host sofort ausfuehren auf einem wiederkehrenden Zeitplan. Wenn ein neuer Host sich zum ersten Mal registriert, wird der Job automatisch erstellt und zugestellt - auch wenn der Host spaeter einem Kunden, einer Gruppe oder einem Standort zugeordnet wird (bis 30 Tage nach Aufnahme).
| Option | Beschreibung |
|---|---|
| Bei neuem Host sofort ausfuehren | Checkbox: Job wird beim ersten Connect eines neuen Hosts ausgefuehrt bzw. sobald der Host spaeter ins Ziel des Jobs kommt (Standard: Nein) |
Wie funktioniert Onboarding?
- Ein neuer Host registriert sich zum ersten Mal (
last_seenist leer) - Das System sucht alle aktiven, wiederkehrenden Schedules mit Onboarding aktiviert
- Fuer jeden passenden Schedule (direkt zugewiesen, ueber Gruppe, Kunde, Standort oder global) wird ein Task erstellt
- Die Tasks werden sofort an den Agent zugestellt
- Control merkt sich je Job und Host, dass das Onboarding gelaufen ist - jeder Job laeuft je Host nur einmal
Spaetere Zuordnung (ab v3.49.0)
Neue Hosts landen beim ersten Kontakt oft noch ohne Kunden oder im Platzhalter-Kunden ONBOARDING und ohne Gruppe. Kunden-, Gruppen- und Standort-Jobs greifen dann noch nicht. Deshalb prueft der Scheduler jede Minute:
- alle Hosts, die hoechstens 30 Tage in Control sind und gerade online sind,
- ob ein Onboarding-Job jetzt auf sie passt, der fuer diesen Host noch nicht lief.
Sobald Sie den Host also dem Kunden, der Gruppe oder dem Standort zuordnen, laeuft der passende Onboarding-Job (bei einem offline Host, sobald er sich meldet). Ein zweites Mal laeuft derselbe Job auf demselben Host nicht.
- Bestandshosts bekommen nichts nachtraeglich: beruecksichtigt werden nur Hosts, die nach der Einfuehrung (Update auf 3.49.0) aufgenommen wurden.
- Hosts in Wartung (einmalig) oder Ausser Betrieb werden wie bei geplanten Jobs uebersprungen; das Onboarding kommt nach dem Ende des Zustands (innerhalb der 30 Tage).
- Wie beim ersten Kontakt gilt: kein Neustart, kein Major-Upgrade, Neustart-Jobs werden ausgelassen.
Neuer Onboarding-Job
Legen Sie einen neuen Job mit Bei neuem Host sofort ausfuehren an (oder aktivieren die Option nachtraeglich), laeuft er auch auf passenden Hosts, die in den letzten 30 Tagen aufgenommen wurden und online sind - fuer diese ist er ja noch nicht gelaufen.
Typischer Anwendungsfall
Sie haben einen woechentlichen Update-Schedule fuer die Gruppe "Produktions-Server". Ein neuer Server wird der Gruppe hinzugefuegt und der Agent installiert. Mit Onboarding bekommt er sofort sein erstes Update, statt bis naechsten Sonntag warten zu muessen.
Bulk-Updates
Sie koennen Updates auch fuer mehrere Hosts gleichzeitig starten:
- Waehlen Sie mehrere Hosts ueber die Checkboxen aus
- Klicken Sie auf Bulk-Update
- Waehlen Sie den Update-Typ
- Bestaetigen Sie die Ausfuehrung
Hinweis
Bulk-Updates werden gleichzeitig auf allen gewaehlten Hosts gestartet. Planen Sie bei kritischer Infrastruktur gestaffelte Updates ueber Zeitplaene.
Verhalten seit v3.14.2
- Einmalige Jobs brauchen ein Datum. Ohne
schedule_datelehnt die API den Job ab (400). Vorher galt "kein Datum = sofort", wodurch ein Bearbeiten oder Aktivieren den Job im naechsten Tick startete. - Cron-Zeitplaene funktionieren. Der Ausdruck wird in der Zeitzone der Instanz ausgewertet (Einstellung
timezone); ungueltige Ausdruecke werden mit 400 abgelehnt. Vorher wurde der Cron-Typ ignoriert und der Job lief in jeder Minute erneut. - Monatlich am 29./30./31. laeuft am letzten Tag kuerzerer Monate statt still zu verrutschen.
- Bearbeiten rechnet den naechsten Lauf nur neu, wenn sich Zeitfelder aendern. Pausieren/Aktivieren oder Umbenennen startet nichts; ein einmaliger Job behaelt seinen Termin.
- Geloeschte Ziele deaktivieren ihre Jobs. Wird ein Host, eine Gruppe, ein Kunde, ein Check, ein Script oder ein Playbook geloescht, werden die betroffenen Jobs deaktiviert und tragen den Status
deaktiviert: ... geloescht. Vorher blieb der Job aktiv und galt als "alle Hosts" bzw. fiel in den Update-Zweig. - "Alle Hosts" = Hosts mit Heartbeat in den letzten 120 Sekunden (Windows: 5 Minuten). Fuer Proxmox VE, PBS und Linux lief dieser Fall vorher gar nicht (Programmfehler im Filter).
- Linux-Jobs erhalten beim Anlegen einen naechsten Lauf (vorher nie, wenn das Formular kein
next_runsendete). - Script-Jobs fuer Linux und Windows erzeugen jetzt einen Task-Typ, den der Agent kennt; Pre-/ Post-Hooks der Scripts werden mitgegeben.
- Jobs bei neuem Host (
run_on_new_host) erzeugen die gleichen Tasks wie der Zeitplan selbst (OPNsense: nur Pakete, kein Reboot - der CARP-Zustand eines neuen Hosts ist noch unbekannt). - Jetzt ausfuehren nimmt weiterhin alle Hosts des Ziels, auch offline; solche Tasks werden innerhalb des Catch-up-Fensters nachgeholt. Fuer Updates mit Reboot bewusst einsetzen.
- Windows-Geraetetyp unbekannt passt auf jeden Filter (auch wenn der Agent wortwoertlich "Unknown" meldet).