Pervasive PSQL では、設定やインストールの問題の解決に役立つ機能やツールを備えています。

これらのユーティリティの中には、エンジンのインストール時にインストールされ直ちに実行されるものもあります。すべてのユーティリティはエンジンのインストール後に実行し、環境設定やレジストリ設定、トラブルシューティングに利用することができます。ユーティリティの一覧は、表 27 で示します。

この章では、以下の項目について説明します。

次の表は、問題の回避と解決に役立つツールの説明です。

Pervasive Software は、インストール処理が何の問題もなく完了することを望んでいます。しかし、ネットワークの適切なサポートやオペレーティング システムの設定を含め、数多くの要因によって問題が発生する可能性があります。

インストール中に問題があった場合、Pervasive では問題の原因を突き止めるために役立つツールを提供します。この章では、いくつかの実用的なトラブルシューティングのテクニックについて説明します。

このセクション以降には、インストールに関する調査で使用可能な以下の手順が含まれています。

Pervasive PSQL によって記録されるメッセージは、問題の解決に役立ちます。メッセージのタイプには、ステータス、情報、警告またはエラーがあり、これらは Pervasive PSQL コンポーネントから発生します。ライセンス管理コンポーネントからのみ発生するライセンス問題に特化したメッセージもあります。いずれの場合も Pervasive PSQL はメッセージを以下のリポジトリに記録します。

Pervasive Notification Viewer へ記録されるライセンス メッセージは、オペレーティング システムのイベント ログおよび Pervasive PSQL イベント ログへも記録されます。同様に、オペレーティング システムのイベント ログに記録されるライセンス メッセージは、Pervasive PSQL イベント ログへも記録されます。ただし、オペレーティング システムのイベント ログと Pervasive PSQL イベント ログには、Pervasive Notification Viewer に記録されないライセンス メッセージが含まれる可能性があります。

ライセンスに特化しないメッセージは、オペレーティング システムのイベント ログおよび Pervasive PSQL イベント ログへ記録されます。

これらのガイドラインに従ってメッセージを使用し、問題を解決してください。

ライセンスに関する問題が疑われた場合は、まず Notification Viewer をチェックし、その次にオペレーティング システムのイベント ログおよび Pervasive PSQL イベント ログをチェックしてください。ライセンスとは関係ない問題が疑われた場合は、オペレーティング システムのイベント ログおよび Pervasive PSQL イベント ログをチェックしてください。

ログの詳しい説明については、『Pervasive PSQL User's Guide』の Pervasive PSQL メッセージ ログを参照してください。ステータス コードの詳細については、『Status Codes and Messages』のステータス コードを参照してください。

ここでは、適切なデータベース操作のために Pervasive PSQL のデフォルトの設定の調整が必要な場合のシナリオを示します。

以下の表では、これらのシナリオのいくつかをまとめています。該当する設定がありましたら、詳細説明が含まれる参照先をご覧ください。

Pervasive System Analyzer は Pervasive PSQL に含まれる診断ユーティリティです。

Pervasive System Analyzer（PSA）は、便宜上、製品のインストール過程に組み込まれていますが、スタンドアロンで実行できる診断ツールとしても使用可能です。このツールは以下の作業に利用することができます。

Pervasive PSQL エンジンが起動するかどうかを調べるには、以下のお使いのプラットフォームおよびエンジン向けの手順をご覧ください。

Windows の［コントロール パネル］のサービス機能を使用することができます。

Pervasive PSQL ワークグループ エンジンが起動するかどうかを調べるには、以下の手順に従います。

Linux の ps ユーティリティを使用してエンジン（mkded）が実行されていることを確認できます。

root ユーザー アカウントの権限で、コマンド ラインで次のように入力します。

Pervasive PSQL のユーティリティを使用して、クライアントおよびエンジンのバージョン番号、あるいは特定のファイルのバージョン番号を調べることができます。

Windows プラットフォームで Function Executor を使用して、またはすべてのプラットフォームで BUTIL コマンド ライン ユーティリティを使用してエンジンとクライアントのバージョンを調べることができます。Function Executor は Pervasive PSQL リクエスターを使用して Btrieve クライアント オペレーションをシミュレートするユーティリティです。

Function Executor を使用してクライアント、ローカルおよびリモート エンジンのバージョンを調べます。

