Genie Discovery Agent (GDA) – Feldaktivierung

Zusammenfassung

Der GDA ist eine Desktop-Anwendung (Windows), die auf einem PC ausgeführt wird, der mit demselben lokalen Netzwerk wie Ihre Kameras verbunden ist. Er erkennt alle ONVIF-kompatiblen Kameras und konfiguriert die Ereignisweiterleitung an GC Surge automatisch — ohne manuelle Einrichtung pro Kamera. Der GDA muss nach der Aktivierung auf diesem PC weiterlaufen; er übernimmt die laufende Alarmweiterleitung für Objekte in privaten Netzwerken.

Behandelt: Was der GDA leistet, Plattformunterstützung, Ablauf der delegierten Installation, Bevor Sie beginnen, Wie Sie den Objektschlüssel erhalten, Netzwerkanforderungen, Aktivierungsschritte, Wenn Kameras nicht erkannt werden, Was die App konfiguriert, Nach der Aktivierung, Fehlermeldungen, Edge-Bereitstellungen.

Was der GDA leistet

• Verbindet sich mit demselben lokalen Netzwerk wie Ihre Kameras.
• Erkennt alle ONVIF-kompatiblen Kameras mithilfe des WS-Discovery-Protokolls.
• Überträgt die SMTP-Einstellungen zur Ereignisweiterleitung automatisch an jede erkannte Kamera, wobei Anmeldedaten verwendet werden, die mit Ihrem Objektschlüssel verknüpft sind.
• Muss nach der Einrichtung auf dem PC weiterlaufen — er übernimmt die laufende Alarmweiterleitung für Objekte in privaten Netzwerken.

Plattformunterstützung

Unterstützte Kameramarken für die automatische Konfiguration: Hikvision, Dahua, Axis und NX Witness. Hanwha- und SpykeBox-Kameras laufen auf der NX-Witness-Plattform — wählen Sie bei entsprechender Aufforderung NxWitness.

Ablauf der delegierten Installation

Wenn ein Super-Admin ein neues Objekt in der Konfiguration erstellt und Installation delegieren auswählt:

1. Der Super-Admin gibt Name, E-Mail-Adresse und Telefonnummer der Kontaktperson vor Ort ein.
2. GC Surge sendet den Objektschlüssel und die Installationsschritte an die Kontaktperson.
3. Die Kontaktperson vor Ort installiert den GDA auf einem Windows-PC am Objekt.
4. Die Kontaktperson öffnet den GDA und gibt den Objektschlüssel ein.
5. Der Agent erkennt die Kameras im lokalen Netzwerk und konfiguriert die Ereignisweiterleitung automatisch.

Um die Installation selbst durchzuführen, ohne sie zu delegieren, wählen Sie stattdessen Ich bin vor Ort. Den vollständigen Workflow zur Objekterstellung finden Sie unter Objekte einrichten.

Bevor Sie beginnen

Stellen Sie vor der Ausführung des GDA Folgendes sicher:

• Ein Windows-PC ist im selben lokalen Netzwerk wie die Kameras verfügbar.
• Alle Kameras sind eingeschaltet und mit dem Netzwerk verbunden.
• Sie haben den Objektschlüssel (GCSK-...) von Ihrem Super-Admin erhalten.
• ONVIF ist auf jeder Kamera aktiviert — falls Sie unsicher sind, siehe Wenn Kameras nicht erkannt werden weiter unten.

Option B — Mobile App (Aktivierung vor Ort)

Verwenden Sie die mobile GDA-App, wenn Sie keinen Fernzugriff auf das Netzwerk des Objekts haben und jemanden persönlich dorthin schicken müssen. Wenn Kameras für ein Objekt ohne lokalen Agenten hinzugefügt werden, erzeugt das System einen Objektschlüssel und einen QR-Code.

Die Person vor Ort:

1. Installiert die mobile GDA-App auf ihrem Gerät.
2. Scannt den QR-Code oder gibt den Objektschlüssel manuell ein, um die App mit dem Objekt zu verknüpfen.
3. Verbindet ihr Gerät mit demselben lokalen Netzwerk wie die Kameras.
4. Die App findet automatisch alle Kameras des Objekts und konfiguriert jede erreichbare Kamera.
5. Der Status im Portal wechselt nach Abschluss zu Konfiguriert.

Die mobile App hat keine Anmeldung — der Zugriff wird ausschließlich über den Objektschlüssel gesteuert. Geben Sie den QR-Code nur an vertrauenswürdige Personen weiter. Jeder Objektschlüssel ist an ein einzelnes Objekt gebunden; pro Objekt wird ein separater Schlüssel benötigt.

Wie Sie den Objektschlüssel erhalten

