トラブルシューティング
このページでは、カテゴリごとに整理された一般的な問題の解決策を紹介します。
接続問題
クライアントがサーバーを見つけられない
症状: クライアントが「サーバーを検索中」または「サーバーが見つかりません」と表示します。
解決策:
- 管理PCでHandyCafeサーバーが稼働していることを確認します。
- 両方のPCが同じサブネット上にあることを確認します（例: 両方が192.168.1.x上）。
- ネットワークスイッチやルーターでmDNSがブロックされていないことを確認します。
- 手動接続を試みます: クライアント設定でサーバーのIPアドレスを直接入力します。
- 他のソフトウェアがサーバーのTCPポート（デフォルト: 5001）を使用していないことを確認します。
クライアントが接続後すぐに切断される
症状: クライアントが一時的に「接続済み」と表示された後、「検索中」に戻ります。
解決策:
- サーバーとクライアントの接続キーが一致していることを確認します。キーはサーバーの設定 > ネットワークで設定されます。
- ネットワークの不安定さ（パケットロス、ケーブル問題）を確認します。
- サーバーがライセンスPCの制限に達していないことを確認します。
- 認証失敗メッセージがサーバーログにないか確認します。
クライアントがサーバーで「オフライン」と表示されるがPCは稼働中
症状: クライアントPCが電源オンでクライアントアプリケーションが稼働中ですが、サーバーではオフラインと表示されます。
解決策:
- クライアントPCでHandyCafeクライアントが実際に稼働していることを確認します（システムトレイを確認）。
- クライアントPCのネットワーク接続を確認します（サーバーにpingを送信できるか）。
- ファイアウォールルールを確認します: TCPポート5001-5003がサーバーとクライアントの両方で開いていること。
- 問題のPCでHandyCafeクライアントを再起動します。
- VLANを使用している場合、サーバーとクライアントのVLANが通信できることを確認します。
ネットワーク設定変更後に接続できない
症状: ポートや接続キーを変更した後、クライアントが接続できません。
解決策:
- クライアントが新しいポート番号と接続キーで更新されていることを確認します。
- ネットワーク設定を変更した後、HandyCafeサーバーを再起動します。
- 新しいポートを許可するようにファイアウォールルールを更新します。
- すべてのクライアントを新しい値で再設定する必要があります。
セッション問題
クライアントでセッションを開始できない
症状: 開始ボタンが無効化されているか、開始アクションがエラーで失敗します。
解決策:
- ライセンスの状態を確認します。読み取り専用モードの場合、新しいセッションを開始できません。
- クライアントの状態が「アイドル」であることを確認します。セッションはアイドルクライアントでのみ開始できます。
- キャッシャーの権限を確認します。役割にはAUTH_CLIENT_LOGIN権限が必要です。
- 料金設定が構成されていることを確認します（設定 > 料金で有効な時間料金が必要です）。
セッションタイマーが正しい時間を表示しない
症状: 表示される時間が実際の経過時間と一致しません。
解決策:
- サーバーとクライアントPCのシステムクロックを確認します。同期されている必要があります（NTPを使用）。
- セッションが一時停止された場合、一時停止期間はカウントされません。
- プリペイドセッションの場合、タイマーは経過時間ではなく残り時間を表示します。
セッションのコストが正しくないように見える
症状: 請求された金額が期待と一致しません。
解決策:
- 料金スケジュールを確認します。有効な場合、セッションは異なる乗数を持つ複数の料金スロットを通過した可能性があります。
- 料金設定を確認します: 基本時間料金、VAT、開始料金、四捨五入。
- トランザクション詳細でセッションの料金セグメントを確認して内訳を確認します。
- 支払い方法の手数料と固定料金を確認します。
- プリペイドセッションの場合、「購入時にロック」または「ライブスケジュール」モードがアクティブかどうかを確認します。
一時停止したセッションを再開できない
症状: 再開アクションが失敗するか、利用できません。
解決策:
- クライアントPCがまだサーバーに接続されていることを確認します。
- クライアントの状態が「一時停止」（オレンジ）と表示されていることを確認します。
- 一時停止中にクライアントが切断された場合、再接続が必要な場合があります。
支払い問題
支払い方法がドロップダウンに表示されない
症状: セッションや注文を終了する際に期待される支払い方法が表示されません。
解決策:
- 管理 > 支払い方法で支払い方法が存在することを確認します。
- 支払い方法がアクティブであることを確認します（削除または無効化されていない）。
- キャッシャーの権限を確認します。PAYMENT_MANAGEが付与されている必要があります。
手数料の計算が正しくないように見える
症状: 差し引かれた手数料が期待される率と一致しません。
解決策:
- 支払い方法の手数料率（パーセンテージとして）と固定料金を確認します。
- 手数料の計算式: 手数料 = (請求金額 * 手数料率 / 100) + 固定料金。
- キャッシャーが請求金額に手動で上書きしたかどうかを確認します。
クライアント表示問題
クライアントのアイドル画面が空白
症状: アイドル画面が設定されたスライドショーの代わりに何も表示しません。
解決策:
- 設定 > クライアント > アイドル画面でアイドル画面が有効になっていることを確認します。
- 少なくとも1つのメディアアイテム（画像またはビデオ）が追加されていることを確認します。
- メディアファイルが有効であり、破損していないことを確認します。
- 最新の設定をクライアントにプッシュするために同期をトリガーします。
クライアントメニューにアプリが表示されない
症状: アプリランチャーが空であるか、カテゴリがありません。
解決策:
- 設定 > クライアント > コンテンツでアプリとカテゴリが構成されていることを確認します。
- カテゴリとアプリの表示がオンになっていることを確認します。
- クライアントが最新のメニューデータを受信していることを確認します（変更はTCP経由で自動的にプッシュされます）。
- リアルタイム同期が適用されなかった場合は、クライアントを再起動します。
クライアントの外観テーマが適用されない
症状: クライアントがデフォルトの外観を表示し、設定されたテーマが適用されません。
解決策:
- 設定 > クライアント > 外観でテーマ設定が保存されていることを確認します。
- クライアントに設定をプッシュするようにトリガーします。
- クライアントアプリケーションを再起動します。
リモートデスクトップ問題
リモートデスクトップが遅延または途切れる
症状: ビデオフィードが遅延し、スタッタリングするか、フレームレートが低い。
解決策:
- ビットレートを下げます（標準LAN使用の場合は1000-2000 kbpsを試してください）。
- FPS設定を下げます。
- WiFiの代わりに有線イーサネットを使用します。
- ネットワークの混雑や他のアプリケーションによる高帯域幅使用を確認します。
- UDPポート5004がブロックまたはレート制限されていないことを確認します。
リモートデスクトップが黒い画面を表示する
症状: リモートデスクトップウィンドウが開くが、黒い画面のみが表示されます。
解決策:
- クライアントがオンラインで応答していることを確認します（最初にスクリーンショットを撮ってみてください）。
- UDPポート5004が双方向に開いていることを確認します。
- クライアントのグラフィックドライバーを更新する必要があるかもしれません。
- キーフレームのリフレッシュを要求してみてください。
リモートでマウスやキーボードを操作できない
症状: リモート画面は見えるが、クリックやキーストロークが効果を持たない。
解決策:
- リモート管理ポート（TCP 5003）が開いていることを確認します。
- クライアントアプリケーションが適切なシステム権限を持っていることを確認します。
- 一部のフルスクリーンゲームはリモート入力をブロックすることがあります。
ライセンス問題
ライセンスが「offline_grace」と表示される
症状: ライセンスステータスがoffline_graceとカウントダウンを表示します。
解決策:
- サーバーPCのインターネット接続を復元します。
- DNS解決を確認します。サーバーはライセンスサーバーに到達する必要があります。
- プロキシやファイアウォールがアウトバウンドHTTPS接続をブロックしていないか確認します。
- サーバーがロックされる前に72時間以内に接続を復元する必要があります。
ライセンスが「over_limit」と表示される
症状: ライセンスが許可するより多くのクライアントが接続されています。
解決策:
- 使用していないアイドルクライアントを切断します。
- 現在のクライアント数とライセンス制限を確認します。
- より多くのPC容量のためにライセンスをアップグレードします。
- 注意: コンソールもPCの総数制限にカウントされます。
ライセンスが「expired」または「revoked」と表示される
症状: サーバーが制限モードに入ります。
解決策:
- ライセンスの有効期限を確認します。
- HandyCafeのウェブサイトでライセンスを更新します。
- 取り消されたライセンスについては、HandyCafeサポートに連絡してください。
一般的な問題
設定変更が保存されない
症状: 設定から離れると変更が元に戻ります。
解決策:
- 変更後に保存ボタンをクリックすることを確認します。
- 検証エラーを確認します（エラーメッセージが表示されたハイライトされたフィールド）。
- 管理者権限を持っていることを確認します。
監査ログにエントリが欠落している
症状: 期待されるアクションがログページに表示されません。
解決策:
- ログフィルターを確認します。正しいカテゴリと日付範囲が選択されていることを確認します。
- LOG_DISPLAY_FULL権限が付与されていることを確認します（そうでない場合、今日のログのみが表示されます）。
- 特定のアクションをテキスト検索フィールドで検索します。