PSQL Vx Server Product Guide (v11)

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

  1. Launch the installation program from your Windows machine.
    1. Insert the Pervasive PSQL Vx Server media into the CD-ROM drive.
    2. 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.
  2. 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.
  3. If prompted, close or uninstall any running applications that may interfere with the Pervasive PSQL installation.

    メモ

    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.


  4. At the Welcome screen, click Next.
  5. On the License Agreement page, read and accept the Software License Agreement, then click Next.
  6. 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.
  7. 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.
  8. Click Next to continue.
  9. 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.
  10. Click Install to begin installation.
  11. 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).
  12. Enter your key and click the button to authorize it (an Internet connection is required).
  13. A message box displays with the status of the authorization action. Perform one of the following actions depending on the status:
  14. 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.

    メモ

    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 6 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:

To install Pervasive PSQL Vx Server using RPM

  1. Log in as the root user.
  2. Assuming the RPM package is in the current directory, enter the following command:
    rpm -ivh <Linux_Pervasive PSQL Vx Server_Package_Name>

    メモ

    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.
  3. Run the command line License Administrator utility to apply the key. See License Administrator のコマンド ライン インターフェイス 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 7 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

  1. Log in as the root user.
  2. Change to the /usr/local directory.
    cd /usr/local
  3. Enter the following command to copy the tar into /usr/local.
    cp <path_to_tar>/<Linux_Pervasive PSQL Vx Server_Package_Name> .

    メモ

    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> . 
    
  4. Unpack the tar using the following command.
    tar -xzf <Linux_Pervasive PSQL Vx Server_Package_Name>
  5. Change directories to the /usr/local/psql/etc folder where the installation scripts reside.
    cd psql/etc
  6. Run the pre-installation script:
    sh preinstall.sh
  7. Run the post installation script:
    sh postinstall.sh
  8. Run the command line License Administrator utility to apply the key. See License Administrator のコマンド ライン インターフェイス 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.

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.

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 Windows での Pervasive PSQL クライアントのインストール 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 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.


Upgrading to Pervasive PSQL Vx Server

After Installing Pervasive PSQL Vx Server