コンテンツにスキップ

よくある質問

アップグレードが失敗した場合のロールバック手順は何ですか？

ロールバック手順の維持はユーザーの責任です。 アップグレードの前にシステムのバックアップを作成することをお勧めします。

アナライザーのバージョンを更新/アップグレードするにはどうすればよいですか？

カスタマイズされたダッシュボードがない場合：

新しいバージョンがリリースされたら、以下を実行するだけです：

wget https://api.latence.ca/software/update.sh

bash update.sh

現在のアナライザーのDockerを停止し、履歴データを保持しながらアナライザーを再インストールします。

カスタマイズされたダッシュボードがある場合：

カスタマイズされたダッシュボードがある場合は、更新する前にLatenceTechベンダーに連絡してください。

アナライザーのバージョンを更新/アップグレードするにはどうすればよいですか（オフラインインストールの場合）？

前提条件

  • 新しいAnalyzer_offline.zipを持っていること
  • lti_analyzer/フォルダの場所を知っていること
  • この例では、lti_analyzer/フォルダは~/ディレクトリにあります。コマンド#3と#5はご自身の場所に合わせて調整してください

更新手順

1) データを保存する

mkdir -p ~/lti-backup/config

コンテナ停止前に、lti_analyzer/docker-compose.yml の値を控えてください（再インストール後に必要です）。

  • ADMIN_KEY
  • MCP_TOKEN
  • LTI_license_key
  • LTI_password
  • LTI_PERCENTILE_FILTER または LTI_percentile_filter
# ホーム配下の設定ファイルを保存（存在する場合）
cp ~/.saved_lti_password ~/lti-backup/config/ 2>/dev/null
cp ~/.cached_lti_license_key ~/lti-backup/config/ 2>/dev/null

InfluxDB のバックアップは任意です。新規DBでよい場合は次の3ブロックをスキップしてください。

# influxdbを停止する
docker stop lti_analyzer-influxdb-1

# Influxdbデータを保存する
tar -cvf ~/lti-backup/data.gzip ~/lti_analyzer/influxdb/data

# MCPサーバーデータを保存する
sudo cp -r ~/lti_analyzer/mcp .

# certs と data フォルダを保存（存在する場合）
sudo mv ~/lti_analyzer/certs ~/certs 2>/dev/null
sudo mv ~/lti_analyzer/data ~/data 2>/dev/null

2) コンテナを削除する

# コンテナとイメージを削除する
docker stop $(docker ps -q) && docker rm $(docker ps -a -q) && docker rmi $(docker images -q) && docker system prune -af

# クリーンアップ
sudo rm -rf ~/lti_analyzer/ ~/lti_analyzer.launch.log

3) 再インストール

# 解凍する
unzip Analyzer_offline.zip 2>&1

# フォルダに移動する
cd Analyzer_offline/

# スクリプトを実行する
bash install-run-analyzer-offline.sh

4) データを元に戻す

# influxdbとinflux-writerコンテナを停止する
docker stop lti_analyzer-influxdb-1
docker stop lti_analyzer-influx-writer-1

# influxdbデータを展開する
tar -xvf ~/lti-backup/data.gzip

# influxdbとinflux-writerを再起動する
docker start lti_analyzer-influxdb-1
docker start lti_analyzer-influx-writer-1

# MCPサーバーデータを元に戻す
sudo cp -r ~/mcp lti_analyzer/
# 保存した certs と data を戻す（ある場合）
sudo mv ~/certs lti_analyzer/ 2>/dev/null
sudo mv ~/data lti_analyzer/ 2>/dev/null

lti_analyzer/ 直下に certs/ または data/ がある場合は、新しい mcp/ 構成へ移動してください：

mkdir -p lti_analyzer/mcp
mv lti_analyzer/certs lti_analyzer/mcp/ 2>/dev/null
mv lti_analyzer/data lti_analyzer/mcp/ 2>/dev/null

5) 設定を復元

# home の設定ファイルを復元（保存済みの場合）
cp ~/lti-backup/config/.saved_lti_password ~/.saved_lti_password 2>/dev/null
chmod 600 ~/.saved_lti_password 2>/dev/null
cp ~/lti-backup/config/.cached_lti_license_key ~/.cached_lti_license_key 2>/dev/null

lti_analyzer/docker-compose.yml を編集し、手順1で控えた値（ADMIN_KEY, MCP_TOKEN, LTI_license_key, LTI_password, percentile filter）を戻してください。

analyzer パスワードを使っていた場合は、Grafana と InfluxDB に再設定してください（YOUR_PASSWORD を置換）：

GRAFANA_ID=$(docker ps --format "{{.ID}} {{.Image}}" | grep grafana | awk '{print $1}')
INFLUX_ID=$(docker ps --format "{{.ID}} {{.Image}}" | grep influxdb | awk '{print $1}')
docker exec -u root $GRAFANA_ID grafana-cli admin reset-admin-password YOUR_PASSWORD
docker exec $INFLUX_ID influx user password --name LatenceTech --password YOUR_PASSWORD --host http://localhost:8086

