Vaidio-Installation

Diese Seite enthält Anleitungen für zwei Installationen:

• Der Integrationsdienst

  • Läuft auf einem Windows-Rechner, der auf Vaidio zugreifen kann, verfügt über einen Einrichtungsassistenten und ein Kontrollkästchen zum Einbinden der IdentityMatch-Datenbankinstallation.

  • Fordern Sie die signierte Datei VaidioIntegrationServiceSetup.exe bei Mirasys an.

• Das Forensic Search-Plugin

  • Ein separates, optionales Plugin-Paket (.spi), das in Spotter installiert wird.

  • Fordern Sie das signierte ToolPluginIntegrationServer.spi-Paket bei Mirasys an.

Installation des Vaidio-Integrationsdienstes

1. Klicken Sie mit der rechten Maustaste auf die Datei VaidioIntegrationServiceSetup.exe und wählen Sie Als Administrator ausführen.

2. Lassen Sie das Kontrollkästchen deaktiviert und klicken Sie auf Installieren, wenn keine Datenbankinstallation erforderlich ist. Wenn Sie die Datenbank installieren möchten, aktivieren Sie das Kontrollkästchen IdentityMatch-Datenbank installieren (PostgreSQL 16), legen Sie das Superuser-Passwort für PostgreSQL fest und klicken Sie auf Installieren.

   1. Um sicherzustellen, dass Sie die für Ihre Anforderungen geeignete Option auswählen, lesen Sie bitte die Anweisungen zur optionalen Datenbanknutzung, bevor Sie mit der Installation fortfahren.

      1. Wenn Sie die Datenbankinstallation ausgewählt haben, finden Sie die Dokumentation hier.

3. Klicken Sie auf Weiter.

4. Wählen Sie Ich akzeptiere die Bedingungen der Lizenzvereinbarung aus und klicken Sie auf Weiter.

   1. Wenn Sie die Bedingungen nicht akzeptieren, können Sie die Installation nicht fortsetzen.

5. Führen Sie optional die Serverlizenzierung durch (dies kann auch nach der Installation erfolgen) und klicken Sie auf Weiter.

6. 1. Auf dem Lizenzierungsbildschirm wird die Hardware-ID des Computers angezeigt, und Sie können die Lizenzdatei (.lic) auswählen.

6. Ändern Sie gegebenenfalls den Installationsort und klicken Sie auf Weiter.

   1. Der Standardinstallationsort lautet C:\Program Files\DVMS\VaidioIntegration.

7. Geben Sie optional die Konfigurationsdaten ein (dies ist auch nach der Installation möglich) und klicken Sie auf Weiter.

   1. Vaidio-Adresse und -Port (voreingestellt: 127.0.0.1 und 80)

   2. Vaidio-Benutzername und -Passwort

   3. Der Admin-API-Schlüssel und der Benutzer-API-Schlüssel

8. Klicken Sie auf Installieren.

9. Klicken Sie auf Fertig stellen.

Nachdem die Installation abgeschlossen ist, können Sie die Installation überprüfen, um sicherzustellen, dass alles ordnungsgemäß funktioniert.

Hinzufügen der Datenbank (IdentityMatch)

Wenn Sie sich dafür entscheiden, die Datenbank in die Installation einzubeziehen (siehe Schritt 2 unter Installation des Vaidio-Integrationsdienstes), beachten Sie bitte Folgendes:

• Wenn PostgreSQL 15/16 bereits vorhanden ist, wird es erkannt und weiterverwendet; in diesem Fall muss DB_PASSWORD dem bestehenden Superuser-Passwort dieser Instanz entsprechen. Andernfalls wird das eingebettete PostgreSQL 16 als Dienst AdvPostgreSql16 auf Port :5432 installiert.

• Das Installationsprogramm richtet eine Anwendungsrolle mit minimalen Berechtigungen (vaidio) ein, die Eigentümerin einer dedizierten Datenbank (vaidiointegration) ist. Sie geben lediglich das Superuser-Passwort (DB_PASSWORD) an; das Passwort für die Anwendungsrolle wird generiert und ausschließlich in die Verbindungszeichenfolge geschrieben.

• IdentityMatch und die Datenbank sind aktiviert; der Dienst erstellt sein Schema beim ersten Start.

Konfiguration nach der Installation

Ein nicht konfigurierter Server antwortet:

• GET /_health → 503 Unhealthy, wobei jede fehlende Einstellung und der vollständige Pfad der zu bearbeitenden Datei aufgeführt werden.

• Jeder funktionsfähige Endpunkt → 503, mit derselben Erklärung im Textkörper.

• GET /api/v1/version → 200 (das Plugin meldet also „nicht konfiguriert“ statt einer Versionsinkongruenz).

So schließen Sie die Konfiguration nach der Installation ab:

1. Gehen Sie zum Startmenü → Mirasys → Vaidio-Integrationskonfiguration bearbeiten. Dadurch wird die Datei appsettings.Production.json mit erhöhten Rechten im Notepad geöffnet. Sie benötigen diese Verknüpfung: Die Datei ist nur für SYSTEM und Administratoren lesbar, sodass ein normal gestarteter Notepad (selbst von einem Administrator) die Fehlermeldung „Zugriff verweigert“ anzeigt. In der Datei wird jede Einstellung in einem Kommentar am Anfang erläutert.

2. Speichern Sie die Datei und starten Sie anschließend den Dienst ADVVaidioIntegration über services.msc neu.

3. Gehen Sie zum Startmenü → Mirasys → Vaidio Integration Health (oder <http://localhost:5194/_health), um den Vorgang zu überprüfen.

Die Konfigurationsdatei ist im JSON-Format, wobei Kommentare und abschließende Kommas zulässig sind. Wenn Sie die Datei fehlerhaft belassen, startet der Server dennoch, ignoriert die Datei und meldet die Zeile und Spalte des Syntaxfehlers unter /_health.

Überprüfen Sie die Installation

Überprüfen Sie nach der Installation die folgenden Punkte, um sicherzustellen, dass die Installation ohne Probleme abgeschlossen wurde:

• Der Dienst ADVVaidioIntegration („ADV Vaidio Integration Service“) läuft (automatischer Start, LocalSystem).

• Die Dateien befinden sich unter C:\Program Files\DVMS\VaidioIntegration.

• Der Dienst lauscht auf Port 5194, und die eingehende Firewall-Regel „ADV Vaidio Integration Service (TCP 5194)“ ist vorhanden.

• GET <http://localhost:5194/_health> → 200 Healthy, sobald Vaidio erreichbar ist und eine Lizenz vorhanden ist. (Ohne Lizenz geben funktionsfähige Endpunkte den Status 423 zurück; die Endpunkte für Status, Version und Lizenz reagieren weiterhin.)

Verbindung zu Vaidio herstellen

Die Verbindung zu Vaidio erfolgt ausschließlich über die Konfiguration (wird bei der Installation über die oben genannten Eigenschaften festgelegt oder durch Bearbeiten der Dienstkonfigurationsdatei und einen Neustart):

"Vaidio": { "Server": {
  "BaseUrl": "http://<vaidio-host>/",   // API port (:80, /ainvr/api). NOT :8000.
  "Username": "admin",
  "Password": "<password>"
}}

Verbindung überprüfen: Bei aktivierter Lizenz gibt der Aufruf von GET /api/v1/forensic-search/cameras die Vaidio-Kameras zurück, und der Aufruf von GET /api/v1/license zeigt Vaidio IsValid: true an, wenn die Authentifizierung bei Vaidio erfolgreich war.

Lizenz aktivierung

Eine Lizenz ist über die Hardware-ID an den Rechner gebunden und muss daher für jeden Rechner einzeln generiert werden (ausgestellt von Mirasys). So weisen Sie eine Lizenz zu:

1. Rufen Sie die Hardware-ID ab. Die ID ist an verschiedenen Stellen zu finden:

• • Auf dem Lizenzbildschirm des Installationsprogramms (siehe Schritt 5 bei der Installation des Vaidio-Integrationsdeinstes), wo sie kopiert werden kann;

  • In der Datei C:\Program Files\DVMS\VaidioIntegration\License\hardware-id.txt, die der Dienst bei jedem Start neu schreibt;

  • "C:\Program Files\DVMS\VaidioIntegration\Mirasys.IntegrationServer.exe" --hardware-id, wodurch die ID ausgegeben wird und das Programm beendet wird;

  • GET <http://<host>>:5194/api/v1/license/hardware-id, wofür der Admin-API-Schlüssel erforderlich ist.

Die Hardware-ID kann nicht zum Erstellen einer Lizenz verwendet werden.

2. Senden Sie die Hardware-ID an Mirasys, um eine license.lic-Datei zu erhalten.

3. Wenden Sie die Lizenz an. Dazu gibt es mehrere Möglichkeiten:

   • auf der Seite „Lizenz“ des Installationsprogramms, indem Sie die .lic-Datei auswählen

   • bei der Installation über LICENSE_FILE=...

   • indem Sie die Datei unter C:\Program Files\DVMS\VaidioIntegration\License\license.lic ablegen und den Dienst neu starten

   • indem Sie sie zur Laufzeit hochladen (Admin-API-Schlüssel): POST /api/v1/license (Multipart-Datei, .lic, ≤1 MB) (kein Neustart erforderlich)

Solange keine gültige Lizenz vorliegt, geben funktionsfähige Endpunkte den HTTP-Status 423 zurück.

Kameras in Vaidio importieren (optional)

Der Dienst kann Kameras aus einem Mirasys-VMS-Kameraexport (CSV) in Vaidio massenweise registrieren. Dies ist ein Vorgang, für den ein Admin-Schlüssel erforderlich ist:

• GET /api/v1/system/test-connection – Funktionsprüfung des Dienstes (Benutzerschlüssel).

• POST /api/v1/system/cameras/bulk-add – CSV-Datei hochladen (multipart/form-data, text/csv; Admin-Schlüssel).

Die CSV-Spalten entsprechen dem Mirasys-VMS-Export (Camera.Address, Camera.Port, Camera.Username, Camera.Password, Camera.Install.CameraType = RTSP oder Onvif, Camera.Name, StreamUrl, Camera.Description, Camera.Install.Manufacturer/Model, Camera.Location.Longitude/Latitude). RTSP-Kameras verwenden StreamUrl als Quelle; ONVIF-Kameras erhalten die RTSP-URI über das ONVIF-Protokoll. Überspringen Sie diesen Schritt, wenn die Kameras des Kunden bereits in Vaidio registriert sind.

Kamerakonfiguration und Zuordnung

Die von Vaidio verwendeten Kameras müssen ebenfalls im Mirasys VMS konfiguriert werden. Für jede integrierte Kamera muss die Kamerakonfiguration im Mirasys VMS mit der in Vaidio konfigurierten Kamera übereinstimmen. Der Kameraname und die Details zum Videostream müssen übereinstimmen, damit die Integration eine Vaidio-Erkennung der richtigen Mirasys VMS-Kamera und -Aufzeichnung zuordnen kann.

Für Spotter-Funktionen, die VMS-Aufzeichnungen nutzen, ist eine korrekte Kameratoeweisung erforderlich, darunter:

• Öffnen eines forensischen Suchergebnisses in der Wiedergabe

• Anzeigen der zu einer Erkennung gehörenden Aufzeichnung

• Erstellen und Überprüfen von Storyboards

• Verfolgen von Erkennungen über mehrere Kameras hinweg

• Exportieren von Videoclips

• Exportieren von Schnappschüssen oder anderem Beweismaterial

• Öffnen synchronisierter Aufzeichnungen von zugehörigen Kameras

Vaidio stellt die Metadaten für die KI-Erkennung und die forensische Suche bereit, während das Mirasys-VMS das aufgezeichnete Videomaterial für die Wiedergabe, die Erstellung von Storyboards und den Export bereitstellt.

Installation und Konfiguration des Forensic Search-Plugins in Spotter

Das .spi-Paket wird im System Manager installiert, und die Spotter-Clients erkennen es automatisch. Anschließend kann es auf den Dienst verwiesen werden.

Beim Öffnen der Registerkarte überprüft das Plugin die Serverversion und zeigt eine Upgrade-Meldung an, falls der Server zu alt ist. Andernfalls stellt es über die konfigurierte Adresse und den API-Schlüssel eine Verbindung zur REST-API des Dienstes her.

Installieren Sie das Plugin-Paket (System Manager)

1. Laden Sie die Datei ToolPluginIntegrationServer.spi von Mirasys herunter und kopieren Sie sie auf den Rechner, auf dem System Manager ausgeführt wird.

2. Öffnen Sie in System Manager die Registerkarte System und wählen Sie Client-Plugin installieren.

3. Klicken Sie auf Neues Client-Plugin hinzufügen.

4. Wählen Sie die .spi-Datei aus. System Manager überprüft die Signatur des Pakets und lädt es in den SMServer-Plugin-Speicher hoch.

5. Forensic Search wird nun in der Liste der installierten Plugins angezeigt.

Spotter-Clients laden das Plugin bei Bedarf vom SMServer herunter, sodass die Benutzer lokal nichts installieren müssen. Ein bereits ausgeführter Client muss neu gestartet werden, bevor die Registerkarte angezeigt wird.

Richten Sie das Plugin auf den Dienst aus (zentralisierte Einstellungen im System Manager)

Das Plugin liest seine Verbindungsdaten aus den zentralisierten Einstellungen von Spotter, die einmalig im System Manager konfiguriert werden:

1. Stellen Sie sicher, dass Forensic Search im System Manager installiert bzw. registriert ist (starten Sie den SMServer neu, falls es nicht angezeigt wird).

2. Öffnen Sie die Registerkarte Profile → wählen Sie das aktuelle Profil aus.

3. Ändern Sie auf der Registerkarte Geräte die Quelle auf „Client-Plugins“, wählen Sie links Forensic Search und rechts eine Gerätegruppe aus und fügen Sie diese dem Profil hinzu.

4. Klicken Sie auf die Schaltfläche „→“, füllen Sie die Einstellungsfelder aus und klicken Sie auf OK.