How to Check-out the Plandora Project
The Plandora team appreciates when more developers join to project to contribute and improve the knowledge. The steps bellow teaches you to check-out the project from sourceForge server into your machine.
This tutorial was written assuming that your development environment contains: Windows platform, Eclipse 3.0 or higher and Tomcat 5.0.27 or higher.
This tutorial was written assuming that your development environment contains: Windows platform, Eclipse 3.0 or higher and Tomcat 5.0.27 or higher.
- Keep the Eclipse closed and go to the site: http://www.eclipsetotale.com/tomcatPlugin.html#A3 and download the Tomcat plug-in. This component will create a bridge between Eclipse (Plandora source-code) and Tomcat (Plandora deploy). So, it is very important when you need to make debug step-by-step
- After install the plug-in, you should setup it. Open the Eclipse and go to: Window - Preference - Tomcat. The only thing to do is to adjust the field that contains the reference to Tomcat home folder in your machine. Besides, in the Eclipse screen menu 3 icons must appear (3 "little cats" icons used to Start, Stop and Restart the Tomcat).
- Create a user into sourceForge (if you don't have one) and add yourself into the project. The project leader must approve it.
- Then, open the Eclipse and open the CVS perspective. Create a new "Repository Location" using the following configuration:
- host: plandora.cvs.sourceforge.net
- path: /cvsroot/plandora
- user: [your sourceForge user]
- connection type: extssh
- Click over the Repository Location that you have just created, and the option HEAD, Branches, etc must appear. Then, make a double click over HEAD, and Eclipse must display the authentication popup.
- After authentication, the subfolders CVSROOT and Plandora must appear. Click over the CVSROOT option using the right button and select "Check Out As..."
- The process of download depends of your internet connection, but is made only once. After all, the Plandora must become a project into your Eclipse.
- Then, some additional configuration is necessary. Go to Menu Window -> Preference -> Ant -> Runtime -> (tab) properties
- Set the property my_source with the path where your source-code is placed in your machine. (ex.: D:\projects\Projeto_Pandora\src\plandora\)
- Set the property tomcat_home with the path where is the Tomcat into your machine (ex.: C:\jakarta-tomcat-5.0.27)
- go to Menu Project -> Properties Java Build Path -> (tab) Libraries and press the button "Add JARs...". Add all libs of project. (folder lib\ )
- To compile the source-code, click with right button over the build.xml file and select "Run" - "Ant Build...". The project must compile without errors and copy the WAR file to the path of tomcat that you specified previously.
- Finally, click over the icon to start the Tomcat (little cat icon)
