DataRush 4.0 - Readme
RC1 Release - August 2008

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 may have later updates. Check for a newer version under the Download tab at 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 DataRush RC1 Release

Welcome to the first release candidate for DataRush 4.0.

These release notes cover the following topics:

System Requirements

Please review these requirements before running DataRush.

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
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
Red Hat Enterprise Linux
4
x86
Sun Solaris Enterprise
10
UltraSPARC T2
x86

Performance

Minimum satisfactory performance requires the following:

Java

Run DataRush on the latest versions of the following Java releases:

A JDK is required rather than a JRE.

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 DataRush application development:

Installing and Configuring DataRush

This topic covers the following procedures:

To install DataRush

Allow at least 25 MB free disk space for DataRush installation.

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

  4. Unix only. Run the following commands to reset permissions:
  5. chmod a+x InstallDir/datarush-4.0.0/samples/runsamples

    chmod a+x InstallDir/datarush-4.0.0/bin/dr

To set the license file

  1. Obtain a license file from Pervasive Software.
  2. A trial license can be found under the Download tab at the web site.

  3. Copy the license file to InstallDir/datarush-4.0.0.

To add DataRush to the Path environment variable

Required for Windows, optional for Unix systems.

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

To configure Java for DataRush

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

To verify DataRush installation

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

    Product version: 4.0.0.RC1
    Java version: 1.6.0_07 in C:\Program Files\Java\jdk1.6.0_07\jre

    DataRush is now installed.

To configure run-time logging

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

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

DataRush Documentation

Documentation for this release is provided as command line help, Javadoc, and comments in the property files for the samples.

DataRush Samples

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

DataRush includes the following sample applications:

The samples directory also includes Javadoc for the samples.

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 and logging files.

Known Issues

The following items describe known issues in the current release.

Sorting Dataflows with Many Columns

Issue: In sorting dataflows with hundreds of columns, the current sort implementation may encounter resource problems involving memory, number of threads, and number of open files.

Workaround: An RC1 patch will be made available for download after the release.

Incorrect Linking in Serialized Applications

Issue: Use of flows created using RoundRobinPartitioner, RoundRobinUnpartitioner, TruncatedFlows, or AppendableFlows leads to incorrect linking information in the serialized application and in the App Structure tab in JConsole. Statistics may also reflect unobvious combinations of internal ports not visible to the user.

Workaround: None.

Trimming of Dynamic Subgraphs

Issue: To save memory usage, dynamic subgraphs are trimmed from the serialized application along with their statistics.

Workaround: None.

Technical Support

Support is provided in the online developer forums.


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