Installing Pervasive PSQL Vx Server

This section explains how to install Pervasive PSQL Vx Server on Windows and on Linux.

If the installation fails for any reason, the installation log file for Windows platforms can be found in the Windows %Temp% directory. For Linux distributions, the standard Linux logging system is used for messages (as configured in /etc/syslog.conf).

Windows

The following steps explain how to install Pervasive PSQL Vx Server from its media using the default interactive installation.

►

To install Pervasive PSQL Vx Server on Windows

Launch the installation program from your Windows machine.

Insert the Pervasive PSQL Vx Server media into the CD-ROM drive.

If the installation does not start automatically, click Start then Run, and type drive:\autorun\autorun where drive is the drive letter of your CD-ROM device.

The installation selection dialog displays.

Click the installation for the desired bit architecture (32-bit or 64-bit) of Pervasive PSQL Vx Server.

The installation program begins its initial preparation. After the preparation completes, the Welcome screen appears.

If prompted, close or uninstall any running applications that may interfere with the Pervasive PSQL installation.

Note: If you wish to leave one or more programs running that may interfere, you must click Ignore to continue. Unpredictable results may occur during the Pervasive PSQL installation if you ignore programs that may interfere.

At the Welcome screen, click Next.

On the License Agreement page, read and accept the Software License Agreement, then click Next.

Select the setup type: Complete (default) or Custom.

The Complete setup (recommended for most users) installs all the Pervasive PSQL Vx Server components using the default options and locations.

•

If you choose a Complete install, click Next and continue with step 10.

The Custom setup (recommended for advanced users) allows you to specify the installation location, select the optional features and associated subfeatures to install, and determine the space requirements for the components.

•

If you choose Custom, click Next and continue with the following steps.

To specify different installation locations, click Change for any of the folders listed, then enter or browse for a different folder. Click OK to accept the location.

Click Next to continue.

Select the optional features and associated subfeatures you want to exclude from the installation and click Next. All of the Pervasive PSQL optional features and subfeatures are selected for installation by default.

Click Install to begin installation.

A dialog displays when the installation wizard completes. The product has been installed with a trial key that expires at the end of its trial period.

You have two choices at this point: continue and authorize the product with a permanent key, or end the installation (and later authorize the product with a permanent key).

•

If you choose to continue and authorize the product, click Next and continue with step 12.

•

