Upgrading from Btrieve 6.1x to Pervasive.SQL 2000i Revision 7 October 2001 Pervasive Software Inc. Pervasive Software Inc. 12365 Riata Trace Parkway II Austin, Texas 78727 Public Relations Contact: Marian Kelley Telephone: 800-287-4383/ 512-231-6000 Fax: 512-231-6010 Internet: http://www.pervasive.com 2001-2002 Pervasive Software Inc., Pervasive, Pervasive.SQL, Btrieve, and the Pervasive logo are registered trademarks of Pervasive Software Inc. All other product names are trademarks of their respective companies. All rights reserved worldwide. TABLE OF CONTENTS Overview ......................................................................................................................................... 1 What’s New ..................................................................................................................................... 1 Installation ...................................................................................................................................... 1 Workstation................................................................................................................................ 1 Workgroup ................................................................................................................................. 2 Server ........................................................................................................................................ 3 Requesters or Server First?................................................................................................ 3 Server Engine and User Count Key.................................................................................... 3 Windows NT........................................................................................................................ 3 Novell NetWare................................................................................................................... 3 Unix ..................................................................................................................................... 4 Requesters ................................................................................................................................ 4 Configuring Smart Components to Work ............................................................................ 4 Using the Network Installation ............................................................................................ 5 Documentation.................................................................................................................... 5 Troubleshooting installations..................................................................................................... 6 Workstation/Workgroup editions......................................................................................... 6 Server editions .................................................................................................................... 6 Upgrade complete.......................................................................................................................... 7 Service Packs ................................................................................................................................. 8 Troubleshooting......................................................................................................................... 8 Available online resources ........................................................................................................ 8 Summary......................................................................................................................................... 9 Rebuilding Files (Optional) ......................................................................................................... 10 Optimizing the rebuild process.......................................................................................... 10 Configuration parameters and rebuilding files .................................................................. 12 Sort Buffer Size setting ..................................................................................................... 12 Index page size.................................................................................................................12 How much memory do you need? .................................................................................... 13 Cache Allocation setting ................................................................................................... 14 Calculating depth of B-tree index (optional)...................................................................... 14 2 OVERVIEW This paper describes an approach for upgrading applications from Btrieve 6.10 or Btrieve 6.15 to Pervasive.SQL 2000i. The number of required steps in the upgrade process is small, but depending on your environment, it can be a time-consuming process. This paper is designed to anticipate problems you may experience and help minimize the time required to complete your upgrade. The content is organized in three general sections. Installation of Pervasive.SQL by configuration (Workstation, Workgroup, or Server) and any known issues that you may encounter along the way Rebuilding existing Btrieve files if needed - though the rebuild process is optional, it may be required to take advantage of some of the new features in Pervasive.SQL 2000i Testing your application WHAT’S NEW Pervasive.SQL 2000i is a major step in the evolution of the Pervasive.SQL database engine. Completely redesigned Relational interface Workgroup edition database engine Distributed Tuning Interface Improved database security Redesigned utilities, including the new Pervasive Control Center and the Pervasive System Analyzer Support for connectivity with JDBC (Level 2, Type IV), OLE DB, and a replacement plug-in for the Borland Database Engine Row-Level Locking Auto-Reconnect functionality to avoid minor network disruptions Lowered Total-cost-of-Ownership Support for Windows XP Support for NetWare 6 The goal of this paper is not to review all of these features in detail. Please refer to the Pervasive.SQL 2000i Web site at http://www.pervasive.com/portals/psql.tml for details on each of the above features. It is, however, important to draw your attention to the first two points of the list. INSTALLATION Workstation The Workstation version of Pervasive.SQL 2000i is only available as a 32-bit Windows database engine. This does not mean that your existing DOS-based and 16-bit Windows applications are no longer supported, but it does mean that your workstation must run Windows 95/98/ME/XP/NT/2000. Simply install the Pervasive.SQL 2000i as a Windows application and follow the instructions to adjust the configuration to run your application. 1 Windows 32-bit applications require no further adjustments to take advantage of Pervasive.SQL. Pervasive.SQL will transparently take over control of your database access. Windows 16-bit applications also require no further adjustments to take advantage of Pervasive.SQL. DOS applications will require a slight change to any batch files that are used to launch the application. Simply remove the command in the batch file that launches Btrieve. Pervasive.SQL takes care of providing the required interface for your DOS-based application. Note: There was no workstation engine available with Btrieve 6.10 Workgroup Available only with Pervasive.SQL 2000i, the Workgroup edition is the latest edition to the Pervasive.SQL family. It is designed from the ground up to meet the needs of workgroup and peer-to-peer configurations. This is the first release of Pervasive.SQL to address this configuration in such a manner. In Btrieve 6.15, the database engine used a mechanism called Multi-Engine File Sharing (MEFS) to provide connectivity in these environments. Though solid, the MEFS technology imposed certain limits on the workgroup, sacrificing performance for security in larger workgroup configurations. Pervasive.SQL 2000i Workgroup solves the performance issue and raises the level of security and reliability in the workgroup. Designed essentially as a scaled-down version of the client/server database engine, Pervasive.SQL 2000i assigns an “owner” to the database through which all other workgroup members access the data store. The owner provides a central access point to the database, either on the local hard drive or on a remote storage device not running a Pervasive.SQL 2000i Workgroup engine. Through this central access, Pervasive.SQL 2000i Workgroup is able to manage file locks, record locks, transactions, and the like quickly and reliably. You can define the owner statically or let the system dynamically establish the owner engine each time the database is opened. In configurations where the database resides on a computer that is also running the database engine, Pervasive recommends that you include Pervasive.SQL 2000i Workgroup in the Startup folder of the workgroup computer hosting the database. In this manner there will always be an engine running where the database is located and it will assume ownership. In configurations where the database resides on a computer that cannot run the database engine, the first Pervasive.SQL 2000i Workgroup database engine accessing the database will become a Gateway to the remote database. Should you prefer or require that the Gateway always be the responsibility of a particular machine, you should use the “Gateway locator” feature to statically define the Gateway.