PDF

Pervasive.SQL V8
Installation Toolkit Handbook
How to Integrate Pervasive Program Installations into Your Own
免責事項
Pervasive Software Inc. は、本ソフトウェアおよびドキュメントの使用を、利用
者またはその会社に対して「現状のまま」で、かつ同梱の使用許諾契約書に記
載の契約条件によってのみ許諾するものです。 Pervasive Software Inc. は、いかな
る場合にも本ソフトウェアおよび本マニュアルに記載された内容に関するその
他の一切の保証を、明示的にも黙示的にも行いません。 Pervasive Software Inc.
は、市場性、権利、特定の目的に対する適合性、あるいは一連の取引業務や職
業的な使用に関する問題などに対し、一切の保証を行わないことを明示すると
ともに、利用者およびその会社がこれに同意したものとします。
商標
Btrieve、 Client/Server in a Box、 Pervasive、 Pervasive Software および Pervasive
Software のロゴは、 Pervasive Software Inc. の登録商標です。
Built on Pervasive Software、 DataExchange、 MicroKernel Database Engine、 MicroKernel
Database Architecture、 Pervasive.SQL、 Solution Network、 Ultralight、 ZDBA は Pervasive
Software Inc. の商標です。
Microsoft、 MS-DOS、 Windows、 Windows 95、 Windows 98、 Windows NT、 Windows
Millennium Edition、 Windows 2000、 Windows XP、 Windows Server 2003、 Win32、 Win32s、
および Visual Basic は、 Microsoft Corporation の登録商標または商標です。
NetWare および Novell は Novell, Inc. の登録商標です。
NetWare Loadable Module、NLM、Novell DOS、Transaction Tracking System、TTS は、Novell,
Inc. の商標です。
すべての会社名および製品名は各社の商標または登録商標です。
©Copyright 2003 Pervasive Software Inc. All rights reserved. このマニュアルの全文、一部に関
わりなく複製、複写、配布をすることは、前もって発行者の書面による同意がない限り禁止しま
す。
本製品には、 Powerdog Industries により開発されたソフトウェアが含まれています。
©Copyright 1994 Powerdog Industries.All rights reserved. 本製品には、KeyWorks Software によ
り開発されたソフトウェアが含まれています。 ©Copyright 2002 KeyWorks Software.All rights
reserved. 本製品には、 DUNDAS SOFTWARE により開発されたソフトウェアが含まれています。
©Copyright 1997-2000 DUNDAS SOFTWARE LTD. All rights reserved 本製品には、 Apache
Software Foundation Foundation （http://www.apache.org/）により開発されたソフトウェアが含まれ
ています。
本製品に含まれている ODBC Driver Manager for NetWare （ODBC.NLM）は、 Ke Jin
<kejin@empress.com> による GNU iODBC software Copyright (Χ) 1995 に基づき、1999 年 6 月
に Simba Technologies Inc. が修正を加えたものです。
このライブラリはフリーソフトウェアであり、 Free Software Foundation の GNU Lesser General
Public License （第 2 版以降）の条項に従って再配布や変更が可能です。
このライブラリは、実用性を目的に配布されていますが、商品性や特定目的に対する適合性の
黙示保証を含め、保証は一切行いません。詳細については、『GNU Lesser General Public
License』を参照してください。
『GNU Lesser General Public License』は、 Pervasive.SQL をインストールすると、 \program
files\common files\Pervasive Software Shared\doc\lesser.htm に含まれています。このライセン
スが見つからない場合は、 Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston,
MA 02111-1307 USA までお問合せください。このマニュアルの裏表紙に掲載した Pervasive
Software, Inc. の連絡先もご利用ください。
Installation Toolkit Handbook
2004 年 8 月
100-004145-002
目次
このマニュアルについて . . . . . . . . . . . . . . . . . . . . . . . . . vii
このマニュアルの読者 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . viii
このマニュアルの構成 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ix
表記上の規則. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . x
1
Installation Toolkit の新機能 . . . . . . . . . . . . . . . . . . . . . . . . 1-1
Pervasive.SQL Installation Toolkit の新機能の概要
Windows Installer テクノロジの追加 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2
Windows Installer のサンプルプロジェクト . . . . . . . . . . . . . . . . . . . . . . . 1-2
Pervasive Toolkit API の削除 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-3
メインインストールから手動インストール用ファイルを除外 . . . . . . . . . . . . . . . 1-4
簡易更新 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-5
2
Installation Toolkit の概念 . . . . . . . . . . . . . . . . . . . . . . . . . 2-1
Pervasive インストールプログラムのカスタマイズおよび組み込み方法
Pervasive Installation Toolkit の紹介 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2
対応する開発環境 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-3
使用できるインストールの種類 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-4
Pervasive.SQL スマートコンポーネントの使用 . . . . . . . . . . . . . . . . . . . . . . . . 2-5
Pkg サブディレクトリのレイアウト . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-6
パスの長さ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-7
設定パラメータの移行 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-8
よく寄せられる質問. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-9
3
Windows Installer を使用した Pervasive.SQL の組み込み . . . . . . . . 3-1
Pervasive インストールプログラムのカスタマイズおよび組み込み方法
Pervasive Installation Toolkit for Windows Installer のインストール . . . . . . . . . . . . . . 3-2
カスタムインストール . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-4
インストールされた Installation Tookit のファイル . . . . . . . . . . . . . . . . . . . 3-5
インストールプロジェクトの例. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-6
インストールプログラムの呼び出し . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-7
製品がインストールされているかどうかのチェック . . . . . . . . . . . . . . . . . 3-7
利用可能なインストールプログラムの呼び出し . . . . . . . . . . . . . . . . . . . . 3-8
インストールプログラムの呼び出しの実行 . . . . . . . . . . . . . . . . . . . . . . 3-9
インストールプログラムの呼び出しのカスタマイズ . . . . . . . . . . . . . . . . . 3-10
iii
目次
Pervasive System Analyzer の呼び出し . . . . . . . . . . . . . . . . . . . . . . . . . . 3-10
再起動の必要条件 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-11
Windows Installer マージモジュール . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-14
システム MSM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-14
Pervasive MSM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-16
インストールのシンプルなカスタマイズの実行 . . . . . . . . . . . . . . . . . . . . . . . 3-18
インストール手順の補足. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-19
ライセンスキーの適用 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-19
インストール後のデータベースの作成 . . . . . . . . . . . . . . . . . . . . . . . . . 3-19
セットアップ中の PSA の実行 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-21
MSM にないインストール動作. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-21
スタンドアロンビルド . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-22
簡易更新 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-23
簡易更新の動作方法 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-23
簡易更新の使い方 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-25
Pervasive.SQL 製品のアンインストール . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-28
4
バッチファイルを使用した Pervasive.SQL の組み込み . . . . . . . . . 4-1
Pervasive インストールプログラムのカスタマイズおよび組み込み方法
手動インストールパッケージのインストール . . . . . . . . . . . . . . . . . . . . . . . . 4-2
手動によるファイルのインストール . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-4
コンポーネントウィザードを使用したインストールのカスタマイズ . . . . . . . . . . . 4-6
インストールの手順の補足 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-7
ライセンスキーの適用 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-7
インストール後のデータベースの作成 . . . . . . . . . . . . . . . . . . . . . . . . . 4-7
ドキュメントとユーティリティリソースのインストール . . . . . . . . . . . . . . 4-7
iv
図
3-1
3-2
3-3
3-4
3-5
3-6
3-7
3-8
3-9
Installation Toolkit のロケーションの指定 . . . . . . . . . . . . . . . .
Installation Toolkit のセットアップのタイプ . . . . . . . . . . . . . . .
Installation Toolkit のインストール準備完了 . . . . . . . . . . . . . . .
Installation Toolkit のファイルコピー処理 . . . . . . . . . . . . . . . .
Installation Toolkit のインストール完了 . . . . . . . . . . . . . . . . .
Installation Toolkit のカスタムインストール . . . . . . . . . . . . . .
Installation Toolkit のカスタムインストール . . . . . . . . . . . . . .
Installation Toolkit カスタムコンポーネントの選択解除 . . . . . . .
Windows プラットフォームにおける簡易更新の有効なサブフォルダ
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 3-2
. 3-2
. 3-3
. 3-3
. 3-3
. 3-4
. 3-4
. 3-4
. 3-25
v
表
2-1
2-2
2-3
3-1
3-2
3-3
3-4
3-5
4-1
4-2
vi
Windows NT/2000/Server 2003 インストールロケーション . . . . .
Windows 98/ME/XP インストールロケーション . . . . . . . . . . .
NetWare インストールロケーション . . . . . . . . . . . . . . . . .
インストールプログラムの呼び出し . . . . . . . . . . . . . . . . .
システムコンポーネント要件 . . . . . . . . . . . . . . . . . . . . .
非 Pervasive マージモジュール. . . . . . . . . . . . . . . . . . . . .
Pervasive マージモジュール . . . . . . . . . . . . . . . . . . . . . .
インストールプログラムによって認識される UPD サブフォルダ
DOS バッチファイルの例 . . . . . . . . . . . . . . . . . . . . . . .
レジストリの例 . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
2-10
2-10
2-11
3-8
3-12
3-14
3-16
3-24
4-4
4-5
このマニュアルについて
このマニュアルには、Pervasive 製品のインストールプログラムをほかのア
プリケーションのインストールプログラムに組み込む方法に関する開発
者向けの情報が記載されています。
vii
このマニュアルについて
このマニュアルの読者
このマニュアルには、Pervasive.SQL V8.6 を使って NetWare または Windows
32 ビットの各オペレーティング環境向けのアプリケーションを開発する
開発者向けの情報が記載されています。
viii
このマニュアルの構成
このマニュアルの構成
このマニュアルの各章について簡単に説明ます。

第 1 章「Installation Toolkit の新機能」
この章では、本リリースの Installation Toolkit における変更点の概要に
ついて説明します。

第 2 章「Installation Toolkit の概念」
この章では、 Installtion Toolkit のご紹介とその概念について説明します。
次の 2 つの章では Pervasive.SQL Installation Toolkit の使用法に関する概念
と手順を説明し、作成したアプリケーションのインストールプロシージャ
に Pervasive インストールの全部または一部をバンドルできるようにしま
す。インストールアプリケーションの種類に対応する章を選択してくださ
い。

第 3 章「Windows Installer を使用した Pervasive.SQL の組み込み」
この章では、 Windows Installer テクノロジを使用した Pervasive.SQL コ
ンポーネントの組み込みについて説明します。

