更新/アップグレードおよびロールバック手順
最新版を維持する理由
一度に吸収する破壊的変更が少なくなります。 いくつかのリリースでは、古いデプロイメントが依存していた内容が変更されています。
- Rel-1.5 では、設定がファイルから環境変数と docker-compose に移行し、データベースのフィールド名がリファクタリングされました。
- Rel-1.12 では Customer(Network)ID が追加されました。
LTI_customer_idは現在必須のエージェントパラメーターであり、FAQ には API エラーとして「customerID is required」が記載されています。 - Rel-2.5 では MCP のデータレイアウトが変更され、証明書とデータフォルダは
mcp/配下に配置されるようになりました。また、スタックライセンスとオプションのランダムアナライザーパスワードが導入されました。
複数リリースを一度に飛び越えるサイトでは、これらすべてを 1 回のメンテナンスウィンドウで対応することになり、障害時のトラブルシューティングも増えます。
セキュリティとライセンス。
- Rel-2.1 では脆弱性テストを実施し、オープンソースコンポーネントを更新し、セキュアなディスカバリー API を追加しました。
- Rel-2.5 ではランダム化されたアナライザーパスワードが追加されました。
- Rel-2.5 ではエージェントのライセンス有効期限メカニズムが追加され、Grafana での警告と、データ停止前の猶予期間が導入されました。
- スタックには現在 Grafana 12.4.2、InfluxDB 2.8.0、Kafka 8.2.0、Telegraf 1.38 が同梱されています。
測定精度と信頼性。 最近の修正はデータ品質に直接影響します。
- Rel-2.4.1 では、約 1 時間 LIFBE 測定を停止させていた残留 TCP ソケットを修正しました。
- Rel-2.4.2 では iPerf3 マルチプロファイルのタイミングを修正しました。
- Rel-2.5 では、2 つのエージェントが同時送信する場合に最初のエージェントのスループットのみが記録される問題を修正しました。
- Rel-2.5 では遅延していた iPerf UDP 測定を修正しました。
- Rel-2.5 では 5G だけでなく 4G の PCI 値も送信するようになりました。
段階的に追加される機能。
- Rel-2.3:MCP サーバー、新しい OpenAPI エンドポイント、エージェント–リフレクター接続の IPv6 サポート。
- Rel-2.4:強化されたヒートマップ、トラブルシューティングツール、XR-90 サポート。
- Rel-2.5:中断ダッシュボード、詳細レイテンシービューのパーセンタイル。
各リリースは新しいダッシュボード、API、ハードウェアサポートをもたらし、バージョン差が大きいほど一度に必要な導入作業が増えます。
サポート。 現行リリースを利用しているお客様は診断と修正が最も容易で、ドキュメントは常に最新の動作を説明しています。
Analyzer、Reflector、QoSエージェントのバージョンを更新/アップグレードするには?
新しいリリースが公開されたら(リリースノートを参照)、次の順序でコンポーネントをアップグレードしてください。
- アナライザー
- リフレクター
- QoSエージェント
次のコンポーネントに進む前に、各コンポーネントを確認してください。チェックに失敗した場合は、そのコンポーネントのロールバック手順に従ってください。
カスタマイズされたダッシュボードがある場合は、アナライザーを更新する前に LatenceTech ベンダーに連絡してください。
開始前の準備
- メンテナンスウィンドウを計画してください。アナライザーのバックアップまたはアップグレード中は測定が保存されません。
- 現在のライセンスキーをすべて手元に用意してください。
- アナライザーの更新は、アナライザーをインストールしたユーザーとして、そのユーザーのホームディレクトリから実行してください。ホームディレクトリには
lti_analyzer/フォルダが含まれている必要があります。InfluxDB と Grafana はそのユーザーの ID で実行され、データフォルダもそのユーザーに属するため、別のユーザーで実行すると権限エラーが発生します。 - ランダムアナライザーパスワードを使用する場合、パスワードは 8 文字以上である必要があります。アナライザーホストの
~/.saved_lti_passwordに保存され、QoSエージェントではLTI_SERVICE_KEYとして設定されます。 lti_analyzer/docker-compose.ymlから次の値を控えてください:ADMIN_KEY、MCP_TOKEN、LTI_license_key、LTI_password、およびLTI_PERCENTILE_FILTERまたはLTI_percentile_filter。オンライン更新スクリプトはこれらを自動復元しますが、オフライン手順と結果確認のために必要です。- 各ホストにバックアップ用の十分な空きディスク容量があることを確認してください。イメージアーカイブは数 GB になる場合があります。
1) システムをバックアップする
バックアップは ~/lti-rollback/ に保存されます。~/lti-backup/ は使用しないでください。アナライザー更新スクリプトがそのフォルダに書き込み、内容を上書きします。
アップグレード前に取得した仮想マシンのスナップショットも有効なバックアップであり、より迅速なロールバックが可能です。
アナライザーホスト
アナライザーはデータを ~/lti_analyzer/ 配下のフォルダ(influxdb/data、grafana/grafana、mcp/certs、mcp/data)に保持するため、以下のバックアップでそれらすべてが対象になります。また、ホームディレクトリから 2 つのファイルも保存します。API コンテナにマウントされる ~/.cached_lti_license_key と、ランダムパスワードを使用する場合にのみ存在する ~/.saved_lti_password です。
バックアップを作成します。
mkdir -p ~/lti-rollback/config
cp ~/.saved_lti_password ~/lti-rollback/config/ 2>/dev/null
cp ~/.cached_lti_license_key ~/lti-rollback/config/ 2>/dev/null
# InfluxDB と Grafana のファイルが一貫した状態になるよう、アナライザー全体を停止する
docker compose -f ~/lti_analyzer/docker-compose.yml stop
# InfluxDB データを保存する
sudo tar -czf ~/lti-rollback/influxdb-data.tar.gz -C ~ lti_analyzer/influxdb/data
# アナライザーフォルダの残りを保存する(docker-compose.yml、Grafana データ、mcp、certs、data など)
sudo tar -cf ~/lti-rollback/lti_analyzer-config.tar --exclude='lti_analyzer/influxdb/data' -C ~ lti_analyzer
# アナライザーを再起動する
docker compose -f ~/lti_analyzer/docker-compose.yml start
# ダウンロードなしでロールバックできるよう、現在のコンテナイメージを保存する
docker images --format '{{.Repository}}:{{.Tag}}' | grep -v '<none>' | xargs docker save -o ~/lti-rollback/images-pre-upgrade.tar
続行前にバックアップを確認します。
ls -lhA ~/lti-rollback ~/lti-rollback/config
sudo tar -tzf ~/lti-rollback/influxdb-data.tar.gz | head -5
sudo tar -tf ~/lti-rollback/lti_analyzer-config.tar | grep -m3 'lti_analyzer/grafana/grafana'
各コマンドは何かを出力する必要があり、config/ には .cached_lti_license_key(ランダムパスワードを使用する場合は .saved_lti_password も)が含まれている必要があります。
# バックアップにはパスワードとキーが含まれるため、アクセスを制限する
sudo chmod -R go-rwx ~/lti-rollback
リフレクターホスト
lti_reflector.yml があるディレクトリから実行します。
mkdir -p ~/lti-rollback
cp lti_reflector.yml ~/lti-rollback/lti_reflector.yml.pre-upgrade
docker save -o ~/lti-rollback/reflector-image.tar registry.latence.ca/software/reflector
QoSエージェントホスト
lti_qos-agent.yml があるディレクトリから実行します。
mkdir -p ~/lti-rollback
cp lti_qos-agent.yml ~/lti-rollback/lti_qos-agent.yml.pre-upgrade
docker save -o ~/lti-rollback/qos-agent-image.tar registry.latence.ca/software/qos-agent
2) アナライザーをアップグレードする
カスタマイズされたダッシュボードがない場合(オンラインインストール):
lti_analyzer/ フォルダがあるディレクトリ(ホームディレクトリ)に移動し、スクリプトをダウンロードして sudo で実行します。
cd ~
wget https://api.latence.ca/software/update.sh
sudo bash update.sh
スクリプトは InfluxDB データのバックアップを取るかどうかを尋ねます。履歴データを保持するには y と答えてください。 n と答えると、空のデータベースでアナライザーが再インストールされます。
その後、スクリプトは現在のアナライザーコンテナとイメージを停止・削除し、最新のアナライザーを再インストールし、InfluxDB データを戻し、ライセンスキー、パーセンタイルフィルター、アナライザーパスワード、ADMIN_KEY、MCP_TOKEN、MCP データを自動復元します。
スクリプトは標準インストーラーを実行するため、次の 2 つの質問も表示されます。
- 95 パーセンタイルフィルター(
true/false): 現在の設定で答えてください。 - ランダムパスワード(
true/false): この質問は、まだランダムパスワードを使用していない場合(つまり~/.saved_lti_passwordが存在しない場合)にのみ表示されます。現在のパスワードを維持するにはfalseと答えてください。trueと答えると新しいランダムパスワードが生成・適用され、すべての QoSエージェントでLTI_SERVICE_KEYとして設定する必要があります。そうしないとデータ送信が停止します。
インストーラーは更新時にライセンスキーを尋ねません。~/.cached_lti_license_key に保存されたキーを再利用します。最後にライセンスチェックを待ちますが、数分かかることがあります。
注意事項:
- スクリプトを中断しないでください。中断または途中失敗した場合は、再実行せずロールバック手順に従ってください。
- 「Waiting for License logs」で数分以上止まる場合は、
docker logs lti_analyzer-influx-writer-1を確認してください。ライセンスが許可エージェント数 0 を報告している場合、スクリプトは有効なライセンスキーを求めます。 - スクリプトが作成するバックアップ(
~/lti-backup/)には InfluxDB データと 2 つの設定ファイルのみが含まれます。これはロールバック用バックアップではありません。手順 1 のバックアップは引き続き必要です。 - スクリプトはステップが失敗しても「Update completed successfully」と表示します。必ず以下の確認を実行してください。
カスタマイズされたダッシュボードがある場合:
更新前に LatenceTech ベンダーに連絡してください。
オフラインインストール:
前提条件:
- 新しい
Analyzer_offline.zipを用意していること。wget https://api.latence.ca/software/Analyzer_offline.zipでダウンロードするか、LatenceTech から USB スティックで入手できます。 - すべてのコマンドは、
lti_analyzer/とAnalyzer_offline.zipの両方があるディレクトリから実行してください。この例ではlti_analyzer/はホームディレクトリ(~/)にあります。場所に合わせてコマンドを調整してください。 - 手順 1(バックアップ)が完了していること。
2a) コンテナを削除する
警告: このコマンドはホスト上のすべてのコンテナとイメージを削除します。アナライザー専用ホストでのみ実行してください。
# コンテナとイメージを削除する
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
2b) 再インストール
# 解凍する
unzip Analyzer_offline.zip 2>&1
# フォルダに移動する
cd Analyzer_offline/
# スクリプトを実行する
bash install-run-analyzer-offline.sh
# 前のディレクトリに戻る
cd ..
2c) データを戻す
# influxdb と influx-writer コンテナを停止する
docker stop lti_analyzer-influxdb-1
docker stop lti_analyzer-influx-writer-1
# InfluxDB データを展開する
sudo tar -xf ~/lti-rollback/influxdb-data.tar.gz -C ~
# influxdb と influx-writer を再起動する
docker start lti_analyzer-influxdb-1
docker start lti_analyzer-influx-writer-1
# MCP サーバーデータ、certs、data フォルダを戻す(バックアップに存在するもの)
for d in mcp certs data; do sudo tar -xf ~/lti-rollback/lti_analyzer-config.tar -C ~ lti_analyzer/$d 2>/dev/null; done
certs/ または data/ が lti_analyzer/ のルートに存在する場合は、新しい mcp/ フォルダ構造へ移動します。
mkdir -p ~/lti_analyzer/mcp
sudo mv ~/lti_analyzer/certs ~/lti_analyzer/mcp/ 2>/dev/null
sudo mv ~/lti_analyzer/data ~/lti_analyzer/mcp/ 2>/dev/null
2d) 設定を復元する
# ホームの設定ファイルを復元する(バックアップ済みの場合)
cp ~/lti-rollback/config/.saved_lti_password ~/.saved_lti_password 2>/dev/null
chmod 600 ~/.saved_lti_password 2>/dev/null
cp ~/lti-rollback/config/.cached_lti_license_key ~/.cached_lti_license_key 2>/dev/null
lti_analyzer/docker-compose.yml を編集し、アップグレード前に控えた値(ADMIN_KEY、MCP_TOKEN、LTI_license_key、LTI_password、パーセンタイルフィルター)を戻してください。
アナライザーパスワードがあった場合は、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
2e) サービスを再起動する
# ライセンスキーを適用するため 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
続行前にアナライザーを確認する
- すべてのアナライザーコンテナが稼働している(
docker ps)。 http://YOUR_ANALYZER_HOST_IP:12021でダッシュボードが読み込まれる。- 履歴データが表示される。
- ライセンスのステータスと有効期限が正しく表示される。
これらの確認のいずれかが失敗した場合は、ロールバック手順に従ってください。
3) リフレクターをアップグレードする
リフレクターでは、次の更新スクリプトを使用できます。
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
オフラインインストール: Reflector_offline.zip をダウンロードする(wget https://api.latence.ca/software/Reflector_offline.zip)か USB スティックから入手し、上記と同様に古いコンテナを停止・削除し、ファイルを解凍してフォルダ内のスクリプトを bash で実行します。スクリプトが新しいイメージを作成します。その後、ドキュメントの説明どおりに lti_reflector.yml を記入してコンテナをデプロイします。
続行前にリフレクターを確認する
docker compose -f lti_reflector.yml logs
ログにエラーが表示されないことを確認してください。
4) QoSエージェントをアップグレードする
まず 1 つのエージェントをアップグレードして確認し、その後ほかのエージェントをアップグレードすることを推奨します。
QoSエージェントを最新バージョンに更新するには、次のコマンドで実行中の 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
ランダムアナライザーパスワードを使用する場合は、LTI_SERVICE_KEY をアナライザーパスワードに設定してください。値の設定漏れを防ぐため、新しいファイルをバックアップと比較します。
diff ~/lti-rollback/lti_qos-agent.yml.pre-upgrade lti_qos-agent.yml
次に、新しいイメージをダウンロードして実行します。
docker compose -f lti_qos-agent.yml up -d
エージェントをアップグレードするその他の方法:
- QoSエージェント管理ダッシュボード: エージェントホストにインストールされている場合は、Docker Management > Update を使用して最新のコンテナイメージを取得し、サービスを再起動できます。
- オフラインインストール:
Agent_offline.zipをダウンロードする(wget https://api.latence.ca/software/Agent_offline.zip)か USB スティックから入手し、上記と同様に古いコンテナを停止・削除し、ファイルを解凍してフォルダ内のスクリプトをbashで実行します。スクリプトが新しいイメージを作成します。その後、ドキュメントの説明どおりにlti_qos-agent.ymlを記入してコンテナをデプロイします。 - Cradlepoint および SDK エージェント: Cradlepointデプロイメント および QoSエージェントSDKデプロイメント のページに従ってください。
QoSエージェントを確認する
docker compose -f lti_qos-agent.yml logs
ログにエラーがなく、ダッシュボードにそのエージェント ID のデータが表示されることを確認してください。
5) 最終確認
- すべてのエージェントがダッシュボードに表示され、データを送信している。
- アナライザーが期待どおりのライセンスステータスを報告している。
- システムが 1 サイクル正常に動作するまで、各ホストの
~/lti-rollback/を保持してください。
アップグレード失敗時のロールバック手順は?
ロールバック手順の維持はユーザーの責任です。アップグレード前に、アップグレード手順のステップ 1 を使用してシステムをバックアップすることを強く推奨します。以下の手順はそのバックアップからシステムを復元するもので、アップグレードと逆の順序で実行する必要があります:QoSエージェント、次にリフレクター、次にアナライザー。
各コンポーネントは個別にロールバックできます。
- アナライザーのアップグレードが失敗した場合は、アナライザーのみをロールバックします(ほかはまだアップグレードされていません)。
- リフレクターのアップグレードが失敗した場合は、リフレクターのみをロールバックします。
- QoSエージェントのアップグレードが失敗した場合は、影響を受けたエージェントのみをロールバックします。
- アップグレード全体を中止する場合は、次の順序でロールバックします:QoSエージェント、リフレクター、アナライザー。
ロールバック中に docker compose pull、更新スクリプト、または QoSエージェント管理ダッシュボードの Update ボタンを実行しないでください。新しいバージョンが再度ダウンロードされます。
アナライザー更新スクリプトが途中で失敗した場合は、再実行せず、まずロールバックしてください。
前提条件
- アップグレード手順のステップ 1 で作成した、各ホスト上の
~/lti-rollback/フォルダ。このフォルダは、アナライザー更新スクリプトが使用する~/lti-backup/とは異なり、ロールバックには使用されません。 - 保存済みのイメージアーカイブ(
images-pre-upgrade.tar、reflector-image.tar、qos-agent-image.tar)。
1) QoSエージェントをロールバックする
各エージェントホストで、lti_qos-agent.yml があるディレクトリから実行します。
# 新しいバージョンを削除する
docker stop lti_qos-agent && docker rm lti_qos-agent
docker rmi registry.latence.ca/software/qos-agent
# 以前のイメージと設定ファイルを復元する
docker load -i ~/lti-rollback/qos-agent-image.tar
cp ~/lti-rollback/lti_qos-agent.yml.pre-upgrade lti_qos-agent.yml
# 何もダウンロードせずに以前のバージョンを起動する
docker compose -f lti_qos-agent.yml up -d --pull never
QoSエージェント管理ダッシュボードがインストールされている場合は、Agent Configuration Editor から以前の設定バージョンを復元することもできます。コンテナイメージ自体は、上記のコマンドで復元する必要があります。
2) リフレクターをロールバックする
リフレクターホストで、lti_reflector.yml があるディレクトリから実行します。
# 新しいバージョンを削除する
docker stop lti_reflector && docker rm lti_reflector
docker rmi registry.latence.ca/software/reflector
# 以前のイメージと設定ファイルを復元する
docker load -i ~/lti-rollback/reflector-image.tar
cp ~/lti-rollback/lti_reflector.yml.pre-upgrade lti_reflector.yml
# 何もダウンロードせずに以前のバージョンを起動する
docker compose -f lti_reflector.yml up -d --pull never
3) アナライザーをロールバックする
バックアップには、lti_analyzer/ フォルダ全体(設定、Grafana データ、MCP データ、証明書)と InfluxDB データが含まれます。アナライザー更新スクリプトが途中で失敗した場合、ホームディレクトリに mcp、certs、data フォルダのコピーが残っていることがあります。これらはすでにバックアップに含まれており、ロールバック確認後に削除できます。
以下の docker compose コマンドは、アナライザーをインストールしたユーザーとして、sudo なしで実行してください。compose ファイルは ${HOME}/.cached_lti_license_key をマウントするため、別のホームディレクトリだと Docker がそのファイルの代わりにフォルダを作成してしまいます。
# 新しいバージョンを停止・削除する(フォルダがもう存在しない場合は最初のコマンドをスキップ)
docker compose -f ~/lti_analyzer/docker-compose.yml down
docker ps -a --filter name=lti_analyzer -q | xargs -r docker rm -f
sudo rm -rf ~/lti_analyzer ~/lti_analyzer.launch.log
# 以前のアナライザーフォルダ(docker-compose.yml、Grafana データ、mcp、certs など)とイメージを復元する
sudo tar -xf ~/lti-rollback/lti_analyzer-config.tar -C ~
docker load -i ~/lti-rollback/images-pre-upgrade.tar
# アップグレード前に保存した InfluxDB データを復元する
sudo tar -xf ~/lti-rollback/influxdb-data.tar.gz -C ~
# ホームの設定ファイルを復元する(アナライザー起動前:ライセンスキーファイルは API コンテナにマウントされる)
cp ~/lti-rollback/config/.saved_lti_password ~/.saved_lti_password 2>/dev/null
chmod 600 ~/.saved_lti_password 2>/dev/null
cp ~/lti-rollback/config/.cached_lti_license_key ~/.cached_lti_license_key 2>/dev/null
# 何もダウンロードせずに以前のバージョンを起動する
docker compose -f ~/lti_analyzer/docker-compose.yml up -d --pull never
# ライセンスキーを適用するため influx-writer を再起動する
docker stop lti_analyzer-influx-writer-1
docker start lti_analyzer-influx-writer-1
以前のアナライザーパスワードでログインできない場合は、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
コンテナイメージを保存していない場合
インストール時と同じ方法で以前のバージョンを再インストールし、~/lti-rollback/ からデータと設定を復元します。
- オフラインインストール: 以前の
Analyzer_offline.zip、Reflector_offline.zip、Agent_offline.zipを使用し、オフラインアナライザーアップグレードの手順 2c〜2e に従ってください。 - オンラインインストール: オンラインスクリプトは常に最新リリースをインストールします。以前のバージョンを入手するには LatenceTech ベンダーに連絡してください。
ロールバック後
http://YOUR_ANALYZER_HOST_IP:12021でダッシュボードを開き、履歴データが表示され、ダッシュボードとユーザーが存在することを確認します。- ダッシュボードと
docker compose -f lti_qos-agent.yml logsを使用して、すべてのエージェントがデータを送信していることを確認します。 - ランダムアナライザーパスワードを使用する場合は、各エージェントの
LTI_SERVICE_KEYが復元されたパスワードと一致することを確認します。 - アップグレードからロールバックまでの間に収集された測定値は、復元されたデータベースには含まれません。
- システムが 1 サイクル正常に動作するまで
~/lti-rollback/を保持してください。
ロールバックで動作するシステムが復元されない場合は、デバッグ情報をサポートに送信し、LatenceTechサポートチームにチケットを開いてください。