Pervasive PSQL v10 SP3 Getting Started with Pervasive PSQL Pervasive Software Inc. 12365 Riata Trace Parkway Building B Austin, TX 78727 USA Telephone: 512 231 6000 or 800 287 4383 Fax: 512 231 6010 Email: [email protected] Web: http://www.pervasive.com 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. trademarks Btrieve, Client/Server in a Box, Pervasive, Pervasive Software, and the Pervasive Software logo are registered trademarks of Pervasive Software Inc. Built on Pervasive Software, DataExchange, MicroKernel Database Engine, MicroKernel Database Architecture, Pervasive.SQL, Pervasive PSQL, Solution Network, Ultralight, and ZDBA are trademarks of Pervasive Software Inc. Microsoft, MS-DOS, Windows, Windows 95, Windows 98, Windows NT, Windows Millennium, Windows 2000, Windows XP, Win32, Win32s, and Visual Basic are registered trademarks of Microsoft Corporation. NetWare and Novell are registered trademarks of Novell, Inc. NetWare Loadable Module, NLM, Novell DOS, Transaction Tracking System, and TTS are trademarks of Novell, Inc. Sun, Sun Microsystems, Java, all trademarks and logos that contain Sun, Solaris, or Java, are trademarks or registered trademarks of Sun Microsystems. All other company and product names are the trademarks or registered trademarks of their respective companies. © Copyright 2009 Pervasive Software Inc. All rights reserved. Reproduction, photocopying, or transmittal of this publication, or portions of this publication, is prohibited without the express prior written consent of the publisher. This product includes software developed by Powerdog Industries. © Copyright 1994 Powerdog Industries. All rights reserved. This product includes software developed by KeyWorks Software. © Copyright 2002 KeyWorks Software. All rights reserved. This product includes software developed by DUNDAS SOFTWARE. © Copyright 1997-2000 DUNDAS SOFTWARE LTD., all rights reserved. This product includes software developed by the Apache Software Foundation (http://www.apache.org/). See the Apache Software License. This product uses the free unixODBC Driver Manager as written by Peter Harvey ([email protected]), modified and extended by Nick Gorham ([email protected]), with local modifications from Pervasive Software. Pervasive Software will donate their code changes to the current maintainer of the unixODBC Driver Manager project, in accordance with the LGPL license agreement of this project. The unixODBC Driver Danager home page is located at www.unixodbc.org. For further information on this project, contact its current maintainer: Nick Gorham ([email protected]). A copy of the GNU Lesser General Public License (LGPL) is included on the distribution media for this product. You may also view the LGPL at www.fsf.org/licensing/licenses/lgpl.html. Getting Started with Pervasive PSQL November 2009 100-004386-004 Contents Contents About This Manual . xi Who Should Read This Manual . xii Manual Organization . xiii Conventions . xv 1 Welcome to Pervasive PSQL . 1-1 A Basic Introduction to Pervasive PSQL v10 SP3 About Pervasive PSQL . 1-2 Competitive Advantages. 1-2 Relational or Transactional Access . 1-3 The Pervasive PSQL Transactional Interface . 1-4 Benefits of the Transactional Interface . 1-4 Transactional Features. 1-5 The Pervasive PSQL Relational Interface . 1-6 Benefits of the Relational Interface . 1-6 Relational Features . 1-6 About the Pervasive PSQL Engines . 1-8 Pervasive PSQL Server . 1-8 Pervasive PSQL Workgroup. 1-8 Engine Feature Comparison. 1-9 Pervasive PSQL SDK . 1-10 Development Environment . 1-10 2 Preparing to Install Pervasive PSQL . 2-1 Preparation Needed for Pervasive PSQL v10 SP3 Installation Installation Requirements . 2-2 Installation Options. 2-3 Complete Installation . 2-3 Custom Installation . 2-3 Pervasive PSQL v10 SP3 Products . 2-4 Server Engine (64-bit) . 2-4 Server Engine (32-bit) . 2-4 Workgroup Engine (32-bit) . 2-4 Client (64-bit) . 2-5 Client (32-bit) . 2-5 Pervasive PSQL v10 SP3 Optional Features. 2-6 Xtreme I/O (Server 32-bit Only) . 2-6 Pervasive Access Methods . 2-6 Utilities . 2-7 Documentation. 2-8 iii Contents Java Runtime Environment (JRE) . 2-9 Installation Review . 2-10 Quick Checklist . 2-10 Common Pre-Installation Questions . 2-11 3 Upgrading Your Pervasive PSQL Installation for Windows . 3-1 Considerations for Users Upgrading to Pervasive PSQL v10 SP3 Upgrading to Pervasive PSQL v10 SP3 From a Previous Version . 3-2 Considerations When Upgrading to Pervasive PSQL v10 SP3. 3-2 Common Questions After Upgrading to Pervasive PSQL . 3-4 4 Installing Pervasive PSQL Server for Windows . 4-1 Instructions for Installing the Pervasive PSQL Server Engine on Windows Before You Install the Windows Server Engine . 4-2 Platform Notes . 4-2 Installation Tips . 4-2 Installing Pervasive PSQL Server for Windows . 4-4 5 Installing Pervasive PSQL Clients for Windows . 5-1 Instructions for Installing the Pervasive PSQL Client on Windows Before You Install the Windows Client Engine . 5-2 Installing the Pervasive PSQL Client for Windows . 5-3 Installing the BTRBOX Requester . 5-7 Win32 DOS Box Support. 5-7 Understanding Client Requesters . 5-8 Types of Windows Requesters . 5-8 Where To Go From Here . 5-9 6 Installing Pervasive PSQL Workgroup for Windows. 6-1 Instructions for Installing the Pervasive PSQL Workgroup Engine on Windows Before You Install the Windows Workgroup Engine . 6-2 Installation Tips . 6-2 Installing the Pervasive PSQL Workgroup for Windows . 6-3 Activation of Workgroup Key on Vista and Windows 7 . 6-6 7 After Installing Pervasive PSQL for Windows . 7-1 Answers to Common Post Installation Questions for Pervasive PSQL on Windows Common Questions After Installing Pervasive PSQL . 7-2 Where To Go From Here . 7-5 Uninstalling Pervasive PSQL . 7-6 iv Contents 8 Configuring the Workgroup Engine. 8-1 Understanding the Available Workgroup Engine Configurations Overview. 8-2 Installation Requirements . 8-2 Operating System Security . 8-2 When to Use Workgroup . 8-2 What is a Gateway Engine? . 8-3 Setting Up a Small Client/Server Configuration . 8-5 Setting Up a Peer-to-Peer Configuration . 8-7 Setting Up a Gateway Configuration . 8-9 Floating or Fixed Gateway. 8-9 Working with the Gateway Locator Utility. 8-11 Running the Workgroup Engine as a Service . 8-15 Configuration . 8-15 Stopping the Service . 8-16 9 Configuring Engine Network Communications . 9-1 How to Set Up Network Communication for Pervasive PSQL Engines Determining What Kind of Network You Have . 9-2 Database Engine on Windows . 9-2 Engine Network Communication Settings . 9-3 Setting Up TCP/IP Support . 9-4 Setting Up SPX Support . 9-6 Setting Up NetBIOS Support (Workgroup only). 9-8 Avoiding Unavailable Protocols . 9-9 10 Configuring Network Communications for Clients . 10-1 How to Configure Network Communications for Your Pervasive PSQL Clients Client Network Communication Settings. 10-2 Network Path Formats Supported by Pervasive Requesters . 10-3 Universal Naming Convention (UNC) Path Formats. 10-3 Drive-based Formats. 10-4 Linux Path Formats . ..