Cathexis VMS

Einleitung

Die GCXONE–Cathexis-Integration verbindet die Cathexis-Video‑Management‑Umgebung mit GCXONE und ermöglicht, dass Video‑ und Ereignisinformationen einer Cathexis‑Installation im GCXONE‑Überwachungs‑Workflow verfügbar sind.

CathexisVision fungiert als Video‑Management‑Ebene, verwaltet verbundene Kameras, Live‑ und aufgezeichnete Videos, integrierte Geräte, Alarm und unterstützte Kamerafunktionen wie PTZ. Cathexis stellt zudem ein Integrations‑Framework zur Anbindung externer Systeme und Geräte über seine Integrationsdatenbank und API bereit.

Durch diese Integration kommuniziert GCXONE mit dem konfigurierten Cathexis‑Server und ruft die erforderlichen Kamera‑ und Ereignisinformationen ab. Kamerastreams können über die Cathexis‑Schnittstellen abgerufen werden, während Geräte‑ und Ereignisinformationen von GCXONE für die Überwachung und Alarmbearbeitung genutzt werden.

Umfang der Integration

Die GCXONE–Cathexis-Integration konzentriert sich darauf, die erforderlichen Video‑ und Ereignis‑Funktionen eines CathexisVision‑Systems in GCXONE zu integrieren.

Für ein konfiguriertes Cathexis‑System kann GCXONE die folgenden Integrationsbereiche unterstützen:

• Kamera‑Erkennung und Identifizierung — Verfügbare Kameras abrufen und deren Cathexis‑Kamera‑IDs für weitere Vorgänge verwenden.
• Live‑Video — Zugriff auf den Live‑Stream der Kamera über die Cathexis‑Video‑Schnittstelle.
• Aufgezeichnetes Video — Aufgezeichnetes Filmmaterial einer Kamera bei Bedarf für die Ereignisuntersuchung abrufen.
• Referenzbilder — Ein Referenzbild einer Kamera zur Identifizierung oder Ereignisdarstellung abrufen.
• PTZ‑Steuerung — Unterstützte PTZ‑Kameras steuern und unterstützte PTZ‑Operationen ausführen, einschließlich preset‑bezogener Funktionen.
• Geräte‑ und Kamera‑Ereignisse — Cathexis‑Ereignis‑ und Technischer‑Alarm‑Informationen empfangen, einschließlich der zugehörigen Kameradetails, sofern vorhanden.
• Ereignis‑verbundenes Video — Die mit einem Alarm enthaltenen Kamera‑ und Review‑Track‑Informationen (aufgezeichnetes Video) nutzen, um das zum Ereignis gehörende relevante Video zu identifizieren.
• Integration mit Cathexis‑Geräten und Objekten — Cathexis nutzt sein Integrations‑Framework, um integrierte Geräte und deren Objekte mit Kameras und Ereignissen zu verknüpfen.

Systemarchitektur

Feldschicht – Kameras und Video‑Geräte

Dies ist die physische Schicht, in der Video‑ und zugehörige Gerätedaten entstehen.

Es kann umfassen:

• IP‑Kameras
• Video‑Einheiten / Encoder
• E/A‑Geräte
• Kameras mit unterstützter Analytik oder Ereignis‑Fähigkeiten

CathexisVision verwaltet diese Geräte und stellt Zugriff auf deren Video, Status und unterstützte Funktionen bereit. Je nach Kamerafähigkeiten kann Cathexis Live‑Feeds, aufgezeichnetes Video, PTZ‑Funktionen und Kamera‑Ereignisse bereitstellen.

Cathexis‑Plattform‑Schicht – CathexisVision

Der CathexisVision‑Server fungiert als die Video‑Management‑Ebene zwischen den physischen Geräten und GCXONE.

Es ist verantwortlich für:

• Verwalten verbundener Kameras und Videoressourcen
• Aufzeichnung und Bereitstellung des Zugriffs auf gespeicherte Videos
• Verwaltung der Verfügbarkeit und Konfiguration von Kameras
• Verarbeitung unterstützter Ereignisse und Alarme
• Bereitstellung von Kameraressourcen, Live-Feeds und Review‑Tracks
• Bereitstellung unterstützter PTZ‑ und I/O‑Funktionen

