File	Date	Author	Commit
src	2013-01-22	pholas	[9ed54e] add jetty-webdefault.xml
.gitattributes	2012-11-08	Jack Liu	[1601fb] add template project files.
.gitignore	2013-01-08	Jack Liu	[e85d21] remote .project from git
README.txt	2013-01-22	pholas	[6dee45] change readme
pom.xml	2013-01-22	pholas	[572c47] change jetty web config path to project's class...

Read Me

IBM Distributed System Validator
=========================================
This project consists of three sub projects as described below

* dsvalid-center
* dsvalid-agent
* dsvalid-core

[dsvalid-center]
It's a web application and the main purpose is to provide end user interface. It is ready to run as a web application. 
The pom.xml file is pre-defined with Hibernate as a persistence model and Struts 2 as the web framework.

[dsvalid-agent]
It's a real validation running engine, it will be responsible to handle all validation execution and report the status of each validation. 
It can be deployed on the same server with dsvalid-center, or any other machine in the target environment. Under some circumstances,
multiple instances of this agent are required. 

For example, direct communication is not possible from the dsvalid-center server to the target machine in a target environment. 
This could be a firewall restriction. If that's the case, we have to install dsvalid-agent in one of machines in the target environment, 
and trigger the validation from that machine. It's also a web application project.


[dsvalid-core]
This is a common shared project which will hold all settings or configuration, and also utilities that might be used among the above two projects. 
It will be packaged into a jar file.



Prerequisites
-----------------------

1. Download all prerequisite software
    * [MySQL 5.x database](http://dev.mysql.com/downloads/installer/5.5.html)
    * [Java 1.6](http://www.oracle.com/technetwork/java/javasebusiness/downloads/java-archive-downloads-javase6-419409.html)
    * [Maven 2.2.1](http://maven.apache.org/download.html)
    * [Maven repository files](http://www.rayfile.com/zh-cn/files/e618917a-2bb3-11e2-bbc7-0015c55db73d/)
    * [Git for Windows 1.7.11](http://code.google.com/p/msysgit/downloads/list?q=full+installer+official+git)


2. Install MySQL 5.x database, and then change "root" user's password to "passw0rd"

3. Install Java 1.6 into any directory e.g. C:\ide\jdk1.6.0_27

4. Extract Maven 2.2.1 to any directory e.g. C:\ide\apache-maven-2.2.1. 

5. Set environment variables
    * Set a new environment variable JAVA_HOME and the value is C:\ide\jdk1.6.0_27 in this example . 
    * Update PATH environment variable to include C:\ide\jdk1.6.0_27\bin and C:\ide\apache-maven-2.2.1\bin.

6. Install Git on Windows



dsvalid-core
-----------------------

1. Clone "dsvalid-core" project by running the command below

git clone ssh://bjliujie@git.code.sf.net/p/dsvalid/core dsvalid-core

2. Build "dsvalid-core" and install it in the Maven local repository by running the command below

mvn clean install

3. Under the project directory "dsvalid-core", Run the command below to generate/refresh Eclipse Project configuration file

mvn eclipse:eclipse

4. Import the project into eclipse



dsvalid-center
------------------------

1. Clone "dsvalid-center" project by running the command below

git clone ssh://bjliujie@git.code.sf.net/p/dsvalid/mycode dsvalid-center

2. Under the project directory "dsvalid-center", Run the command below to generate/refresh Eclipse Project configuration file
mvn eclipse:eclipse

3. Change jdbc properties at the bottom of pom.xml and make sure mysql root account and password match.

4. Run "mvn jetty:run" and view the application at http://localhost:8080



dsvalid-agent
------------------------
1. Clone "dsvalid-agent" project by running the command below

git clone ssh://bjliujie@git.code.sf.net/p/dsvalid/agent dsvalid-agent

2. Under the project directory "dsvalid-agent", Run the command below to generate/refresh Eclipse Project configuration file
mvn eclipse:eclipse

3. Run "mvn jetty:run" and view the application at http://localhost:9090