第 4 章「バッチファイルを使用した Pervasive.SQL の組み込み」
この章では、バッチファイルとファイルコピーを使用した Pervasive.SQL コ
ンポーネントの組み込みについて説明します。
このマニュアルの巻末には索引が用意されています。
ix
このマニュアルについて
表記上の規則
特段の記述がない限り、コマンド構文、コード、およびコード例では、以下の
表記が使用されます。
大文字と小文字通常、コマンドと予約語は、大文字で表記されます。本書で別途
の区別
記述がない限り、これらの項目は大文字、小文字、あるいはその
両方を使って入力できます。たとえば、 MYPROG、 myprog、ま
たは MYprog と入力することができます。
x
[ ]
省略可能な情報には、［log_name］のように、角かっこが使用さ
れます。角かっこで囲まれていない情報は必ず指定する必要があ
ります。
|
縦棒は、［file name ｜ @file name］のように、入力する情報の選択
肢を表します。
< >
＜＞は、 /D=<5|6|7> のように、必須項目に対する選択肢を表
します。
変数
file name のように斜体で表されている語は、適切な値に置き換え
る必要のある変数です。
...
［parameter...］のように、情報の後に省略記号が続く場合は、そ
の情報を繰り返し使用できます。
::=
記号 ::= は、ある項目が別の項目用語で定義されていることを意
味します。たとえば、 a::=b は、項目 a が b で定義されていること
を意味します。
Installation Toolkit の新機能
1
Pervasive.SQL Installation Toolkit の新機能の概要
この章では、Pervasive.SQL V8.6 Installation Toolkit の機能および前のリリー
スとの相違点を概説します。
新しい機能や相違は以下のとおりです。

「Windows Installer テクノロジの追加」（1-2 ページ）

「Pervasive Toolkit API の削除」（1-3 ページ）

「メインインストールから手動インストール用ファイルを除外」
（1-4 ページ）

「簡易更新」（1-5 ページ）
1-1
Installation Toolkit の新機能
Windows Installer テクノロジの追加
Windows Installer テクノロジを使用すると、インストールの詳細な作業を
すべて行ってくれます。必要なのは、適切な MSM ファイルをプロジェク
トに含めることだけです。レジストリエントリ、ファイルコピーおよびコ
ンポーネントの登録は自動的に実行されます。 Pervasive System Analyzer を
含む製品全体をインストールしたい場合は、 setup.exe の呼び出しインス
トールを実行してください。
インストールに Pervasive.SQL マージモジュールを含めるには
1
Windows Installer プロジェクトにマージモジュールを追加します。
2
モジュールの要件によって目的のディレクトリを設定します。
マージモジュールの代わりにコンポーネント自体を含めると、そのコン
ポーネントを非 Windows Installer ツールからもアクセスおよびインストー
ルすることができます。この場合、コンポーネントの登録はインストール
ツール内で手動で行う必要があります。
Windows Installer の詳細については、「Windows Installer を使用した
Pervasive.SQL の組み込み」（3-1 ページ）を参照してください。
Windows Installer のサンプルプロジェクト
以前のツールキットで提供されたサンプルプロジェクトが、 Windows
Installer テクノロジも利用できるように変更されています。サンプルプロ
ジェクトについては、「インストールプロジェクトの例」（3-6 ページ）で
説明します。
1-2
Pervasive Toolkit API の削除
Pervasive Toolkit API の削除
Pervasive Toolkit API はこのリリースでは削除され、サポートもされません。
インストールアプリケーションに Windows Installer マージモジュールを含
めるか、 Pervasive コンポーネントをコピーして必要な登録とレジストリ操
作を行う一連のバッチファイルを実行することにより、今までどおりカス
タムインストールを作成することができます。
Pervasive が独自のインストールを作成するために使用するのと同じマー
ジモジュールのセットにアクセスすることができるため、 Ptk API は不要
になりました。マージモジュールは、選択した Pervasive.SQL コンポーネ
ントをインストールするために必要な要素をすべて提供します。
1-3
Installation Toolkit の新機能
メインインストールから手動インストール用ファイルを除外
Installation Toolkit の以前のリリースでは、手動インストール用パッケージ
は InstallShield ベースのインストールに組み込まれていました。
今回のバージョンでは、手動インストールパッケージについては別個の圧
縮（zip）ファイルとしてダウンロード提供するので、Windows Installer ベー
スのツールキットには含まれていません。
Pervasive.SQL を組み込む方法については、「バッチファイルを使用した
Pervasive.SQL の組み込み」（4-1 ページ）を参照してください。
1-4
簡易更新
簡易更新
Pervasive.SQL インストーラでは、インストールの過程で Pervasive.SQL の
各種ファイルのアップデートも追加インストールすることができます。こ
の機能は、「簡易更新」と呼びます。このように呼ばれる理由は、
Pervasive.SQL のインストールプログラムにファイルを追加するためには、
それらのファイルをインストールイメージの特定のディレクトリに置く
だけで済むからです。インストールプログラムでコードを変更する必要は
まったくありません。
この機能を使用すると、顧客は単一のインストール処理の中でメイン製品
と共に更新ファイルをインストールすることができるので、とても便利で
す。顧客は、更新ファイルを別個にインストールする必要がありません。
詳しい説明については、「簡易更新」（3-23 ページ）を参照してください。
1-5
Installation Toolkit の新機能
1-6
Installation Toolkit の概念
2
Pervasive インストールプログラムのカスタマイズおよび組み込み方法
この章では、Pervasive Installation Toolkit の手順に関する情報を提供します。
この Installation Toolkit を使用すれば、貴社のアプリケーションに Pervasive.SQL
製品のすべてまたは一部をバンドルすることができます。この章では、以
下の項目について説明します。

「Pervasive Installation Toolkit の紹介」（2-2 ページ）

「対応する開発環境」（2-3 ページ）

「使用できるインストールの種類」（2-4 ページ）

「Pervasive.SQL スマートコンポーネントの使用」（2-5 ページ）

「Pkg サブディレクトリのレイアウト」（2-6 ページ）

「パスの長さ」（2-7 ページ）

「設定パラメータの移行」（2-8 ページ）

「よく寄せられる質問」（2-9 ページ）
2-1
Installation Toolkit の概念
Pervasive Installation Toolkit の紹介
ソフトウェアを Windows のコンピュータにインストールすることは、ま
すます複雑になってきています。ファイルコンポーネントの設定と登録に
は、多大な時間と大量のコードが必要になることがあります。
Pervasive.SQL Installation Toolkit は、貴社アプリケーションのインストール
プログラム開発作業を迅速かつ容易にするために作成されました。
Pervasive Installation Toolkit を使用すれば、Pervasive.SQL が正しく機能する
ために必要な個々の設定手順を学ぶ必要もなく Pervasive.SQL を貴社製品
のインストールプログラムへシームレスに組み込むことができます。
Pervasive Installation Toolkit はさまざまなインストール開発環境で使用でき
るよう設計されています。 Pervasive.SQL を組み込むために、 Windows
Installer ベースのインストールツールを使用する必要はありません。
2-2
対応する開発環境
対応する開発環境
Installation Toolkit は、コード、用例、および再配布可能な Pervasive.SQL コ
ンポーネントで構成されています。次のプラットフォームでインストール
プログラムを開発することを目的に作成されています。

Windows NT/2000/XP/Server 2003
Installation Toolkit を使って作成するインストールプログラムは、次のプ
ラットフォームで Pervasive.SQL と貴社のアプリケーションをインストー
ルする際に使用できます。

Windows 98 SE/ME/XP

Windows NT/2000/Server 2003

NetWare 4.2、 5.x、 6.x
メモ Pervasive.SQL V8.6 を貴社のアプリケーションに組み込むとき
は、 SQL Relational Database エンジン（SRDE）もインストールする必
要があります。 SRDE はエンドユーザーが ODBC を使用してデータ
ベースにアクセスする場合に必要です。
2-3
Installation Toolkit の概念
使用できるインストールの種類
Installation Toolkit では、次の 3 つの方法で貴社のアプリケーションとイン
ストールプログラムとの統合が行えます。

既存の Pervasive.SQL インストールプログラムを呼び出す。インス
トールプログラムはサイレントモードで実行されるため、貴社の GUI
のみがユーザーに表示されます。インストールオプションは、
ptksetup.ini 設定ファイルで制御できます。この方法は、さまざま
なインストールツールでも使用できます。

Windows Installer プロジェクトで 1 つまたは複数の Pervasive.SQL マー
ジモジュールを、新規または既存のアプリケーションのインストール
に統合します。

必要な Pervasive.SQL コンポーネントを、貴社の顧客のシステムに手
動でインストールし、必要な設定を行う。このプロセスを手助けする
ために MS-DOS バッチファイルが提供されます。
インストールプログラムの呼び出しとマージモジュールベースのインス
トールについては、「Windows Installer を使用した Pervasive.SQL の組み込
み」（3-1 ページ）を参照してください。
ファイルコピーとスクリプトに基づくカスタムインストールについては、
「バッチファイルを使用した Pervasive.SQL の組み込み」（4-1 ページ）を参
照してください。
2-4
Pervasive.SQL スマートコンポーネントの使用
Pervasive.SQL スマートコンポーネントの使用
Pervasive.SQL では、スマートコンポーネントと呼ばれるコンポーネント
アーキテクチャを使用することにより、インストールと実行時の信頼性が
向上し、またアプリケーションのトラブルシューティングを簡単に行える
ようにします。
この設計における機能は、これまでのコンポーネント管理に伴う問題、つ
まりコンポーネントの機能、バージョン、パッチレベルを特定するのが困
難であるという問題に取り組むものです。それぞれの「スマート」コンポー
ネントには一意のコンポーネント名が付いており、これにコンポーネント
の機能、バージョン、およびパッチレベルが示されています。この機能に
よって、更新されたコンポーネントが前のバージョンを上書きしてしまう
ことがなくなります。
スマートコンポーネントアーキテクチャには、以下の機能もあります。

ダイナミックバインディング。 Pervasive.SQL では、まとまったプロ
グラムファイル一式がメモリにロードされません。従属コンポーネン
トがロードされるのは、別のコンポーネントが従属コンポーネントの
機能、バージョン、およびパッチレベルを具体的に要求した場合だけ
です。互換性のないコンポーネントが誤ってロードされることがない
ため、バージョンに関係するエラーを軽減したり防ぐことができます。

エラーコードの解明。下層から出されたエラーコードはメッセージ
ログに転送され、上層のステータスコード内に隠れることがなくなり
ました。エラーの原因がすばやく解明できるようになったため、トラ
ブルシューティングがより容易になります。

