EUWI のトラブルシューティング

ログファイル

以下に記載されているログファイルの場所は /opt/pmx/var/log に対する相対パスです。

  • manager/eui_local_log

    このファイルは EUWI (End User Web Interface) によって生成されるトランザクションおよび重大なエラーを記録します。

  • manager/httpd_access_log

    HTTPD サービスのアクセスログです。

  • manager/httpd_error_log

    HTTPD サービスのエラーログです。

ログ内でのトランザクションの表示

EUWI の正常に完了した各トランザクションは、以下の順番で 2つのログファイルに記録されます。

  1. eui_local_log (別にインストールされている場合は EUWI サーバー上)

    EUWI の出力ページ内のエントリは以下のような内容になります。

    1 2005-03-17T14:23:09 [5646,eui_local] quarantine_qview user 'user@example.com',\
        session '66705d63e810acd456f38831d0bd4ba9'
  2. httpd_access_log (別にインストールされている場合は EUWI サーバー上)

    さまざまな EUWI トランザクションのエントリです。トランザクションは以下の例のように表示されます。

    192.168.99.135 - - [17/Mar/2005:14:23:09 -0800] "POST /index.cgi HTTP/1.1" 302 7192
    192.168.99.135 - - [17/Mar/2005:14:23:11 -0800] "GET /messages.cgi?message_type=blocked\
        HTTP/1.1" 200 7605
    192.168.99.135 - - [17/Mar/2005:14:23:11 -0800] "GET /main.css HTTP/1.1" 304 -

HTTPD サービスでエラーが発生した場合、httpd_error_log に記録されます。

認証およびトランザクションに関するエラーは eui_local_log に記録されます。

その他のエラーは error_log に記録されます。

共通エラーメッセージ

共通するエラーメッセージについて簡単に説明します。

「Invalid user in session」(セッションで無効なユーザー)

セッションのクッキーがユーザーと一致しない場合、またはユーザーが古いセッションのパスワードを使用してログインしようとした場合に表示されます。表示が可能な場合、メールアドレスおよびセッション ID が表示されます。

これを解決するには、ユーザーはログアウトした後に EUWI から送信されてきた最新のセッションのパスワードを使用してログインする必要があります。

「Temporarily unavailable」(一時的に使用不可能)
設定を有効にしている enduser.conf で、誤った値が設定されています。
「Your session has expired or is invalid.」(セッションの有効期限が切れているか、セッションが無効です。)「Please log in again」(再度ログインしてください)

セッションクッキーまたはセッション ID が古いか無効である、または RPC のバックエンドと通信する際にエラーが発生しました。さらに具体的なエラーメッセージについては、httpd_error.log および rpc_error.log ファイルを確認してください。

このエラーは、ユーザーが設定された enduser-users のリストに登録されていない、またはリストの内容と一致しない場合にも発生します。

enduser-users ファイルまたは rpc-hosts ファイルのいずれかが、存在しないか無効な場合、EUWI ユーザーはこのようなエラーを受け取ります。ログインが失敗した実際の理由はセキュリティ上のり理由でエンドユーザーには知らされませんが、管理者はログファイル上で確認できます。
「user_invalid_access_list="The configured end user access list '<name>' is invalid and cannot be used."」(user_invalid_access_list="設定されているエンドユーザーのアクセスリスト '<ファイル名>' が無効または使用できません。")
rpc.conf ファイルが無効なリストを含んでいるか、リストの内容が無効です。
「Authentication failed for user ...」(ユーザーの認証に失敗しました)

設定された認証バックエンドに問題があり、ユーザーがログインできないことを示しています。 この問題は、ユーザー名が enduser-users リストと一致しない場合、パスワードやユーザー名が間違っている場合、またはセッションが無効な場合に発生します。ログファイル内のエラーにさらに詳細な情報が記載されています。

エラーの原因が明確でない場合、enduser_ui.conf 内の debug_level の値を増やして、HTTPD (RPC/UI) サービスを再起動し、アクションを再実行します。ログファイルには、さらに詳細なエラーメッセージが記載されています。

「RPC call failed: ... 」(RPC コールが失敗しました: ...)...
通常、この形式で示されるエラーメッセージは、転送エラーです。セントラルサーバーへ接続できなかったり、バックエンドが使用するライブラリが予期せぬタイミングで停止してしまったことが原因で、中央サーバーが適切なエラーメッセージを送信できなくなる場合があります。
「Unable to initialize database connection:...」(データベース接続を初期化できません:...)
データベースが稼働していない、または EUWI がデータベースへの接続できていないことを示しています。データベースが起動されていることを確認します。複数サーバーがインストールされている場合、postgres/var/data/pg_hba.conf で EUWI サーバーにデータベースへのアクセス権が許可されているかどうかを確認します。