Ereignisse, Aktionen und Timer

Der Event & Action Handler ermöglicht es, Aktionen basierend auf dem Eintreffen eines Ereignisses auszulösen.

Ereignisse

Ereignisse sind Zustandsänderungen im oder am Router, die dazu verwendet werden können, um bei deren Eintreten eine Aktion auszulösen.

Folgende Ereignisse stehen derzeit zur Verfügung:

• WAN-Ketten-Zustand hat sich geändert: Eine WAN-Kette hat ihren Zustand auf "online" oder "offline" geändert.

• Interface-Zustand hat sich geändert: Ein Interface hat seinen Zustand auf "online" oder "offline" geändert.

• Modem-Zustand hat sich geändert: Ein Modem hat seinen Zustand  auf "online", "offline", "eingebucht" oder "nicht eingebucht" (für  LTE-Modems) bzw. "Sync erreicht" oder "Sync verloren" (für DSL-Modems)  geändert.

• Signalfeldstärke des Modems hat sich geändert: Die Signalfeldstärke hat den konfigurierten Wert über- oder unterschritten.

• Konfiguration wurde geändert: Die Konfiguration wurde verändert oder aktiviert.

• Link eines Ethernet-Ports hat sich geändert: Der Link-Zustand  hat sich auf "UP" oder "DOWN" geändert, d.h. ein Ethernet-Kabel wurde  ein- oder ausgesteckt oder das angeschlossene Gerät wurde ein- oder  ausgeschaltet.

• Container-Zustand hat sich geändert: Ein aktiver Container wurde "gestartet" oder "gestoppt".

• System wurde neu gestartet: Als Neustart wird sowohl ein  Hardware-Reset (z.B. Spannungsausfall) als auch ein Software-Reset (z.B.  Reset über Web-Interface) gewertet.

• Schlafmodus beendet: Der Schlafmodus wird nach Ablauf der  angegebenen Dauer, einem Reset, einem vorübergehenden Ausfall der  Spannungsversorgung oder der Änderung eines Zustands an einem Eingang  beendet. Diese Funktionalität ist abhängig von einer bestimmten  Hardware-Ausstattung und nicht für alle Router verfügbar.

• Auto-Update wurde erfolgreich durchgeführt

• Versorgungsspannungs-Quelle hat sich geändert: Die anliegende Spannung an den Klemmen V+1 und V+2 wird überwacht. Die Klemme mit der höheren Spannung versorgt das Gerät. Das Ereignis wird ausgelöst, wenn der die höhere Spannung nun an der anderen Klemme anliegt.

• Anmeldungsversuch erkannt: Es werden erfolgreiche oder fehlgeschlagene Anmeldeversuche am Web-Interface oder am CLI erkannt.

• Netzfilterverletzung ist aufgetreten: Eine Netzfilterverletzung tritt ein, wenn die IP-Filter (Firewall) ein Paket zurückweisen.

• Einsteckkarte wurde neu gestartet: Dieses Ereignis wird auch bei einem Neustart des Routers ausgelöst.

• Digitaler Eingang hat sich geändert: Der Pegel eines Digitaleingangs ist nun "HIGH" oder "LOW" oder es wurde die konfigurierte Pulsfolge gezählt. Der Pegel muss mindestens eine Sekunde anliegen, um erkannt zu werden. Ein Puls einer Pulsfolge muss mindestens 100 ms lang anliegen. Eine Pulsfolge (1-99 Pulse) wird abgeschlossen, wenn sich der Pegel länger als 2 Sekunden nicht mehr ändert.

• Analoger Eingang hat sich geändert: Der Pegel eines Analogeingangs hat nun den eingestellten Wert "überschritten" oder "unterschritten".

• Timer ist abgelaufen: Ein Zeitpunkt wurde erreicht, ein Countdown ist abgelaufen oder ein Zeitraum ist vergangen.

• Zähler hat Endwert erreicht: Ein Zähler hat seinen konfigurierten Endwert erreicht.

• Seriell-Ethernet-Zustand hat sich geändert: Der TCP-Verbindungszustand eines Seriell-Ethernet-Gateway hat sich auf "verbunden" oder "getrennt" geändert.

• SMS wurde empfangen: Optional kann durch die Angabe einer  Absendernummer und/oder eines SMS-Texts spezifiziert werden, ob die  eingehende SMS als Ereignis betrachtet wird.

• MCIP-Telegramm wurde empfangen: Optional kann durch die  Angabe einer Absender-OID und/oder eines Telegramminhalts spezifiziert  werden, ob das eingehende MCIP-Telegramm als Ereignis betrachtet wird.

• WLAN-Station - Zustand hat sich geändert: Eine WLAN-Station hat den Zustand ihrer Verbindung mit einem Access Point auf "verbunden" oder "getrennt" geändert.

• Status eines SFP-Ports hat sich geändert: Ein SFP-Modul wurde in den jeweiligen Port "eingelegt" oder daraus "entfernt".

