Getting Started

This topic will give you some initial information about dRS and will help to get your environment ready to work with dRS.

Download Contents 

 

Java Platform 

The distribution comes as a zip archive. The contents need to be extracted to any folder before you start to use the dRS.

You can find the offline version of this documentation in /doc/reference folder.

The API documentation in located in /doc/api folder. 

 

db4o and dRS online documentation resources are located in the reference documentation.



Requirements 

Java version

dRS is dependent on the JDK 5 version of db4o object database. You will also need a corresponding db4o version (compatible db4o and dRS have the same version number).
To use the Hibernate Replication functionality, the Hibernate core version 3.1 files are required. These files and their dependencies have been included in the /lib folder for your convenience. If you require more complicated Hibernate mapping configurations, you may wish to download the full Hibernate documentation from the Hibernate project website.
To run the provided build scripts dRS requires Apache Ant 1.6 or later.

.NET version 

dRS requires Microsoft .NET framework version 2.0 to work. A compatible version of db4o database should be used (compatible db4o and dRS have the same version number).

To work with the source code and examples you will need Microsoft Visual Studio 2005.

Installation 

Java Platform Installation

dRS functionality is delivered in a single jar file. If you add dRS.jar to your CLASSPATH, dRS is installed. For using db4o replication to another database (RDBMS) you will also need hibernate library, which is included in the /lib folder in the distribution.

In case you work with an integrated development environment like Eclipse  you can copy the dRS jar to a /lib/ folder under your project and add dRS to your project as a library.

Here is how to add the dRS library to an Eclipse project

  • create a folder named "lib" under your project directory, if it doesn't exist yet
  • copy dRS.jar to this folder
  • Right-click on your project in the Package Explorer and choose "refresh"
  • Right-click on your project in the Package Explorer again and choose "properties"
  • select "Java Build Path" in the treeview on the left
  • select the "Libraries" tabpage.
  • click "Add Jar"
  • the "lib" folder should appear below your project
  • choose dRS.jar in this folder
  • hit OK twice 
You might need to repeat the same for hibernate3.jar