RushRecommender 4.2 - Readme
General Release - October 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 RushRecommender 4.2 Release

These release notes cover the following topics:

System Requirements

Please review these requirements before running RushRecommender.

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 RushRecommender 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 RushRecommender application usage:

Installing and Configuring RushRecommender

This topic covers the following procedures:

To install RushRecommender

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

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

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-recommender-4.2.0.

To add RushRecommender to the Path environment variable

Required for Windows, optional for Unix systems.

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

To configure Java for RushRecommender

The RushRecommender bin directory contains multiple Windows batch and Unix shell launcher scripts. Each file begins with settings for JVM location and memory usage.

To verify RushRecommender installation

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

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

    RushRecommender is now installed.

To configure run-time logging

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

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

RushRecommender Documentation

Documentation for this release is provided in RushRecommender User’s Guide and through the samples. The RushRecommender 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.

RushRecommender Samples

Once you have installed RushRecommender, we recommend that you try the working sample applications provided with the installation. For each example, all needed files are in InstallDir/datarush-recommender-4.2.0/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 in the InstallDir/datarush-recommender-4.2.0/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 ***