Benutzerhandbuch für Ajax Translator PRO

Ajax Translator PRO ist ein Plugin zur Anbindung von Ajax Systemen an Überwachungssoftware von Drittanbietern. Als Bindeglied zwischen dem Space und einer Leitstelle wandelt der Ajax Translator PRO die Ajax Systemereignisse in NSL-unterstützte Protokolle um.

Ajax Translator PRO ist eine verbesserte Version der Ajax Translator App. Die aktuelle Ajax Translator App verfügt über eingeschränkte Leistung und Funktionalität. Ajax Translator PRO hingegen bietet eine verbesserte Bedienbarkeit, erweiterte Funktionen, ein verbessertes Status-Tracking und eine größere Flexibilität bei der Konfiguration. Es ist nicht nötig, zusätzliche Software zu installieren, denn alle Einstellungen werden direkt in der App Ajax PRO Desktop konfiguriert.

So erhalten Sie Ajax Translator PRO

Um Ajax Translator PRO zu erhalten, füllen Sie das Online-Formular auf der Website von Ajax Systems aus. Nach dem Absenden der Anfrage erhalten Sie eine Willkommens-E-Mail. Als Antwort auf diese E-Mail sollten Sie Einzelheiten zu Ihrer Systemeinrichtung angeben, Ihr Unternehmen in der App Ajax PRO Desktop registrieren und Ihre Unternehmens-ID senden. Anschließend erhalten Sie eine E-Mail mit dem Link zum Herunterladen von Ajax Translator PRO und Ihren Zugangsdaten.

Wenn Sie im Formular die Option Unternehmen zu den Ajax Apps hinzufügen ausgewählt haben, wird Ihr Unternehmen der Liste Sicherheitsunternehmen in den Ajax Apps hinzugefügt. Damit können Sie Benutzeranfragen zur Sicherheitsüberwachung direkt an Ajax Translator PRO weiterleiten. Ein Benutzer wählt Ihr Unternehmen aus der Liste in der App aus, tippt auf Überwachungsanfrage senden, und die Anfrage wird automatisch an die dem Sicherheitsunternehmen zugewiesene E-Mail-Adresse gesendet.

Systemanforderungen

Unterschiede zum Ajax Translator

Ajax Translator PRO ist in Ajax PRO Desktop integriert, während Ajax Translator eine separate App ist. Ajax Translator PRO bietet auch zusätzliche Funktionen im Vergleich zu Ajax Translator an:

• SIA-DCS-Codes;
• Kontonummern in HEX;
• Regeln für Ereigniscodes;
• zusätzliche Daten in den Ereignissen, wie Geräte- oder Gruppennamen;
• Möglichkeit, Kontonummern für Videogeräte separat von Hub-Zentralen hinzuzufügen;
• URLs zur Videoverifizierung von KI-gestützten Erkennungsereignissen von Ajax Kameras/NVRs im Widget Ajax PRO Desktop;
• Unterstützung für zusätzliche Ereignisübertragungsprotokolle;
• eine erhöhte Anzahl von Spaces, die mit dem Empfänger verbunden sind;
• Regelmäßige Funktionsaktualisierungen und Verbesserungen.

Funktionsprinzip

Ajax Translator PRO arbeitet als TCP-Client und verbindet sich über die in den Einstellungen angegebene Adresse und den Anschluss mit der Leitstelle.

Ajax Translator PRO funktioniert nur im Modus Speicherung und Weiterleitung. Jedes Ereignis, das von einem Space erzeugt und über den Ajax Cloud Server und Ajax Translator PRO an die Überwachungssoftware übertragen wird, muss bestätigt werden. Wenn ein Space ein Ereignis sendet, benötigt er lediglich eine Bestätigung von Ajax Cloud. Der Space nimmt nicht an der Kommunikation zwischen Ajax Cloud und der Leitstelle teil.

Ereignisübertragung

Wenn eine Verbindung zur Leitstelle verfügbar ist, werden Alarme sofort über das ausgewählte Protokoll übertragen. Ajax Translator PRO unterstützt die folgenden Protokolle zur Übertragung von Ereignissen an die Überwachungssoftware:

• SIA DC-09,

• Sur-Gard (Contact ID),

