uVersion
日本語
ダウンロード →

Wiki

トラブルシューティング

よくある問題の解決方法：サービスが起動しない、アクティベーションコードの拒否、PostgreSQL、TLS。

サービスが起動しない

Linux：systemctl start が失敗する 
sudo journalctl -u uversion-server -n 100 --no-pager

よくある原因：

  • PostgreSQL が停止している： sudo systemctl status postgresql
  • DB パスワードを紛失した： postinst が --reconfigure で設定を再生成します (sudo dpkg-reconfigure uversion-server)
  • ポート 8443 が使用中：後述の専用セクションを参照してください
Windows：エラー 1053 または 1067

サービスが起動後すぐに停止します。イベントビューアーを確認してください：

Get-EventLog -LogName Application -Source uVersionServer -Newest 50

よくある原因：

  • CONFIG_PATH 環境変数がない： 通常はインストーラーが HKLM\SYSTEM\CurrentControlSet\Services\uVersionServer\Environment に設定します
  • PostgreSQL が停止している： Get-Service postgresql*

アクティベーションコードが拒否される

  • コードが別のマシンで使用されていないか確認してください （各コードは最初のインストール時の server-ID に紐付けられます）。新しい コードはアカウントページから請求してください。
  • licence.uversion.io への接続を確認してください： curl -I https://licence.uversion.io/api/v1/health
  • アンインストール後に新しいマシンでコードを再利用したい場合は、 サポートに連絡して以前の server-ID を解放してください。

PostgreSQL に接続できない

uVersion サービスがデータベースに接続できません。手動でテストしてください：

# Linux
sudo -u postgres psql -c "SELECT 1;"

# Windows
& "C:\Program Files\PostgreSQL\16\bin\psql.exe" -U postgres -h 127.0.0.1 -c "SELECT 1;"

PostgreSQL はインストールされているがスーパーユーザーのパスワードを紛失した場合、 uVersion インストーラー（Linux の postinst も Windows の install.ps1 も）は PostgreSQL を自動的に trust モードに戻し、パスワードをリセットしてから 元の設定を復元できます。再実行してください：

# Linux
sudo dpkg-reconfigure uversion-server

# Windows
iwr https://uversion.io/downloads/server/install.ps1 -UseBasicParsing | iex
# (re-passe par le script avec -Reconfigure)

ポート 8443 が使用中

uVersion はデフォルトで 8443 の HTTPS をリッスンします（また HTTP フォールバック用に 8080 も開いたままにします）。いずれかが使用中の場合：

# Linux
sudo ss -tlnp | grep -E '8443|8080'

# Windows
Get-NetTCPConnection -LocalPort 8443 | Select-Object OwningProcess, State
Get-Process -Id <PID>

TLS ポートを変更するには config.toml を編集してください：

[tls]
https_port = 9443

その後、サービスを再起動してください。

クライアントが TLS 接続を拒否する

uVersion はクライアント側で TOFU によりロックされた自己署名証明書を 使用します（TLS フィンガープリントを参照）。 最もよくある原因：

  • 初回接続が未確認：デスクトップクライアントが フィンガープリントを含むダイアログを表示します。管理者から共有された 値と比較してください。CLI では uversion trust <url> を実行します。
  • フィンガープリントが変更された（赤い警告）：サーバーが再インストールされ、 証明書が再生成されました。管理者と out-of-band で確認してから：
    • デスクトップ：赤いダイアログで Trust new fingerprint をクリック
    • CLI：uversion mistrust <url> の後 uversion login <url>
  • サーバーが HTTPS を提供していない：8080 ではなく 8443 で正しくリッスンしているか確認してください： 
    # Linux
ss -tlnp | grep 8443
# Windows
Get-NetTCPConnection -LocalPort 8443 -State Listen
    何もリッスンしていない場合は、config.toml で [tls] disabled = false になっているか確認してください（これがデフォルトです）。
  • サーバー側でフィンガープリントを再表示する： 
    # Linux
sudo cat /var/lib/uversion/data/tls/fingerprint
# Windows
Get-Content "C:\ProgramData\uVersion\data\tls\fingerprint"

完全リセット

クリーンインストールからやり直すには、Ubuntu/Debian のアンインストール または Windows のアンインストール ページを参照してください。