Pervasive.SQL V8 (V8.6) - Linux
Service Pack 2 (SP2) Release - July 2004
README.HTML

Contents

This document contains the following topics:

• General Information
• Installation Notes
• Environments Supported
• Documentation Notes
• Technical Support
• Useful Links
• Disclaimer

General Information

Welcome to the Pervasive.SQL V8.6 Service Pack 2 (SP2) Release.

If you have previously installed one of the pre-releases of SP2 you must completely remove it from your system prior to installing this final release of SP2.

This release delivers fixes to all known critical issues in Pervasive.SQL V8. It can be applied over any Pervasive.SQL product. This includes, but is not limited to, the following Pervasive products:

Pervasive.SQL 2000i SP4 (v7.94)
Pervasive.SQL V8 (initial shipping version V8.0)
Pervasive.SQL V8 SP1 (8.10)
Pervasive.SQL V8 Security (8.50)
Or it can be installed on a machine with no previous Pervasive products installed.

User count keys from any previous V8 product apply automatically to SP2. However, if you are running Pervasive.SQL 2000i or earlier, you must purchase an upgrade key from Pervasive sales.

Note:   Because this is a service pack without extensive new features, the documentation remains as it was for Pervasive.SQL V8.50. All references to 8.50 in the documentation also apply to 8.60.

This release has separate installations for NetWare Servers, Windows Servers, Linux Servers, and Windows Workgroup Engine. To update your client installations, install the server first. Then install the client at each remote computer by mapping a drive to the server and running setup.exe from the server directory C:\pvsw\clients (or the "clients" directory of your chosen installation location).

Note:   After testing the prerelease of SP2, use the Pervasive Systems Analyzer cleanup option to remove this prerelease of SP2 from your system. Removal of the prerelease SP2 is required before installing the final release of SP2.

IMPORTANT FOR USERS OF V8.10 AND EARLIER

The Pervasive Security release (v8.50) included major new features and enhancements. These features are included in this service pack. These features have been explained in detail in the What's New document version 8.50. If you are upgrading from an earlier version of Pervasive.SQL other than 8.50, you should read the What's New document in detail before installing.

Pervasive.SQL V8 for Linux supports any Linux deployment with the following characteristics:

• Kernel version 2.4 or higher
• Glibc 2.2 or higher
• PAM libraries (if PAM is selected for security)

Installation Notes

Note:   Red Hat 8.0 contains the Red Hat Package Manager (RPM) version 4.1, which causes an installation issue with both Pervasive.SQL 2000i and Pervasive.SQL V8. If you have Red Hat 8.0, please see the following Knowledge Base article that describes the issue in more detail and offers a workaround to the problem.
Go to: http://support.pervasive.com/esupport/ and search for "RedHat 8.0"

Server-side Updates for Using the Linux Client

If you want to use the new security features of the Linux Client, you need to install the Pervasive.SQL v8.6 server engine on your server machines.

Otherwise, if you are using Pervasive.SQL V8 (SP1) for a server, you do not require any updates in order to use the Linux client. However, previous releases do require an update, and there are optional updates for the V8 releases.

Installation Procedures

• Client procedures
• Server procedures

Client Procedures

1. Log in as the root user
2. If a prior version of the client exists, remove it by issuing the following command:

   rpm -e 'Pervasive.SQL-Client'

3. Issue the following command.

   rpm -ivh Pervasive.SQL-Client-x.yy-zzz.zzz.i486.rpm

1. Log in as the root user.
2. Change to the /usr/local directory.

   cd /usr/local 
   

3. Copy the tar into /usr/local

   cp <path_to_tar>/Pervasive.SQL-Client-x.yy-zzz.zzz.i486.tar.gz . 
   

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

   cp /home/bholly/Pervasive.SQL-Client-x.yy-zzz.zzz.i486.tar.gz .

4. Unpack the tar using the following command.

   tar -xzf Pervasive.SQL-Client-x.yy-zzz.zzz.i486.tar.gz
   

5. If you have a previous installation of Pervasive.SQL (whether or not it is still installed), you may have an existing /usr/local/psql directory. Perform the ls command as follows to ascertain whether you have an existing psql directory.

   ls /usr/local/psql
   

   If you do have an existing psql directory, continue with Step 6 now. Otherwise, issue this command first:

   mkdir /usr/local/psql
   