コマンド プロンプトから次のコマンドを入力します。

リクエスターとエンジンのバージョンが表示されます。このツールではリモート サーバー エンジンのバージョンを調べることはできません。

MicroKernel データ ファイルのファイル バージョンは Pervasive PSQL v11 SP3 ユーティリティを使用して調べることができます。Windows プラットフォームでは、Control Center、Function Executor、DDF Builder、または Btrieve Maintenance ユーティリティを使用します。BUTIL コマンド ライン ユーティリティはどのプラットフォームでも使用できます。これらの方法の使用についての情報を次に説明します。

Pervasive PSQL Control Center を使用するとファイルのバージョンを調べることができます。

コマンド ラインを使い慣れていない場合は、GUI ベースの Btrieve Maintenance ツールを使用できます。

Function Executor ユーティリティは Btrieve オペレーションをシミュレートするので、ファイルに対する情報レポート作成を実行することによってファイル バージョンを調べることができます。

Function Executor ユーティリティの詳細は、『Advanced Operations Guide』で説明しています。

BUTIL の -stat パラメーターを使用して、次のファイル統計情報を取得することができます。

コマンド プロンプトで次のコマンドを入力します。

たとえば、Pervasive PSQL に含まれる DEMODATA データベースの DEPT.MKD ファイルの統計を取得するには次のように入力します。

BUTIL ユーティリティ（Windows および Linux で使用可能）の詳細は、『Advanced Operations Guide』で説明しています。

Pervasive は、データベース エンジンと同じバージョンのクライアント リクエスターを使用することをお勧めします。通信するデータベース エンジンより古いバージョンのクライアント リクエスターを使用することもできます。ただし、アプリケーションで使用する SDK アクセス方法のタイプによっては、古いバージョンのリクエスターがデータベース エンジンで動作しないこともあります。アプリケーションはデータベース エンジンと通信できなくなります。そのような状況の場合は、データベース エンジンと同じバージョンのクライアント リクエスターを使用する必要があります。

データベース エンジンよりも新しいバージョンのクライアント リクエスターの場合、正しく機能するかどうかはわかりません。Pervasive では、新しいバージョンのクライアント リクエスターと古いバージョンのエンジンを一緒に使用した場合の動作については保証しません。このため、新しいバージョンのクライアント リクエスターと古いバージョンのエンジンを一緒に使用しないようにしてください。

Pervasive PSQL のライセンス コンポーネントは、データベース エンジン用のキーが有効かどうかを定期的に検証します。 キーが無効と判定されると、そのキーの状態は "アクティブ" から "検証失敗" に変わります。この状態でも一定の期間内（"検証失敗期間" といいます）はデータベース エンジンが正常に機能するので、検証失敗を修正するための時間は十分にあります。デフォルトで、Pervasive PSQL Server および Pervasive PSQL Workgroup での検証失敗期間は 14 日間です。 Pervasive PSQL Vx Server でのデフォルトの検証失敗期間は 30 日間です。

この検証失敗期間が終わる前に検証失敗を修正しなかった場合は、キーの状態が "無効" に変わります。これにより、このキーは無効となりデータベース エンジンはデータ ファイルにアクセスできなくなります。

検証失敗への対応を適時に行う必要があるため、キーの状態の変更はさまざまなログ リポジトリからできるだけ早く通知されるようになっています。詳細については、『Pervasive PSQL User's Guide』の Pervasive PSQL メッセージ ログを参照してください。

このセクションでは、Workgroup 製品をインストールする際、または初めて使用する際に発生する可能性のある問題について説明します。

この状況は、Windows Vista 以上のオペレーティング システムで、Pervasive PSQL Workgroup をアプリケーションとしてインストールした場合に発生することがあります。Windows Vista 以上のユーザー アクセス制御（UAC）を使用する OS の場合、アプリケーションはユーザーの管理者権限を継承しません。

Pervasive PSQL ワークグループ エンジンをサービスとしてインストールする、またはエンジンを一旦停止し、管理者としてそのエンジンを起動した後、コマンド ラインまたは GUI バージョンの License Administrator を管理者として実行し、ライセンスを認証してください。

