QoSエージェント — Teltonikaモデム
提供される .ipk パッケージを使い、Teltonika RUTX50(RutOS)上に LatenceTech QoSモニターをインストールして実行します。
必要なもの:
- ルーターへの
rootでのSSHアクセス - サイト値: エージェントID、顧客ID、リフレクター、アナライザー、名称
表示されている 192.168.1.1 は、ルーターのLAN IPに置き換えてください。
1. パッケージのダウンロードとアップロード
ノートPC上で、LatenceTechからリリースをダウンロードします:
wget https://api.latence.ca/software/lti-qos-agent.ipk
次にルーターへコピーします:
scp lti-qos-agent.ipk root@192.168.1.1:/tmp/
2. システムパッケージのインストール
ssh root@192.168.1.1
opkg update
opkg install python3
opkg install iperf3
Web UIの System → Package Manager からも、これら2つのパッケージをインストールできます。
3. 無線とGPS(推奨確認)
ラジオメトリクスのため、モバイル / SIM が登録されている必要があります:
gsmctl -q
N/A と表示される場合は、Web UI(Status → Network → Mobile)でSIMとAPNを有効にしてから再試行してください。
GPS(任意): Web UI → Services → GPS → Enabled、空が見えるアンテナ。測位が取れるまでは、設定の静的値(設定済みなら LTI_agent_gps_pos)を位置に使えます。
4. QoSエージェントのインストール
opkg install /tmp/lti-qos-agent.ipk
ローカルファイルでは「未署名パッケージ」の警告が出るのが普通です。
RutOSでは、ファイルは通常 /usr/local/… 配下(例: /usr/local/usr/lib/lti-qos/)に配置されます。サービスは /etc/init.d/lti-qos です。
5. サイトの設定
vi /etc/lti-qos.env
そのパスが無い場合は、次を試してください:
vi /usr/local/etc/lti-qos.env
スペースを含む値は引用符で囲みます。例(サイトに合わせて調整):
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"
起動時、サービスは LTI_analyzer を /etc/hosts に msgbus.latence.ca として書き込みます(そのマッピングが変わった場合のみ dnsmasq を再起動します)。アナライザーへ到達するために、手作業で /etc/hosts を編集する必要はありません。
6. サービスの起動
/etc/init.d/lti-qos enable
/etc/init.d/lti-qos start
日常コマンド
/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 # 起動時に開始
/etc/init.d/lti-qos disable # 起動時に開始しない
ログ
logread -f
# または:
logread | grep -i "LT QoS"
正常な起動(例)
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
更新(新しいパッケージ版)
- ノートPCで新しいパッケージをダウンロードし、アップロードします(手順1と同様に
wget+scp)。 - ルーター上で:
opkg install /tmp/lti-qos-agent.ipk
/etc/init.d/lti-qos restart
編集済みの /etc/lti-qos.env は保持されます。通常、先にパッケージを削除する必要はありません。
アップグレードに失敗した場合:
opkg remove lti-qos
opkg install /tmp/lti-qos-agent.ipk
vi /etc/lti-qos.env
/etc/init.d/lti-qos start
停止 / アンインストール
/etc/init.d/lti-qos stop
/etc/init.d/lti-qos disable
# 完全削除(変更済みenvは、削除しない限り残ります):
opkg remove lti-qos
rm -f /etc/lti-qos.env /usr/local/etc/lti-qos.env
トラブルシューティング
| 症状 | 対処 |
|---|---|
gsmctl -q → N/A |
SIMを挿入/有効化; APNを設定; WebUI Status → Network → Mobile |
GPSが常に 0,0 / gpsd … Not found |
Services → GPS を有効化; 屋外のアンテナ; または静的な LTI_agent_gps_pos を設定 |
python3: not found / サービスが再起動を繰り返す |
opkg install python3 の後 /etc/init.d/lti-qos restart |
| ログファイルに行が出ない | logread -f を使用(ログはシステムログへ) |
PacketLoss … Connection refused |
ルーターから: nc -vz <reflector> 12555 — キャリア/ファイアウォール/ACLを確認 |
| iperfが動かない | opkg install iperf3 と LTI_iperf3_exec=iperf3 を設定 |
| エージェントが二重起動 | /etc/rc.local から古い python3 main.py ブロックを削除 |
| ダッシュボードのラジオが空 / おかしい | SIM登録を確認(gsmctl -q); サービスを再起動 |
サポートには、エージェントIDと起動後の短い logread 抜粋を添えて LatenceTech に連絡してください。