DataMatcher 1.0 - Readme
General Release - April 2009

These release notes may supersede information in the rest of the documentation. The Pervasive DataRush web site may also have new information on using this product.

This document itself may have updates. Check for a newer version for download from the web site.

License Restrictions

The 3-month trial license is not for production use, not for resale, and not for commercial use.

For details, see license.txt in the installation.

Pervasive DataMatcher 1.0 Release

These release notes cover the following topics:

System Requirements

Please review these requirements before running DataMatcher.

Operating Systems and Hardware

This release has been tested on the following platforms and environments.

System
Supported Versions
Hardware
Microsoft Windows
2003 Server R2 SP1
XP SP2
Server 2008, SP1
x86
x86-64
HP-UX
11
Itanium
PA-RISC
IBM AIX 5L
5.3
PowerPC
Mac OS X
10
Intel
Novell SUSE Linux Enterprise
9.3
10
x86
x86-64
Red Hat Enterprise Linux
4
x86
x86-64
Sun Solaris Enterprise
10
UltraSPARC T2
x86
x86-64

Performance

Minimum satisfactory performance requires the following:

Java

Run DataMatcher on the latest versions of the following Java releases.

Where possible, Sun Java is recommended.

In all cases, 64-bit Java is preferred.

Permissions and Privileges

Administrator privileges are required on your local machine to modify the system path environment variable.

Additional Tools

The following tools are useful but are not required for DataMatcher application usage:

Installing and Configuring DataMatcher

This topic covers the following procedures:

To install DataMatcher

Allow at least 30 MB free disk space for DataMatcher installation.

  1. Download the .zip archive.
  2. Extract the archive contents to an installation directory.
  3. Extracted files appear in InstallDir/datarush-matching-1.0.2.

To set the license file

  1. Obtain a license file from Pervasive Software.
  2. A trial license can be downloaded from the DataRush web site.

  3. Copy the license file to InstallDir/datarush-matching-1.0.2.

To add DataMatcher to the Path environment variable

Required for Windows, optional for Unix systems.

  1. Log on as local administrator.
  2. Add the DataMatcher /bin directory to the Path environment variable.

To configure Java for DataMatcher

The DataMatcher bin directory contains the batch script match.bat and the shell script match. Both files begin with settings for JVM location and memory usage.

To verify DataMatcher installation

  1. On the machine where you installed DataMatcher, open a new command prompt.
  2. Run the command match --version or match -v.
  3. On Windows the return should resemble the following:

    Product version: Build 1.0.x.xx on YYYY-MM-DD HH:MM:SS PM
    Library version: Build 1.0.x.x on YYYY-MM-DD HH:MM:SS PM
    Java version: 1.6.0_11 in <JAVA_HOME>\jre

    DataMatcher is now installed.

To configure run-time logging

Logging is configured in the file InstallDir/datarush-matching-1.0.2/conf/logger.properties.

In this properties file, see “File Handler Logging Settings.”

DataMatcher Documentation

Documentation for this release is provided in DataMatcher User’s Guide and through the samples. The DataMatcher User’s Guide is provided as a PDF file in the installation. Updates to this document may also be found on the DataRush web site.

DataMatcher Samples

Once you have installed DataMatcher, we recommend that you try the working sample applications provided with the installation. For each example, all needed files are in InstallDir/datarush-matching-1.0.2/samples.

DataMatcher includes the following sample applications:

As a convenience, the installation includes the batch script runsamples.bat for Windows and the shell script runsamples for Unix. Running this script in the samples directory executes all samples and generates output in the InstallDir/datarush-matching-1.0.2/samples/results directory.

Technical Support

Online community forums provide general customer support and answers to technical questions posted by developers who build and embed DataRush applications. Users both inside and outside Pervasive participate in these forums.

Telephone support is available during normal business hours US Central Time:


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 README ***