Advanced Topics

A Look at Advanced Topics for Pervasive DataExchange

This appendix discusses advanced topics dealing with installation of Pervasive DataExchange. The following section is included:

Installing DataExchange as Part of Your Application

 

Installing DataExchange as Part of Your Application

The DataExchange Getting Started guides explain how to install DataExchange interactively from a CD. You can also install DataExchange as part of your own application installation process. The DataExchange installation can be noninteractive, in which no input is required from the user. This is referred to as a silent installation.

See also Installation Toolkit Handbook under the “Embedding Pervasive PSQL” topic at http://www.pervasive.com/library/index.asp?_shownode=EMB.

How To Perform a Silent Install

The following steps explain how to perform a silent installation for a First Site and a Partner Site.

Note Ensure that all Pervasive PSQL utilities, such as PCC, and all applications that use Pervasive PSQL are closed before performing a silent install.

To install DataExchange silently

1	Copy all files from the Pervasive DataExchange CD to a temporary directory on a hard disk.

Use a machine that does not have DataExchange already installed.

2	Execute the DataExchange setup.exe program on the hard disk and include the -r argument.

For example, you would type setup -r. This creates an InstallShield record of the installation.

Continue the installation as explained in Installing Pervasive DataExchange of the Getting Started with Pervasive DataExchange. Select First Site as the type of installation.

3	Copy the setup.iss file from the Windows directory (identified by the %windir% system variable) to the directory containing the DataExchange setup.exe file.

Setup.iss is an InstallShield script file that was created by the setup -r process from the previous step.

4	Open setup.iss in an editor.

Notice that szType is set to Complete (szType=Complete). “Complete” indicates a First Site installation.

5	Modify the SiteName and HostAddr to the name or IP address of the machine that you want to be the First Site.

For example, if the machine name is DXSRVR, the entries would read SiteName=DXSRVR and HostAddr=DXSRVR.

6	For szEdit1, specify a DataExchange server activation license.

For example, if your license is AAAA1234BBBB5678CCCC9999, the entry reads szEdit1=AAAA1234BBBB5678CCCC9999.

7	Save setup.iss with a name that identifies it as pertaining to a First Site (such as first.iss).

You have created an ISS file for the First Site. You now need to create an ISS file for the Partner Site by modifying the First Site ISS file.

8	Save first.iss with a name that identifies it as pertaining to a Partner Site (such as partner.iss).

9	Change szType to Typical (szType=Typical).

“Typical” indicates a Partner Site installation.

10	Modify the Site Name and HostAddr to the name or IP address of the machine that you want to be the Partner Site.

For example, if the machine name is DXPRTNR, the entries would read SiteName=DXPRTNR and HostAddr=DXPRTNR.

11	In the [DlgOrder] section, perform the following actions:

a.	Change count=9 to count=8.

b.	Delete the line Dlg4=AskYesNo-0.

c.	Renumber the subsequent dialog lines sequentially:

Dlg4=SdSelectFolder-0

Dlg5=Site Information-0

Dlg6=SdStartCopy-0

Dlg7=SdFinish-0

12	Delete the section [AskYesNo-0] and all of its subordinate lines, such as Result=1.

13	Delete setup.iss.

14	Add the contents of the temporary directory, with both of the newly created ISS files, to your installation media.

15	Use the following commands to silently install DataExchange from your media.

For a First Site: setup -sms /f1 first.iss /s (or whatever you named the ISS file in step 7)

For a Partner Site: setup -sms /f1 partner.iss /s (or whatever you named the ISS file in step 8)