Die Cathexis API stellt GCXONE über authentifizierte API‑Schnittstellen Zugriff auf diese Ressourcen bereit.

Integrationsschicht – GCXONE

Der GCXONE‑Integrationsschicht verbindet sich mit der CathexisVision‑Umgebung und ruft die Ressourcen ab, die GCXONE benötigt.

Auf dieser Ebene GCXONE:

• Entdeckt und identifiziert verfügbare Kameras
• Ruft Kamerainformationen und verfügbare Streams ab
• Greift auf Live‑ und aufgezeichnete Videos zu
• Verarbeitet unterstützte PTZ‑Operationen
• Ruft Referenzbilder bei Bedarf ab
• Empfängt und verarbeitet unterstützte Ereignis‑ und Alarminformationen

Cathexis stellt Kamera‑IDs, Live‑Feed‑URLs, Review‑Tracks (aufgezeichnete Videos) und unterstützte PTZ‑Informationen über die API bereit, die GCXONE zur Ausführung dieser Vorgänge nutzt.

Überwachungsschicht – GCXONE

Die Überwachungsschicht ist der Ort, an dem die integrierten Cathexis‑Informationen den Bedienern über GCXONE zur Verfügung gestellt werden.

Bediener können GCXONE verwenden, um:

• Live‑Kameravideo ansehen
• Aufgezeichnetes Filmmaterial dort prüfen, wo es unterstützt wird
• Alarme und Ereignisse empfangen und untersuchen
• Auf unterstützte PTZ‑Steuerungen zugreifen

Diese Schicht liefert die Bediener‑Ansicht, während CathexisVision weiterhin die zugrunde liegende Video‑Infrastruktur und Aufzeichnungsumgebung verwaltet.

Cathexis‑Konfiguration

Dieser Abschnitt beschreibt die für CathexisVision erforderliche Konfiguration, bevor das System mit GCXONE verbunden wird. Führen Sie die nachfolgenden Schritte in der angegebenen Reihenfolge aus, damit Kameras, Video‑Streams, Ereignisse und technische Alarme für die GCXONE‑Integration verfügbar sind.

Hinweis: Die genauen Optionen können je nach CathexisVision‑Version, installierten Treibern und lizenzierten Merkmalen variieren.

Schritt 1: Cathexis‑Site erstellen oder auswählen

Ein Site gruppiert die Cathexis‑Server und Ressourcen, die zur selben Bereitstellung gehören. Kameras und integrierte Geräte werden auf den Servern innerhalb der Site konfiguriert. Wenn der Cathexis‑Server bereits als Single‑Server‑Site installiert ist, verwenden Sie die vorhandene Site, anstatt eine weitere zu erstellen.

Navigation: Datei → Enterprise manager

Erstellen oder wählen Sie die erforderliche Site aus und prüfen Sie, ob der Cathexis‑Server verfügbar ist.

Schritt 2: Kameras hinzufügen und prüfen

Fügen Sie die Kameras hinzu, die über GCXONE überwacht werden sollen.

Navigation: Standort → Öffnen → Einrichtung → Server konfigurieren → Kameras

Klicken Sie Neu um die Neue Kamera Assistent. Cathexis stellt die erforderlichen Verbindungsfelder basierend auf dem ausgewählten Kameratreiber bereit.

Geben Sie die erforderlichen Verbindungsdetails ein:

• Treiber
• IP Adresse
• Videoeingang, falls zutreffend
• Port
• Login (Kamerabenutzername)
• Passwort (Kamerapasswort)

Auswahl des Kameratreibers

Kameras können entweder über die kameraspezifischen Treiber oder den Generic Encoder Treiber.

• Kameraspezifischer Treiber: Unterstützt die vom ausgewählten Treiber bereitgestellten Integrationsfunktionen, einschließlich Streaming, Ereignissen und PTZ, sofern unterstützt.
• Generic Encoder: Kann verwendet werden, wenn kein kameraspezifischer Treiber verfügbar ist. Mit dem Generic Encoder‑Treiber werden Live-Streaming und Ereignisse unterstützt, PTZ‑Steuerung ist jedoch nicht verfügbar.

Empfohlen: Verwenden Sie den kameraspezifischen Treiber, sobald das erforderliche Kameramodell unterstützt wird. Verwenden Sie Generic Encoder, wenn nur Streaming‑ und Ereignis‑Funktionalität benötigt wird.