Ihr Super-Admin sendet den Objektschlüssel über die Konfiguration. Er wird auf eine von drei Arten zugestellt:

WhatsApp — der Objektschlüssel wird als WhatsApp-Nachricht gesendet. Kopieren Sie den Schlüssel aus der Nachricht und geben Sie ihn im GDA auf Ihrem PC ein.

E-Mail — die E-Mail enthält den vollständigen Objektschlüssel (GCSK-...) sowie Download-Links für das Windows-Installationsprogramm. Geben Sie den Schlüssel nach der Installation im GDA ein.

QR-Code — wenn Ihr Super-Admin mit Ihnen vor Ort ist, kann er den QR-Code aus der Konfiguration anzeigen. Scannen Sie ihn mit Ihrem Telefon, um den Objektschlüssel auszulesen, und geben Sie ihn dann manuell im GDA auf Ihrem PC ein.

Wie WS-Discovery funktioniert

WS-Discovery (Web Services Dynamic Discovery) ist das standardmäßige ONVIF-Protokoll zur Erkennung von Geräten in einem lokalen Netzwerk. Wenn der GDA die Erkennung startet, sendet er einen UDP-Multicast-Broadcast an das lokale Subnetz (Adresse 239.255.255.250). ONVIF-kompatible Kameras, die den Broadcast empfangen, antworten mit der Adresse ihres Dienst-Endpunkts. Die Anwendung sammelt alle Antworten und konfiguriert jede erkannte Kamera automatisch.

Damit die Erkennung funktioniert, müssen die folgenden Bedingungen erfüllt sein:

• Der PC, auf dem der GDA läuft, und die Kameras müssen sich im selben Netzwerksegment befinden (gleiches Subnetz oder VLAN).
• UDP-Multicast darf nicht durch den Netzwerk-Switch oder Router blockiert werden.
• ONVIF muss auf jeder Kamera aktiviert sein. Bei den meisten modernen Kameras ist dies standardmäßig aktiviert.

Netzwerkanforderungen

Der GDA erkennt Kameras über Multicast-Broadcasts, was bedeutet, dass der PC und die Kameras im selben Netzwerksegment kommunizieren können müssen. Unterschiedliche Netzwerkkonfigurationen erfordern unterschiedliche Vorbereitungen:

Flaches Netzwerk (empfohlen): Alle Kameras und der PC befinden sich im selben WLAN- oder Ethernet-Netzwerk. Die Erkennung funktioniert automatisch ohne zusätzliche Konfiguration.

VLAN-segmentiertes Netzwerk: Wenn sich die Kameras in einem anderen VLAN als der PC befinden, erreicht WS-Discovery sie nicht. Optionen: Verbinden Sie den PC während der Aktivierung vorübergehend mit dem Kamera-VLAN, lassen Sie Ihr IT-Team das Multicast-Routing zwischen den VLANs konfigurieren oder geben Sie die Kamera-IP-Adressen manuell ein.

Mehrere Subnetze an einem Standort: Jedes Subnetz muss separat aktiviert werden. Verbinden Sie den PC nacheinander mit jedem Subnetz und führen Sie die Erkennung für jedes Subnetz durch.

Aktivierungsschritte

1. Laden Sie den GDA über den Link in Ihrer Einrichtungs-E-Mail oder aus der Konfiguration herunter und installieren Sie ihn — wählen Sie Windows Installer oder MacOS Installer.
2. Öffnen Sie den GDA auf Ihrem PC.
3. Geben Sie den von Ihrem Super-Admin gesendeten Objektschlüssel ein.
4. Der Agent verbindet sich mit GC Surge, erkennt die Kameras im lokalen Netzwerk und konfiguriert die Ereignisweiterleitung auf jeder Kamera automatisch — es sind keine Schritte pro Kamera erforderlich.
5. Warten Sie auf die Erfolgsbestätigung, bevor Sie das Objekt verlassen. Schließen Sie den GDA nicht — er muss auf diesem PC weiterlaufen.

Wenn Kameras in der Liste der erkannten Geräte fehlen, siehe Wenn Kameras nicht erkannt werden weiter unten, bevor Sie die Aktivierung abschließen.

Wenn Kameras nicht erkannt werden

Wenn Kameras nicht in den Erkennungsergebnissen erscheinen, ist ONVIF möglicherweise auf der Kamera deaktiviert. Aktivieren Sie es über die Weboberfläche der Kamera:

Hikvision

1. Melden Sie sich an der Weboberfläche der Kamera an.
2. Gehen Sie zu Configuration → Network → Advanced Settings → Integration Protocol.
3. Aktivieren Sie ONVIF.

Dahua

