コンテンツにスキップ

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

更新(新しいパッケージ版)

  1. ノートPCで新しいパッケージをダウンロードし、アップロードします(手順1と同様に wget + scp)。
  2. ルーター上で:
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 に連絡してください。