Die Kamera sollte erfolgreich verbunden sein und Video anzeigen, bevor Sie fortfahren.

Kamera‑Verifizierung

Nach dem Hinzufügen der Kamera prüfen Sie, ob:

• Live‑Video verfügbar ist.
• Die Kamera keinen Verbindungsfehler anzeigt.
• Die erforderliche Aufzeichnungskonfiguration verfügbar ist, falls Wiedergabe benötigt wird.

Damit kann GCXONE die Kamerainformationen und Videoressourcen über Cathexis abrufen.

Schritt 3: GCXONE API Base Station konfigurieren

Für die Ereignisübermittlung verwendet Cathexis ein API Base Station als Ziel für Alarme.

Die Basisstation sollte auf die GCXONE Service-Endpunkt der Cathexis‑Alarme empfängt.

Navigation: Standort → Einrichtung → Server konfigurieren → Basisstationen

Neue Basisstation erstellen und auswählen:

• Name: Ein beschreibender Name, z. B. API-BASE
• Typ: API
• Adresse: https://cathexisproxy.nxgen.cloud/eventIngest
• Port: 443
• Benutzer: Geben Sie die eindeutige Kennung des Geräts von GCXONE ein. GCXONE verwendet diese, um eingehende Alarme dem richtigen Gerät zuzuordnen.

Cathexis unterstützt Basisstationen vom Typ API zum Senden von Alarmen an ein externes System.

Wichtig: Der GCXONE‑Endpunkt muss vom Cathexis‑Server erreichbar sein. Netzwerk‑/Firewall‑Regeln sollten dem Cathexis‑Server erlauben, Alarm‑Anfragen an den konfigurierten GCXONE‑Endpunkt zu senden.

Schritt 4: Ereignis‑Alarme konfigurieren

Cathexis‑Ereignisse bestimmen wann ein Alarm ausgelöst wird und welche Aktion durchgeführt werden soll.

Stellen Sie vor dem Erstellen eines Ereignisses sicher, dass die erforderlichen Ressourcen bereits konfiguriert sind, z. B.:

• Kamera
• Video‑Analytik oder Bewegungsauslöser, falls erforderlich
• Aufzeichnungsdatenbank (siehe Schritt 7)
• Weitere erforderliche Eingänge oder Auslöser

Cathexis empfiehlt, diese Ressourcen vor dem Erstellen des Ereignisses zu konfigurieren.

Navigation: Standort → Einrichtung → Server konfigurieren → Ereignisse

Klicken Sie auf Neu um das erforderliche Ereignis zu erstellen.

Konfigurieren Sie das Ereignis gemäß dem erforderlichen Überwachungsszenario und wählen Sie den passenden Auslöser (Bewegungsaufzeichnungen werden empfohlen). Setzen Sie den Auslöser Haltezeit auf 0 damit Ereignisse sofort an GCXONE gesendet werden.

Ereignisbeschreibung

• Name: Geben Sie einen eindeutigen Alarmnamen ein (optional).
• Beschreibung (wichtig): Geben Sie $input_name.

Die Beschreibung für das Ereignis konfigurierte Beschreibung wird in den über die Cathexis‑API gesendeten Alarm-Informationen enthalten sein.

Schritt 5: Ereignis konfigurieren, um die GCXONE‑Basisstation aufzurufen

Nachdem Sie den Ereignisauslöser erstellt haben, konfigurieren Sie dessen Aktion, damit der Alarm an die GCXONE API Base Station gesendet wird.

Im Ereignis‑Aktionen‑Tab klicken Sie auf Neu und fügen Sie sowohl Kamera aufzeichnen als auch Basisstation aufrufen. Beide sind erforderlich, damit Kamerainformationen zusammen mit jedem Ereignis gesendet werden.

Wählen Sie die GCXONE API Base Station die Sie in Schritt 3 als Ziel erstellt haben.

Cathexis unterstützt eine primäre Erste‑Versuch Basisstation und optional eine Zweite‑Versuch Basisstation, falls ein sekundäres Ziel erforderlich ist.

Markieren Sie alle Kontrollkästchen im Basisstation aufrufen und Alarmvorschau‑Tabs.

Im Ressourcen Registerkarte, wählen Sie Trigger-Ressourcen verwenden am unteren Rand.

