この章では、Pervasive PSQL インストールをカスタマイズする方法の概念および手順について説明します。Pervasive PSQL インストールのカスタマイズでは、Pervasive PSQL 製品の全部または一部を貴社のアプリケーションにバンドルすることが可能です。この章では、以下の項目について説明します。

ここでは、Pervasive Software が Pervasive PSQL 製品インストールで使用するテクノロジおよびカスタマイズ設定の概要について説明します。Pervasive PSQL インストールで使用されるテクノロジは Microsoft Windows Installer（MSI）です。カスタマイズ用の設定は PTKSetup.ini ファイルにあります。

ほとんどのインストール シナリオでは、インストールにセットアップ実行可能ファイルを使用する必要があります。セットアップ実行可能ファイルは InstallShield ブートストラップ パッケージで、インストールを実行する前にさまざまなチェックを行います。また、セットアップ実行可能ファイルは、MSI インストールを起動する前に、ターゲット システムで必要な Windows インストーラー サービスのバージョンの検出とインストールも行います。要件を満たすバージョンの MSI がターゲット システムにあることを確認できた場合は、セットアップ実行可能ファイルが自動的に MSI インストールを起動します。インストールしようとするシステムに Pervasive PSQL でサポートされる MSI テクノロジのバージョンが含まれているかどうか不明な場合は、セットアップ実行可能ファイルを使用してください。

ご自身のソフトウェア アプリケーションに Pervasive PSQL をバンドルする場合は、Pervasive PSQL MSI ファイルによるインストール処理を使用することをお勧めします。MSI ファイルを用いれば、Pervasive PSQL でサポートされるバージョンの Windows インストーラーがターゲット システムに含まれている場合、ソフトウェア アプリケーションのインストール時に Pervasive PSQL インストールを呼び出すことができます。Microsoft Windows Vista 以上では、MSI ファイルを用いた Pervasive PSQL インストールを実行する前に、Pervasive PSQL インストールを呼び出す処理が、昇格されたユーザー資格情報で実行されている必要があります。

MSI テクノロジの詳細については、Microsoft のマニュアルおよび Web サイトを参照してください。Windows インストーラーで使用可能なオプションやパラメーターは、DOS プロンプトで以下のコマンドを入力して使用できます。

このマニュアルではこの情報についてこれ以上の説明を行いません。その代わり、貴社の Pervasive PSQL インストールをカスタマイズするために MSI テクノロジを使用する実例を提供します。

MSI テクノロジを使用してコマンド ラインによるインストールを実行する場合は、MSI ファイルを使用してインストール処理を実行します。

次の表は、Pervasive PSQL の各製品と、その Pervasive PSQL 製品に関連付けられているセットアップ実行可能ファイル名および MSI ファイル名を示しています。

PTKSetup.ini ファイルは Pervasive PSQL の各製品のインストールに含まれています。このファイルはインストール メディアの MSI 実行可能ファイルがある同じフォルダーにあります。PTKSetup.ini ファイルの各セクションには、サポートされるキーと指定可能な値についての説明があります。

PTKSetup.ini ファイルには 2 つの主要セクションがあります。[PROPERTIES] セクションでは、サイレント インストール時または有人インストール時に使用可能なオプションを提供します。[Registry Migration] セクションは Pervasive PSQL v10 より前のバージョンの Pervasive PSQL にのみ適用されます。このセクションについては後で詳しく説明します。

次の表は、PTKSetup.ini の [PROPERTIES] セクションにあるカスタマイズ可能なカテゴリと、各カテゴリのキーについて概説します。

PTKSetup.ini ファイルの 2 番目のセクションは、Pervasive PSQL v10 より前のバージョンからアップグレードする場合にのみ使用できます。最新バージョンの Pervasive PSQL へアップグレードする間に、このセクションに指定されたレジストリ設定を移行することによって、Pervasive PSQL v9 以前の構成設定を維持します。

[Registry Migration] セクションでは、各種設定について以前のバージョンの設定が等号（=）の左側に記載され、等号の右側に Pervasive PSQL 用の設定が記載されています。