Pervasive.SQL イベントログ。すべてのコンポーネントがエラーおよ
びメッセージを 1 つのログに記録するため、トラブルシューティング
の負荷が軽減されます。
スマートコンポーネントアーキテクチャの詳細については、『Advanced
Operations Guide』を参照してください。
2-5
Installation Toolkit の概念
Pkg サブディレクトリのレイアウト
pkg サブディレクトリには、 Pervasive.SQL エンジン、リクエスタ、ユー
ティリティ、およびマニュアルのファイルが置かれています。手動インス
トールの例でも、このディレクトリ構造のファイルが使用されます。
pkg レイアウトの配置や原理については考慮する必要はありません。
Installation Toolkit のファイルグループは、環境変数を設定していれば、提
供される関連ファイルを取得する正しいパスをすでに持っています。
2-6
パスの長さ
パスの長さ
Pervasive.SQL データベースエンジンの完全なインストールパスは 42 文字
以内にしてください。完全なパスには、ドライブレター、コロンおよび円
記号が含まれます（例： C:\）。インストールパスが 42 文字を超えると、
DEMODATA サンプルデータベースがインストールされません。パスの長
さに関するこの制限は、 Pervasive.SQL のリレーショナルインターフェイ
ス、 SQL Relational Database エンジン（SRDE）で必要な要件です。
2-7
Installation Toolkit の概念
設定パラメータの移行
インストールプログラムの呼び出し以外の方法を使用してインストール
を実行するときに、そのインストールで 8.x より古いバージョンを使用す
る既存の Pervasive.SQL サイトをアップグレードする場合は、設定を前の
リリースから Pervasive.SQL V8.6 へ移行する必要があります。
Confmig.exe は、 Pervasive.SQL 7.x エンジン設定を Pervasive.SQL 8.x へ移行
するために使用するユーティリティです。このユーティリティを使用する
と、 7.x で使用していたエンジン設定を保持したまま、一方でレジストリ
キーを更新して 8.x レイアウトを反映させることができます。
このユーティリティは自動的にはインストールされず、次のディレクトリ
にあります。
\pkg\winroot\PVSW\bin\confmig.exe
このユーティリティは既存の設定を削除せず、設定を Pervasive.SQL 8.x で
有効にするために移行するだけです。移行の必要な値は、 ptksetup.ini
ファイルに一覧があります。
移行ユーティリティを起動するには次にように指定します。
confmig -ini < インストールディレクトリ >\ptksetup.ini -log
< ログファイル >
2-8
よく寄せられる質問
よく寄せられる質問
このセクションでは、 Installation Toolkit に関してよく寄せられるいくつか
の質問にお答えします。

「Pervasive.SQL でインストールするファイルの選択方法を教えてくだ
さい。」（2-9 ページ）

「ODBC なしで MicroKernel （Btrieve）コンポーネントをインストール
する方法を教えてください。」（2-9 ページ）

「Pervasive.SQL コンポーネントはどのロケーションにインストールす
ればよいですか ?」（2-10 ページ）
Pervasive.SQL でインストールするファイルの選択方法を教
えてください。
Pervasive.SQL V8.6 Installation Toolkit でインストールされるファイルの
セットをカスタマイズするにはいくつかの方法があります。

いくつかのオプションについては、ptksetup.ini ファイルを変更し
ます。

選択されたマージモジュールのみをアプリケーションにインストー
ルします（Windows Installer）。

バッチファイルのみを実行します（手動インストール）。

http://www2.agtech.co.jp/compguide/asp/index.asp を使用して、要件を満
たす必要なファイルのセットを決定してください。
詳細については、「インストールのシンプルなカスタマイズの実行」（3-18
ページ）を参照してください。
ODBC なしで MicroKernel （Btrieve）コンポーネントをイン
ストールする方法を教えてください。
Installation Toolkit スクリプトは、トランザクショナルコンポーネントとリ
レーショナルコンポーネントの両方をインストールするよう設計されて
います。 Control Center を含む多くの Pervasive.SQL ユーティリティを使用
するには、 ODBC がインストールされていなければなりません。トランザ
クショナルエンジンをインストールするときに ODBC をインストールす
ることをお勧めします。
ODBC をインストールしない場合はその代わりに、「手動によるファイル
のインストール」（4-4 ページ）セクションに示すように、ファイルを手動
でディレクトリにコピーするしかありません。ODBC や SQL リレーショナ
ルデータエンジン（SRDE）に関連する手順はすべて省略します。
2-9
Installation Toolkit の概念
Pervasive.SQL コンポーネントはどのロケーションにインス
トールすればよいですか ?
Installation Toolkit のデフォルト設定を使っている場合、次のディレクトリ
が使用されます（Windows コンピュータでは c:\ ドライブに Windows シ
ステムがインストールされ、NetWare では x: がマップされた最初のネット
ワークドライブである場合）。
表 2-1 Windows NT/2000/Server 2003 インストールロケーション
コンポーネントのタイプ
デフォルトのターゲットインストール
ディレクトリ
Pervasive 以外のシステムコ
ンポーネント
c:\winnt\system32\
Pervasive.SQL エンジンとク
ライアントコンポーネント
c:\pvsw\
Pervasive.SQL ドキュメント
コンポーネント
c:\program files\common files\pervasive software
shared\doc
Pervasive System Analyser コ
ンポーネント
c:\program files\common files\pervasive software
shared\psa
PVSW コアコンポーネント
c:\program files\common files\pervasive software
shared\pvswcore
表 2-2 Windows 98/ME/XP インストールロケーション
2-10
コンポーネントのタイプ
デフォルトのターゲットインストール
ディレクトリ
Pervasive 以外のシステムコ
ンポーネント
c:\windows\system\
Pervasive.SQL エンジンとク
ライアントコンポーネント
c:\pvsw\
Pervasive.SQL ドキュメント
コンポーネント
c:\program files\common files\pervasive software
shared\doc
Pervasive System Analyser コン
ポーネント
c:\program files\common files\pervasive software
shared\psa
PVSW コアコンポーネント
c:\program files\common files\pervasive software
shared\pvswcore
よく寄せられる質問
表 2-3 NetWare インストールロケーション
コンポーネントのタイプ
デフォルトのターゲットインストー
ルディレクトリ
Pervasive.SQL エンジンのコンポーネント
x:\system\
Pervasive.SQL クライアントとマニュアル
のコンポーネント
x:\pvsw\
Pervasive.SQL コンポーネントは、どのような場合でもデフォルトロケー
ションにインストールすることをお勧めします。デフォルトロケーション
にインストールすれば、Pervasive.SQL によって有効になるアプリケーショ
ンが、Pervasive.SQL に依存するほかのアプリケーションと問題なく共存で
きます。
2-11
Installation Toolkit の概念
2-12
Windows Installer を使用した
Pervasive.SQL の組み込み
3
Pervasive インストールプログラムのカスタマイズおよび組み込み方法
この章では、Pervasive Installation Toolkit の手順に関する情報を提供します。
この Installation Toolkit を使用すれば、貴社のアプリケーションに Pervasive.SQL
製品のすべてまたは一部をバンドルすることができます。この章では、以
下の項目について説明します。

「Pervasive Installation Toolkit for Windows Installer のインストール」（3-2
ページ）

「インストールプロジェクトの例」（3-6 ページ）

「インストールプログラムの呼び出し」（3-7 ページ）

「Windows Installer マージモジュール」（3-14 ページ）

「インストールのシンプルなカスタマイズの実行」（3-18 ページ）

「インストール手順の補足」（3-19 ページ）

「簡易更新」（3-23 ページ）

「Pervasive.SQL 製品のアンインストール」（3-28 ページ）
3-1
Windows Installer を使用した Pervasive.SQL の組み込み
Pervasive Installation Toolkit for Windows Installer のインストール
Pervasive Installation Toolkit for Windows Installer は CD-ROM で提供されま
す。これには、組み込みインストールを作成するために必要なすべてのプ
ロジェクト、ファイルおよびコンポーネントが含まれています。インストー
ルプログラムを Windows コンピュータで起動するには、次の手順に従いま
す。
1
お使いのマシンの CD-ROM ドライブに Pervasive Installation Toolkit for
Windows Installer の CD を挿入します。
2
setup.exe プログラムを実行して初期画面を起動します。［次へ］ボ
タンをクリックしてインストール処理を開始します。
3
デフォルトのインストールロケーションの C:\Program Files\Pervasive
Software\Pervasive Install Toolkit 8.6 を受け入れる場合は［次へ］ボタ
ンをクリックします。インストールロケーションを変更したい場合
は、［変更］をクリックしてパスを変更します。
図 3-1 Installation Toolkit のロケーションの指定
4
セットアップタイプを選択します。
図 3-2 Installation Toolkit のセットアップのタイプ
5
3-2
カスタムインストールを選択した場合は、「カスタムインストール」
（3-4 ページ）に進んでください。そうでない場合は、この手順を続行
します。
Pervasive Installation Toolkit for Windows Installer のインストール
6
［インストール］ボタンをクリックしてファイルコピーを開始します。
図 3-3 Installation Toolkit のインストール準備完了
7
コンポーネントがコピーされる間しばらくお待ちください。
図 3-4 Installation Toolkit のファイルコピー処理
8
インストールは完了しました。
図 3-5 Installation Toolkit のインストール完了
9
［完了］をクリックしてインストールプログラムを終了します。
10 「インストールされた Installation Tookit のファイル」（3-5 ページ）の手
順に進みます。
3-3
Windows Installer を使用した Pervasive.SQL の組み込み
カスタムインストール
Installation Toolkit インストールのカスタム機能を使用すると、どのサンプ
ルプロジェクトをハードドライブにコピーするかを指定することができ
ます。
図 3-6 Installation Toolkit のカスタムインストール
1
インストールするサンプルプロジェクトを選択します。
図 3-7 Installation Toolkit のカスタムインストール
2
サンプルプロジェクトの一覧から適切なエントリをクリックして［イ
ンストールしない］を選択すると、そのサンプルプロジェクトを除外
することができます。
図 3-8 Installation Toolkit カスタムコンポーネントの選択解除
3
3-4
選択が終わったら、インストールのメインの手順 6 （3-3 ページ）に戻
ります。
Pervasive Installation Toolkit for Windows Installer のインストール
インストールされた Installation Tookit のファイル
Installation Toolkit をすべてデフォルトのオプションでインストールした場
合、ファイルは次のディレクトリ構造にコピーされます。
C:\Program Files\Pervasive Software\
\Pervasive Install Toolkit 8.6
// Installation Toolkit のプロジェクト、
コードおよびサンプル
\doc
// Installation Toolkit のオンラインマ
ニュアル
\support
\pkg
// サンプルのインストールに必要な
スクリプトと実行形式ファイルが含
まれます。手動のインストール方法
とは異なり、Windows Installer 用ツー
ルキットの pkg ディレクトリには
Pervasive.SQL が必要とするファイル
がすべて含まれるわけではありませ
ん。マージモジュールがその機能に
必要な追加ファイルをすべて保持し
ています。
\system
// インストールプロジェクトで使用
されるサポートファイル
\wi
// Pervasive.SQL V8.6 コンポーネント
が組み込まれた InstallShield サンプ
ルプロジェクト
\Client
// Pervasive.SQL クライアント
\Modules
// マージモジュール
\Ntsrv
// NT サーバーエンジン
\Scripts
// インストールスクリプト
\Wge
// ワークグループエンジン
3-5
Windows Installer を使用した Pervasive.SQL の組み込み
インストールプロジェクトの例
Installation Toolkit には、以下の製品に対応する Windows Installer を基にし
たサンプルが含まれています。