Schritt 6: Technische Alarme konfigurieren

Technische Alarme werden für System‑ oder Infrastrukturbedingungen verwendet, nicht für normale Kamera‑Ereignisse.

Beispiele, die von Cathexis unterstützt werden, umfassen:

• Kamera‑Fehler
• Datenbankprobleme
• Festplattenfehler
• Netzwerkverbindung
• Aufzeichnungsfehler
• Softwarefehler
• Integrations‑Datenbank‑Probleme
• Server‑Überwachungsbedingungen

Navigation: Site → Setup → Server konfigurieren → Technische Alarme

Erstellen Sie die für die Bereitstellung erforderlichen einzelnen Technischen Alarme.

Für jeden Technischen Alarm konfigurieren Sie:

• Beschreibender Alarmname (optional)
• Erforderliche technische Bedingung
• Alarme höchstens einmal wiederholen alle, falls erforderlich
• Call base-station aktiviert, mit der GCXONE API Base Station ausgewählt

Schritt 7: Datenbank konfigurieren

Cathexis‑Integrationen verwenden eine dedizierte Datenbank. Wenn die Datenbank auf dem Server noch nicht initialisiert wurde, initialisieren Sie sie, bevor Sie die Integration konfigurieren.

Navigation: Site → Setup → Datenbanken

Falls erforderlich:

1. Datenbank initialisieren.
2. Passende Partition auswählen.
3. Erforderliche Datenbankgröße zuweisen.
4. Erforderliche Integrations‑Datenbank erstellen.

Die Datenbank wird von Cathexis verwendet, um integrationsbezogene Daten und Ereignisse zu speichern.

Schritt 8: Integration Devices konfigurieren

Wenn die GCXONE‑Integration Cathexis verwendet Integration Devices, konfigurieren Sie sie über die Integration devices Panel.

Navigation: Einrichtung → Server konfigurieren → Integration devices

Klicken Sie New device, wählen Sie den passenden Treiber aus und fahren Sie mit der Geräte‑Konfiguration fort.

Cathexis stellt Konfigurations‑Tabs für das integrierte Gerät bereit, darunter Objekte, Objekt‑Eigenschaften, Geräte‑Ereignisse, Objekt‑Gruppen und Allgemeine Informationen, je nach Integration.

Cathexis‑API konfigurieren

Wichtig: GCXONE verwendet die Cathexis API um Informationen wie Standort Details, Kameraresourcen, Live‑Feeds, aufgezeichnete Tracks, Referenzbilder und unterstützte Steuerungen abzurufen. Die Cathexis‑API nutzt den Standard‑HTTP‑API‑Port 33104/TCP. Wenn HTTPS erforderlich ist, verwenden Sie einen SSL/TLS‑Proxy vor der API, wie in der Cathexis‑API‑Dokumentation beschrieben.

Cathexis‑Konfigurationshandbuch mit GCXONE

GCXONE‑Konfiguration

In der Service Provider Einstellungen, öffnen Sie Zusätzliche Einstellungen → Benutzerdefinierte Eigenschaft und fügen Sie die folgende Eigenschaft hinzu:

• Parametertyp: String
• Parametername: Cathexis_Device_Custom_baseUrl
• Parameterwert: https://cathexisproxy.nxgen.cloud/

Konfigurationsanforderungen

Wenn Sie das Cathexis‑Gerät in GCXONE hinzufügen, geben Sie die folgenden Details ein:

1. Gerät: Cathexis
2. Name:Ein Name für das Gerät.
3. IP Adresse oder Host Name:Die IP Adresse oder der Hostname des von GCXONE erreichbaren Cathexis-Servers.
4. Nutzername:Gültige Cathexis‑Benutzeranmeldedaten mit dem erforderlichen API‑Zugriff.
5. Passwort:Passwort für den konfigurierten Cathexis‑Benutzer.
6. Aktivieren Sie HTTPS:Aktivieren Sie diese Option, wenn die Cathexis‑API für die Verwendung von HTTPS konfiguriert ist.
7. HTTP Port:Der für die Cathexis‑API‑Kommunikation konfigurierte HTTP‑Port.
8. HTTPS Port:Geben Sie den HTTPS‑Port ein, wenn HTTPS aktiviert ist.
9. Zeitzone:Wählen Sie die Gerätezeitzone aus.