1. Melden Sie sich an der Weboberfläche der Kamera an.
2. Gehen Sie zu Setting → System → Account und bestätigen Sie, dass ein ONVIF-Benutzer konfiguriert ist.
3. Gehen Sie anschließend zu Setting → Network → Advanced Settings und aktivieren Sie ONVIF.

AXIS

ONVIF ist standardmäßig aktiviert. In der Regel ist keine Aktion erforderlich.

Wenn eine Kamera nach dem Aktivieren von ONVIF weiterhin nicht erscheint, vergewissern Sie sich, dass sich die Kamera und der PC, auf dem der GDA läuft, im selben Netzwerksegment befinden.

Was der GDA auf jeder Kamera konfiguriert

Für jede erkannte Kamera überträgt der GDA automatisch die SMTP-Einstellungen zur Ereignisweiterleitung. Sie müssen diese nicht manuell eingeben — der Agent ruft die korrekten Anmeldedaten mithilfe Ihres Objektschlüssels von GC Surge ab und übermittelt sie direkt an jede Kamera. Auf jeder Kamera wird Folgendes konfiguriert:

• SMTP-Server: smtp.zeptomail.eu
• SMTP-Port: 587
• Verschlüsselung: TLS
• Authentifizierungsdaten: für dieses Objekt eindeutig, aus der Cloud über den Objektschlüssel abgerufen
• Absenderadresse: alerts@nxgen.io
• Empfänger: die für dieses Objekt spezifische GC-Surge-Eingangsadresse, automatisch zugewiesen
• Bildanhänge: aktiviert — jedes Alarmereignis enthält eine Momentaufnahme der Kamera
• Sendeintervall: mindestens 5 Sekunden zwischen Alarm-E-Mails

Nach der Aktivierung: Überprüfen der Pipeline

Nachdem der GDA die Konfiguration abgeschlossen hat, gewähren Sie der Cloud bis zu 10 Minuten, um die Verarbeitung abzuschließen. Öffnen Sie in der Konfiguration das Objekt und prüfen Sie den Konfigurationsstatus jeder Kamera — er sollte von „ausstehend“ zu Created (nicht Error) wechseln. Der eigene Status des Objekts zeigt Aktiv an, sobald es hinzugefügt wurde, was also kein Anzeichen dafür ist, dass die Konfiguration abgeschlossen ist.

Überprüfen Sie anschließend, ob die Alarme die Plattform erreichen:

1. Erzeugen Sie ein Testereignis am Objekt — lösen Sie die Bewegungserkennung aus oder durchqueren Sie das Sichtfeld der Kamera.
2. Warten Sie 30–60 Sekunden.
3. Gehen Sie in GC Surge zu Videosuche.
4. Wählen Sie das neu aktivierte Objekt aus.
5. Bestätigen Sie, dass das Testereignis als Ereigniskarte erscheint.

Wenn nach 5 Minuten keine Ereignisse erscheinen:

• Prüfen Sie, ob die Kamera ausgehenden Internetzugang zu smtp.zeptomail.eu über Port 587 hat.
• Vergewissern Sie sich, dass Bewegungs- oder Erkennungsauslöser auf der Kamera aktiviert sind.
• Prüfen Sie die Uhr der Kamera — falsche Zeitstempel können dazu führen, dass Ereignisse in falscher Reihenfolge verarbeitet werden.
• Melden Sie sich an der Weboberfläche der Kamera an und verwenden Sie die integrierte Schaltfläche „Test“ in den E-Mail- oder SMTP-Einstellungen, um direkt eine Test-E-Mail zu senden.

Fehlermeldungen

Der GDA zeigt bei jedem Fehler eine Fehlermeldung an. Wenn bei einem beliebigen Schritt etwas schiefgeht — beim Verbinden mit dem Objektschlüssel, beim Erkennen von Kameras oder beim Übertragen der Konfiguration — zeigt die Anwendung den konkreten Fehler auf dem Bildschirm an. Teilen Sie einen Screenshot des Fehlers mit Ihrem Super-Admin oder dem NXGen-Support-Team, um eine schnellere Lösung zu erreichen.

Edge-Bereitstellungen — Nicht zutreffend

Der GDA wird ausschließlich für die Feldaktivierung über Private/VPN verwendet. Bei Edge-Bereitstellungen ist er nicht beteiligt. Edge-Objekte verwenden GC Edge — eine Windows-PC-Anwendung, die sich über RTSP mit Kameras verbindet, die NOVA99x-Klassifizierung auf dem PC ausführt und klassifizierte Ereignisse an GC Surge weiterleitet. Der GDA läuft, streamt oder klassifiziert nicht für Edge-Objekte. Anweisungen zur Edge-Einrichtung finden Sie unter Objekte einrichten.