Windows サーバーエンジン

Windows ワークグループエンジン

Windows クライアント
完全なインストールプログラムの呼び出しとは異なり、これらのインス
トールは仕様に合わせて変更することができます。カスタマイズされた
Windows Installer ベースのインストールプログラム構築を行う際にはこれ
らのプロジェクトを参考にしてください。
サンプルのインストールでは、 Pervasive のインストールに組み込まれてい
る以下の作業は実行しません。

Windows Script Host の最新バージョンのチェック

Windows Installer 実行モジュールの最新バージョンのチェック

PSA のインストール

PSA アーカイブとリストアの実行

インストールの終了時点での PSA テストの実行

システムファイルの更新

別の Pervasive.SQL 製品のチェック
OEM/ISC 開発者は独自に作成したインストールで、必要に応じてこれらの
操作を実行することを前提としています。
サンプルインストールをビルドするには InstallShield バージョン 8.0 SP2
以降が必要です。
メモ Pervasive では、このリリースをバージョン 8.0 SP2 およびバー
ジョン 9.0 でテストしています。
3-6
インストールプログラムの呼び出し
インストールプログラムの呼び出し
インストールプログラムの呼び出しを使用すれば、インストールコードを
変更することなく、 Pervasive.SQL の完全なインストールプログラムを貴
社製品のインストールプログラムにカプセル化することができます。この
タイプのインストールプログラムを使用すれば、貴社製品のインストール
の過程でコマンドを実行するだけで Pervasive.SQL のインストールプログ
ラムが起動します。また、このインストールプログラムではインストール
するコンポーネントのカスタマイズ、およびサイレントインストールを実
行する機能も提供されます。
この呼び出し方式のインストールは使用法が簡単で、さまざまなインス
トールツールから動作します。この方法を使用する場合、配布メディアに
インストールしたい Pervasive.SQL インストールプログラムを入れてお
き、アプリケーションのインストールプログラムから setup.exe を呼び出し
ます。
製品がインストールされているかどうかのチェック
Pervasive.SQL インストールプログラムでは、ターゲットマシン上に
Pervasive.SQL が既にインストールされているかどうかを検出します。イン
ストール済みであれば、そのバージョンをアーカイブします。インストー
ルプログラムの呼び出しを実行する前に、インストールされている
Pervasive.SQL のバージョンを調べるよう指定することができます。これは
必要ではありませんが、バージョンを確認することによってインストール
の呼び出しコマンドが必要ない場合は、インストールの時間を節約するこ
とができます。
最初に、以下のレジストリキーが存在するかどうかをチェックします。
HKEY_LOCAL_MACHINE\SOFTWARE\Pervasive
Software\products\product\InstallInfo
product 部分は以下に示す項目のいずれかになります。
Pervasive.SQL V8.6
Pervasive.SQL 2000 と 2000i
Pervasive.SQL NT Server
Pervasive.SQL 2000 NT Server
Pervasive.SQL NetWare Server
Pervasive.SQL 2000 NetWare Server
Pervasive.SQL Workgroup
Pervasive.SQL 2000 Workstation
Pervasive.SQLClient
Pervasive.SQL 2000 Client
キーが存在しない場合は、 Pervasive.SQL 製品はインストールされていません。
3-7
Windows Installer を使用した Pervasive.SQL の組み込み
キーが存在する場合、InstallInfo で以下の値を調べてさらに詳しい情報を得
ることができます。
キーの値
説明
VersionLevel
インストールされている製品のデータベースエンジンの
バージョン番号。
PatchLevel
インストールされている製品のサービスパック番号。
メモ NetWare 用インストールの場合、 bti.cfg ファイルの同じ値を
チェックしてください。INI ファイルのルーチンを使用して、bti.cfg
ファイルのセクションとキーを読み取ります。
利用可能なインストールプログラムの呼び出し
貴社独自のインストールプログラムから呼び出すことができるさまざま
なインストールオプションがあります。
インストールプログラムの呼び出しで使用するインストールは、出荷され
ている製品に含まれているものと同じです。したがって、これらは
Installation Toolkit のパッケージには含まれていません。 CD に含まれてい
るインストールプログラムを使用するか、 Pervasive の Web サイトからダ
ウンロードして使用してください。
表 3-1 インストールプログラムの呼び出し
製品
Pervasive.SQL Server for Windows (v8.6)
Pervasive.SQL Server for NetWare (v8.6)
Pervasive.SQL Workgroup (v8.6)
Pervasive System Analyzer
Pervasive.SQL Client for Windows (v8.6)
メモ DOS クライアントファイルのインストールプログラムはありま
せん。『Getting Started with Pervasive.SQL （Server Edition）』で記載され
ている DOS クライアントのインストールの説明に従ってください。
このマニュアルで説明しているように、DOS クライアントファイルは
手作業で DOS クライアントにコピーする必要があります。
3-8
インストールプログラムの呼び出し
インストールプログラムの呼び出しの実行
貴社の製品のインストールプログラムから Pervasive.SQL インストールプ
ログラムを呼び出す準備を行うには CD イメージ上に 1 個のディレクトリ
を作成してください。このディレクトリ名は任意に指定できます。下記の
コード例では psql というディレクトリ名を使用しています。適切な
Pervasive インストールプログラムのディレクトリ（表 3-1 を参照）の内容
を CD イメージ上のそのディレクトリにコピーします。
Pervasive のインストールプログラムは、デフォルトで、インストールオ
プションを尋ねるダイアログボックスを表示します。貴社がユーザイン
ターフェイスを定義するインストールプログラムを作成する場合は、パラ
メータを指定して Pervasive のインストールプログラムを呼び出せば、ユー
ザーが入力しなくてもインストール機能を実行できます。このようにする
と、 Pervasive.SQL コンポーネントのインストールプログラムは、貴社の
インストールプログラムの背後で実行されます。この形態のインストール
はサイレントインストールとして知られています。
「psql」サブディレクトリにある Pervasive.SQL インストールプログラムの
サイレント呼び出しを行うコマンドは、次のとおりです。
psql\setup.exe /S /v" /l*v "c:\install.log" /qn
メモサイレントインストール中に発生したインストールエラーは
install.log ファイルに書き込まれます。ユーザーにはエラーメッ
セージは表示されません。ログファイルは、呼び出しコマンドで指定
した場所に作成されます。前の例では、ドライブ C のルートです。
ワークグループエンジンが起動していると、ワークグループエンジン
のサイレントインストールはエラーになります。ワークグループエン
ジンをインストールする前に、そのエンジンが停止していることを確
認してください。 ptksetup.ini の［modules］セクションにあるキーの値
を変更すればエンジンが停止します。
ptksetup.ini ファイルで
[modules]
w3dbsmgr.exe=2
を以下のように変更します。
[modules]
w3dbsmgr.exe=1
"1" は処理検出コンポーネントに対しチェック処理を続行して、モ
ジュールをシャットダウンするよう指示します。 "2" はモジュールが
実行中（w3dbsmgr.exe が実行中など）の場合はインストール処理を停
止します。デフォルトで、 w3dbsmgr.exe には "2" が設定されます。
3-9
Windows Installer を使用した Pervasive.SQL の組み込み
インストールプログラムの呼び出しのカスタマイズ
インストールプログラム呼び出しのデフォルト動作を変更するため、
Installation Toolkit では、 ptksetup.ini 設定ファイルを用意しています。
このファイルは、 setup.exe などの、ほかのインストールファイルと同
じディレクトリにあります。これは、 Windows の初期化ファイルの形式に
なっています。このファイルにはテキストエディタを使って変更できる設
定が含まれています。これらの設定を変更して、インストールプログラム
の実行時に特定の動作を行うか行わないかを指定することができます。
ptksetup.ini ファイルの詳細については「インストールのシンプルなカ
スタマイズの実行」（3-18 ページ）を参照してください。
ptksetup.ini ファイルには、ほかにも次のようなカスタマイズのための
豊富な設定があります。

インストールのロケーション

ライセンスキー

インストールと競合する可能性のあるプログラムのテスト

