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
rootsur 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)
- Sur votre ordinateur, téléchargez le nouveau paquet et envoyez-le (
wget+scpcomme à l’étape 1). - 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.