• Manitou,

• MASXML,

• Micro Key,

• SoftGuard,

• Sentinel,

• ADEMCO 685.

Übertragungskanäle und Formate

Ereignisse können über die Ajax Cloud, über die direkte Verbindung des Spaces zu Ajax Translator PRO oder über beide Kanäle gleichzeitig übertragen werden. Zur Übertragung von Ereignissen werden folgende Codeformate verwendet:

• SIA-DCS nur für Cloud-Verbindung,
• ADM-CID für sowohl Cloud- als auch Direktverbindungen.

So verbinden Sie die Hub-Zentrale direkt über das SIA DC-09-Protokoll mit der Leitstelle

Ajax Translator PRO verwendet eine einzige Schnittstelle für das Übertragungsnetzwerk und einen dedizierten Port für die direkte Verbindung mit einem lokalen Netzwerk. Ajax Translator PRO unterstützt die ATS-Kategorien SP1–SP5.

Wenn Ajax Translator PRO und die Ereignisempfänger der Leitstelle auf demselben Computer (lokaler Server) installiert sind, können sie über ein Paar virtueller serieller Ports (COM) verbunden werden. Sie können auch separate Computer über zwei physische serielle Ports (COM) verbinden.

Kapazität und Leistung

Der Ajax Translator PRO Empfänger arbeitet mit bis zu 50 000 verschiedenen Spaces. Wenn die Anzahl der verbundenen Spaces die empfohlene Grenze überschreitet, teilen Sie die Empfänger in mehrere Gruppen auf.

Ajax Translator PRO legt keine feste Grenze für die Anzahl der pro Sekunde verarbeiteten Ereignisse fest. Die maximale Ereignisverarbeitungsrate beträgt 50 Ereignisse pro Sekunde. Die tatsächliche Verarbeitungsgeschwindigkeit hängt von der Rechenleistung des Rechners ab, auf dem Ajax Translator PRO ausgeführt wird.

Ereignisspeicherung und -weiterleitung

Wenn die Verbindung zur Leitstelle während eines ausgelösten Alarms abbricht, werden alle gespeicherten Ereignisse automatisch übertragen, sobald die Verbindung wiederhergestellt ist.

Sicherheitsmechanismen

Ajax Translator PRO ist durch Sicherheitsmechanismen geschützt, die eine zuverlässige Kommunikation gewährleisten und unbefugte Eingriffe verhindern.

Schutz vor Denial-of-Service-Angriffen (DoS)

Ajax Translator PRO implementiert Schutzmechanismen gegen Denial-of-Service-Angriffe (DoS) in der Kommunikation zwischen einem Space, Ajax Cloud, Ajax Translator PRO und der Leitstelle.

Wenn das System ein anormales Verkehrsverhalten erkennt (mehr als 500 ungültige Nachrichten innerhalb von 5 Sekunden), wird die Verbindung zur Leitstelle automatisch getrennt. Ungültige Nachrichten umfassen zum Beispiel:

• Nachrichten ohne Sequenzkennung;
• Nachrichten, die nicht korrekt analysiert werden können.

Wenn diese Schutzregel ausgelöst wird, kann die Verbindung zur Leitstelle für 60 Sekunden nicht wiederhergestellt werden.

Der DoS-Schutz für Ajax Translator PRO basiert derzeit auf Sicherheitsmechanismen der Cloud-Infrastruktur. Der Ajax Cloud-Server nutzt die AWS Shield Advanced-Technologie, um seine Cloud-Ressourcen vor verteilten Denial-of-Service-Angriffen (DDoS) zu schützen.

Schutz vor Gerätevortäuschung

Ein Ajax System verhindert, dass eine Hub-Zentrale von einem anderen Gerät, einschließlich identischer oder gefälschter Geräte, manipuliert wird.

Nur Ajax Hub-Zentralen und Videogeräte können sich mit der Ajax Cloud verbinden und Systemereignisse erzeugen. Der Ajax Cloud-Server überprüft die Echtheit des Geräts, bevor jegliche Kommunikation akzeptiert wird.

