Pervasive logo

Prev Getting Started with Pervasive.SQL (Server edition) Next

Upgrading to Pervasive.SQL Server from Earlier Pervasive.SQL Versions or Btrieve 6.x


You must install the Pervasive.SQL Server upgrade for Windows at the server itself; you cannot install it remotely from a client machine.


Note
If the installation fails before the program copies any files to the target installation directory, the installation log file (install.log) can be found in the directory specified by the %TEMP% environment variable. This directory is often c:\windows\temp or c:\winnt\temp.

   To upgrade to Pervasive.SQL V8 (Server Edition) on a Windows machine:

  1. Launch the installation program from your Windows machine.
    1. Insert the Pervasive.SQL Server for Windows CD in the CD-ROM drive of your Windows server.
    2. If the installation does not start automatically, click Start, select Run, and type drive:setup where drive is the drive letter of your CD-ROM device.


Note
Please see Installation Tips regarding the Pervasive.SQL V8 Setup Reboot Required dialog box.

The setup Welcome screen appears. Click Next to proceed with the installation.

  1. Certain programs and services on Windows can interfere with the Pervasive.SQL installation process. The Pervasive.SQL installation program detects these programs if they are running during your installation and informs you so that you can stop the programs. Doing so ensures that your installation completes successfully.

    Skip to Step 3 if you do not see a screen similar to Figure 5-2.

     
    Figure 5-2    Detection of Programs Running During Installation

There are two categories of programs detected by the installation program:

An example of a program in this category is one that utilizes the Pervasive.SQL Workgroup engine. If you are running such a program, Figure 5-3 displays if you try to continue without stopping the program.

 
Figure 5-3    Programs in Conflict with Installation

Examples of programs in this category include such products as Microsoft Internet Information Service (IIS) and others that can potentially lock system files.

If you try to continue the installation without stopping the listed programs, Figure 5-4 displays and asks for confirmation to stop the conflict detection process. If you want the installation program to check for conflicts again, click Yes. If you want to continue the installation despite the possible conflict, click No.

 
Figure 5-4    Programs that May Conflict with Installation

  1. Read and accept the Software License Agreement

     
    Figure 5-5    Pervasive Software's Software License Agreement

Read the Pervasive Software License Agreement. Click Yes to accept the terms of the agreement and continue installation.

  1. Apply your user count license key

     
    Figure 5-6    Applying the User Count License

Your Pervasive.SQL V8 server is set to the number of users specified in the license key. When the update is complete, a dialog box informs you that you have increased your user count license to support that number of simultaneous users.


Note
If you do not yet have a license key or it is not with you at the moment, you can still continue with the installation. Click Next at the License Key dialog box to install a trial version and run the License Administrator utility at a later time to install a user count license key. The License Administrator utility is documented in Pervasive.SQL User's Guide in the section License Administrator .

  1. Select the Setup Type: Complete or Custom.

     
    Figure 5-7    Setup Type Dialog Box

Click Next to continue with installation.

Notes About Complete Setup

The Complete installation, which is recommended for most first time users, takes default actions for most operations performed during the installation.

The Complete server installation installs the following components:

Notes About Custom Setup

The Custom installation is typically for advanced users since it lets you choose the components you want to install and specify the program folder name.

Selecting Custom setup type allows you to specify the program folder, select the components to install, and set the Pervasive.SQL V8 engine service start mode.

During a Custom server installation, the following components are optional:

If you choose a custom install, skip now to Custom Installation Path . At the end of that section you will return to this section to continue the installation.

  1. Select the server installation directory.

    The default installation location for Pervasive.SQL V8 is C:\PVSW, assuming the Windows system drive is C:\.

     
    Figure 5-8    Select Your Installation Directory

Click Next to accept the default installation directory and proceed with the installation.


Note
To select a different directory, click Browse and select or enter the new installation directory. If the folder you have chosen doesn't exist, you'll need to answer Yes to have setup create the folder for you.

  1. Verify your installation settings.

     
    Figure 5-9    Your Selected Installation Settings

If the displayed selections are correct, click Next to continue.

  1. Scan for previous Pervasive.SQL files.

    If you had a previous version of Pervasive.SQL on your system, Pervasive System Analyzer archives it before copying the updated Pervasive.SQL V8 files.

     
    Figure 5-10    System Analysis Using PSA

  1. Pervasive.SQL setup begins to copy the necessary files to complete your specified installation requirements.

     
    Figure 5-11    Setup Begins Copying Files


Note
Only click Cancel if you want to stop installation and exit the Setup process.

  1. Your Pervasive.SQL V8 server upgrade is complete.

    The following dialog box informs you that the installation is complete.

     
    Figure 5-12    Installation Complete Dialog Box

Click Finish.

  1. If installed files could not be copied because they were locked in memory, a reboot may be necessary at this point. Setup only prompts for a reboot if a locked file or some other event was detected that requires a reboot. Please reboot your system if prompted to do so in order to ensure proper operation of your Pervasive.SQL V8 product.

     
    Figure 5-13    Installation Complete - Need Reboot


Click Finish.


Note
If you have any trouble with the installation, see Chapter 21, Troubleshooting After Installation.

The installation program modifies the PATH and CLASSPATH environment variables at the end of the installation process, if needed. These settings control how your Windows operating system finds Pervasive components. In Windows, these environment variables are stored in the Control Panel under the Environment tab on the System icon. In Windows 2000, these environment variables are stored in the Control Panel under the Advanced tab on the System icon.

Post Installation

  1. Register your product.

    After you have completed your Pervasive.SQL installation, you can register your product to receive news about future updates, and other timely information. You can also register later using a web, e-mail, or print-based registration form.

     
    Figure 5-14    Product Registration Page


  1. Read the README and What's New.

     
    Figure 5-15    View Readme and What's New


If you did not read the README file prior to installation as described in Before You Begin , please do so now from the registration page.

  1. Close the Registration page. Next the Pervasive System Analyzer (PSA) launches its tests of the transactional and relational interfaces. These tests ensure that your database engine is working as expected after installation.
  2. Test the Transactional Engine

    PSA performs a series of tasks to ensure that the transactional engine is working properly.

     
    Figure 5-16    Transactional Engine Test


Note
It is recommended that you perform this test to ensure that the transactional engine is communicating properly and the transactional databases are now functional.

  1. Run the Transactional Test.

    PSA displays a check mark for each test that passes and an X for each task that fails during the transaction engine test. A summary report is also provided in the information window, as shown in the following figure.

     
    Figure 5-17    Transactional Engine Test Results from PSA

Once your transactional engine tests are complete, click Next to test the relational engine.

  1. Test the Relational Engine.

    PSA performs a series of tasks to ensure that the relational engine is working properly.

     
    Figure 5-18    Relational Engine Test


Note
It is recommended that you perform this test to ensure that the relational engine is communicating properly and the relational databases are now functional.

  1. Run the Relational Test.

    PSA displays a check mark for each test that passes and an X for each task that fails during the relational engine test. A summary report is also provided in the information window, as shown in the following figure.

     
    Figure 5-19    Relational Engine Test Results from PSA

Once your relational engine tests are complete, click Next to finish the installation.

  1. Your installation and verification tests are complete.

    Thank you for choosing Pervasive.SQL.

What to do Next

Skip the next section for custom installations and see Common Questions After Installing Pervasive.SQL .


Prev
Before You Begin
Contents
Up
Check for Revisions
Next
Custom Installation Path