• Client-Zertifikat wurde von EST-Server erhalten: Ein EST-Enrollment hat ein neues Client-Zertifikat auf dem Router verfügbar gemacht.

• Netzwerk-Tool beendet: Der ausgewählte Netzwerk-Tool-Aufruf hat das Ergebnis erfolgreich oder fehlgeschlagen zurückgemeldet.

Aktionen

Aktionen sind Vorgänge, die durch den Router bei Eintreten eines Ereignisses gestartet werden.

Folgende Aktionen stehen derzeit zur Verfügung:

• Uhr via NTP synchronisieren: Die interne Uhr wird mit dem konfigurierten NTP-Server synchronisiert.

• System neu starten: Der Router führt einen Neustart durch.

• INFO-LED schalten: Die Info-LED in Slot 2 wird eingeschaltet, ausgeschaltet oder beginnt zu blinken.

• Meldung versenden: Die ausgewählte Meldung wird versendet.

• WAN-Kette starten: Die ausgewählte WAN-Kette wird gestartet.

• Modem aus-/einschalten oder aus-/einbuchen: Das ausgewählte Modem wird entweder ausgebucht, eingebucht, ausgeschaltet oder eingeschaltet. Wird ein ausgebuchtes oder ausgeschaltetes Modem in einer aktiven WAN-Kette  verwendet, wird es automatisch wieder eingeschaltet und eingebucht. Ist es nicht Teil einer aktiven WAN-Kette, wird es erst eingeschaltet  (und eingebucht), wenn eine WAN-Kette gestartet wird, in der es  enthalten ist, oder durch eine Aktion eingeschaltet oder eingebucht  wird. Für den SMS-Versand muss ein Modem eingeschaltet und eingebucht sein, es  muss aber nicht Teil einer WAN-Kette sein. DSL-Modems können nur ausgeschaltet (z.B. zu Stromsparzwecken) oder  eingeschaltet werden.

• Container starten oder stoppen: Der ausgewählte Container wird gestartet oder gestoppt. Dazu muss der Container aktiv sein.

• Auto-Update starten: Der automatische Update-Vorgang wird gestartet.

• Firmware aktivieren: Die ausgewählte Firmware wird aktiviert.

• Profil aktivieren: Das ausgewählte Profil wird aktiviert und geöffnet.

• ASCII-Konfiguration anwenden: Die ausgewählte ASCII-Konfiguration wird auf das geöffnete Profil angewendet. Enthält diese ASCII-Konfiguration ein Lua-Skript, wird auch das ausgeführt.

• Countdown starten oder stoppen: Der ausgewählte Countdown-Timer wird entweder gestartet oder gestoppt.

• Zähler setzen: Der ausgewählte Zähler wird entweder zurückgesetzt, um Eins hochgezählt oder um Eins heruntergezählt.

• Digitalen Ausgang schalten: Der ausgewählte Digitalausgang wird geöffnet, geschlossen, umgeschaltet oder gepulst.

• Analogen Ausgang setzen: Der ausgewählte Analogausgang wird auf den angegebenen Wert gesetzt.

• Seriell-Ethernet-Gateway verbinden oder trennen: Das ausgewählte Seriell-Ethernet-Gateway wird entweder verbunden oder getrennt, d.h. die TCP-Verbindung zur angegebenen Gegenstelle wird aufgebaut oder abgebaut.

• Schlafmodus starten: Der Router wird in den Schlafmodus  versetzt. Nach Ablauf der angegebenen Dauer, einem Reset, einem vorübergehenden  Ausfall der Spannungsversorgung oder der Änderung eines Zustands an  einem Eingang startet der Router neu. Diese Funktionalität ist abhängig von einer bestimmten  Hardware-Ausstattung und nicht für alle Router verfügbar.

• Zertifikatsregistierung: Client-Zertifikat erneuern: Für das ausgewählte Client-Zertifikat wird eine Anfrage zur Erneuerung beim Zertifikatsregistrierungs-Server gestellt.

• Netzwerk-Tool starten: Der ausgewählte Netzwerk-Tool-Aufruf wird ausgeführt.

• Geräte-Zähler zurücksetzen: Der ausgewählte Geräte-Zähler wird zurückgesetzt.

Timer

Timer werden verwendet, um zeitgesteuert ein Ereignis auszulösen. Bestimmte Timer können auch im Rahmen einer Aktion (hervorgerufen durch ein Ereignis) gestartet oder gestoppt werden. Ein Timer wird nur gestartet, wenn er auch als Ereignis einer Aktion zugewiesen ist.

Es gibt drei verschiedene Typen von Timern: Zeitpunkt, Intervall und Countdown.

Zeitpunkt

Ein Timer vom Typ Zeitpunkt läuft regelmäßig zum angegebenen Zeitpunkt ab.
Mit dieser Art Timer können regelmäßige Aktionen ausgelöst werden, wie zum Beispiel eine tägliche Synchronisierung der Uhrzeit oder ein tägliches Aus- und Einbuchen im Mobilfunknetz.

