Cathexis VMS

Inleiding

De GCXONE–Cathexis integratie verbindt de Cathexis video‑beheersomgeving met GCXONE, waardoor video‑ en gebeurtenisinformatie van een Cathexis‑installatie beschikbaar is binnen de GCXONE‑monitorworkflow.

CathexisVision fungeert als de videobeheerslaag, beheert aangesloten camera's, live‑ en opgenomen video, geïntegreerde apparaten, alarmen en ondersteunde camerafuncties zoals PTZ. Cathexis biedt tevens een integratiekader voor het aansluiten van externe systemen en apparaten via zijn integratiedatabase en API.

Via deze integratie communiceert GCXONE met de geconfigureerde Cathexis‑server en haalt de benodigde camera‑ en gebeurtenisinformatie op. Camerastreams kunnen worden benaderd via de Cathexis‑interfaces, terwijl apparaat‑ en gebeurtenisinformatie door GCXONE kan worden gebruikt voor monitoren en alarmafhandeling.

Reikwijdte van de integratie

De GCXONE–Cathexis integratie is gericht op het beschikbaar stellen van de benodigde video‑ en gebeurtenisfunctionaliteit van een CathexisVision‑systeem in GCXONE.

Voor een geconfigureerd Cathexis‑systeem kan GCXONE de volgende integratiegebieden ondersteunen:

• Camera‑detectie en identificatie — Haal de beschikbare camera's op en gebruik hun Cathexis‑camera‑ID's voor verdere bewerkingen.
• Live video — Toegang tot de live‑stream van de camera via de Cathexis‑video‑interface.
• Opgenomen video — Toegang tot opgenomen beeldmateriaal gekoppeld aan een camera wanneer nodig voor gebeurtenisonderzoek.
• Referentie‑beelden — Haal een referentie‑beeld van de camera op voor identificatie of gebeurtenisweergave.
• PTZ‑besturing — Bestuur ondersteunde PTZ‑camera's en voer ondersteunde PTZ‑bewerkingen uit, inclusief preset‑gerelateerde functies.
• Apparaat‑ en camera‑gebeurtenissen — Ontvang Cathexis‑gebeurtenis‑ en technisch alarm‑informatie, inclusief de bijbehorende cameragegevens indien beschikbaar.
• Gebeurtenis‑gerelateerde video — Gebruik de camera‑ en review‑track (opgenomen video) informatie die bij een alarm is inbegrepen om de relevante video die bij een gebeurtenis hoort te identificeren.
• Integratie met Cathexis‑apparaten en objecten — Cathexis gebruikt zijn integratiekader om geïntegreerde apparaten en hun objecten te koppelen aan camera's en gebeurtenissen.

Systeemarchitectuur

Veldlaag – Camera's en video‑apparaten

Dit is de fysieke laag waar video‑ en gerelateerde apparaatgegevens ontstaan.

Het kan omvatten:

• IP‑camera's
• Video‑eenheden / encoders
• I/O‑apparaten
• Camera's met ondersteunde analyse‑ of gebeurteniscapaciteiten

CathexisVision beheert deze apparaten en biedt toegang tot hun video, status en ondersteunde functies. Afhankelijk van de cameramogelijkheden kan Cathexis live‑feeds, opgenomen video, PTZ‑functies en camera‑gebeurtenissen leveren.

Cathexis‑platformlaag – CathexisVision

De CathexisVision‑server fungeert als de videobeheerslaag tussen de fysieke apparaten en GCXONE.

Het is verantwoordelijk voor:

• Beheren van aangesloten camera's en video‑bronnen
• Opname en het bieden van toegang tot opgeslagen video
• Beheren van camera beschikbaarheid en configuratie
• Verwerken van ondersteunde gebeurtenissen en alarmen
• Leveren van camera‑bronnen, live‑feeds en review‑tracks
• Leveren van ondersteunde PTZ‑ en I/O‑functies

De Cathexis API biedt GCXONE toegang tot deze bronnen via geauthenticeerde API‑interfaces.

Integratielaag – GCXONE

De GCXONE‑integratielaag maakt verbinding met de CathexisVision‑omgeving en haalt de bronnen op die GCXONE nodig heeft.

Op dit niveau doet GCXONE:

• Ontdekt en identificeert beschikbare camera's
• Haalt camera‑informatie en beschikbare streams op
• Toegang tot live‑ en opgenomen video
• Verwerkt ondersteunde PTZ‑bewerkingen
• Haalt referentie‑afbeeldingen op waar nodig
• Ontvangt en verwerkt ondersteunde gebeurtenis‑ en alarminformatie

Cathexis levert camera‑ID’s, live‑feed‑URL’s, review‑tracks (opgenomen video) en ondersteunde PTZ‑informatie via de API, die GCXONE gebruikt om deze bewerkingen uit te voeren.

Monitorlaag – GCXONE

De monitorlaag is waar de geïntegreerde Cathexis‑informatie beschikbaar wordt voor operators via GCXONE.

Operators kunnen GCXONE gebruiken om:

• Live‑camera‑video bekijken
• Opgenomen beeldmateriaal bekijken waar ondersteund
• Alarmen en gebeurtenissen ontvangen en onderzoeken
• Toegang tot ondersteunde PTZ‑besturingen

Deze laag biedt de operator‑gerichte weergave terwijl CathexisVision de onderliggende video‑infrastructuur en opname‑omgeving blijft beheren.

Cathexis‑configuratie

Deze sectie beschrijft de CathexisVision‑configuratie die vereist is voordat het Systeem wordt gekoppeld aan GCXONE. Voltooi de stappen in de onderstaande volgorde zodat camera's, videostreams, gebeurtenissen en technische alarmen beschikbaar zijn voor de GCXONE‑integratie.

Opmerking: De exacte beschikbare opties kunnen variëren afhankelijk van de CathexisVision‑versie, geïnstalleerde drivers en gelicentieerde functies.

Stap 1: Maak of selecteer de Cathexis‑site

Een Site groepeert de Cathexis‑servers en -bronnen die tot dezelfde uitrol behoren. Camera's en geïntegreerde apparaten worden geconfigureerd op de servers binnen de site. Als de Cathexis‑server al is geïnstalleerd als een single‑server‑site, gebruik dan de bestaande site in plaats van een nieuwe aan te maken.

Navigatie: Bestand → Onderneming manager

Maak of selecteer de vereiste site en controleer of de Cathexis‑server beschikbaar is.

Stap 2: Camera's toevoegen en verifiëren

Voeg de camera's toe die via GCXONE worden gemonitord.

Navigatie: Site → Open → Setup → Servers configureren → Camera's

Klik Nieuw om de Nieuwe camera wizard. Cathexis levert de vereiste verbindingsvelden op basis van het geselecteerde camera‑driver.

Voer de vereiste verbindingsdetails in:

• Driver
• IP-adres
• Video‑invoer, indien van toepassing
• Poort
• Login (camera‑gebruikersnaam)
• Wachtwoord (camera‑wachtwoord)

Selectie camera‑driver

Camera's kunnen worden toegevoegd met behulp van camera‑specifieke driver of de Generieke encoder driver.

• Camera‑specifieke driver: Ondersteunt de integratiemogelijkheden die de geselecteerde driver biedt, inclusief streaming, gebeurtenissen en PTZ waar ondersteund.
• Generieke encoder: Kan worden gebruikt wanneer een camera‑specifieke driver niet beschikbaar is. Met de Generieke encoder‑driver worden livestreaming en gebeurtenissen ondersteund, maar PTZ‑besturing is niet beschikbaar.

Aanbevolen: Gebruik de camera‑specifieke driver wanneer het vereiste cameramodel wordt ondersteund. Gebruik Generieke encoder wanneer alleen streaming‑ en gebeurtenisfunctionaliteit vereist is.

De camera moet succesvol verbonden zijn en video weergeven voordat u doorgaat.

Camera‑verificatie

Controleer na het toevoegen van de camera dat:

• Livestream is beschikbaar.
• De camera geeft geen verbindingsfout weer.
• De vereiste opname‑configuratie is beschikbaar indien afspelen vereist is.

Dit zorgt ervoor dat GCXONE de camera‑informatie en video‑bronnen via Cathexis kan ophalen.

Stap 3: Configureer het GCXONE API Base Station

Voor gebeurtenislevering gebruikt Cathexis een API Base Station als bestemming voor alarmen.

De Base Station moet wijzen naar de GCXONE service endpoint die Cathexis-alarmen ontvangt.

Navigatie: Site → Setup → Configure Servers → Base-stations

Maak een nieuwe Base Station aan en selecteer:

• Naam: Een beschrijvende naam, bijvoorbeeld API-BASE
• Type: API
• Adres: https://cathexisproxy.nxgen.cloud/eventIngest
• Poort: 443
• Gebruiker:Voer u de Device ID van het apparaat in vanuit GCXONE. GCXONE gebruikt deze om binnenkomende alarmen aan het juiste apparaat te koppelen.

Cathexis ondersteunt Base Stations van het type API voor het verzenden van alarmen naar een extern systeem.

Belangrijk: Het GCXONE‑eindpunt moet bereikbaar zijn vanaf de Cathexis‑server. Netwerk‑/firewall‑regels moeten de Cathexis‑server toestaan de alarm‑verzoeken naar het geconfigureerde GCXONE‑eindpunt te verzenden.

Stap 4: Event‑alarm configureren

Cathexis‑events bepalen wanneer een alarm wordt gegenereerd en welke actie moet worden uitgevoerd.

Zorg ervoor dat de benodigde resources al geconfigureerd zijn voordat u een event maakt, zoals:

• Camera
• Video‑analyse of bewegingstrigger, indien vereist
• Opname‑database (zie Stap 7)
• Andere vereiste inputs of triggers

Cathexis raadt aan deze resources te configureren vóór het aanmaken van het event.

Navigatie: Site → Setup → Configure Servers → Events

Klik op Nieuw om het vereiste event aan te maken.

Configureer het event volgens het vereiste monitoringsscenario en selecteer de juiste trigger (bewegingsopnames worden aanbevolen). Stel de trigger Hold‑tijd naar 0 zodat gebeurtenissen onmiddellijk naar GCXONE worden verzonden.