データベース エンジンを停止して再起動してください。エンジン設定コンポーネントの変更を行った場合は、その変更を有効にするためにデータベース エンジンを停止し、再起動する必要があります。データベース エンジンの起動と停止については、データベース エンジンが起動するかどうかのチェックを参照してください。

PCC でデータベースを新規作成する場合、新しいデータベースの名前が dbnames.cfg に追加され、対応するシステム DSN を作成するためにエントリが ODBC.INI レジストリに追加されます。

Microsoft Vista オペレーティング システムではレジストリ アクセスに対する制約があるため、データベース システム DSN を作成できるようにするにはワークグループ エンジンを昇格モードで実行するようにしてください。

システム DSN の作成に成功すれば、ユーザーはワークグループ エンジンを起動してその DSN を使用することができます。

アプリケーションのデータベース エンジンとのセッションが失われています。これは、前述のトラブルシューティング例のように、設定値を変更した後でデータベース エンジンを再起動する必要がある場合などに発生する可能性があります。データベース エンジンを停止すると、その時点で実行されていたアプリケーションのデータベース エンジンとのセッションが失われます。通信を再確立するためには、すべてのユーティリティをいったん停止した後で再起動する必要があります。

このステータス コードが返される可能性があるその他のケースについては、『Status Codes and Messages』マニュアルを参照してください。

最新の DLL で上書きされた場合は、Pervasive PSQL インストール時に自動的に作成されるバックアップ ディレクトリを使用して、上書きされた DLL を元に戻すことができます。

Pervasive では、DOS コンポーネントが適切に機能していることを確認できるよう、BUTIL.EXE の DOS バージョンが用意されています。このファイルは、Pervasive PSQL プログラム ファイルがデフォルトでインストールされるディレクトリの PSQL\BIN フォルダーにインストールされます。

データベース エンジンが不正に停止された場合、そのコンポーネントがメモリに残ることがあります。

以前の Pervasive PSQL リクエスターがインストールされており、その後 Pervasive PSQL v11 SP3 ワークグループ エンジンをインストールした状況で、アプリケーションがリクエスターのみを使用していた場合は、古い設定でローカル アクセスが無効になっている可能性があります。Pervasive PSQL v11 SP3 ワークグループ エンジンのインストール プログラムは、既存の設定を上書きしません。ローカル アクセスを有効にする方法については、サーバー エンジンとワークグループ エンジンの同時使用を参照してください。

このメッセージは、更新される PATH 定義が長すぎる（環境領域の制限文字数を超えている）ために、インストール プログラムが PATH 環境変数を更新することができなかった場合に表示されます。config.sys で定義されている環境領域を増やす方法についての情報は、Microsoft KnowledgeBase で該当する記事を参照してください。

このメッセージが表示された場合、REM ステートメント（コメント）が autoexec.bat ファイルに追加されます。REM ステートメントには入力された PATH の値が含まれています。PATH ステートメントは手動で変更することができます。

可能であれば、PATH の値が環境領域（制限文字数）範囲内に収まるインストール ディレクトリの場所に製品をインストールすることが最良の方法です。

Windows の「アプリケーションの追加と削除」メカニズムを使って Pervasive PSQL をアンインストールすれば、システム上のデータベース エンジン ファイルはすべて削除されます。しかし、アーカイブされたコンポーネントを復元するなどの操作を行っていた場合は、多くのファイルが削除されないままシステム上に残ります。これは、Windows オペレーティング システムのインストール処理メカニズムによって発生する副次的な事象です。

通常の場合、Windows ではファイルが複数のプログラムから使用されていることを示すカウント数を保持しています。アンインストール プログラムでは、複数のプログラムから使用されているファイルはシステムから削除しません。これは適切な動作ですが、結果的には Pervasive PSQL のアンインストール プログラムが正しく機能しません。

Pervasive Software では、インストールが正しく完了するよう万全を期しています。インストール中またはインストール後に、ユーザー マニュアルでは対処できない問題が発生した場合は、株式会社エージーテックにお問い合わせください。速やかに対処いたします。

ご質問への回答や問題のトラブルシューティング方法に関するリソースおよび問い合わせ先の情報については、『Pervasive PSQL User's Guide』の Pervasive Software のリソースを参照してください。

Pervasive PSQL のインストールに関するご質問や問題については、株式会社エージーテックのサポート サービス部門がお役に立ちます。