Zum Inhalt

QoS Agent — Teltonika-Modems

Installation und Betrieb des LatenceTech-QoS-Monitors auf einem Teltonika RUTX50 (RutOS) mit dem bereitgestellten .ipk-Paket.

Sie benötigen:

  • SSH-Zugang als root zum Router
  • die Werte des Standorts: Agent-ID, Kunden-ID, Reflector, Analyzer, Namen

Ersetzen Sie 192.168.1.1 überall durch die LAN-IP Ihres Routers.

1. Paket herunterladen und übertragen

Laden Sie auf Ihrem Computer die von LatenceTech bereitgestellte Version herunter:

wget https://api.latence.ca/software/lti-qos-agent.ipk

Kopieren Sie sie anschließend auf den Router:

scp lti-qos-agent.ipk root@192.168.1.1:/tmp/

2. Systempakete installieren

ssh root@192.168.1.1
opkg update

opkg install python3
opkg install iperf3

Sie können diese 2 Pakete auch über die Weboberfläche installieren: System → Package Manager

3. Funk und GPS (empfohlene Prüfungen)

Die SIM / Mobilfunkverbindung muss für die Funkmetriken registriert sein:

gsmctl -q

Wenn Sie N/A sehen, aktivieren Sie SIM und APN in der Weboberfläche (Status → Network → Mobile) und versuchen Sie es erneut.

GPS (optional): Weboberfläche → Services → GPS → Enabled, Antenne mit freier Sicht zum Himmel. Solange kein Fix vorliegt, kann die Position den statischen Wert aus der Konfiguration verwenden (LTI_agent_gps_pos, falls gesetzt).

4. QoS-Agent installieren

opkg install /tmp/lti-qos-agent.ipk

Eine Warnung zu einem „nicht signierten Paket“ ist bei einer lokalen Datei normal.

Unter RutOS befinden sich die Dateien in der Regel unter /usr/local/… (zum Beispiel /usr/local/usr/lib/lti-qos/). Der Dienst ist über /etc/init.d/lti-qos verfügbar.

5. Standort konfigurieren

vi /etc/lti-qos.env

Wenn dieser Pfad nicht existiert, versuchen Sie:

vi /usr/local/etc/lti-qos.env

Setzen Sie Werte, die Leerzeichen enthalten, in Anführungszeichen. Beispiel (an Ihren Standort anpassen):

LTI_reflector="REFLECTOR_IP"
LTI_analyzer="ANALYZER_IP"
LTI_agent_id="1"
LTI_customer_id="0"
LTI_agent_verbose="INFO"
LTI_startup_delay="0"
LTI_agent_name="RUTX50 Office"
LTI_agent_hardware="RUTX50"
LTI_agent_net_type="5G"
LTI_agent_net_name="RUT_A923"
LTI_agent_address="Teltonika"
LTI_agent_details="Teltonika RUTX50"
LTI_icmp_interval="2"
LTI_tcp_interval="2"
LTI_udp_interval="2"
LTI_http_interval="2"
LTI_https_interval="2"
LTI_twamp_session_interval="5"
LTI_packetlossudp_interval="5"
LTI_iperf3_first_interval="30"
LTI_iperf3_session_interval="7200"
LTI_iperf3_exec="iperf3"
LTI_device_interval="20"
LTI_radio_interval="10"
LTI_gps_interval="30"

Beim Start schreibt der Dienst LTI_analyzer unter dem Namen msgbus.latence.ca in /etc/hosts (und startet dnsmasq nur neu, wenn sich diese Zuordnung geändert hat). Sie müssen /etc/hosts nicht manuell bearbeiten, um den Analyzer zu erreichen.

6. Dienst starten

/etc/init.d/lti-qos enable
/etc/init.d/lti-qos start

Häufige Befehle

/etc/init.d/lti-qos status
/etc/init.d/lti-qos start
/etc/init.d/lti-qos stop
/etc/init.d/lti-qos restart
/etc/init.d/lti-qos enable     # beim Booten starten
/etc/init.d/lti-qos disable    # beim Booten nicht starten

Protokolle

logread -f
# oder:
logread | grep -i "LT QoS"

Fehlerfreier Start (Beispiel)

Starting LatenceTech QoS_Monitor-…
Starting ICMP probe with interval 2.0s
Starting TCP probe with interval 2.0s
…
Starting TWAMP probe with interval 10.0s
Starting Iperf3 probe with interval 30.0s
Starting PacketLossUDP probe with interval 5.0s

Aktualisierung (neue Paketversion)

  1. Laden Sie auf Ihrem Computer das neue Paket herunter und übertragen Sie es (wget + scp wie in Schritt 1).
  2. Auf dem Router:
opkg install /tmp/lti-qos-agent.ipk
/etc/init.d/lti-qos restart

Ihre angepasste Datei /etc/lti-qos.env bleibt erhalten. In der Regel müssen Sie das Paket nicht zuerst deinstallieren.

Wenn die Aktualisierung fehlschlägt:

opkg remove lti-qos
opkg install /tmp/lti-qos-agent.ipk
vi /etc/lti-qos.env
/etc/init.d/lti-qos start

Beenden / Deinstallation

/etc/init.d/lti-qos stop
/etc/init.d/lti-qos disable
# vollständige Entfernung (behält eine angepasste env-Datei, sofern Sie sie nicht löschen):
opkg remove lti-qos
rm -f /etc/lti-qos.env /usr/local/etc/lti-qos.env

Fehlerbehebung

Symptom Maßnahme
gsmctl -q → N/A SIM einsetzen/aktivieren; APN festlegen; WebUI Status → Network → Mobile
GPS immer 0,0 / gpsd … Not found Services → GPS aktivieren; Antenne im Freien; oder LTI_agent_gps_pos statisch festlegen
python3: not found / Dienst startet in einer Schleife neu opkg install python3, dann /etc/init.d/lti-qos restart
Keine Zeilen in einer Protokolldatei logread -f verwenden (die Protokolle gehen in das Systemprotokoll)
PacketLoss … Connection refused Vom Router aus: nc -vz <reflector> 12555 — Betreiber/Firewall/ACL prüfen
iperf startet nie opkg install iperf3 und LTI_iperf3_exec=iperf3 festlegen
Zwei Agents laufen Jeden alten Block python3 main.py aus /etc/rc.local entfernen
Funkdaten im Dashboard leer / seltsam Bestätigen, dass die SIM registriert ist (gsmctl -q); Dienst neu starten

Für Support wenden Sie sich mit Ihrer Agent-ID und einem kurzen Auszug aus logread nach dem Start an LatenceTech.