インストール確認
ptksetup.ini の設定と有効な値の一覧については、「インストールのシ
ンプルなカスタマイズの実行」（3-18 ページ）を参照してください。
Pervasive System Analyzer の呼び出し
Pervasive System Analyzer （PSA）には、それ自体のインストールプログラ
ムが含まれています。デフォルトで、 Pervasive.SQL エンジンのインストー
ル時に ptksetup.ini の設定に基づいて自動的に PSA をインストールす
る呼び出しコマンドを発行します。
Pervasive.SQL のインストールと同じような方法で PSA をカスタマイズす
ることができます。 ptksetup.ini の PSA セクションで PSA に適用する
設定キーを参照してください。
「psql」サブディレクトリにある PSA インストールプログラムを呼び出す
コマンドは、次のとおりです。
psa\setup.exe
PSA インストールプログラムを呼び出し、サイレントで実行するコマンド
は、次のとおりです。
psa\setup.exe -s
別の ptksetup.ini ファイルを指定して PSA インストールプログラムを
呼び出すコマンドは、次のとおりです。
psa\setup.exe -i"c:\temp" -s
3-10
インストールプログラムの呼び出し
PSA トランザクショナルテストのリダイレクト
デフォルトで、 PSA のトランザクショナルテストはサーバーエンジン、
ワークグループエンジンまたはクライアントコンポーネントがインス
トールされているコンピュータにリダイレクトされます。選択により、別
のコンピュータにトランザクショナルテストをリダイレクトすることも
できます。
SourceDir の値を設定するスクリプトまたは ptksetup.ini の
TargetDir に値を設定するスクリプトを作成します。これらの値は、
Pervasive.SQL のインストールが ptksetup.ini への書き込みを行った後
で設定する必要があります。 Pervasive.SQL インストールはこれらの値を
ptksetup.ini に書き込むことに注意してください。 Pervasive.SQL のイ
ンストールが完了する前に値を設定すると、これらは上書きされてしまい
ます。
C: ドライブにサーバーエンジンまたはワークグループエンジンをインス
トールしているが、トランザクショナルテストは
X:\MyDatabase\PVSW\Samples にリダイレクトすると仮定します。こ
の場合、 TargetDir に X:\MyDatabase\PVSW を設定してください。
Pervasive.SQL インストールプログラムでは自動的に \Samples を
TargetDir に追加します。 \Samples を ptksetup.ini ファイルの設定に追
加すると、インストールプログラムは
X:\MyDatabase\PVSW\Samples\Samples でトランザクショナルテス
トを実行しようとするのでエラーになります。
同様に、 C: ドライブにクライアントコンポーネントインストールしてい
るが、トランザクショナルテストは X:\MyDatabase\PVSW\Samples に
対して実行したいと仮定します。この場合は、 SourceDir に
X:\MyDatabase\PVSW を設定してください。エンジンの例で述べたよう
に、 \Samples を指定しないでください。インストールプログラムでは自
動的に \Samples を SourceDir の設定リストに追加します。
再起動の必要条件
Pervasive.SQL V8.6 のインストール時、 Setup.exe によってシステムコン
ポーネントが更新された後で、Pervasive.SQL コンポーネントをインストー
ルする前にシステムの再起動が要求されることがあります。 Pervasive.SQL
のいくつかのユーティリティおよびエンジンコンポーネントでは、最新の
システムコンポーネントがロードされていないと Pervasive.SQL ファイル
を自動登録できないため、この時点で再起動を行う必要があります。
3-11
Windows Installer を使用した Pervasive.SQL の組み込み
すべての Windows プラットフォーム
Pervasive.SQL では Pervasive.SQL インストールを続行する場合、以下に示
すバージョン番号以降のシステムファイルがコンピュータにインストー
ルされていなければなりません（これらのファイルはすべて Windows の
System フォルダにあります）。
表 3-2 システムコンポーネント要件
ファイル名
バージョン番号
msvcrt.dll
6.0.8267.0
msvcp60.dll
6.0.8168.0
mfc42.dll
6.0.8665.0
comctl32.dll
5.80.2614.3600
メモ Pervasive.SQL のインストールへの呼び出しコマンドを発行する
前にシステムファイルを更新してください。その時点でファイルを更
新していないと、システムファイルの更新が必要な場合は Pervasive.SQL
のインストールで再起動が行われます。これでは、インストールが不
完全な状態になります。
Windows 98 および DCOM
Pervasive.SQL では、インストールするターゲットコンピュータに DCOM
が存在していなければなりません。レジストリキーがない場合、インス
トールを続行することはできませんが、システムの再起動は発生しません。
これは、 Microsoft が Windows 98 において DCOM のアップデートの再配布
を許可していないために起こります。
メモ通常、Windows 98 システムには DCOM のいずれかのバージョン
がインストールされています。
3-12
インストールプログラムの呼び出し
RunOnce レジストリキー
Pervasive.SQL のインストールプログラムでは、インストール前の再起動
が発生したときに、レジストリの RunOnce キーに次のような値を置きます。
HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\RunOnce ->
x:\install\setup.exe -s
この値を使用すれば、再起動後に Pervasive.SQL のインストールを自動的
に続行することができます。この場合は、貴社製品のインストールが続行
されないことに注意してください。このような理由から、 Pervasive.SQL の
インストールプログラムの呼び出しコマンドを発行する前にシステム
ファイルを更新してください。
そうしないと、 Pervasive.SQL のインストールプログラムが既に RunOnce
キーに書き込んで再起動を行っているため、貴社製品のインストールプロ
グラムから RunOnce キーに書き込みを行う機会がありません。
3-13
Windows Installer を使用した Pervasive.SQL の組み込み
Windows Installer マージモジュール
貴社のインストールで、インストール全体ではなく選択したコンポーネン
トのセットのみをインストールする必要がある場合は、 Installation Toolkit
で提供するマージモジュールを使用して Pervasive 製品の機能を組み込む
ことができます。
この Installation Toolkit に付属している MSM には依存関係を示す情報が含
まれていないため、どの MSM がどの製品と依存関係にあるかについては
下記の表で調べてください。この表の中で、その製品に対してリストされ
ている MSM よりも少ない MSM しか使用しなかった場合は、予測できな
い結果を招くことがあります。 http://www2.agtech.co.jp/compguide/asp/
index.asp には組み込みについてのガイドがあります。 Pervasive コンポーネ
ントの依存関係についてはここを参照してください。
システム MSM
以下の表には、非 Pervasive コンポーネントを含むマージモジュールを一
覧表示します。
表 3-3 非 Pervasive マージモジュール
3-14
MSM
機能
メモ / 依存関係
atl.msm
ATL Module for Windows
このマージモジュールには、
ATL Module for Windows をイン
ストールするためのロジック、
ファイル、および登録情報が含
まれています。
COMCAT.MSM
Microsoft Component
Category Manager Library
このマージモジュールには、
Microsoft Component Category
Manager Library をインストー
ルするためのロジック、ファイ
ル、および登録情報が含まれて
います。
COMCTL32.MSM
Windows Common
Controls ActiveX Control
DLL
このマージモジュールには、
Windows Common Controls
ActiveX Control DLL をインス
トールするためのロジック、
ファイル、および登録情報が含
まれています。
COMDLG32.MSM
CMDialog ActiveX
Control DLL
このマージモジュールには、
CMDialog ActiveX Control DLL
をインストールするためのロ
ジック、ファイル、および登録
情報が含まれています。
Windows Installer マージモジュール
表 3-3 非 Pervasive マージモジュール
MSM
機能
メモ / 依存関係
DCOM95.Msm
Microsoft DCOM
Installation Database
このマージモジュールは、
Microsoft が提供する再配布可
能な DCOM95.exe のラッパー
となります。
MDAC25.Msm
MDAC 2.5 Sp2 (English)
このマージモジュールは、
Microsoft が提供する再配布可
能な mdac_typ.exe のバージョ
ン 2.5 Sp2 （英語）のラッパー
となります。
MFC42.MSM
MFCDLL Shared Library Retail Version
このマージモジュールには、
MFCDLL Shared Library - Retail
Version をインストールするた
めのロジック、ファイル、およ
び登録情報が含まれています。
MSVCP60.MSM
Microsoft (R) C++
Runtime Library
このマージモジュールには、
Microsoft (R) C++ Runtime
Library をインストールするた
めのロジック、ファイル、およ
び登録情報が含まれています。
MSVCRT.MSM
Microsoft (R) C Runtime
Library
このマージモジュールには、
Microsoft (R) C Runtime Library
をインストールするためのロ
ジック、ファイル、および登録
情報が含まれています。
OLEAUT32.MSM
Microsoft OLE 2.40 for
Windows NT(TM) and
Windows 95(TM)
Operating Systems
このマージモジュールには、
Microsoft OLE for Windows
NT(TM) and Windows 95(TM)
Operating Systems をインストー
ルするためのロジック、ファイ
ル、および登録情報が含まれて
います。
OLEDB21.msm
OLE DB 2.1 Installation
Database
このマージモジュールには、
Microsoft OLE DB 2.1 コンポー
ネントをインストールするた
めのロジック、ファイル、およ
び登録情報が含まれています。
WSH56.msm
Windows Scripting Host
このマージモジュールには、
Windows Scripting Host 5.6 をイ
ンストールするためのロジッ
ク、ファイル、および登録情報
が含まれています。これは、
Pervasive インストールに含ま
れる Visual Basic スクリプトを
実行するのに使用されます。
3-15
Windows Installer を使用した Pervasive.SQL の組み込み
Pervasive MSM
以下の MSM には Pervasive コンポーネントが含まれます。独自のインス
トールを作成する場合には、この表に示されている製品に必要なすべての
MSM をインストールする必要があります。そうしないと、完全に機能しま
せん。
表 3-4 Pervasive マージモジュール
MSM
機能
PSQL_CLIENT_16.msm
PVSW 16 ビットクラ
イアントマージモ
ジュールプロジェク
ト
NT サーバー、
ワークグループ、
クライアント
PSQL_CORE_NONREGISTERED.msm
Pervasive 非登録コア
NT サーバー、
ワークグループ、
クライアント
PSQL_CORE_REGISTERED.msm
PVSW クライアント
登録マージモジュー
ルプロジェクト
NT サーバー、
ワークグループ、
クライアント
PSQL_DEMODATA.msm
Demodata マージモ
ジュール
NT サーバー、
ワークグループ
PSQL_DOCS_COMMON.msm
Pervasive 共通ドキュ
メントマージモ
ジュール
PSQL_FUNC_EXEC_16.msm
16 ビット Function
Executor マージモ
ジュール
PSQL_FUNC_EXEC_32.msm
32 ビット Function
Executor マージモ
ジュール
NT サーバー、
ワークグループ、
クライアント
PSQL_JDBC_COMPONENTS.msm
Pervasive JDBC
Components
Installation Database
NT サーバー、
ワークグループ、
クライアント
PSQL_JSBDOS_REQ.msm
JSB DOS リクエスタ
マージモジュール
DOS リクエス
タ
NT サーバー、
ワークグループ、
クライアント
PSQL_MIN_UTILS.msm
PVSW Minimum
Utilities Installation
Database
ユーティリティ
の最小セット
（pvnetpass.exe、
PCC）
NT サーバー、
ワークグループ、
クライアント
3-16
メモ / 依存関係
C:\Program
Files\Common
Files\Pervasive
Software Shared
にインストール
されるドキュメ
ント
必要とする製品
NT サーバー、
ワークグループ、
クライアント
Windows Installer マージモジュール
表 3-4 Pervasive マージモジュール
MSM
機能
メモ / 依存関係
必要とする製品
PSQL_NTSRV_RELATIONAL.msm
Pervasive NTSRV
Relational Installation
Database
NT サーバーエ
ンジン
（Windows 用）
NT サーバー
PSQL_PCOM_COMPONENTS.msm
Pervasive PCOM
Components
Installation Database
PSQL_REL_DEPENDS.msm
Pervasive Relational
Dependencies
Installation Database
PSQL_RESOURCE_SHARED_BUNDLE.msm
Pervasive Shared
Resource Bundle
Installation Database
NT サーバー、
ワークグループ、
クライアント
PSQL_SAMPLEDB.msm
Sample DB Installation
Database
NT サーバー、
ワークグループ
PSQL_SRDE_RELATIONAL.msm
Pervasive SRDE
Installation Database
SQL エンジン
NT サーバー、
ワークグループ
PSQL_TRANSACTIONAL_DEPENDS.msm
Pervasive
Transactional
Dependencies
Installation Database
トランザクショ
ナルエンジン
の従属物
NT サーバー、
ワークグループ
PSQL_UTILS.msm
Pervasive Software
Utilities Installation
Database
PSQL_WGE_RELATIONAL.msm
WGE Relational
Installation Database
PSQL_WIN9X.msm
Pervasive Windows 9x
files Installation
Database
NT サーバー、
ワークグループ、
クライアント
リレーショナル
エンジンの従属
物
NT サーバー、
ワークグループ、
クライアント
NT サーバー、
ワークグループ、
クライアント
ワークグループ
エンジン
ワークグループ
3-17
Windows Installer を使用した Pervasive.SQL の組み込み
インストールのシンプルなカスタマイズの実行
Pervasive.SQL インストールプログラムは、再コンパイルすることなく数
多くの基本的なカスタマイズを行うことができるようデザインされていま
す。これらのカスタマイズは ptksetup.ini ファイルの内容を変更する
ことによって行うことができます。
ファイルを編集して実行できるいくつかのカスタマイズをここで示しま
す。