レジストリ移行設定には次のような書式を使用します。
<古いバージョン>=<新しいバージョン>

インストール時に Pervasive PSQL v10 より前のバージョンから移行しない設定についてはコメント行にします。移行されるキーが既に存在する場合、以前のレジストリ設定は移行された設定に置き換わります。

現在の設定を確認するには bcfg ユーティリティ使用します。このユーティリティについては『Advanced Operations Guide』を参照してください。このユーティリティを使用すれば、現在の設定を取得して確認することができるので、設定の変更が必要かどうかを判断するのに役立ちます。

Pervasive PSQL のインストール後、Distributed Tuning Interface（DTI）で使用可能な関数を使用して、お使いの Pervasive PSQL エンジンの設定やチューニングを行うことができます。DTI の関数を使用すれば、現在の設定を調べたりプログラムから設定を変更したりするなど、さまざまなタスクを実行することができます。

Pervasive PSQL エンジンの設定を行うための DTI 関数の使用に関する詳細については、『Distributed Tuning Interface Guide』の「DTI 関数グループ」セクションにある関数の一覧を参照してください。

Pervasive DTO オブジェクトは、DTI インターフェイスと同様、Pervasive Control Center 機能を実行するための COM インターフェイスです。

ワークステーションを復旧するための方法として再イメージ化やその他の技術を採用し、「システムの復元」を使用しない企業の環境では、インストーラー動作用の「システムの復元」を無効にすることによって、システムの復元ポイントを作成するための時間やディスク スペースが不要になりパフォーマンスを向上させることができます。

「システムの復元」を無効にするには、お使いのオペレーティング システムに固有の詳細な情報について、Microsoft のヘルプ システムを参照してください。

この設定はインストーラーが開始する復元動作のみに影響します。またこの設定はグループ ポリシーで使用することができ、各ワークステーションへの配置を支援します。

以下の 3 つの方法のいずれかを使用することで、インストールに対して簡単なカスタマイズが行えます。

ここでは、Windows インストーラーに含まれているオプションとパラメーターを使用した、インストールのカスタマイズについて説明します。

この quiet オプションを使用すると、ユーザーが介入することなくインストールが実行できます。サイレント インストールではそれ以外の別のインストールを自動的に起動することはできません。サイレント インストールの場合は、製品が完全な最新版になるよう別のインストールを実行する必要がある場合もあります。サイレント インストールで特に考慮すべき点を参照してください。

以下の手順では、コマンド ラインから、quiet オプションを指定して Pervasive PSQL をインストールする方法について説明します。

サイレント インストールではそれ以外の別のインストールを自動的に起動することはできません。サイレント インストールの場合は、製品が完全な最新版になるよう別のインストールを実行する必要がある場合もあります。そのような独立したインストールの例には次のようなものがあります。

アップグレードとは旧バージョンのリリースから現在のリリースに移行することです。現在のリリースにアップグレードする前に、パッチを適用しておく必要がある場合があります。現在のリリース用の readme ファイルを参照してください。これには必要なアップグレード パッチが挙げられています。アップグレード パッチが使用可能であれば、最初にそれをインストールします。

コマンド プロンプトから以下のコマンドを使用してパッチをインストールします。

この場合、

Product は製品を示し、type および platform は製品の種類と製品を実行するプラットフォームを示します。たとえば、PSQLversionPatch_Client_x86.msp は、32 ビット プラットフォームの Pervasive PSQL クライアントを参照します。

現在のリリース用のパッチは「製品アップデート」と呼ばれます。製品の現在のリリースによっては、サイレント インストールの後に製品アップデートを適用する必要がある場合もあります。製品アップデートが必要な場合、インストール メディアの ~\Redist\PVSW\PSQL\Patches\ フォルダーにそのアップデートがあります。

そのフォルダーのパッチをインストールすると現在のリリースが確実に最新版になります。たとえば、以下のコマンドは 32 ビット版の Pervasive PSQL Server 用の製品アップデートをインストールします。

