Aller au contenu

QoS Agent — modems Teltonika

Installer et exécuter le moniteur QoS LatenceTech sur un RUTX50 Teltonika (RutOS) à l’aide du paquet .ipk fourni.

Vous avez besoin de :

  • un accès SSH en root sur le routeur
  • les valeurs du site : ID d’agent, ID client, reflector, analyzer, noms

Remplacez 192.168.1.1 par l’IP LAN de votre routeur là où elle apparaît.


1. Télécharger et envoyer le paquet

Sur votre ordinateur, téléchargez la version fournie par LatenceTech :

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

Puis copiez-la sur le routeur :

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

2. Installer les paquets système

ssh root@192.168.1.1
opkg update

opkg install python3
opkg install iperf3

Vous pouvez aussi installer ces 2 paquets depuis l’interface Web : System → Package Manager


3. Radio et GPS (vérifications recommandées)

La SIM / mobile doit être enregistrée pour les métriques radio :

gsmctl -q

Si vous voyez N/A, activez la SIM et l’APN dans l’interface Web (Status → Network → Mobile), puis réessayez.

GPS (optionnel) : interface Web → Services → GPS → Enabled, antenne avec vue du ciel. Tant qu’il n’y a pas de fix, la position peut utiliser la valeur statique de la config (LTI_agent_gps_pos si définie).


4. Installer l’agent QoS

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

Un avertissement de « paquet non signé » est normal pour un fichier local.

Sous RutOS, les fichiers se trouvent en général sous /usr/local/… (par exemple /usr/local/usr/lib/lti-qos/). Le service est disponible via /etc/init.d/lti-qos.


5. Configurer le site

vi /etc/lti-qos.env

Si ce chemin est absent, essayez :

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

Mettez entre guillemets les valeurs qui contiennent des espaces. Exemple (à adapter à votre site) :

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"

Au démarrage, le service écrit LTI_analyzer dans /etc/hosts sous le nom msgbus.latence.ca (et redémarre dnsmasq seulement si ce mapping a changé). Vous n’avez pas besoin d’éditer /etc/hosts à la main pour joindre l’analyzer.


6. Démarrer le service

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

Commandes courantes

/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     # démarrer au boot
/etc/init.d/lti-qos disable    # ne pas démarrer au boot

Journaux

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

Démarrage sain (exemple)

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

Mise à jour (nouvelle version du paquet)

  1. Sur votre ordinateur, téléchargez le nouveau paquet et envoyez-le (wget + scp comme à l’étape 1).
  2. Sur le routeur :
opkg install /tmp/lti-qos-agent.ipk
/etc/init.d/lti-qos restart

Votre fichier /etc/lti-qos.env modifié est conservé. En général, vous n’avez pas besoin de désinstaller le paquet d’abord.

Si la mise à jour échoue :

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

Arrêt / désinstallation

/etc/init.d/lti-qos stop
/etc/init.d/lti-qos disable
# suppression complète (conserve un env modifié sauf si vous le supprimez) :
opkg remove lti-qos
rm -f /etc/lti-qos.env /usr/local/etc/lti-qos.env

Dépannage

Symptôme Que faire
gsmctl -q → N/A Insérer/activer la SIM ; définir l’APN ; WebUI Status → Network → Mobile
GPS toujours 0,0 / gpsd … Not found Activer Services → GPS ; antenne à l’extérieur ; ou définir LTI_agent_gps_pos en statique
python3: not found / le service redémarre en boucle opkg install python3, puis /etc/init.d/lti-qos restart
Aucune ligne dans un fichier de log Utiliser logread -f (les logs vont dans le journal système)
PacketLoss … Connection refused Depuis le routeur : nc -vz <reflector> 12555 — vérifier opérateur/pare-feu/ACL
iperf ne démarre jamais opkg install iperf3 et définir LTI_iperf3_exec=iperf3
Deux agents en cours Retirer tout ancien bloc python3 main.py de /etc/rc.local
Radio du tableau de bord vide / bizarre Confirmer que la SIM est enregistrée (gsmctl -q) ; redémarrer le service

Pour le support, contactez LatenceTech avec votre ID d’agent et un court extrait de logread après le démarrage.