製品と共にインストールするライセンスキーを指定します。

潜在的にインストールを阻害するモジュールを指定し、インストール
プログラムがユーザーにその競合を通知できるようにします。

コンポーネントのコピー後に Pervasive System Analyzer を実行してイ
ンストールの機能をテストするかどうかを指定します。
ptksetup.ini ファイル内のセクションとキーにはそれぞれその目的を
説明するコメントが付けられています。 Installation Toolkit に付属している
ptksetup.ini ファイルのいずれかを参照してください。
メモ Pervasive.SQL V8.6 を貴社のアプリケーションに組み込むとき
は、 SQL Relational Database エンジン（SRDE）もインストールする必
要があります。 SRDE はエンドユーザーが ODBC を使用してデータ
ベースにアクセスする場合に必要です。
3-18
インストール手順の補足
インストール手順の補足
このセクションには、インストールで実行する可能性のある手順が含まれ
ています。
ライセンスキーの適用
Pervasive.SQL データベースエンジンを実行するにはライセンスキーが必
要です。 Installation Toolkit はライセンスを提供しませんが、サンプルのイ
ンストールは CustomInstallActions.vbs を使用してライセンスをインストー
ルします。
インストール中にライセンスキーを指定するには、以下の方法がありま
す。

ライセンスキーを ptksetup.ini に指定します（ptksetup.ini ファイ
ルの［License］セクションを参照してください）。

エンドユーザーがキーを入力できるように、入力ダイアログを表示しま
す。 ptksetup.ini でライセンスキーを指定し、HideLicenseInput
キーに "yes" を設定している場合、このダイアログは表示されません。
入力ダイアログを表示させる場合は、マージ済みの Windows Installer
プロジェクトに独自の入力ダイアログを追加する必要があります。そ
して、そのダイアログの出力を取得して CustomInstallActions.vbs に記
述されているプロシージャを実行します。

Distributed Tuning Interface 関数の PvAddLicense() を使用してライセン
スを追加します。

Distributed Tuning Objects （DtoLicenseMgr object）を使用してライセン
スを追加します。

コマンドラインユーティリティの clilcadm を呼び出してライセン
スをインストールします。
インストール後のデータベースの作成
Pervasive.SQL 製品のインストールが正常終了してから、 Pervasive.SQL
Distributed Tuning Interface （DTI）を使用してデータベース作成することが
できます。データベースを作成する前に Pervasive.SQL エンジンを起動し
ておく必要があります。
以下のコードは、 DTI 関数 PvCreateDatabase を使用してデータベースを作
成する方法を示しています。データベースをローカルマシン上だけで作成
することもできます。『API Programmer's Reference』の PvCreateDatabase を
参照してください。このマニュアルは、 Pervasive.SQL Software Developer
Kit （SDK）に含まれています。
3-19
Windows Installer を使用した Pervasive.SQL の組み込み
// DTI 関数を処理するために必要な DLL にアクセスします。
nRet = UseDLL(szPtkTargetDir ^ PTK_DEST_BINDIR ^
"w3dbav80.dll");
// DTI セッションを開始します。このセッションはすべての
// DTI 呼び出しを行う前に実施しておく必要があります。
nBTIRET = PvStart(nM);
// DLL にアクセスできる場合は続行します。
if (nRet = PTK_SUCCESS) then
// 既存のデータベースを削除する必要がある場合は、
// 下記の IF 構文のコメント行適用を外して使用します。
// bDeleteOld はユーザー定義の変数です。
// if (bDeleteOld) then
// nBTIRET = PvDropDatabase(-1,szDatabaseName,0);
// -1 はローカル接続を表します。
// 1 は DDF の削除、 0 は DDF の保持を意味します。
// endif;
// 次のフラグではデータベースオプションを設定します。
nDBFLAG = 0;
// 2 は参照整合性を設定することを意味します。
nDBFLAG = nDBFLAG | 2;
// 次の関数はデータベースを新規作成します。
nBTIRET = PvCreateDatabase(-1, szDatabaseName,
szDatabasePath, szDatabasePath, nDBFLAG );
// -1 はローカル接続を表します。
// szDatabasePath はデータベース用と DSN 用に
// 2 回使用します。
// データベースまたは DSN が既に存在する場合、
// install.log にエラーメッセージが書き込まれ、
// エラーを示すコードが返ります。
if !( nBTIRET = 0 || nBTIRET =
PTK_STATUS_DBNAME_ALREADY_EXISTS ) then
Sprintf(szMsg, @PTK_ERR_CREATE_DEMODBNAME,
nBTIRET);
PtkAddToLogFile(szMsg,@PTK_STAMP_DBCONFIG);
nRet =PTK_FAILURE;
else
// データベースと DSN が作成された場合は、
// 正常終了を示すコードが返ります。
//
nRet = PTK_SUCCESS;
endif;
endif;
// DLL を解放します。
nRet = UnUseDLL(szPtkTargetDir ^ PTK_DEST_BINDIR ^
"w3dbav80.dll");
3-20
インストール手順の補足
セットアップ中の PSA の実行
このセクションでは、 Pervasive System Analyzer （PSA）のファイルアーカ
イブと接続テスト機能の使用方法を示します。 PSA は 2 つのフェーズで実
行できます。最初のフェーズではシステムの分析とファイルのアーカイブ
を行います。次のフェーズではエンジンの接続テストを行います。
¾PSA をインストールするには
PSA のインストールイメージから以下を実行します。
psa\setup.exe -s -sms
¾PSA の分析とアーカイブを実行するには
（フェーズ 1）
"< システム共通ディレクトリ >\Pervasive Software
Shared\PSA\psawizrd.exe" -p:1 -s -i<pvsw インストール
ディレクトリ >\ptksetup.ini
¾PSA のエンジン接続テストを実行するには
（フェーズ 2）
"< システム共通ディレクトリ >\Pervasive Software
Shared\PSA\psawizrd.exe" -p:2 -i<pvsw インストールディ
レクトリ >\ptksetup.ini
パラメータは以下のように解釈されます。
パラメータ
説明 / 有効な値
-p
PSA のフェーズを指定します。
1 : 分析
2 : ネットワーク接続、リレーショナルおよびトランザク
ショナルテスト
-i
.ini ファイルのロケーション
-s
サイレントモードを指定します。
MSM にないインストール動作
いくつかの動作は Pervasive マージモジュールのどれにも取り込まれてい
ません。その代わり、これらの動作は CustomInstallAction.vbs スクリプトに
含まれています。
このスクリプトには以下の操作を実行するための情報が含まれています。

Pervasive Control Center に外部ツールを登録する。

Pervasive コンポーネントへのショートカットを作成する。

ワークグループまたはサーバーデータベースエンジンを起動する。
3-21
Windows Installer を使用した Pervasive.SQL の組み込み