サイレント インストールが終了したかどうかを判断するために次のいずれかの方法を使用できます。

このセクションでは、PTKSetup.ini 設定を使用するカスタム インストールをコマンド ラインから実行する作業例を示します。PTKSetup.ini 設定を使用するインストール方法には、この INI ファイルで設定を指定し、コマンド ラインからオプションを指定しないでインストールを実行するというもう 1 つの方法もあります。

PTKSetup.ini ファイルで値を設定することはできますが、INI キーや値をこのファイルに追加することはできないので注意してください。このファイルに INI キーや値を追加しても、それらが Pervasive Software で定義されていなければインストール処理で無視されます。

Pervasive PSQL v11 より前のバージョンの Pervasive PSQL で、Pervasive PSQL キーは PTKSetup.ini ファイルで属性として指定できました。そのため、複数のインストールで同じキーを使用できました。本バージョンではインストールごとに独自の一意キーが必要となります。従来どおり、PTKSetup.ini にキーを指定することはできますが、そのキーはインストールが実行されるマシンごとに一意でなければなりません。

キーの配布にはさまざまな手段が用いられます。たとえば、パッケージの箱の上にキーを印刷する、箱の中に同梱する、エンド ユーザーへの電子メールに記載するなどの手段があります。キーの配布にどのような方法を用いたとしても、PTKSetup.ini におけるキーの一意性を保証する 1 つの方法は、アプリケーションのインストールでエンド ユーザーにキーの入力を促すことです。 その後、アプリケーションのインストールで PTKSetup.ini のローカル コピーにそのキーを書き込むことができ、PTKSetup.ini を使用するインストール処理を続行します。 PTKSetup.ini に有効なキーが指定されている場合、Pervasive PSQL インストール処理によってそのキーが自動的に認証されます。 キーが有効であるということは、インストールが実行されるマシンに対してキーが一意であるということです。

次の手順では、コマンド ラインからオプション機能を使用して Pervasive PSQL をインストールする方法について説明します。

PTKSetup.ini ファイルの設定に加えて MSI オプションとパラメーターも使用して、Pervasive PSQL インストールをカスタマイズすることができます。この方法を使用すれば、PTKSetup.ini 内のプロパティを無効にし、コマンド ラインから追加オプションを使ってインストールを実行できます。

このセクションでは、これらの両方のオプションを使用してカスタマイズされたインストールの作業例を提供します。ここで提供する例は、前述の例で使用した、PTKSetup.ini ファイルで値を設定する方法とコマンド ラインでオプションを指定する方法を組み合わせたものです。

MSI のパブリック プロパティである PVSW_CFG_FILE を設定して完全に修飾されたファイル パス名を渡すことによって、別の設定ファイルを使用することができます。このプロパティは、コマンド ラインで Windows のプロセス（msiexec）に渡す必要があります。

このプロパティを渡す前に、プロパティにスペースが含まれているかどうかを確認します。このプロパティにスペースが含まれていない場合は、次の例のように指定します。

プロパティにスペースが含まれている場合は、次の例に示すように、そのプロパティの値を二重引用符で囲み、先頭に円記号（\"）を付ける必要があります。

上記の例を組み合わせて使用すれば、MSI の複数のプロパティ設定を渡すこともできます。

対象とするターゲット システムに、現在サポートされている Windows インストーラーのバージョンがある場合は、MSI 実行可能ファイルを使用するだけです。MSDN のサポート技術情報（Knowledge Base）で Windows インストーラーのコマンド ラインオプションに関するトピック「Command-Line Options」（英語）に記載されている MSI パブリック プロパティを指定する手順に従います。

このセクションでは、Pervasive PSQL の組み込みインストールに対して高度なカスタマイズを行う方法について詳しく説明します。 Pervasive PSQL はインストールの高度なカスタマイズ方法として以下をサポートします。

Pervasive PSQL インストールにはキャビネット（CAB）ファイルが含まれています。このファイルはご自身のインストール パッケージから削除することによってインストール パッケージの全体のサイズを削減したり、不要なファイルを使用しないようにすることができます。これらのファイルを削除すると、カスタム セットアップ時にグラフィカル ユーザー インターフェイスで使用可能な機能のリストから該当する機能を自動的に削除します。