If you choose to end the installation at this point, click Next then click Finish and skip to step 14. (You may run the License Administrator utility at a later time to authorize a key. See License Administration in Pervasive PSQL User's Guide.)

Enter your key and click the button to authorize it (an Internet connection is required).

A message box displays with the status of the authorization action. Perform one of the following actions depending on the status:

•

If the authorization status message is “key is authorized,” click OK, then click Finish to complete the installation.

•

If the authorization status message reports an error or warning, click OK, and repeat step 12, ensuring that you enter a valid license key.

•

If you are installing a trial download from the Pervasive PSQL Web site, you can authorize the product with the same key on two different machines, physical or virtual.

Register your product (recommended) as explained on the Registration page that displays, then close the Registration page.

If you are prompted to reboot your system, please do so in order to ensure proper operation of the product.

Note: The installation program modifies some of the environment variables. On Windows platforms, environment variables are stored in the Control Panel under System information.

Utilities

Pervasive PSQL Vx Server does not install the utilities for telephone authorization and off-line authorization. They are not needed because Pervasive PSQL Vx Server requires Internet connectivity at all times.

Linux

Pervasive PSQL Vx Server may be installed on Linux using either the RPM or TAR format.

Installing Using RPM

The RPM format allows you to install Pervasive PSQL Vx Server if your Linux distribution contains the Red Hat Package Manager (RPM). Version 4 or greater of RPM is required.

Determine the package name to use for the installation using the following table and the distribution media.

Table 5

Pervasive PSQL Vx Server for Linux Package Names - RPM

Installation Type

Package Name

64-bit

Pervasive.SQL-Vx-yy.yy-zzz.zzz.x86_64.rpm

32-bit

Pervasive.SQL-Vx-yy.yy-zzz.zzz.i486.rpm

In all cases, the yy.yy designates a release number and zzz.zzz designates a build number. Refer to the distribution media for the actual name of the package.

The package manager copies all necessary files onto disk (default location is /usr/local/psql) and runs a post-installation script which performs the following tasks:

•

Creates user psql and group pvsw

•

Sets user:group ownership to psql:pvsw for the installed files

•

Applies a trial license

•

Creates a new ODBC DSN (data source name) for the DEMODATA test database

•

If Samba configuration file is found

•

Creates a new Samba share PSQLDATA

•

Creates a new Samba share PVPIPE$

•

Creates startup/shutdown scripts for Pervasive PSQL daemons

•

Launches the Pervasive PSQL daemon (mkded)

►

To install Pervasive PSQL Vx Server using RPM

Assuming the RPM package is in the current directory, enter the following command:

rpm -ivh <Linux_Pervasive PSQL Vx Server_Package_Name>

Note: Refer to Pervasive PSQL Vx Server for Linux Package Names - RPM for the package name to use. You must include the appropriate release and build number information to perform the installation. Verify the complete package name from the distribution media.

If the RPM package is in another directory, preface the package name with a path.

Run the command line License Administrator utility to authorize the key. See License Administrator Command Line Interface in Pervasive PSQL User's Guide. If you are installing a trial download from the Pervasive PSQL Web site, you can authorize the product with the same key on two different machines, physical or virtual.

Installing Using TAR

The tape archive (TAR) format allows you to install Pervasive PSQL Vx Server if you have a Linux distribution that does not support the RPM format or if you prefer not to use RPM. This section explains how to install Pervasive PSQL Vx Server using TAR.

The name of the Pervasive PSQL Vx Server installation package conforms to the following conventions.

Table 6

Pervasive PSQL Vx Server for Linux Package Names - TAR

Installation Type

Package Name

64-bit

Pervasive.SQL-Vx-yy.yy-zzz.zzz.x86_64.tar.gz

32-bit

Pervasive.SQL-Vx-yy.yy-zzz.zzz.i486.tar.gz

In all cases, the yy.yy designates a release number and zzz.zzz designates a build number. Refer to the distribution media for the actual name of the package.

►

To install Pervasive PSQL Vx Server using TAR

Change to the /usr/local directory.

cd /usr/local

Enter the following command to copy the tar into /usr/local.

cp <path_to_tar>/<Linux_Pervasive PSQL Vx Server_Package_Name> .

Note: Refer to Pervasive PSQL Vx Server for Linux Package Names - TAR for the package name to use. You must include the appropriate release and build number information to perform the installation. Verify the complete package name from the distribution media.

For example, if you downloaded the installation package into the /home/bholly directory:

cp /home/bholly/<Linux_Pervasive PSQL Vx Server_Package_Name> .

Unpack the tar using the following command.

tar -xzf <Linux_Pervasive PSQL Vx Server_Package_Name>

Change directories to the /usr/local/psql/etc folder where the installation scripts reside.

cd psql/etc

Run the pre-installation script:

sh preinstall.sh

Run the post installation script:

sh postinstall.sh

Utilities

Pervasive PSQL Client and Pervasive Backup Agent

See the following topics for how to install Pervasive PSQL Client and Pervasive Backup Agent. Note that Pervasive Backup Agent is an optional utility included with Pervasive PSQL Vx Server and is not installed by default.


Product	Windows Installation	Linux Installation
Pervasive PSQL Client	Perform a Custom installation. See Installing the Pervasive PSQL Client for Windows in Getting Started With Pervasive PSQL.	See the following in Getting Started With Pervasive PSQL: Installing Pervasive PSQL Client for Linux - RPM Installing Pervasive PSQL Client for Linux - TAR
Pervasive Backup Agent	Install it from the Pervasive PSQL Vx Server media after you install Pervasive PSQL Vx Server. Select Pervasive Backup Agent on the installation selection dialog. No separate license for Pervasive Backup Agent is required if it is installed on the same machine as Pervasive PSQL Vx Server. See Step 6 under To install Pervasive PSQL Vx Server on Windows.	See the following in Getting Started With Pervasive PSQL: To install Backup Agent using RPM To install Backup Agent using TAR No separate license for Pervasive Backup Agent is required if it is installed on the same machine as Pervasive PSQL Vx Server.