付録: トラブルシューティング
Web 画面が開けない
| 確認 | 内容 |
|---|---|
| サービス稼働 | Windows: サービス「Handbook X コンテンツ収集サービス」が実行中か。Mac: サービスが起動しているか |
| ポート競合 | 他アプリが 8089 を使用していないか |
| URL | http://localhost:8089/ を指定しているか（https ではない） |
| 待受アドレス | BIND_ADDRESS を変更している場合、そのアドレスでリッスンしているか |
http://localhost:8089/api/ping が応答しない場合は、プロセス／サービスが起動していない可能性が高いです。
ログインはできるが「権限がありません」
ログインと利用権限 を参照し、有料プランにご契約 か、または 購入ユーザーでない方でワークグループに入り オーナー か 共有権限管理者 かを確認してください。組織管理者への依頼が必要なケースが多いです。
同期されない・一部のファイルだけ失敗する
- ソースフォルダのパスが存在するか、ネットワークドライブの切断で見えなくなっていないか
- ファイルが他アプリによってロックされていないか
- 対象ブックに対する 編集権限 が Coordinator 上で有効か
- ログに API エラーや認証エラー（トークン期限切れ等）が出ていないか
データベースや設定をリセットしたい
handbookXSync.db を削除するとローカル設定や履歴が失われます。行う前にバックアップと、組織の運用ポリシーの確認を必ず行ってください。Windows では C:\ProgramData\HandbookXAggregationTool\、Mac ではインストールディレクトリ内にあります。
サポートへの連絡時に用意するとよいもの
- ツールのバージョン
- 問題が起きた日時（おおまかで可）
- Web 画面またはファイルログから、該当箇所の抜粋（個人情報・機密はマスク）
- Coordinator の URL（本番／検証の区別）