Developer's guide

Quick start

WiTrack Team

4/29/2007

Requirements

To start you need to download:

·Java Runtime Environment (JRE) (http://www.eclipse.org/downloads/moreinfo/jre.php)

·Eclipse Classic (http://www.eclipse.org/downloads/)

·HTTP and MySQL server (For instance XAMPP)( http://www.apachefriends.org/en/xampp.html)

·The script “witrack_create_db.sql” to create the MySQL database

Set up your HTTP and MySQL server (XAMPP)

Install XAMPP, then launch a browser and go to localhost. Open phpMyAdmin.

Create a new Database called witrack.

Gives right to a new user called witrackserver and password: wipass
(if you want to change the connection parameters you will have the opportunity to edit the source file 'Server/config.ini' later)

Finally import the script “witrack_create_db.sql”.

Install the JRE

Install the JRE, no tricks here…

Set up your integrated development environment (Eclipse)

Extract the eclipse archive wherever you want and launch Eclipse.

Subclipse

Now we need to install Subclipse, an Eclipse Team Provider plug-in providing support for Subversion within the Eclipse IDE.

Begin the installation from the Eclipse Help menu item.

Step 2:

This screenshot show the screen as it initially comes up. In this case you will need to change the radio button to indicate that this is a new install.

Step 3:

This screen will vary depending on the features you have already installed. You want to click on the New Remote Site button. If you are behind a proxy and the Eclipse install mechanism does not work, then you can download a zipped version of the update site and then click the New Local Site button instead.

Step 4:

This screen shows the New Remote Site dialog box with the correct information to install Subclipse

Name: Subclipse 1.2.x (Eclipse 3.2+)

URL:http://subclipse.tigris.org/update_1.2.x

Name: Subclipse 1.0.x (Eclipse 3.0/3.1)

URL:http://subclipse.tigris.org/update_1.0.x

Step 5:

When you first come back to this screen, the site you added will NOT be selected. Be sure to select it before clicking Next.

Step 6:

This next screen shows all of the features that are available for install.

Step 7:

Click the button to accept the license agreement.

Step 8:

Confirm the install location

Step 9:

Then you will probably get a warning.

Step 10:

Just a screenshot of the in-process installation.

Step 11:

Eclipse needs to be restarted after installing Subclipse.

Checkout the project

After restarting Eclipse, open the Subclipse Repository perspective where you can define your repositories.

Step 2:

Right click on the SVN repository panel and click on New->Repository location…

Put the URL: https://witrack.svn.sourceforge.net/svnroot/witrack

Click finish.

Step 3:

Expand the repository location and right click on the project you want to work on. Then select Checkout... For this example we are going to retrieve the server and the manager.

Click Finish.

Step 4:

Now let's run the application. Be sure the apache and MySQL server are running.

Start the server: Right click on the server. Select Run as/Java Application (Alt+Shift+X, J).
Then select core - net.witrack.net

Start the manager: Right click on the manager. Select Run as/Eclipse Application (Alt+Shift+X, E).

user: User1
password: 0123456789
Server:localhost 9001

Set up your integrated development environment (Microsoft Visual Studio 2005)

visual studio 2005