OpenRDS - Java clustering framework Files

/**
 * OpenRDS - Open Requisition Distribution System
 * Copyright (c) 2006 Rodrigo Zechin Rosauro
 * 
 * This software program is free software; you can redistribute it and/or modify it under the
 * terms of the GNU Lesser General Public License as published by the Free Software Foundation;
 * either version 2.1 of the License, or (at your option) any later version.
 * 
 * This library is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY;
 * without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
 * See the GNU Lesser General Public License for more details.
 */
 
OpenRDS 0.4 - July 27, 2006
readme.txt  - July 27, 2006

Package files' description:
- OpenRDS.jar:       JAR compiled without debug information.
- OpenRDS_debug.jar: JAR compiled with debug information.
- OpenRDS-src.zip:   Source-code for this version.
- OpenRDS.dll:       Windows JNI for getting processor speed and memory amount.
- changelog.txt:     Change-log for this version.
- readme.txt:        This file :)

This package contains OpenRDS JAR file and windows DLL for getting processor speed and memory amount.

USEFUL COMMANDS TO RUN:
-----------------------
(Starts a generic main node)
java -cp OpenRDS.jar net.sf.openrds.examples.GenericMainNode

(Starts a generic process node and connects it to a main node on the local machine)
java -cp OpenRDS.jar net.sf.openrds.examples.GenericProcessNode 127.0.0.1

(Runs a hello-world application to test connection with a main node on the local machine)
java -cp OpenRDS.jar net.sf.openrds.examples.HelloWorld 127.0.0.1

(Closes ALL started process nodes - By closing their JVM)
java -cp OpenRDS.jar net.sf.openrds.examples.CloseAll 127.0.0.1

IMPORTANT NOTE:
---------------
Since the implementation to detect processor speed and memory amount is only available
for Windows at the moment, you have to set the system properties "openrds.memory.amount"
and "openrds.clock.amount" in order to use OpenRDS in other operating systems. See bellow
all available system properties.
To test system-properties from command-line, run:
java -Dopenrds.memory.amount=512 -Dopenrds.clock.amount=2400 -cp OpenRDS.jar <main-class>

AVAILABLE SYSTEM-PROPERTIES:
----------------------------
* openrds.base.ip:
	 This property can be used on machines with more than one network adaptor
	 to set witch one to use.
	 Eg: Suppose you have one adaptor with ip "200.206.xxx.xxx" (external ip)
	 and another one with ip "192.168.xxx.xxx" (LAN ip).
	 You can set this property to "192." to tell the
	 distributed system to use the network adaptor connected on the LAN.
* openrds.memory.amount:
	 This property can be used to set the memory amount of all nodes started on
	 this JVM.
	 If this property is not set when calling NodeFactory.startProcessNode(),
	 it will use a JNI library to determine the physical memory of this machine.
* openrds.clock.amount:
	 This property can be used to set the clock amount (MHz) of all nodes started on
	 this JVM.
	 If this property is not set when calling NodeFactory.startProcessNode(),
	 it will use a JNI library to determine the clock in MHz.
* openrds.verification.interval:
	 This property can be used to override the default connection verification interval
	 (in milliseconds) between a process node and the main node.
	 This verification is used to detect disconnections. Everytime a disconnection is
	 detected, the node will keep trying to restabilish it continuously with a shorter
	 interval. (See RECONNECTION_INTERVAL).
	 The default interval is 30000.
* openrds.reconnection.interval:
	 This property can be used to override the default interval for reconnection
	 tentatives.
	 A process node enters in a "disconnected" mode after detecting any communication
	 error with the main node, after that it will keep trying to restabilish the connection
	 continuously at every interval.
	 The default reconnection interval is 5000.