Jede Hub-Zentrale wird durch einen proprietären Handshake-Prozess authentifiziert. Der zur Authentifizierung erforderliche kryptografische Schlüssel wird während der Herstellung in die Hub-Zentrale hochgeladen und kann während des Betriebs nicht verändert werden.

Ajax Cloud identifiziert jede Hub-Zentrale anhand ihrer eindeutigen Geräte-ID, die nicht geändert werden kann. Damit wird sichergestellt, dass eine im System registrierte Hub-Zentrale nicht unerkannt durch ein anderes Gerät ersetzt werden kann.

Die Verbindung zwischen der Hub-Zentrale und der Ajax Cloud ist durch einen von NIST zertifizierten kryptografischen Algorithmus geschützt.

Erfahren Sie mehr über die NIST-Zertifizierung

So fügen Sie den Translator-Empfänger hinzu

Sobald Sie Ajax Translator PRO erhalten haben:

1. Öffnen Sie die App Ajax PRO Desktop und melden Sie sich in Ihrem Konto an.

2. Gehen Sie zum Modul Unternehmen.

3. Gehen Sie zum Menü NSL-Aufschaltung.

4. Wählen Sie die Registerkarte Ajax Translator aus.

5. Klicken Sie auf die Schaltfläche Translator-Empfänger hinzufügen.

6. Legen Sie die erforderlichen Parameter fest: Name, Adresse (IP oder Domainname) und Anschluss.

7. Klicken Sie auf die Schaltfläche Hinzufügen.

Sie können bis zu 10 Empfänger für ein einzelnes Unternehmen hinzufügen. Das Gesamlimit von 10 Empfängern gilt für Ajax Cloud Signaling und Ajax Translator PRO-Empfänger zusammen. Es kann jeweils nur ein Empfänger gleichzeitig auf einem Gerät ausgeführt werden.

So binden Sie den Space an den Translator-Empfänger

Als Nächstes müssen Sie den Space mit dem Translator-Empfänger verbinden und die Kontonummer ausfüllen. So konfigurieren Sie diese Option in der App Ajax PRO Desktop:

1. Gehen Sie zum Modul Objekte.
2. Wählen Sie das Objekt aus, das Sie mit dem Empfänger verknüpfen möchten.
3. Klicken Sie auf Wartung, um die Überwachungszustände anzuzeigen.
4. Wählen Sie den gewünschten Translator-Empfänger aus.
5. Wählen Sie den Space aus, den Sie mit dem Empfänger verknüpfen möchten.
6. Geben Sie die Kontonummer an, die für an den Empfänger gesendete Nachrichten verwendet wird. Dies ist nicht die Kontonummer aus der Ajax PRO Desktop App, aber sie kann dieselbe sein. Alle Spaces, die einem Empfänger zugeordnet sind, haben eine einzigartige Kontonummer.
7. Klicken Sie auf Überwachung starten. Danach wechselt der Zustand Überwachung über <Name>Empfänger von Keine auf Aktiv.

Wie man Objekte von Ajax Translator migriert

Ein Ajax System ermöglicht es den Benutzern, Objekte, die an den Ajax Translator gebunden sind, unabhängig zu exportieren. Diese App erstellt eine CSV-Datei, die die ID der Hub-Zentrale und die Kontonummer aktiver Bindungen enthält. Die Datei kann dann zu Ajax PRO Desktop zum ausgewählten Empfänger von Translator oder Cloud Signaling hochgeladen werden.

Wie man Objekte von Ajax Translator zu Ajax Translator PRO migriert

So starten Sie den Translator-Empfänger

Wenn mindestens ein Translator-Empfänger erstellt wurde, kann Ajax Translator PRO heruntergeladen werden. So konfigurieren Sie diese Option in der App Ajax PRO Desktop:

1. Gehen Sie zum Modul Unternehmen.

2. Gehen Sie zum Men�� NSL-Aufschaltung.

3. Wählen Sie die Registerkarte Ajax Translator aus.

4. Klicken Sie auf den Button .

5. Wählen Sie einen Ordner, in dem Sie die Ajax Translator PRO App installieren möchten. Die Länge des Ordnerpfads ist auf 64 Zeichen begrenzt.

Wenn die App heruntergeladen ist, kann der leitende NSL-Techniker einen der Translator-Empfänger festlegen und starten. Um dies zu tun:

1. Wählen Sie den gewünschten Translator-Empfänger aus.
2. Geben Sie die erforderlichen Einstellungenan.
3. Klicken Sie auf die Schaltfläche In Translator App starten.

Stellen Sie vor dem Start der App sicher, dass das System die Anforderungen erfüllt und dass Java 21 installiert ist. Das Starten kann bis zu einer Minute dauern. Nach dem Start wird der Zustand Auf diesem Computer gestartet angezeigt.

Zustände

Die Zustände liefern Informationen über den Empfänger.

Einstellungen

So ändern Sie die Empfänger-Einstellungen in Ajax PRO Desktop:

1. Öffnen Sie das Modul Unternehmen.

2. Klicken Sie auf das Menü NSL-Aufschaltung.

3. Wählen Sie die Registerkarte Ajax Translator aus.

4. Wählen Sie den gewünschten Empfänger aus und klicken Sie auf das Symbol .

5. Stellen Sie die erforderlichen Parameter ein.

6. Klicken Sie auf Speichern.

Empfänger-Ereignisse

Ajax PRO Desktop bietet ein detailliertes Protokoll der Systemalarme und -ereignisse sowie der Aktionen von Mitarbeitern innerhalb der App. Protokolleinträge im Modul Ereignisprotokoll werden bis zu drei Jahre lang gespeichert. Ältere Einträge werden gelöscht. Alarmprotokolle enthalten einen Zeitstempel, wann das Ereignis im Space aufgetreten ist.

Der Firmeninhaber, Ingenieur, Leitender NSL-Techniker, Leiter des Betreiberteams, Betreiber und Leiter des Installationsteams haben Zugriff auf das Modul Ereignisprotokoll.

So zeigen Sie Empfängerereignisse an:

1. Wählen Sie das Modul Ereignisprotokoll aus der Modulliste in der oberen linken Ecke des Bildschirms aus.
2. Wählen Sie das Objekt aus.

Das Modul Ereignisprotokoll zeigt eine Liste der Empfängerereignisse an:

• Ein Mitarbeiter Ihres Unternehmens hat einen neuen Empfänger für die Überwachung über Ajax Cloud hinzugefügt.
• Ein Mitarbeiter Ihres Unternehmens hat die Empfängereinstellungen geändert.
• Ein Mitarbeiter Ihres Unternehmens hat den Empfänger gelöscht.
• Ajax Translator PRO hat die Verbindung zur Ajax Cloud verloren.
• Ajax Translator PRO hat die Verbindung zur Ajax Cloud wiederhergestellt.
• Ajax Translator PRO hat die Verbindung zur Leitstelle verloren.
• Ajax Translator PRO hat die Verbindung zur Leitstelle wiederhergestellt.
• Ein Mitarbeiter Ihres Unternehmens hat begonnen, das Objekt über den Empfänger zu überwachen.
• Ein Mitarbeiter Ihres Unternehmens hat die Kontonummer des Objekts für den Empfänger aktualisiert.
• Ein Mitarbeiter Ihres Unternehmens hat die Überwachung des Objekts über den Empfänger eingestellt.

Legen Sie den Bereich fest und wenden Sie ihn an, um Ereignisse nach Zeit zu filtern. Um einen Bericht auf der Grundlage der angegebenen Parameter zu erstellen, klicken Sie auf die Schaltfläche zur Berichterstellung neben dem Filternamen.

Zeitstempel und Zeitsynchronisation in den Protokollen

Die Zeitstempel der Protokolle beziehen sich auf das lokale Gerät, auf dem sie angezeigt werden. Dies setzt voraus, dass dessen Zeit mit der UTC-Serverzeit synchronisiert ist (die lokale Zeitzone wird dabei berücksichtigt). Wenn die lokale Rechnerzeit von der Serverzeit abweicht, zeigt das System eine Benachrichtigung mit Anweisungen zur Korrektur an.

Um Ajax Translator PRO mit der UTC-Zeit zu synchronisieren, aktivieren Sie die automatischen Einstellungen für Datum und Uhrzeit auf Ihrem Computer:

1. Gehen Sie zu den Einstellungen für Datum und Uhrzeit.
2. Aktivieren Sie das Kontrollkästchen, um die Zeitsynchronisierung mit dem Server zu aktivieren.

Wartung und Fehlerbehebung

In diesem Abschnitt wird beschrieben, wie Sie das Ajax Translator PRO-Plugin warten, häufige Probleme beheben und Diagnoseinformationen für das Support-Team erfassen.

Mehr erfahren

Windows-Update auf dem Computer, auf dem Ajax Translator PRO ausgeführt wird

Um sicherzustellen, dass Ajax Translator PRO nach einem Windows-Update ordnungsgemäß funktioniert, beenden Sie das Programm vor der Installation von Windows-Updates. Nach Abschluss des Updates und dem Neustart des Computers starten Sie Ajax Translator PRO und überprüfen Sie, ob es ordnungsgemäß funktioniert.

So aktualisieren Sie Windows sicher:

1. Beenden Sie Ajax Translator PRO.
2. Installieren Sie die Windows-Updates.
3. Starten Sie den Computer neu.
4. Starten Sie Ajax Translator PRO.
5. Überprüfen Sie, ob Ajax Translator PRO erfolgreich startet und alle Verbindungen wiederhergestellt wurden.

Wiederherstellung von Ajax Translator PRO nach einem unerwarteten Fehler

Wenn die App-Benachrichtigung Translator-App wurde unerwartet beendet erscheint, bedeutet dies, dass Ajax Translator PRO nicht mehr auf die Zustandsprüfungen der App Ajax PRO Desktop reagiert.

Eine mögliche Ursache ist unzureichender Arbeitsspeicher (RAM) oder unzureichender verfügbarer Speicherplatz (HDD, SSD oder NAS). Wenn dem Betriebssystem nicht genügend Speicher zur Verfügung steht, reagiert Ajax Translator PRO möglicherweise nicht mehr oder wird unerwartet beendet.

Systemanforderungen an den Arbeitsspeicher

	Mindestwert, GB	Empfohlen, GB
RAM	8	16
Verfügbarer Speicherplatz (HDD, SSD oder NAS)	50	100

Wenn die App-Benachrichtigung Translator-App wurde unerwartet beendet wiederholt erscheint, überprüfen Sie, ob der Host-Computer die Mindestsystemanforderungen erfüllt und ausreichend Speicher für Ajax Translator PRO zur Verfügung steht. Schließen Sie bei Bedarf andere speicherintensive App.

So starten Sie den Ajax Translator PRO neu:

1. Öffnen Sie den Task-Manager auf dem Computer.
2. Gehen Sie auf die Registerkarte Details.
3. Suchen Sie den mit dem betroffenen Ajax Translator PRO verknüpften Java-Prozess.
4. Falls der Prozess noch läuft, klicken Sie mit der rechten Maustaste darauf und wählen Sie Task beenden.
5. Bestätigen Sie, dass der Prozess beendet wurde.
6. Falls das Support-Team Sie dazu auffordert, sammeln Sie bitte die Protokolle von Ajax Translator PRO, bevor Sie das Plugin neu starten.
7. Kehren Sie zur Ajax PRO Desktop-App zurück.
8. Starten Sie Ajax Translator PRO erneut aus der Ajax PRO Desktop-App.
9. Stellen Sie sicher, dass Ajax Translator PRO erfolgreich startet und alle Verbindungsstatus wiederhergestellt wurden.

Sollte das Problem nach dem Neustart von Ajax Translator PRO weiterhin bestehen, kontaktieren Sie das Support-Team und stellen Sie die gesammelten Protokolle bereit.

Behebung von Problemen mit Cloud-Verbindungsabbrüchen

Löschen Sie den Ordner Persistence nur dann, wenn Sie vom Support-Team dazu aufgefordert werden.

Wenn Ajax Translator PRO ausgeführt wird, aber den Zustand Cloud-Verbindung verloren anzeigt, prüfen Sie zuerst, ob die Netzwerkverbindung ordnungsgemäß funktioniert. Wenn keine Netzwerkverbindungsprobleme vorliegen und das Problem weiterhin besteht, führen Sie die folgenden Schritte aus, um den Ordner Persistence zu leeren, falls Sie vom Support-Team dazu aufgefordert werden.

