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

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

以下のセクションでは、トラブルシューティングのさまざまな要素と局面について説明します。

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

通常、インストール処理は正常に完了します。しかし、正常に完了するかどうかは、ネットワークの適切なサポートやオペレーティング システムの設定を含め、数多くの要因に依存します。インストール中に問題があった場合、Zen では問題を診断するために役立つツールやトラブルシューティングのテクニックが使用できます。

以下のセクションでは、インストールに関する調査で使用可能な手順について説明します。

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

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

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

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

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

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

次の表に、そのようなシナリオと、実行可能なアクションを示します。

Zen System Analyzer（PSA）は診断ツールです。これはデータベースのインストールに含まれるもので、以下の作業に利用することができます

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

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

Workgroup エンジンが起動しているかどうかを調べるには、以下の手順に従います。

［スタート］メニューまたはアプリ画面から［ワークグループ エンジンの開始］をクリックします。

デフォルトでは、MicroKernel によりリソースが割り当てられ、ローカル アプリケーション データベースのリクエストに対応する準備が整います。

［スタート］メニューまたはアプリ画面から［ワークグループ エンジンの停止］をクリックします。

以下の条件下でエンジンを停止しようとすると、警告メッセージが表示されます。

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

ps -e | egrep 'mkded'

エンジン サービスを開始する必要がある場合は、root ユーザー アカウントの権限で、次のコマンドをコマンド プロンプトで実行します。

etc/init.d/actianzen start

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

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

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

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

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

MicroKernel データ ファイルのファイル バージョンは Zen ユーティリティを使用して調べることができます。Windows プラットフォームでは、エクスプローラー、Function Executor、DDF Builder、または Btrieve Maintenance ユーティリティを使用します。butil コマンド ライン ユーティリティはどのプラットフォームでも使用できます。以下のトピックでは、上記のいくつかの方法を使用する際の情報を提供します。

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

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

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

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

butil の -stat パラメーターを使用して、以下の情報に関するファイル統計情報を見ることができます。

たとえば、次のコマンドでは Zen に含まれる Demodata サンプル データベースの dept.mkd ファイルの情報を返します。このファイルは、デフォルトのインストール先である C:\ProgramData\Actian\Zen\Demodata にあります。

butil -stat dept.mkd

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

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

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

Zen のライセンス コンポーネントは、データベース エンジンの製品キーが無効だと判定することがあります。この場合に、キーの状態を "アクティブ" から "検証失敗" に変更します。通常、これは以下のいずれかの操作を行った場合に、無効であることがわかります。

検証失敗とその可能性となる原因を、メッセージ ログやその他の通知によって警告されます。その原因でもっとも一般的なのは、Zen が実行されているシステムのホスト名の変更によるものです。

検証失敗後でも、"検証失敗期間" と呼ばれる一定の期間内はデータベース エンジンが正常に機能します。この期間（製品キー内に設定されている）には、検証失敗を修正し、キーの状態を検証失敗からアクティブに移行するための時間が十分にあります。

この期間が何日間あるかを確認する方法は 3 つあります。

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

詳細については、『Advanced Operations Guide』のメッセージ ログの見直しおよび、『Zen User's Guide』のライセンス管理の概念を参照してください。

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

この状況は、Workgroup エンジンをアプリケーションとしてインストールした場合に発生することがあります。アプリケーションではユーザーの管理者権限が自動継承されません。エンジンを一旦停止し、管理者としてそのエンジンを起動した後、License Administrator のコマンド ライン バージョンまたは GUI バージョンを管理者として実行し、ライセンスを適用してください。もう 1 つの方法としては、Workgroup エンジンをインストールし、サービスとして起動します。サービスとしての Workgroup エンジンの起動を参照してください。

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

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

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

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

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

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

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

Zen では、DOS コンポーネントが適切に機能していることを確認できるよう、コマンド ライン ユーティリティ butil.exe が用意されています。デフォルトのインストールでは、このユーティリティは C:\Program Files (x86)\Actian\Zen\bin に配置されています。

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

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

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

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

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

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

前述のような状況でシステム上にファイルが残る原因は、Windows で、複数のプログラムから使用されていることを示すカウント数でそれらのファイルがマークされるからです。このため、アンインストール プログラムではファイルを削除しません。これは想定される動作ですが、Zen のインストーラーが正しく機能しないという誤った状況につながる可能性があります。

インストール中またはインストール後に、ユーザー マニュアルでは対処できない問題が発生した場合は、弊社テクニカル サポートまでお問い合わせください。