トラブルシューティング
このページではカテゴリ別に一般的な問題の解決策を説明します。
接続の問題
クライアントがサーバーを見つけられない
症状: クライアントが「サーバーを検索中」または「サーバーが見つかりません」と表示される。
解決策:
- 管理用PCでHandyCafe Serverが実行中であることを確認してください。
- 両方のPCが同じサブネット上にあることを確認してください（例: 両方が192.168.1.xにある）。
- mDNSがネットワークスイッチやルーターでブロックされていないことを確認してください。
- 手動接続を試してください: クライアント設定にサーバーのIPアドレスを直接入力。
- 他のソフトウェアがサーバーのTCPポート（デフォルト: 5001）を使用していないことを確認してください。
クライアントが接続後すぐに切断される
症状: クライアントが一瞬「接続済み」と表示された後、「検索中」に戻る。
解決策:
- サーバーとクライアントの接続キーが一致していることを確認してください。キーはサーバーの設定 > ネットワークで設定されています。
- ネットワークの不安定性（パケットロス、ケーブル問題）を確認してください。
- サーバーがライセンスのPC制限に達していないことを確認してください。
- サーバーログで認証失敗メッセージを確認してください。
クライアントがサーバーで「オフライン」と表示されるがPCは起動している
症状: クライアントPCの電源が入っていてクライアントアプリケーションが実行中だが、サーバーはオフラインと表示。
解決策:
- クライアントPCでHandyCafe Clientが実際に実行中であることを確認してください（システムトレイを確認）。
- クライアントPCのネットワーク接続を確認してください（サーバーにpingできるか）。
- ファイアウォールルールを確認: サーバーとクライアントの両方でTCPポート5001～5003が開いていること。
- 影響を受けたPCでHandyCafe Clientを再起動してください。
- VLANを使用している場合、サーバーとクライアントのVLAN間で通信可能であることを確認してください。
セッションの問題
クライアントでセッションを開始できない
症状: 開始ボタンが無効またはエラーで開始アクションが失敗。
解決策:
- ライセンスステータスを確認してください。読み取り専用モードの場合、新しいセッションは開始できません。
- クライアントのステータスが「アイドル」であることを確認してください。セッションはアイドル状態のクライアントでのみ開始可能です。
- キャッシャーの権限を確認してください。ロールにAUTH_CLIENT_LOGIN権限が必要です。
- 料金設定が構成されていることを確認してください（設定 > 料金設定に有効な時間単価が必要）。
セッション料金が間違っているように見える
症状: 請求額が期待と一致しない。
解決策:
- 料金スケジュールを確認してください。有効になっている場合、セッションが異なる倍率を持つ複数の料金スロットを通過した可能性があります。
- 料金設定を確認: 基本時間単価、消費税、開始料金、丸め。
- 取引詳細でセッションの料金セグメントの内訳を確認してください。
- 支払い方法の手数料と固定費を確認してください。
- 前払いセッションの場合、「購入時固定」か「リアルタイムスケジュール」モードのどちらがアクティブか確認してください。
リモートデスクトップの問題
リモートデスクトップが遅延する
症状: 映像フィードが遅延、途切れ、低フレームレート。
解決策:
- ビットレートを下げてください（標準LAN使用の場合は1000～2000 kbpsを推奨）。
- FPS設定を下げてください。
- Wi-Fiの代わりに有線Ethernetを使用してください。
- 他のアプリケーションからのネットワーク混雑や高帯域幅使用を確認してください。
- UDPポート5004がブロックまたはレート制限されていないことを確認してください。
リモートデスクトップが黒い画面を表示する
症状: リモートデスクトップウィンドウが開くが黒い画面のみ表示。
解決策:
- クライアントがオンラインでレスポンシブであることを確認してください（まずスクリーンショットを試してください）。
- UDPポート5004が双方向に開いていることを確認してください。
- クライアントのグラフィックドライバーの更新が必要な場合があります。
- キーフレームのリフレッシュをリクエストしてみてください。
ライセンスの問題
ライセンスが「offline_grace」と表示される
症状: ライセンスステータスがoffline_graceとカウントダウンを表示。
解決策:
- サーバーPCのインターネット接続を復旧してください。
- DNS解決を確認してください。サーバーはライセンスサーバーに到達する必要があります。
- 送信HTTPSの接続をブロックしているプロキシやファイアウォールを確認してください。
- サーバーがロックされるまで72時間の猶予があります。
ライセンスが「over_limit」と表示される
症状: ライセンスの許可数を超えるクライアントが接続されている。
解決策:
- 使用していないアイドルクライアントを切断してください。
- 現在のクライアント数とライセンス制限を確認してください。
- より多くのPC容量のためにライセンスをアップグレードしてください。
- 注: コンソールは総PC制限にカウントされます。
一般的な問題
設定の変更が保存されない
症状: 設定ページから移動すると変更が元に戻る。
解決策:
- 変更後に必ず保存ボタンをクリックしてください。
- 検証エラー（エラーメッセージでハイライトされたフィールド）を確認してください。
- 管理者権限があることを確認してください。
監査ログにエントリがない
症状: 期待したアクションがログページに表示されない。
解決策:
- ログフィルターを確認してください。正しいカテゴリと日付範囲が選択されていることを確認。
- LOG_DISPLAY_FULL権限が付与されていることを確認してください（そうでないと今日のログのみ表示）。
- テキスト検索フィールドを使用して特定のアクションを検索してください。