Gebeurtenisbeschrijving

• Naam: Voer een duidelijke alarmnaam in (optioneel).
• Beschrijving (belangrijk): Voer $input_name.

De Beschrijving geconfigureerd voor de gebeurtenis wordt opgenomen in de alarminfo die via de Cathexis API wordt verzonden.

Stap 5: Configureer de gebeurtenis om de GCXONE Base Station aan te roepen

Na het aanmaken van de gebeurtenistrigger, configureert u de Actie zodat het alarm wordt verzonden naar de GCXONE API Base Station.

Op de gebeurtenis Acties tab, klik Nieuw en voeg beide toe Camera opnemen en Base-station aanroepen. Beide zijn vereist zodat camerainformatie wordt meegestuurd met elke gebeurtenis.

Selecteer de GCXONE API Base Station die u in Stap 3 heeft aangemaakt als bestemming.

Cathexis ondersteunt een primaire Eerste poging Base Station en een optionele Tweede poging Base Station als een secundaire bestemming vereist is.

Selecteer alle selectievakjes op het Base-station aanroepen en Alarmvoorbeeld tabbladen.

Op het Resources tab, selecteer Gebruik trigger resources onderaan.

Stap 6: Configureer Technische alarmen

Technische alarmen worden gebruikt voor systeem‑ of infrastructuurcondities in plaats van normale camera‑gebeurtenissen.

Voorbeelden die door Cathexis worden ondersteund omvatten:

• Camera‑storingen
• Database‑problemen
• Schijf‑fouten
• Netwerkconnectiviteit
• Opname‑fout
• Software‑fout
• Integratie database‑problemen
• Server‑monitoringcondities

Navigatie: Site → Setup → Configureer Servers → Technische alarmen

Maak u de individuele technische alarmen aan die nodig zijn voor de implementatie.

Voor elk technisch alarm, configureer u:

• Beschrijvende alarmnaam (optioneel)
• Vereiste technische conditie
• Herhaalt u alarmen maximaal één keer per, indien vereist
• Call base-station ingeschakeld, met de GCXONE API Base Station geselecteerd

Stap 7: Configureer de Database

Cathexis‑integraties gebruiken een toegewijde Database. Als de database nog niet eerder op de server is geïnitialiseerd, initialiseert u deze voordat u de integratie configureert.

Navigatie: Site → Setup → Databases

Indien vereist:

1. Initialiseer de database.
2. Selecteer de juiste partitie.
3. Wijs de vereiste databasegrootte toe.
4. Maak de vereiste integratiedatabase aan.

De database wordt door Cathexis gebruikt om integratiegerelateerde gegevens en gebeurtenissen op te slaan.

Stap 8: Integratie‑apparaten configureren

Als de GCXONE‑integratie Cathexis gebruikt Integratie‑apparaten, configureer ze via de Integratie‑apparaten paneel.

Navigatie: Setup → Servers configureren → Integratie‑apparaten

Klik op Nieuw apparaat, selecteer de juiste driver en ga verder met de apparaatconfiguratie.

Cathexis biedt configuratietabbladen voor het geïntegreerde apparaat, waaronder Objecten, Objecteigenschappen, Apparaat‑gebeurtenissen, Objectgroepen en Algemene info, afhankelijk van de integratie.

Configureer de Cathexis API

Belangrijk: GCXONE gebruikt de Cathexis API om informatie op te halen zoals site gegevens, camerabronnen, live‑feeds, opgenomen tracks, referentie‑afbeeldingen en ondersteunde besturingen. De Cathexis API gebruikt de standaard HTTP API‑poort 33104/TCP. Indien HTTPS vereist is, gebruik een SSL/TLS‑proxy voor de API, zoals beschreven in de Cathexis API documentatie.

Cathexis Config Guide met GCXONE

GCXONE Configuration

In de Service Provider instellingen, open Additional settings → Custom Property en voeg de volgende eigenschap toe:

• Parametertype: String
• Parameternaam: Cathexis_Device_Custom_baseUrl
• Parameterwaarde: https://cathexisproxy.nxgen.cloud/

Configuratievereisten

Wanneer u het Cathexis apparaat toevoegt in GCXONE, voert u de volgende gegevens in:

1. Apparaat: Cathexis
2. Naam: Een naam voor het apparaat.
3. IP Address of Hostnaam: Het IP address of hostnaam van de Cathexis‑server die toegankelijk is vanuit GCXONE.
4. Gebruikersnaam: Geldige Cathexis‑gebruikersreferenties met de vereiste API‑toegang.
5. Wachtwoord: Wachtwoord voor de geconfigureerde Cathexis‑gebruiker.
6. HTTPS inschakelen: Schakel deze optie in als de Cathexis‑API is geconfigureerd om HTTPS te gebruiken.
7. HTTP poort: De HTTP poort geconfigureerd voor Cathexis‑API‑communicatie.
8. HTTPS poort: Voer de HTTPS poort in wanneer HTTPS is ingeschakeld.
9. Tijdzone: Selecteer de apparaat‑tijdzone.