Home

Welcome to your wiki!

This is the default page, edit it as you see fit. To add a new page simply reference it within brackets, e.g.: [SamplePage].

The wiki uses Markdown syntax.

Project Admins:

• Jack Liu

[Jack Liu]

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
   • Java 1.6
   • Maven 2.2.1
   • Maven repository files
   • Git for Windows 1.7.11

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

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

mvn clean install

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

mvn eclipse:eclipse

1. 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

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

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

3. 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

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

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