Saltar a contenido

QoS Agent — módems Teltonika

Instalar y ejecutar el monitor QoS de LatenceTech en un RUTX50 de Teltonika (RutOS) mediante el paquete .ipk proporcionado.

Necesita:

  • acceso SSH como root al router
  • los valores del sitio: ID de agente, ID de cliente, reflector, analyzer, nombres

Sustituya 192.168.1.1 por la IP LAN de su router allí donde aparezca.

1. Descargar y enviar el paquete

En su ordenador, descargue la versión proporcionada por LatenceTech:

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

A continuación, cópiela en el router:

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

2. Instalar los paquetes del sistema

ssh root@192.168.1.1
opkg update

opkg install python3
opkg install iperf3

También puede instalar estos 2 paquetes desde la interfaz web: System → Package Manager

3. Radio y GPS (comprobaciones recomendadas)

La SIM / red móvil debe estar registrada para las métricas de radio:

gsmctl -q

Si ve N/A, active la SIM y el APN en la interfaz web (Status → Network → Mobile) y vuelva a intentarlo.

GPS (opcional): interfaz web → Services → GPS → Enabled, con la antena con vista al cielo. Mientras no haya fix, la posición puede utilizar el valor estático de la configuración (LTI_agent_gps_pos si está definido).

4. Instalar el agente QoS

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

Una advertencia de «paquete no firmado» es normal para un archivo local.

En RutOS, los archivos suelen encontrarse en /usr/local/… (por ejemplo /usr/local/usr/lib/lti-qos/). El servicio está disponible a través de /etc/init.d/lti-qos.

5. Configurar el sitio

vi /etc/lti-qos.env

Si esta ruta no existe, pruebe:

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

Ponga entre comillas los valores que contengan espacios. Ejemplo (adáptelo a su sitio):

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"

Al arrancar, el servicio escribe LTI_analyzer en /etc/hosts con el nombre msgbus.latence.ca (y reinicia dnsmasq solo si esa asignación ha cambiado). No necesita editar /etc/hosts manualmente para llegar al analyzer.

6. Iniciar el servicio

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

Comandos habituales

/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     # iniciar al arrancar
/etc/init.d/lti-qos disable    # no iniciar al arrancar

Registros

logread -f
# o bien:
logread | grep -i "LT QoS"

Arranque correcto (ejemplo)

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

Actualización (nueva versión del paquete)

  1. En su ordenador, descargue el nuevo paquete y envíelo (wget + scp como en el paso 1).
  2. En el router:
opkg install /tmp/lti-qos-agent.ipk
/etc/init.d/lti-qos restart

Su archivo /etc/lti-qos.env modificado se conserva. Por lo general, no es necesario desinstalar el paquete primero.

Si la actualización falla:

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

Detención / desinstalación

/etc/init.d/lti-qos stop
/etc/init.d/lti-qos disable
# eliminación completa (conserva un env modificado salvo que lo elimine):
opkg remove lti-qos
rm -f /etc/lti-qos.env /usr/local/etc/lti-qos.env

Resolución de problemas

Síntoma Qué hacer
gsmctl -q → N/A Insertar/activar la SIM; definir el APN; WebUI Status → Network → Mobile
GPS siempre en 0,0 / gpsd … Not found Activar Services → GPS; antena en el exterior; o definir LTI_agent_gps_pos como valor estático
python3: not found / el servicio se reinicia en bucle opkg install python3 y después /etc/init.d/lti-qos restart
Ninguna línea en un archivo de registro Utilizar logread -f (los registros van al registro del sistema)
PacketLoss … Connection refused Desde el router: nc -vz <reflector> 12555 — verificar operador/cortafuegos/ACL
iperf nunca arranca opkg install iperf3 y definir LTI_iperf3_exec=iperf3
Dos agentes en ejecución Eliminar cualquier bloque antiguo python3 main.py de /etc/rc.local
Radio del panel de control vacía / extraña Confirmar que la SIM está registrada (gsmctl -q); reiniciar el servicio

Para obtener soporte, póngase en contacto con LatenceTech indicando su ID de agente y un breve extracto de logread tras el arranque.