pervasive sync

Download Pervasive Sync

If you can't read please download the document

Post on 26-Mar-2015

92 views

Category:

Documents

2 download

Embed Size (px)

TRANSCRIPT

Pervasive DataExchange

Users GuideGuide to Using Pervasive DataExchange

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: info@pervasive.com 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. Btrieve, Client/Server in a Box, Pervasive, Pervasive Software, Pervasive DataExchange, and the Pervasive Software and the Pervasive DataExchange logos are trademarks or registered trademarks of Pervasive Software Inc.Built on Pervasive Software, Pervasive AuditMaster, know whos doing what to your data when, where and how, MicroKernel Database Engine, MicroKernel Database Architecture, Pervasive.SQL, 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. The Regex++ library is Copyright (c) 1998-2001 by Dr John Maddock. This product features PeerDirect software. Pervasive Software, Inc. is a licensed user of the trademark "PeerDirect," and that trademark and PeerDirect are owned by PeerDirect Inc. PeerDirect software 1993-2001 PeerDirect Inc. All Rights Reserved.

trademarks

All other company and product names are the trademarks or registered trademarks of their respective companies. Copyright 2008 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.

Users Guide July 2008 100-004177-005

Contents

ContentsAbout This Manual . . . . . . . . . . . . . . . . . . . . . . . . . . .Who Should Read This Manual . . . . . Manual Organization . . . . . . . . . . . Pervasive DataExchange . . . . . . Real-Time Backup Edition . . . . Data Synchronization Edition. . . DataExchange Tools and Utilities. Supplemental Information . . . . Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

xvxvi xvii xvii xvii xvii xvii xviii xix

Pervasive DataExchange1 Introducing Pervasive DataExchange . . . . . . . . . . . . . . . . 1-1Understanding Pervasive DataExchange and Its Capabilities DataExchange Overview . . . . . . . DataExchange Editions . . . . . . . . Real-Time Backup Edition . . Data Synchronization Edition. DataExchange Components . . . . . DataExchange Utilities. . . . . DataExchange Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2 1-3 1-3 1-3 1-4 1-4 1-5

2

Pervasive DataExchange Basics . . . . . . . . . . . . . . . . . . . 2-1An Overview of DataExchange Basics Starting and Stopping Replication . . . . . . . . . . . . . . . As a Service . . . . . . . . . . . . . . . . . . . . . . . . As a Console Application . . . . . . . . . . . . . . . . From Pervasive Control Center . . . . . . . . . . . . . Starting and Stopping the DXAgent Service . . . . . . . . . As a Service . . . . . . . . . . . . . . . . . . . . . . . . From Pervasive Control Center . . . . . . . . . . . . . ODBC Basic Concepts . . . . . . . . . . . . . . . . . . . . . Servers and Clients . . . . . . . . . . . . . . . . . . . . Data Source Names . . . . . . . . . . . . . . . . . . . Pervasive PSQL Security . . . . . . . . . . . . . . . . . . . . Deploying Demodata Under Pervasive PSQL Security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2 2-2 2-3 2-3 2-5 2-5 2-6 2-7 2-7 2-7 2-9 2-9

3

Using Pervasive DataExchange . . . . . . . . . . . . . . . . . . . . 3-1A Guide to Using DataExchange in Daily Operations

iii

Contents

Activation . . . . . . . . . . . . . . . . . . . . . . . . . . Activation and Data Source Names . . . . . . . . Activating First and Partner Sites . . . . . . . . . Deactivation . . . . . . . . . . . . . . . . . . . . . . . . Reactivation . . . . . . . . . . . . . . . . . . . . . Adding Tables to an Activated Database . . . . . . . . . Before you Begin . . . . . . . . . . . . . . . . . . Determine Event Handler DLL Usage . . . . . . . Deactivate All Sites . . . . . . . . . . . . . . . . . Verify the Table Exists in the Pervasive Database. Add the New Table to the Replication Template . Stop Replication Service on Partner Sites . . . . . Copy Files (DDFs, D- and PDC Tables) . . . . . . Activate First Site and Synchronize Tables . . . . Start Replication Service on Partner Sites . . . . . Activate Partner Sites . . . . . . . . . . . . . . . . Initiate Replication . . . . . . . . . . . . . . . . . Removing Tables From an Activated Database . . . . . Before you Begin . . . . . . . . . . . . . . . . . . Deactivate all Sites. . . . . . . . . . . . . . . . . . Remove Table From the Replication Template . . Stop Replication Service on Partner Sites . . . . . Copy D*.mkd Tables . . . . . . . . . . . . . . . . Start Replication Service on Partner Sites . . . . . Activate all Sites . . . . . . . . . . . . . . . . . . . Initiate Replication . . . . . . . . . . . . . . . . . Adding Dynamic Tables to an Activated Database . . . Before you Begin . . . . . . . . . . . . . . . . . . Include File Patterns . . . . . . . . . . . . . . . . Exclude File Patterns . . . . . . . . . . . . . . . . Setting up Nondatabase File Replication . . . . . . . . . Before You Begin . . . . . . . . . . . . . . . . . . Set Log On Properties . . . . . . . . . . . . . . . . Create New Flat File Database . . . . . . . . . . . Execute the SQL Queries . . . . . . . . . . . . . . Create the Design Template . . . . . . . . . . . . Copy Files . . . . . . . . . . . . . . . . . . . . . . Activate all Sites . . . . . . . . . . . . . . . . . . . Restart DX Services . . . . . . . . . . . . . . . . . Redesign Dxevent Table . . . . . . . . . . . . . . Create Site Shares . . . . . . . . . . . . . . . . . . Configure Flat File Replication. . . . . . . . . . . Changing a Table Structure in an Activated Database . Before you Begin . . . . . . . . . . . . . . . . . . Clone PDC Table(s). . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

3-2 3-2 3-3 3-5 3-6 3-7 3-7 3-8 3-8 3-9 3-10 3-11 3-11 3-12 3-13 3-13 3-14 3-15 3-15 3-15 3-16 3-17 3-17 3-18 3-18 3-19 3-20 3-21 3-21 3-22 3-24 3-24 3-25 3-25 3-26 3-27 3-28 3-28 3-29 3-29 3-30 3-30 3-32 3-32 3-33

iv

Contents

Activate t