6. Copy the contents of the psqlclient folder into the psql folder.

   cp -R psqlclient/* /usr/local/psql 
   

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

   cd psql/etc 
   

8. Run the post installation script:

   sh clientpostinstall.sh 
   

9. Your tar installation is complete. Read Guide to Linux Client to understand what actions this script performed.

Server Procedures

1. Log in as the root user
2. Assuming that the RPM package is in the current directory, issue the following command.

   rpm -Uvh Pervasive.SQL-x.yy-zzz.zzz.i486.rpm

1. Log in as the root user
2. Issue the following command.

   rpm -ivh Pervasive.SQL-x.yy-zzz.zzz.i486.rpm

1. Log in as the root user
2. Uninstall the version of Pervasive.SQL 2000i SP3 or later:

rpm -e 'Pervasive.SQL'

or if prior to SP3:

rpm -e 'Pervasive.SQL-server'

3. Issue the following command.

   rpm -ivh Pervasive.SQL-x.yy-zzz.zzz.i486.rpm

1. Log in as the root user.
2. Change to the /usr/local directory.

   cd /usr/local 
   

3. Copy the tar into /usr/local

   cp <path_to_tar>/Pervasive.SQL-x.yy-zzz.zzz.i486.tar.gz . 
   

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

   cp /home/bholly/Pervasive.SQL-x.yy-zzz.zzz.i486.tar.gz .

4. Unpack the tar using the following command.

   tar -xzf Pervasive.SQL-x.yy-zzz.zzz.i486.tar.gz
   

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

   cd psql/etc 
   

7. Run the post installation script:

   sh postinstall.sh 
   

8. Your tar installation is complete. Read Getting Started (Server edition) to understand what actions this script performed.

Return to top of page.

Environments Supported

The Pervasive.SQL V8 Server for Linux was tested and is supported on Linux deployments with the following characteristics:

• Kernel version 2.4 or higher
• Glibc 2.2 or higher
• PAM libraries (if PAM is selected for security)

Return to top of page.

Documentation Notes

How Do I Read the Online Documentation?

Server documentation

file://usr/local/psql/doc/html/index.html

Client documentation

file://usr/local/psql/clientdoc/html/index.html

Contact Pervasive Technical Publications

Technical Support

You may obtain technical support from the following Web-based support options:

• Pervasive Knowledge Base at http://support.pervasive.com/eSupport
• To open a support incident, http://www.pervasive.com/support/index.asp. Click on Open or Check Status of a Support Incident.

To report a product defect, http://www.pervasive.com/support/index.asp. Click on Report a product defect.

If you require something other than what Web-based support options provide, contact Pervasive Support by phone:

• 800-287-4383 option 3 (the Americas)
• +800.1212.3434 (Austria, Belgium, Denmark, France, Germany, Italy, Luxembourg, The Netherlands, Spain, Sweden, Switzerland, and the U.K.)
• +32.0.23.37.61 (Any other European, Middle Eastern, African or Asian countries, excluding Japan)

For technical support and discussions about Pervasive products in general:

• Visit the DevTalk forum at http://www.pervasive.com/devtalk.
• Visit http://www.pervasive.com/company/contact/index.asp for other contact information.

For information on updates and Service Packs:

• Visit the updates page at http://www.pervasive.com/support/updates

Return to top of page.

Useful Links

• For a comprehensive list and details of Pervasive Products, see

http://www.pervasive.com/offerings

• Discuss all your Pervasive development issues at:

http://www.pervasive.com/devtalk

• Review information about application development at:

  http://www.pervasive.com/developerzone

• For Technical Papers, see:

http://www.pervasive.com/support/techpapers.asp

• For online Product Manuals, see:

http://www.pervasive.com/support/technical/online_manuals.asp

• For information on our Support programs, see

  http://www.pervasive.com/support/support_programs.asp

• For information on Updates and Service Packs, see:

  http://www.pervasive.com/support/updates

Return to top of page.

Disclaimer

PERVASIVE SOFTWARE INC. LICENSES THE SOFTWARE AND 
DOCUMENTATION PRODUCT TO YOU OR YOUR COMPANY SOLELY 
ON AN "AS IS" BASIS AND SOLELY IN ACCORDANCE WITH 
THE TERMS AND CONDITIONS OF THE ACCOMPANYING 
LICENSE AGREEMENT.  
 
PERVASIVE SOFTWARE INC. MAKES NO OTHER WARRANTIES 
WHATSOEVER, EITHER EXPRESS OR IMPLIED, REGARDING 
THE SOFTWARE OR THE CONTENT OF THE DOCUMENTATION; 
PERVASIVE SOFTWARE INC. HEREBY EXPRESSLY STATES AND 
YOU OR YOUR COMPANY ACKNOWLEDGES THAT PERVASIVE 
SOFTWARE INC. DOES NOT MAKE ANY WARRANTIES, 
INCLUDING, FOR EXAMPLE, WITH RESPECT TO 
MERCHANTABILITY, TITLE, OR FITNESS FOR ANY 
PARTICULAR PURPOSE OR ARISING FROM COURSE OF 
DEALING OR USAGE OF TRADE, AMONG OTHERS.  
 

Copyright © 2004 Pervasive Software Inc.  
All Rights Reserved.