So leeren Sie den Ordner „Persistence“:

1. Öffnen Sie den Task-Manager.

2. Suchen Sie den mit Ajax Translator PRO verknüpften Java-Prozess.

   

3. Klicken Sie mit der rechten Maustaste auf den Prozess und wählen Sie Task beenden.

4. Bestätigen Sie, dass der Prozess beendet wurde.

5. Öffnen Sie das Installationsverzeichnis von Ajax Translator PRO.

6. Löschen Sie den Persistence-Ordner, der mit dem betroffenen Ajax Translator PRO-Plugin verknüpft ist.

   

7. Starten Sie Ajax Translator PRO.

8. Überprüfen Sie, dass die Benachrichtigung in der App Cloud-Verbindung verloren nicht mehr auf dem Bildschirm angezeigt wird.

So finden Sie die Translator-ID

Viele Fehlerbehebungsverfahren und Protokollsammlungsvorgänge erfordern die Translator-ID.

So finden Sie die Translator-ID:

• Gehen Sie in der Ajax PRO Desktop-App zu Unternehmen → NSL-Aufschaltung → Ajax Translator.

• Wählen Sie den erforderlichen Translator aus.

• Öffnen Sie den Informationsbildschirm von dem Translator.

• Kopieren oder notieren Sie die Empfänger-ID.

  

Die Translator-ID wird für Folgendes verwendet:

• Eindeutiges Identifizieren des richtigen Translators, wenn mehrere Translatoren auf demselben Computer installiert sind.
• Lokalisieren des zugehörigen Protokollordners.
• Auswählen des richtigen Translators beim Übermitteln von Protokollen.
• Überprüfen, ob die Fehlerbehebungsverfahren am vorgesehenen Translator durchgeführt werden.

Senden von Protokollen aus Ajax PRO Desktop

Wenn Sie vom Support-Team dazu aufgefordert werden oder ein Problem beheben möchten, können Sie die Protokolle von Ajax Translator PRO direkt aus der App Ajax PRO Desktop senden.

So senden Sie Protokolle:

1. Gehen Sie in der Ajax PRO Desktop App zu Unternehmen → NSL-Aufschaltung → Ajax Translator.

2. Klicken Sie auf Problem melden.

3. Füllen Sie die erforderlichen Felder aus:

   • Name
   • E-Mail
   • Beschreibung

4. Wählen Sie den betroffenen Translator aus der Liste aus.

5. Klicken Sie bei Bedarf auf Alle auswählen, um Protokolle aller konfigurierten Translator einzubeziehen.

6. Klicken Sie auf Senden.

Wenn mehrere Translator konfiguriert sind, verwenden Sie die Translator-ID, um den richtigen auszuwählen.

Manuelles Sammeln von Protokollen

Falls vom Support-Team angefordert, können Sie die Protokolle von Ajax Translator PRO manuell erfassen und bei Bedarf den Inhalt des Ordners Persistence abrufen.

Standardmäßig wird Ajax Translator PRO im Ordner Dokumente des Benutzers installiert:

C:\Users\<User_Name>\Documents\ajax-translator

Falls Ajax Translator PRO an einem benutzerdefinierten Speicherort installiert wurde, können Sie den Installationspfad über die Option Installationsordner öffnen auf der Registerkarte Ajax Translator in Ajax PRO Desktop überprüfen.

So erfassen Sie Protokolle manuell:

1. Öffnen Sie das Installationsverzeichnis von Ajax Translator PRO.
2. Öffnen Sie den Ordner Logs.
3. Suchen Sie den Ordner, der mit der erforderlichen Translator-ID verknüpft ist.
4. Komprimieren Sie den Ordner in ein ZIP-Archiv.
5. Falls vom Support-Team angefordert, archivieren Sie bitte auch den Ordner Persistence aus dem Installationsverzeichnis von Ajax Translator PRO.
6. Senden Sie die erstellten Archive an das Support-Team.

Technische Daten

Alle technischen Spezifikationen

Einhaltung von Normen

Zusätzliche Informationen

Technischen Support kontaktieren:

• email

• Telegram

Entwickelt von „AS Manufacturing“ GmbH