• Home
  •  


    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.

    1. 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
    2. 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).
    3. Create a user into sourceForge (if you don't have one) and add yourself into the project. The project leader must approve it.
    4. Then, open the Eclipse and open the CVS perspective. Create a new "Repository Location" using the following configuration:
      1. host: plandora.cvs.sourceforge.net
      2. path: /cvsroot/plandora
      3. user: [your sourceForge user]
      4. connection type: extssh
    5. 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.
    6. After authentication, the subfolders CVSROOT and Plandora must appear. Click over the CVSROOT option using the right button and select "Check Out As..."
    7. 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.
    8. Then, some additional configuration is necessary. Go to Menu Window -> Preference -> Ant -> Runtime -> (tab) properties
      1. Set the property my_source with the path where your source-code is placed in your machine. (ex.: D:\projects\Projeto_Pandora\src\plandora\)
      2. Set the property tomcat_home with the path where is the Tomcat into your machine (ex.: C:\jakarta-tomcat-5.0.27)
      3. go to Menu Project -> Properties Java Build Path -> (tab) Libraries and press the button "Add JARs...". Add all libs of project. (folder lib\ )
    9. 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.
    10. Finally, click over the icon to start the Tomcat (little cat icon)