|
Pervasive PSQL ではメッセージ用のさまざまなログ リポジトリを提供して、トラブルシューティングを支援します。ログは大きく分けて 2 つのカテゴリに分類されます。
次の表にログ リポジトリの概要を示します。
リポジトリ
|
記録元
|
---|---|
ライセンス管理コンポーネント
|
|
ライセンス管理コンポーネント(Windows)
Pervasive PSQL の全コンポーネント(Linux)
|
|
Pervasive PSQL の全コンポーネント(Windows)
|
ログ リポジトリのいくつかはライセンス メッセージに重点を置いています。これは、Pervasive PSQL のライセンス コンポーネントが、データベース エンジン用のキーの有効性を定期的に検証するからです。キーが無効と判定されると、そのキーの状態は "アクティブ" から "検証失敗" に変わります。この状態でも一定の期間内はデータベース エンジンが正常に機能するので、検証失敗を修正するための時間は十分にあります。
この期間が終わる前に検証失敗を修正しなかった場合は、キーの状態が "無効" に変わります。これにより、このキーは無効となりデータベース エンジンはデータ ファイルにアクセスできなくなります
検証失敗への対応を適時に行う必要があるため、キーの状態の変更はできるだけ早く通知されるようになっています。たとえば、1 つのメッセージがすべてのメッセージ リポジトリに記録されます。リポジトリの中で最もわかりやすいのは Pervasive Notification Viewer です。(License Administrator でもキーの状態が表示されます。このため、いつでも検証動作を実行して状態を再確認することができます。『Pervasive PSQL User's Guide』のライセンス管理を参照してください)。
次の表では、キーの状態の変更に応じて返されるメッセージのタイプについて説明します。
状態が "期限切れ"(一時キーの場合のみ適用)、または "非アクティブ"(前バージョンの Pervasive PSQL で登録されたままのキーに適用)となっているキーに関するメッセージは記録されないので注意してください。
次の表は、ライセンス メッセージが記録される頻度を特定の動作別に示しています。
起因動作
|
ログ記録の頻度
|
ログ リポジトリ1
|
---|---|---|
表 21 で示したキーの変更状況
|
即時
|
|
キーが検証失敗状態のまま
|
1 日 1 回通知
|
|
API 呼び出しによってプログラムから起動した検証動作
『Pervasive PSQL User's Guide』の認証残り回数を表示するには、『Distributed Tuning Interface Guide』の 「PvValidateLicenses()」、および『Distributed Tuning Objects Guide』の ValidateLicenses を参照してください。
|
即時
|
|
Pervasive PSQL ライセンス サーバーから発生した警告またはエラー メッセージ
|
即時
|
|
1メッセージ ログは一方向の階層に従って記録されます。Pervasive Notification Viewer へ記録されるライセンス メッセージはオペレーティング システムのイベント ログへ、さらに Pervasive PSQL イベント ログへと記録されます。オペレーティング システムのイベント ログに記録されるライセンス メッセージは、Pervasive PSQL イベント ログにも記録されます。
|
Pervasive Notification Viewer(以下「Notification Viewer」)は、ライセンス コンポーネントによって記録されるメッセージを表示するアプリケーション ユーティリティです。このユーティリティは、注目すべきライセンス メッセージ(表 22 を参照)をわかりやすく通知することを目的としています。
Notification Viewer は、デフォルトで Pervasive PSQL Server(Windows および Linux バージョンの 32 ビットおよび 64 ビット版)および Pervasive PSQL Workgroup のインストール時に一緒にインストールされます。また、Windows プラットフォームではデフォルトで、Windows を再起動すると Notification Viewer も再起動します。
Windows プラットフォームの場合、この実行可能ファイルの名前は notifyviewer.exe です。 このユーティリティはユーザーに対し、単独で実行するインスタンスを提供します。Notification Viewer が既に実行されている状態で新たに Notification Viewer を起動しようとすると、実行済みの GUI が画面の最前面に表示されます。
Linux ディストリビューションの場合、このユーティリティは notifyviewer という名前のシェル スクリプトです。このシェル スクリプトは実行するたびに、新たな Notification Viewer インストタンスを起動します。Linux を再起動した場合は、Notification Viewer を手動で再起動する必要があります。Linux の再起動時、このシェル スクリプトは自動的には実行されません。
次のコマンドライン オプションを使用すると、このユーティリティの実行方法を指定できます。
Notification Viewer では、システム トレイ アイコンとグラフィカル ユーザー インターフェイス(GUI)の 2 つのインターフェイスを提供します。
デフォルトで、Windows の場合は、Notification Viewer を実行すると GUI は表示されずトレイ アイコンが表示されます(Linux の場合、Notification Viewer は GUI として実行し、その Linux ディストリビューションがシステム トレイをサポートしている場合は、システム トレイ アイコンを表示します)。ユーティリティが実行されると、ライセンス メッセージの監視を開始します。
Notification Viewer が未読のメッセージを検出すると、トレイ アイコンは未読メッセージを示す表示に変わります。トレイ アイコンを参照してください。
Notification Viewer は 2 種類のツールヒントも表示します。ツールヒントをマウスでポイントすると、重要な未読メッセージがある場合はそのメッセージ数、未読メッセージの総数が表示されます。メッセージがすべて既読の場合はユーティリティの名前が表示されます。通知する必要があるメッセージを Notification Viewer が検出した場合は、バルーン形式のツールヒントが表示されます。Windows の場合、このツールヒントは直接閉じるか、キーボードまたはマウス操作を行わない限り表示され続けます。Linux の場合、このツールヒント上をクリックして閉じる必要があります。
トレイ アイコンのポップアップ メニューには、[Pervasive Notification Viewer を開く](GUI を開く)および[終了](ユーティリティを終了する)があります。このポップアップ メニューはトレイ アイコンを右クリックすると表示されます。
次の表ではトレイ アイコンの意味を説明します。
アイコン
|
説明
|
---|---|
![]() |
Notification Viewer は実行中でライセンス メッセージを監視しています。このアイコンは、すべてのメッセージが開封済み(既読)である "正常" な状態を示しています。
|
![]() |
Notification Viewer には未読メッセージがあります。
このアイコンは、未読メッセージがすべて開封されない限り表示され続けます。左パネルを参照してください。
|
トレイ アイコンをダブルクリックするか、トレイ アイコンを右クリックして[Pervasive Notification Viewer を開く]をクリックすると Notification Viewer GUI を開くことができます。Linux の場合はデフォルトで、Notification Viewer は GUI として実行し、そのシステム トレイ アイコンが表示されます(Linux での起動動作を変更する場合は、notifyviewer シェル スクリプトに -tray オプションを 渡します)。Linux ディストリビューションでシステム トレイがサポートされない場合、Notification Viewer は GUI を表示し、システム トレイ アイコンは表示しません。その場合は、シェル スクリプトを実行して Notification Viewer を起動してください)。
この GUI が表示されると、未読メッセージが直ちに GUI へ追加されます(さらに、トレイ アイコンにツールヒントが表示され、アイコンは未読メッセージを示す表示に変わります)。
Pervasive PSQL は、通知ファイルにある記録の既読または未読状態をユーザーごとに監視します。つまり、GUI を表示している各ユーザーからはすべてのメッセージが見えますが、メッセージの既読または未読状態はユーザーごと異なるということです。
Notification Viewer の 画面を閉じるとこのユーティリティは終了します。システム トレイがサポートされる場合は、画面を閉じることで GUI が非表示になり、ユーティリティが実行中であることを示すトレイ アイコンが表示されます。
図 31 で示すように、Notification Viewer GUI にはツールバーと 2 つのメイン パネルがあります。
Pervasive PSQL のライセンス管理コンポーネントは、Windows プラットフォーム上でオペレーティング システムのイベント ログにメッセージを書き込みます。Linux ディストリビューションの場合、Pervasive PSQL の全コンポーネントがオペレーティング システムのイベント ログへメッセージを書き込みます。
Windows オペレーティング システムでは、"アプリケーション"、"セキュリティ" または "システム" として分類されるイベントの記録方法を提供しています。Pervasive PSQL はライセンス メッセージを Windows の "アプリケーション" イベント ログのみに記録します。このメッセージは PVSW.LOG に書き込まれるライセンス メッセージのサブセットです。
ライセンス メッセージは "エラー" または "警告" として分類され記録されます。これには、キーの状態の変更に起因するメッセージのほか、警告、エラー メッセージが含まれます(表 22 を参照)。さらに、表 21 で挙げているような特定の情報メッセージも記録されます。
Windows オペレーティング システムでは、イベント ログを表示および操作するための「イベント ビューアー」という GUI を提供しています。このユーティリティは、Windows コントロール パネルから、あるいはコマンド インターフェイスで eventvwr.msc コマンドを実行してアクセスすることができます。イベント ビューアーのインターフェイスは、Windows XP/Windows Server 2003 と Windows Vista 以上では異なっているので注意してください。
どのイベント ビューアーを使用した場合でも、Pervasive PSQL はイベントに対し以下の項目を表示します。
さらに Windows Vista 以上では、[キーワード]列に "クラシック"、[ログ]列に "アプリケーション" を表示します。イベント ビューアーではさらに列が表示できるようになっていますが、Pervasive PSQL はそれらに対するデータを提供しません。
Linux ディストリビューションの場合は、Pervasive PSQL の全コンポーネントが Linux の標準ログ システム syslog にメッセージを書き込みます。syslog はデフォルトで /var/log/messages ディレクトリに書き込みます。SQL 接続マネージャーに限り、任意でメッセージを event.log ファイルに記録することもできます。
Bti.ini は Lnux ディストリビューションで使用される Pervasive PSQL 設定ファイルです。デフォルトで、このファイルは /usr/local/psql/etc ディレクトリにあります。
このファイルを使用すると、SQL 接続マネージャー用の構成を行うことができます(INI ファイルの[SQLManager]セクション)。設定の 1 つである LogEvent は、イベント ログ ファイル(event.log)に記録するイベント メッセージのタイプを決定します。デフォルトで、event.log ファイルは /usr/local/psql/bin ディレクトリにあります。
Windows プラットフォームの場合、Pervasive PSQL の全コンポーネントが Pervasive PSQL のイベント ログへステータス、エラー、警告および情報メッセージを書き込みます(Linux ディストリビューションの場合、Pervasive PSQL は専用のイベント ログを使用しません。その代り、Pervasive PSQL の全コンポーネントが Linux の標準ログ システム syslog にメッセージを書き込みます。Linux ディストリビューションのイベント ログ を参照してください)。
Pervasive PSQL のイベント ログは PVSW.LOG という名前が付けられ、デフォルトで <アプリケーション データ ディレクトリ>¥PSQL¥logs ディレクトリにあります。Windows プラットフォームでは Pervasive PSQL の全コンポーネントがこのログ ファイルに書き込みます。複数の Pervasive ベースのアプリケーションが同じマシン上で動作している場合、これらのアプリケーションは PVSW.LOG を共有します。
PVSW.LOG は、次の表 23 で説明されている形式のテキスト メッセージで構成されます。
エントリの後に、標準の 16 進形式のバイナリ データが続くことがあります。バイナリ データの長さには、制限がありません。
以下は、PVSW.LOG に含まれるデータのタイプの例です。
|