コアコンポーネントの pscore.dll および pscl.dll をインストー
ルする。
メモ Windows Installer のサンプルは、 CustomInstallAction.vbs
および CustomUninstallActions.vbs ファイルに記載されている
いくつかのカスタム動作を実行します。
スタンドアロンビルド
スタンドアロンビルド環境では、 InstallShield 製品が完全にインストール
されていなくてもインストールをビルドできます。
InstallShield スタンドアロンビルド実行モジュールのサンプルをビルドす
るには、 Installation Toolkit が提供する batchbuild.cmd ファイルを使用しま
す。このファイルには、必要な手順が記載されています。
3-22
簡易更新
簡易更新
Pervasive.SQL のインストーラを使用すると、エンドユーザーである顧客
は単一のインストール処理の中でメイン製品のインストールと更新インス
トールをまとめて行うことができます。顧客は更新インストールを別個に
行う必要がありません。この機能は「簡易更新」と言います。
「簡易更新」が便利なのは、 Pervasive.SQL のインストールプログラムに
よってインストールされるファイルをインストールイメージの特定の
ディレクトリに置くだけで追加できるからです。インストールプログラム
でコードを変更する必要はまったくありません。
簡易更新の動作方法
Pervasive.SQL インストールプログラムによって主なインストールファイ
ルがインストールターゲットフォルダにコピーされた後、インストール
メディアで UPD というサブフォルダをチェックします。このサブフォル
ダは Pervasive.SQL インストールプログラムである SETUP.EXE と同じ
フォルダにある必要があります。UPD フォルダはインストールイメージの
BOOKS および CLIENTS という名前のフォルダと同じレベルに置く必要
があります。
UPD フォルダが指定されたロケーションに存在する場合、インストール
プログラムはそのフォルダの内容をインストールターゲットフォルダ
の対応するロケーションにコピーします。たとえば、エンジンのインス
トールプログラムで Pervasive.SQL を D:\DB_PRODUCTS\PSQL という
ターゲットロケーションにインストールするよう指示していた場合、
UPD\PVSW\BIN の内容は D:\DB_PRODUCTS\PSQL\BIN にコピーされ
ます。
この機能はクライアントのインストールプログラムでも使用できます。こ
の場合、 UPD フォルダはクライアントの SETUP.EXE プログラムと同じ
フォルダに置く必要があります。つまり、クライアントの UPD フォルダは
サーバーのインストールイメージ上の CLIENTS\WIN フォルダ内に作成
する必要があります。
コピーしようとする更新ファイルと同じ名前のファイルが既にターゲット
フォルダにあった場合、インストールプログラムではどちらのファイル
バージョンが新しいかをチェックします。既存のファイルの方がバージョ
ンが新しい場合は、その更新ファイルをインストールしません。この動作
によって、新しい方のコンポーネントが不注意に旧バージョンのコンポー
ネントで上書きされる危険性がなくなります。
3-23
Windows Installer を使用した Pervasive.SQL の組み込み
インストールされるファイルの一貫性を保持するため、以下に示す UPD
フォルダのサブフォルダのみがインストールプログラムで認識されます。
表 3-5 インストールプログラムによって認識される UPD サブフォルダ
サブフォルダ
ファイルがコピーされる場所とその説明
ODBC
NetWare の場合のみ： ODBC フォルダで通常は F:\ODBC（F:
ドライブが NetWare の SYS フォルダにマップされている場
合）。
PVSW
Pervasive.SQL のメインターゲットインストールフォルダ。
PVSW の下の有効なサブフォルダは以下のとおりです（図
3-9 を参照）。
Bin
Locales
Locales\1033
たとえば、ユーザーがインストールターゲットとして
C:\DB\PSQL を指定した場合、 UPD\PVSW\BIN の内容は
C:\DB\PSQL\BIN にコピーされます。
PVSWCMN
ターゲットインストールフォルダの補助フォルダ。インストールの
補助フォルダは Program Files\Common Files\Pervasive
Software Shared にあります。 PVSWCMN の下の有効なサブ
フォルダは以下のとおりです（図 3-9 を参照）。
DOC
PSA
PSA\psa_msgs
pvswcore
たとえば、ユーザーがインストールのターゲットとして
C:\DB\PSQL を指定した場合、 UPD\PVSWCMN\pvswcore
の内容が C:\PROGRAM FILES\COMMON
FILES\PERVASIVE SOFTWARE SHARED\PVSWCORE に
コピーされます。
SYSTEM
NetWare の場合のみ： NetWare のシステムフォルダで通常は
F:\SYSTEM （F: ドライブが NetWare の SYS フォルダにマッ
プされている場合）。
メモ UPD フォルダ内にあるその他のサブフォルダは無視されます。
3-24
簡易更新
次の図は Windows プラットフォームでの有効なサブフォルダを示してい
ます。
図 3-9 Windows プラットフォームにおける簡易更新の有効なサブフォルダ
簡易更新の使い方
このセクションでは、 Prvasive.SQL ファイルの更新をインストールプログ
ラムに追加する方法を説明します。
1
インストールメディアイメージ上で、 Pervasive.SQL クライアントま
たはエンジンの SETUP.EXE プログラムがある同じフォルダに UPD
フォルダを作成します。
2
作成した UPD フォルダ内に、インストール中に更新する Pervasive.SQL
フォルダおよびファイルを配置します。
UPD フォルダ内で、ファイルとサブフォルはそれぞれインストール
ターゲットの同じロケーションとファイルに対応していなければなり
ません。たとえば、通常 Pervasive.SQL のインストールロケーション
の BIN ディレクトリに置かれているファイルの更新をインストール
する場合、このファイルは UPD\PVSW\BIN におく必要があります。
3-25
Windows Installer を使用した Pervasive.SQL の組み込み
デフォルトのロケーション C:\PVSW ではなく D:\MYDB\DBFILES
などのカスタムロケーションにインストールする場合でも、UPD フォ
ルダ内ではメインのインストールターゲットフォルダを表す
"PVSW" を必ず使用してください。インストールプログラムではイン
ストールするフォルダを自動的に判断します。表 3-5 「インストール
プログラムによって認識される UPD サブフォルダ」（3-24 ページ）を
参照してください。
注意同じディレクトリ内に異なる製品のファイルを一緒に置かない
でください。たとえば、ワークグループエンジンの DLL とサーバー
エンジンの DLL を同じ UPD\PVSW\BIN ディレクトリに置いてはい
けません。また、同じディレクトリ内に異なるプラットフォーム用の
ファイルを一緒に置かないでください。たとえば、 NetWare サーバー
エンジンのファイルと Windows サーバーエンジンのファイルを同じ
UPD\PVSW\BIN ディレクトリに置いてはいけません。インストール
のタイプごとにファイルを個別に保管する必要があります。
Pervasive Field Test Files （FTF）は、すべてのプラットフォームおよび
コンポーネントについて同じディレクトリに収められ出荷されていま
す。 FTF のファイルを使用する場合、これらのファイルを適宜分ける
必要があります。
エンジン DLL 用の簡易更新の使用例
エンジン DLL である W3MIF150.DLL は W3MIF145.DLL の不具合を修正し
たものなのでインストールすることが好ましいでしょう。これはメインの
インストールプログラムでインストールされます。
3-26
1
インストールメディアイメージで、Pervasice.SQL の SETUP.EXE プロ
グラムと同じフォルダ内に UPD フォルダを作成します。
2
作成した UPD フォルダ内に PVSW サブフォルダを作成します。PVSW
サブフォルダ内に BIN という名前のサブフォルダを作成します。
3
目的のファイル更新、この場合は、W3MIF150.DLL を UPD\PVSW\BIN
にコピーします。
4
更新されたイメージでインストール
成します。
メディアのマスターを新たに作
簡易更新
クライアント DLL 用の簡易更新の使用例
同じコンポーネントの W3MIF145.DLL がクライアントにもインストール
されるので、 W3MIF150.DLL をクライアントフォルダにも追加します。
1
インストールメディアイメージで、 Pervasive.SQL クライアントの
SETUP.EXE プログラムと同じフォルダ内に UPD フォルダを作成し
ます。つまり、CLIENTS\WIN32 フォルダ内に UPD フォルダを作成し
ます。
サーバーエンジンのインストールの CLIENTS\WIN32 フォルダにも
UPD フォルダを作成できることに注意してください。このようにする
と、サーバーからインストールされたクライアントはすべて自動的に
更新ファイルを取得します。
2
作成した UPD フォルダ内に PVSW サブフォルダを作成します。PVSW
サブフォルダ内に BIN という名前のサブフォルダを作成します。
3
目的のファイル更新、この場合は W3MIF150.DLL を作成した
CLIENTS\WIN32\UPD\PVSW\BIN フォルダにコピーします。
4
更新されたイメージでインストール
成します。
メディアのマスターを新たに作
どちらの例でも、インストールプログラムが実行されると W3MIF145.DLL
がメインコンポーネントのアーカイブからインストールされ、次に
W3MIF150.DLL が UPD フォルダからインストールされます。
W3MIF145.DLL は削除されませんが、 Pervasive.SQL スマートコンポーネ
ントアーキテクチャによって、これ以降は番号の大きい方の MIF コンポー
ネントが必ず使用されるようになります。
更新ファイルがスマートコンポーネントでない場合（ファイル名に番号の
増加スキーマを使用していない場合）、既存のファイルが更新ファイルに
よって上書きされます。
メモ簡易更新では manifest.csv ファイルを変更しません。ただ
し、ターゲットインストールディレクトリに存在するすべてのファイ
ルが manifest.csv に含められます。自身で追加した新しいファイ
ルは、置き換えられたファイルと共に生成されたマニフェストに記載
されます。
3-27
Windows Installer を使用した Pervasive.SQL の組み込み
Pervasive.SQL 製品のアンインストール
Pervasive 製品は Windows Installer インターフェイスを使用してアンインス
トールされます。その他の手順は必要ありません。
3-28
バッチファイルを使用した
Pervasive.SQL の組み込み
4
Pervasive インストールプログラムのカスタマイズおよび組み込み方法
この章では、Pervasive Installation Toolkit の手順に関する情報を提供します。
この Installation Toolkit を使用すれば、貴社のアプリケーションに Pervasive.SQL
製品のすべてまたは一部をバンドルすることができます。この章では、以
下の項目について説明します。

「手動インストールパッケージのインストール」（4-2 ページ）

「手動によるファイルのインストール」（4-4 ページ）

「コンポーネント
ズ」（4-6 ページ）

「インストールの手順の補足」（4-7 ページ）
ウィザードを使用したインストールのカスタマイ
4-1
バッチファイルを使用した Pervasive.SQL の組み込み
手動インストールパッケージのインストール
Pervasive Installation Toolkit の手動バージョンは、 Pervasive コンポーネント
のすべてを含む圧縮（ zip）ファイルとして配布されます。
圧縮されたパッケージのディレクトリ構造は以下のようになっています。
\manual
\pkg
インストールプロジェクトで使
用される Pervasive.SQL V8.6 コ
ンポーネントのディレクトリ構
造
\Common
\Nw
\System32
\Winroot
\system
インストールプロジェクトで使
用されるサポートファイル
\odbc
\update
4-2
database.vbs
データベースと DSN の作成方
法を示すサンプルスクリプト
docs.bat
ドキュメントとユーティリティ
ヘルプのバッチファイル
docs.reg
ドキュメントとユーティリティ
ヘルプのレジストリエントリ
insttk.chm
HTML ヘルプ形式の Installation
Toolkit ハンドブック
inttk.pdf
PDF 形式の Installation Toolkit ハ
ンドブック
ntsrv.bat
NT サーバーエンジンのバッチ
ファイル
ntsrv.reg
NT サーバーエンジンのレジス
トリエントリ
nwsrv.bat
NetWare サーバーエンジンの
バッチファイル
手動インストールパッケージのインストール
nwsrv.reg
NetWare サーバーエンジンのレ
ジストリエントリ
odbcclnt.reg
ODBC クライアントインター
フェイスのレジストリエントリ
odbceng.reg
ODBC エンジンインターフェイ
スのレジストリエントリ
pcctools.reg
Pervasive Control Center および
関連するユーティリティ - レジ
ストリエントリ
ptksetup.ini
カスタマイズファイルのインス
トール
readitk.htm
HTML 形式の Installation Toolkit
の Readme ファイル
readitk.txt
テキスト形式の
Installation
Toolkit の Readme ファイル
w1clnt.bat
16 ビットクライアントのバッ
チファイル
w3clnt.bat
32 ビットクライアントのバッ
チファイル
w3util.bat
32 ビットユーティリティの
バッチファイル
wge.bat
ワークグループエンジンのバッ
チファイル
wge.reg
ワークグループエンジンのレジ
ストリエントリ
4-3
バッチファイルを使用した Pervasive.SQL の組み込み
手動によるファイルのインストール
インストールを完全に制御するために、 Windows Installer を使用したくな
い場合は、ファイルを手動でインストールして、 Pervasive.SQL コンポーネ
ントのすべてまたはサブセットのインストールに必要な設定手順を実行す
ることもできます。
メモ program
files\common
files\pervasive software
shared\pvswcore にある Pervasive.SQL DLL は共有 DLL としてイン
ストールする必要があります。これらの DLL の使用回数はインストー
ルするごとに 1 回ずつカウントアップされアンインストールごとに 1
回ずつカウントダウンします。
Installation Toolkit には、 Pervasive.SQL コンポーネントのインストールに必
要なファイルのコピーと設定手順を正確に記述する DOS のバッチファイ
ルが含まれています。これらの手順は、ご使用のインストールツールの
コードに変換できます。
これらのバッチファイルには、オペレーションの内容とそのオペレーショ
ンが行われている理由が記録されています。コマンドおよび設定手順の中
には、記述されていても DOS コマンドプロンプトで正しく実行できない
ために実行されないものがあります。たとえば、環境変数を DOS コマンド
プロンプトで更新しても、その外側にあるプロセスには変更が見えないた
め実行されません。
インストールのバッチファイルは、手動インストールパッケージを解凍
したルートディレクトリにあります。
ここに入っている DOS のバッチファイルの例は、次のとおりです。
表 4-1 DOS バッチファイルの例
4-4
ファイル
説明
Docs.bat
ドキュメントとユーティリティヘルプコンポーネントをインス
トールします。
Ntsrv.bat
Pervasive.SQL サーバーコンポーネントを Windows にインストール
します。
Nwsrv.bat
Pervasive.SQL サーバーコンポーネントを NetWare にインストール
します。
Wge.bat
Pervasive.SQL ワークグループコンポーネントを Windows にインス
トールします。
手動によるファイルのインストール
表 4-1 DOS バッチファイルの例
W1clnt.bat
Pervasive.SQL 16 ビットリクエスタコンポーネントをインストール
します。
W3clnt.bat
Pervasive.SQL 32 ビットリクエスタコンポーネントをインストール
します。
W3util.bat
Pervasive.SQL 32 ビットユーティリティをインストールします。
完全な Pervasive.SQL インストールプログラムを作成するには、 1 つまた
は複数の DOS バッチファイルを実行する必要があります。たとえば、弊
社が出荷したインストールプログラムのような、 Windows NT/2000/Sever
2003 用 Pervasive.SQL サーバーのインストールプログラムと同じものを作
成するには、次の DOS バッチファイルを使用します。