CAB ファイルは、MSI 実行可能ファイルやセットアップ実行可能ファイルがある同じディレクトリにあります。先頭にアンダースコア（_）が付く CAB ファイルがそのインストール タイプに必要なものです。インストール タイプごとに必要なファイルのリストについては、必要なファイルを参照してください。

CAB ファイルのコア セットは変わりません。ただし、Pervasive PSQL へのアップデートには、新たに追加されたコンポーネントや機能を担うために、Pervasive PSQL v11 でリリースされているオリジナル セットから追加された CAB ファイルが含まれます。新しい CAB ファイルが存在する場合、Pervasive PSQL へのアップデートでは追加の CAB ファイルの生成が必要となる可能性があります。インストール タイプ用のファイルの最新セットと、インストールしようとするオプション機能を確認して入手してください。

必要な CAB ファイルはアンダースコアで指定されます。次の表は、各インストール タイプに必要なキャビネット ファイルの一覧を示します。

次の表は、インストール タイプ別に適用されるオプション機能の一覧を示します。

一部のオプション機能では、その機能を有効にするために別のコンポーネントが必要な場合があります。以下の表には、別のコンポーネントを必要とするオプション機能を一覧表示します。

CAB ファイルを使用したインストールのカスタマイズの例を以下に示します。この例は、ワークグループ エンジンのインストールに、唯一のオプション機能としてドキュメントを加えます。

Pervasive PSQL インストールをご自分のアプリケーションに組み込むもう 1 つの方法は、カスタム ファイル選択を使用することです。これは、「チェリー ピッキング（良いもののみを選ぶこと）」と呼ばれることもあります。この方法を使用すれば、個々のファイル レベルで Pervasive PSQL コンポーネントを選択することができます。

組み込みインストールをカスタマイズするもう 1 つの高度な方法は、Windows インストーラーによる変換ファイル（MST）を作成することです。インストールをカスタマイズするために変換ファイルを作成する手法は、カスタマイズされたインストール用にカスタム ファイル選択を使用する方法と異なり、インストール時により柔軟に機能が選択でき、MSI テクノロジに関連する機能を保持し、またアップグレードやパッチを簡単に適用することができます。

MSI 変換を生成するには、インストール データベースを操作する必要があります。変換ファイルを生成に使用できるツールがいくつかあります。これらのツールとは Windows プラットフォーム SDK の InstallShield、Microsoft Orca または MSI ユーティリティ です。

カスタマイズされたインストールに変換ファイルを使用する例は、ショートカットをインストールしない Pervasive PSQL のインストールが挙げられます。このタイプの手法を実践する手順を以下に説明します。

次の例は、ユーザーの一時フォルダーにログ ファイルを作成します。

次の例は、ユーザーの一時フォルダーにログ ファイルを作成し、製品キーとサービス インストール オプションを指定します。

次の例は、ユーザーの一時フォルダーにログ ファイルを作成し、製品キーとサービス インストール オプションを指定します。

多くの場合、Windows システムにある Pervasive PSQL に適用された製品アップデートは、その製品アップデートをアンインストールすることによってロール バックすることができます。アンインストールによって、アップデートされている Pervasive PSQL バイナリを製品アップデート適用前の以前のバージョンの状態に戻します。

Windows Vista にインストールされた Pervasive PSQL 用のパッチは、インストールされた更新プログラムを表示］を選択したときにソフトウェア エクスプローラー（［プログラムのアンインストールまたは変更］）には表示されません。これは、Pervasive PSQL をアンインストールまたは変更する場合は、ユーザーに対し必ず管理者へ昇格するよう要求する機能が Pervasive PSQL にあるためです。

Pervasive PSQL 用の製品アップデートをコマンド ラインからアンインストールするには、以下の方法があります。

以下のコマンドのどちらかを使用して製品アップデートをアンインストールします。

または