Beispiele:
Zeitpunkt: 23:05, Wiederholung: täglich - dieser Timer löst täglich um 23:05 ein Ereignis aus
Zeitpunkt: 23:05, Wiederholung: stündlich - dieser Timer löst jede Stunde um fünf Minuten nach der vollen Stunde ein Ereignis aus (00:05, 01:05, 02:05, ...)

Intervall

Ein Timer vom Typ Intervall läuft regelmäßig nach dem angegebenen Intervall ab und startet dann erneut. Erstmalig gestartet wird er mit seiner Einrichtung und bei jedem Neustart des Routers.
Mit dieser Art Timer können regelmäßige Aktionen ausgelöst werden, wie zum Beispiel der Versand von Statusmeldungen.

Beispiel:
Intervall: 5:15 - dieser Timer löst alle 315 Minuten (5*60+15) ein Ereignis aus

Countdown

Ein Timer vom Typ Countdown wird im Rahmen einer Aktion gestartet und läuft dann nach dem angegebenen Intervall ab. Er kann auch vor seinem Ablauf im Rahmen einer Aktion wieder gestoppt werden.
Ist die Checkbox Timer bei neuem Ereignis neu starten markiert, wird ein bereits laufender Timer durch ein ihm zugeordnetes Ereignis noch einmal gestartet, d.h. er wird zurückgesetzt und beginnt erneut zu laufen. Ist die Checkbox deaktiviert, kann der Timer vor seinem Ablauf nicht erneut durch ein Ereignis neu gestartet werden.
Ist die Checkbox Timer nach Ablauf dauerhaft deaktivieren markiert, kann der Timer nicht wieder gestartet werden. Dazu wird der Timer deaktiviert und kann auch nicht von einem Ereignis wieder gestartet werden; um ihn wieder zu aktivieren, muss in der Liste der Timer die Checkbox aktiv dieses Timers wieder markiert werden.
Mit dieser Art Timer können anspruchsvollere Anwendungen realisiert werden, wie zum Beispiel die Kaskadierung von Alarmmeldungen oder der zeitverzögerte Start von Aktionen wie einem Firmware-Update.

Beispiel:
Countdown: 0:07, Timer bei neuem Ereignis neu starten: JA, Timer nach Ablauf dauerhaft deaktivieren: NEIN - dieser Timer löst nach 7 Minuten ein Ereignis aus, wird mit jedem Auftreten eines ihm zugeordneten Ereignisses neu gestartet und kann auch nach seinem Ablauf durch ein Ereignis wieder gestartet werden

Einfügen von Werten in Meldungen und Pfade

Status-Informationen, Ereignis-abhängige Informationen sowie alle Parameter der Konfiguration können als Variablen im Nachrichtentext von SMS- und E-Mail-Meldungen sowie in der Betreff-Zeile einer E-Mail-Nachricht eingesetzt werden. Ereignis-abhängige Informationen können nur von dem Ereignis verwendet werden, durch das die Meldung ausgelöst wurde. Es ist außerdem möglich, Werte in den Pfad für die Download-Liste auf einem Auto-Update-Server einzubinden.

Der Wert wird als CLI-Befehl im Ausdruck $cli() in den Text eingesetzt. Groß- und Kleinschreibung wird dabei berücksichtigt.

Beispiele für Meldungen

Beispiel für einen Meldungstext, der die aktuelle Systemzeit im Router in einer Meldung ausgibt:
Die aktuelle Systemzeit ist $cli(status.sysdetail.system.date).

Beispiel für einen Meldungstext, der mit Hilfe Ereignis-abhängiger Informationen in einer Meldung ausgibt, wann sich welcher Benutzer an welchem Standort anmeldet:
Der Benutzer $cli(events.info[username]) meldete sich um $cli(administration.time.time) am Standort $cli(administration.hostnames.location) an.
Dazu muss die Meldung durch ein Ereignis Anmeldungsversuch erkannt - erfolgreich im Rahmen einer Aktion ausgelöst werden.

Beispiel für einen Meldungstext, der mit Hilfe verschachtelter Ereignis-abhängiger Informationen in einer Meldung ausgibt, welches Ereignis aufgetreten ist:
Das Ereignis $cli(events.event_config.event[$cli(events.info[event_id])].description) ist aufgetreten.
Dabei wird die Nummer des abgefragten Ereignisses über die Ereignis-abhängiger Information $cli(events.info[event_id]) in die Abfrage der Beschreibung des Ereignisses eingesetzt.

Beispiel für einen Pfad

Beispiel für die Verwendung der Seriennummer des Routers, um einen gerätespezifischen Pfad auf dem Auto-Update-Server zu generieren:

/updates/$cli(status.device_info.slot[1].serial_number)/list.txt

In diesem Fall wäre der resultierende Pfad: /updates/12345678/list.txt (bei einer angenommenen Seriennummer von 12345678)