Ntsrv.bat

W1clnt.bat

W3clnt.bat

W3util.bat

Docs.bat
ここに入っているレジストリファイルの例は、次のとおりです。
表 4-2 レジストリの例
ファイル
説明
Docs.reg
ドキュメントおよびユーティリティヘルプキーのセットアップ
Ntsrv.reg
NT/2000/Server 2003 サーバーエンジン用の Installation Information
キーを設定します。
Odbcclnt.reg
ODBC クライアントドライバのキーを設定します。
Odbceng.reg
ODBC エンジンドライバのキーを設定します。
Wge.reg
ワークグループエンジン用の Installation Information キーを設定し
ます。
W3clnt.reg
32 ビットクライアント用の Installation Information キーを設定します。
Nwsrv.reg
NetWare サーバーエンジン用の Installation Information を設定します。
Pcctools.reg
PCC へ外部ツール（各種 Pervasive.SQL ツール）を追加します。
メモこれらのレジストリキーを適用する方法については、バッチ
ファイルのコメントや提案事項を参照してください。
4-5
バッチファイルを使用した Pervasive.SQL の組み込み
コンポーネントウィザードを使用したインストールのカスタ
マイズ
手動インストールはファイルコピーとスクリプトによって実行します。し
たがって、コンポーネント間の相互作用についてどれだけ理解しているか
によって、行えるカスタマイズは異なります。
スクリプトを読んで、 Windows Installer ベースのインストールが Pervasive
コンポーネントのインストールに使用する個々の手順を理解してくださ
い。
オンラインの組み込みガイドを使用してコンポーネントを選択し、ファイ
ル一覧、レジストリ設定、およびインストールの実行に必要な登録を表示
させることができます。
詳細については、 http://www2.agtech.co.jp/compguide/asp/index.asp を参照し
てください。
この Web サイトを使用して実行できるいくつかのカスタマイズをここで
示します。
4-6

さまざまなアクセス方法を使用して、どのコンポーネントをインス
トールするかを指定します。

どのユーティリティをインストールするかを指定します。
インストールの手順の補足
インストールの手順の補足
このセクションには、インストールで実行する可能性のある手順が含まれ
ています。
ライセンスキーの適用
Pervasive.SQL データベースエンジンを実行するにはライセンスキーが必
要です。Installation Toolkit ではサーバーエンジンおよびワークグループエ
ンジン用の一時的なライセンスキーを提供しています。この一時的なライ
センスキーは 30 日間のみ有効で 1 ユーザーカウントを提供します。イン
ストールスクリプトで別のライセンスキーを指定しない場合、 30 日間の
一時ライセンスがインストールされます。
ライセンスキーをインストール中に指定することができます。このために
は、インストールスクリプトを変更して正しいキーを設定します。
rem ************* ライセンスのインストール **************
rem コマンドラインのライセンスおよび管理ユーティリティを使用して
ライセンスを追加する
%PV_BINDIR%\clilcadm -a WKVEUZS298URHGLCZTNLLMB8
このサンプルで使用するキーは一時ライセンス用です。
文字列 WKVEUZS298URHGLCZTNLLMB8 を自身のライセンスで置き換えます。
インストール後のデータベースの作成
Installation Toolkit にはサンプルの Visual Basic スクリプト（VBS）ファイル
が含まれていて、 DTO （Distributed Tuning Objects）を使用したデータベー
ス、 DSN、およびデータベース名の作成方法を示しています。このファイ
ルは、 Installation Toolkitn の手動インストールパッケージのルートレベル
にあり、名前は database.vbs です。
『Visual Programmer's Reference』の DTO （Distributed Tuning Objects）を参照
してください。このマニュアルは、 Pervasive.SQL Software Developer's Kit
（SDK）の一部です。
ドキュメントとユーティリティリソースのインストール
さまざまなインストールのバッチファイルでは、ドキュメントや Pervasive
System Analyzer で必要ないくつかのファイルについて対処していません。
ドキュメントとヘルプリソースのインストールに必要な手順は、別のバッ
チファイル docs.bat に含まれています。
4-7
バッチファイルを使用した Pervasive.SQL の組み込み
このバッチファイルを実行して、このセクションで説明したユーティリ
ティヘルプおよびドキュメントのコンポーネントをインストールしてく
ださい。
ユーティリティヘルプ
Pervasive System Analyzer のインストールには、ユーティリティのヘルプシ
ステムで必要な 2 つのファイルが含まれています。

keyhh.exe

keyhelp.ocx
これらのファイルの登録と設定は PSA インストールに含まれます。
ドキュメントのインストール
ドキュメントはほかのリリースと共有です。これは、常に以下のロケー
ションにインストールされます。
C:\Program Files\Common Files\Pervasive Software
Shared\Doc
この場合、 Windows がインストールされているドライブが C であることを
前提としています。必要に応じドライブ文字を変更してください。
拡張子が .CHM の Pervasive.SQL ファイルは主要なマニュアルファイルで
す。これらのファイルは \program files\common files\pervasive software
shared\doc に共有 DLL として存在する必要があります。これらのファイル
の使用回数はインストールするごとに 1 回ずつカウントアップされアンイ
ンストールごとに 1 回ずつカウントダウンします。
4-8
索引
C
comctl32.dll .................................................. 3-12
D
DCOM および Windows 98 ........................ 3-12
I
Installation Toolkit
Pkg ディレクトリ .................................... 2-6
Ptksetup.ini ....................................... 3-18, 4-6
Windows Installer...................................... 3-1
WI エディションのインストール......... 3-2
インストールプログラムの呼び出し .. 3-7
概念 ........................................................... 2-1
概要 ........................................................... 1-1
手動によるコピー ................................... 4-1
手動によるファイルのコピー............... 4-1
手動バージョンのインストール ........... 4-2
スマートコンポーネント ...................... 2-5
製品の配布 ............................................... 1-1
統合方法 ............................................ 2-4, 2-7
ptksetup.ini......................................... 3-18
組み込みガイド .................................. 4-6
手動によるインストール.................. 4-4
組み込みガイド .................................. 4-6
バッチファイル ...................................... 4-1
Installation Toolkit のインストール ..... 3-2, 4-2
Installation Toolkit の概念 ............................ 2-1
M
mfc42.dll....................................................... 3-12
msvcp60.dll................................................... 3-12
msvcrt.dll ...................................................... 3-12
Pervasive.SQL Installation Toolkit
「Installation Toolkit 」を参照
Pervasive.SQL イベントのログ ................... 2-5
Pervasive.SQL のアンインストール ......... 3-28
Pkg ディレクトリ ......................................... 2-6
PSA, 「Pervasive System Analyzer」を参照
Ptksetup.ini ............................................ 3-18, 4-6
W
Windows Installer ツールキット .................. 3-2
Windows 98 および DCOM ........................ 3-12
い
インストール
ODBC を使用しない ............................... 2-9
カスタマイズ方法 ................................. 3-10
異なるタイプ
呼び出しまたはカプセル化.............. 3-7
シンプルなカスタマイズ .............. 3-18, 4-6
特定のファイル ..................................... 3-10
パスの長さの制限 ................................... 2-4
ファイル更新に使用するディレクトリ 3-23
インストールするファイルの制限 ............ 2-9
え
エラーコードの解明 ................................... 2-5
か
カスタマイズ
スタートメニュープログラムグループ ... 3-18
簡単な更新機能 .......................................... 3-23
インストールプログラムが認識する
サブフォルダ ..................................... 3-24
O
く
ODBC, インストールから除外 ................... 2-9
クリーンアップ機能 .................................. 3-28
P
こ
Pervasive System Analyzer,
セットアップ中に実行.................... 3-21
コンポーネントウィザード ....................... 4-6
コンポーネントのロケーション .............. 2-10
索引 1
し
ゆ
手動によるインストール............................. 4-2
新機能............................................................. 1-1
ユーザー設定
インストール , シンプル ............... 3-18, 4-6
インストールプログラムの呼び出し 3-10
ユーティリティ
インストールしない選択 ..................... 3-18
す
スマートコンポーネント ............................
Pervasive.SQL イベントのログ ..............
エラーコードの解明 ..............................
ダイナミックバインディング ..............
2-5
2-5
2-5
2-5
せ
セットアップ , PSA の実行 .......................
選択
各ユーティリティを
インストールするかどうか .............
どのコンポーネントを
インストールするか .........................
どのマージモジュールを
インストールするか .........................
3-21
3-18
3-10
3-14
た
ダイナミックバインディング.................... 2-5
と
トラブルシューティング............................. 2-9
ODBC なしでインストール ................... 2-9
インストールするファイルの制限 ....... 2-9
コンポーネントのロケーション ......... 2-10
は
パスの長さ , 制約.......................................... 2-4
バッチファイルインストール................... 4-2
ふ
ファイル更新
使用するディレクトリ ......................... 3-23
ファイル更新のディレクトリ ................... 3-23
プログラムグループ
カスタマイズ ......................................... 3-18
ま
マニフェストテキストファイル............. 3-27
2 索引
よ
よく寄せられる質問 .................................... 2-9

Download Report