DataExchange v5.1 - Release Notes
General Release - March 2013

Welcome to Pervasive DataExchange v5.1. This readme contains the following topics:

Welcome

Thank you for your interest in Pervasive DataExchange, an offering in the Pervasive product suite. DataExchange reliably moves data between two or more Pervasive PSQL databases to maintain warm backup systems, drive data into reporting servers, or synchronize multiple remote databases. DataExchange fits seamlessly into your environment.

Please review these release notes for last-minute information not included in the DataExchange user documentation.

Pervasive Software is dedicated to providing new and improved functionality with each release of DataExchange to help you manage your data monitoring needs. The following section outlines some of the features and enhancements found in this release.

What’s New in Pervasive DataExchange v5.1

Pervasive DataExchange v5.1 includes all of the enhancements of release 5.0. The upgrade enables the functionality of your previous release to be compatible with Pervasive PSQL Vx Server and other Pervasive PSQL products. The functionality of DX Designer has been replaced with wizards.

DataExchange 5.1 has been adapted to the new Windows 8 screen format. On the Apps screen, shortcuts for DX Deployment Wizard, DX Documentation, and DX Manager will appear in a Pervasive DataExchange 5 parent folder.

Supported Operating Systems and Database Products

This section lists the supported operating systems and the required Pervasive Software products for Pervasive DataExchange v5.1.

Supported Operating Systems

Pervasive DataExchange is supported on the same Windows platforms as Pervasive PSQL v11 and Pervasive PSQL Vx Server. For a complete list of the supported operating systems, refer to the Pervasive Software Web site ( http://www.pervasivedb.com).

Supported Database Products

Pervasive DataExchange v5.1 is supported by the following Pervasive PSQL database products.

Pervasive PSQL Product
Release
Bitness
Windows
Linux
Server
v11
v11 SP1
v11 SP2
v11 SP3
32-bit
64-bit
Yes
No
Vx Server
11
11 SP3
32-bit
64-bit
Yes
No
Workgroup
v11
v11 SP1
v11 SP2 v11 SP3
32-bit
Yes
not applicable

Installation Notes

This section includes useful information related to installing Pervasive DataExchange v5.1.

If you have not yet installed Pervasive DataExchange and want to read about installation, see the Getting Started with Pervasive DataExchange guide for your particular edition of Pervasive DataExchange. A PDF version of this guide is provided on the product installation media.

The software and hardware requirements for Pervasive DataExchange are listed on the Pervasive Software web site.

Pervasive DataExchange can be used with Pervasive PSQL Vx Server and with Pervasive PSQL v11. However, the License Administrator provided with Pervasive PSQL v11 and Pervasive PSQL v11 SP1 does not correctly display all of the attributes of Pervasive DataExchange v5.1 licenses. If you use PSQL v11 SP2 or later, then License Administrator on the database engine machine and on each Pervasive PSQL v11 Client correctly displays all of the attributes of Pervasive DataExchange licenses.

Upgrade Notes

This section summarizes upgrading DataExchange.

From DX
To DX
Installation or Upgrade Procedure
3.0, 4.0, or 5.0
5.1
  1. Stop all replication schedules (select Do not replicate in DataExchange Manager).
  2. Stop the Pervasive DataExchange Agent service.
  3. Stop the Pervasive PSQL Replication service.
  4. Install the Pervasive PSQL database product.
  5. Install Pervasive DataExchange v5.1.
  6. Restart all replication schedules.
For information on stopping and starting the replication schedules, see “Schedule Tasks” in “Using DataExchange Manager” in the Pervasive DataExchange User’s Guide, or the steps under "To upgrade Pervasive DataExchange" in Getting Started with Pervasive DataExchange.

32-bit to 64-bit Upgrades

Upgrading 32-bit Pervasive DataExchange to 64-bit Pervasive DataExchange requires uninstalling 32-bit DataExchange and the 32-bit Pervasive database product followed by installing a 64-bit Pervasive database product and 64-bit DataExchange.

Known Issues

The following lists the known issues for Pervasive DataExchange v5.1 at the time of release.

Issue
Description
58136
From DX3.0 onwards, DX has been supported on Vista.
However due to insufficient rights, many of DX's utilities don't work on Vista unless run as administrator.
Examples include DX Deployment Wizard and the command line utility dxact.
 
Pervasive DataExchange v5.1 does not support the following Pervasive PSQL feature:
  • V2 metadata (longer object names up to 128 characters)
56304
DX Deployment Wizard Print Summary button does not function properly if a printer is not installed.
After successful completion of Deployment Wizard, clicking Print Summary should prompt to print the summary. If no printer is installed on the machine, then it should prompt to install a printer. In Pervasive DataExchange v5.1, clicking Print Summary does not display the error message. It works properly if there is a printer added.
Solution: Add a printer before clicking Print Summary.
56334
DataExchange does not support using regular expressions with the dxdynpath utility.
Solution: When using the dxdynpath utility, use Dir expressions. Example: dxdynpath append /p=”dir ..\test.MKD” test
56697
Network Shares cannot be accessed from DX Deployment Wizard's Browse Button.
Workaround: Do not try to browse to a network share directly from the wizard. Map a drive to that share instead. Then chose the mapped drive to browse to the project file.
57562
Pervasive DataExchange v5.1 1-way replication (with overwrite) from First Site to multiple Partner Sites fails.
Attempting to run a 1-way replication from a First Site to 2 or more Partner Sites with the 2nd type of replication "Delete and replace all data on the selected sites with data from source database" option selected fails to complete. The First Site only attempts to replicate to one of the Partner Sites instead of all of them and it fails with the following errors in the log:
E 06f8 07-11 13:38:31 rtbproj (rtbnet) - rtb (2KS) is not currently allowing replication - please try again later
E 06f8 07-11 13:38:31 An error occurred in the sync session envelope.
E 06f8 07-11 13:38:31 Refresh or Complete Replication has been disallowed.
Note: the Pervasive DataExchange User’s Guide states that this should be able to replace the data on all Partner Sites.
Workaround: Select a single Partner Site to perform this action on instead of all Partner Sites.
57785
In replication deployments, replication fails when initiated from the partner site on Real-Time Backup and Data Synchronization 1-way deployments.
Workaround: In replication deployments, please initiate replication from the first site.

Known issues with solutions or workarounds for Pervasive DataExchange v5.1 are published in the Knowledge Base on the Pervasive Web site. In the Knowledge Base, search on “Pervasive DataExchange Known Issues.”

Transactional Limitations

The transactional (Btrieve) mode of replication has two known limitations:

Documentation Notes

This section provides information regarding the Pervasive DataExchange documentation included in this release.

These documents are placed on your machine as part of the Pervasive DataExchange product installation. You can access them from the Start menu or in the installation directory.

Technical Support

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

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.

This product features PeerDirect™ software, and Pervasive Software, Inc. is a licensed user of the trademark "PeerDirect", and that trademark and PeerDirect are owned by PeerDirect Inc. All Rights Reserved. PeerDirect software © 1993-2002 PeerDirect Inc. All Rights Reserved.

© Copyright 2013 Pervasive Software Inc.

All Rights Reserved.


Pervasive Software Inc.
http://www.pervasive.com
12365 Riata Trace Pkwy, Bldg B
Austin, TX 78727 USA
Voice: (512) 231-6000
Fax: (512) 231-6010
Online Pervasive Contacts

*** End of Release Notes ***