6) サービス再起動

# ライセンスキー適用のため influx-writer を再起動
docker stop lti_analyzer-influx-writer-1
docker start lti_analyzer-influx-writer-1

パスワードを復元した場合は、全サービスを再起動します：

docker compose -f lti_analyzer/docker-compose.yml up -d

ADMIN_KEY または MCP_TOKEN のみ復元した場合は、MCP サービスを再起動します：

docker compose -f lti_analyzer/docker-compose.yml restart latencetech_mcp chatbot_api

QoS-AgentとReflectorのバージョンを更新するにはどうすればよいですか？

QoS Agent

QoS-Agentを最新バージョンに更新するには、以下のコマンドで実行中のDockerのイメージを停止・削除する必要があります：

docker stop lti_qos-agent && docker rm lti_qos-agent && docker rmi registry.latence.ca/software/qos-agent

インストールファイルの古いバージョンを削除します：

rm lti_qos-agent.yml

次に、yamlファイルを再ダウンロードして、自分の値に合わせて修正できます：

wget https://api.latence.ca/software/lti_qos-agent.yml

その後、以下を実行して新しいイメージをダウンロードします。

docker compose -f lti_qos-agent.yml up -d

Reflector

リフレクターについては、こちらの更新スクリプトを使用することができます：

wget https://api.latence.ca/software/update_reflector.sh

bash update_reflector.sh

または、以下の手順に従って手動で行うこともできます：

docker stop lti_reflector && docker rm lti_reflector && docker rmi registry.latence.ca/software/reflector

インストールファイルの古いバージョンを削除します：

rm lti_reflector.yml

次に、yamlファイルを再ダウンロードして、ライセンスキーとIDに合わせて修正できます：

wget https://api.latence.ca/software/lti_reflector.yml

リフレクターを再起動します：

docker compose -f lti_reflector.yml up -d

測定が正確であることをどのように証明できますか？

各リリース前に、以下を含む精度テストを実施しています：

  • Ookla's Speedtestなどの業界で認められたツールとの比較。
  • 帯域幅のボトルネックや輻輳レベルなどの事前定義されたネットワーク変動を導入し、その後のテストセッションで測定値と期待される結果を比較します。
  • 事前定義された遅延の導入と、その後の予想される結果とのレイテンシー測定値の比較。

受け入れ基準を満たすには、これらの測定値は参照値との最大差が2%以内でなければなりません。

一度に1つのプロトコルのみ実行できますか？

はい。プロトコルのサンプリングレートを-1に設定することで無効にすることができます。 例：LTI_iperf3_session_interval=-1を指定するとiperf3が無効になります。

複数のQoSエージェントを同時に同じリフレクターに向けることができますか？

はい、複数のQoSエージェントを使用することができます。LTI_agent_idを使用して各エージェントに異なるIDを指定することが必須です。指定しない場合、特定のQoSエージェントに関連するデータを識別できなくなります。

現在実行中のDockerを削除するにはどうすればよいですか？

docker pruneドキュメントを参照してください。

ソリューションはデータプライバシーの問題がありますか？

個人情報は収集していません。アナライザーをオンプレミスで実行することができます。

すべての国で利用できますか？

はい、どの国でも使用制限はありません。

アナライザーが応答しない場合、どうすれば再起動できますか？

  1. アナライザーVMにログインします。
  2. 以下のコマンドを実行します：
cd lti_analyzer
docker compose down
docker compose up -d

データが表示されない場合、どのようにトラブルシューティングすればよいですか？

QoS-Agentが実行中でもアナライザーでデータを受信していない場合は、以下の手順を実行してトラブルシューティングしてください：

AWSユーザーの場合：

  1. アナライザーがAWS仮想マシンで実行されている場合は、このスクリプトを実行します：
wget https://wget https://api.latence.ca/software/lti_protocol_debug_AWS.sh
  1. 次に、このコマンドでスクリプトを実行します：
sudo bash lti_protocol_debug_AWS.sh

その他すべてのユーザーの場合：

  1. このトラブルシューティングスクリプトをダウンロードします：
wget https://wget https://api.latence.ca/software/lti_protocol_debug.sh
  1. 次に、このコマンドでスクリプトを実行します：
sudo bash lti_protocol_debug.sh

APIを使用した際にcustomerID is requiredというエラーが発生します。

使用している環境によっては、クエリのanalyzer部分も引用符で囲む必要がある場合があります：

curl -H -k "x-api-key: your_api_key_here" -s "https://<analyzer_IP>:12099/api/v1/ci?agent_id=<agentID>&customer_id=<customerID>"

このソリューションはagentID is requiredエラーにも使用できます。

その他の質問

他にご質問がある場合は、このページの右側のフォームからチケットを開いてください。喜んでお手伝いします。