Eclipse Setup Howto

Introduction

• Introduction
• Get Eclipse ready
  • Create a new Eclipse project from the Subversion Repository
• Run the build
• Run it!

Get Eclipse ready

1. Subclipse Plugin: The jiplet source code is managed using Subversion. The repository resides in the Sourceforge site. The Subclipse plugin lets you manage revision control operations directly from the Eclipse IDE.  For more details on installing and using Subclipse, visit http://subclipse.tigris.org/ .
   
2. The Calisto Web Tools Project (WTP) Plugin: The jiplet container and other cafesip projects contains J2EE and web components. If you develop software in these areas, the WTP plugin comes in handy. You can find more information on this plugin from http://www.eclipse.org/webtools/main.php . Note that this plugin is optional.
   

Create a new Eclipse project from the Subversion Repository

1. Create a directory called cafesip in a location where you want to store the source code for the jiplet project. This is your development workspace. Create an environment variable called CAFESIP_HOME to point to this location.
   
2. From the Eclipse IDE, select menu options Window->Show View->Other.
   
3. From the Show View dialog box, select the SVN folder and  select SVN Repository. An empty SVN repostory panel will be created and docked into the Eclipse screen.
4. Select the SVN Repository panel, right click on the panel to bring up the popup menu. Select New->Repository Location.
5. From the repository dialog box, enter the URL - http://cafesip.svn.sourceforge.net/svnroot/cafesip .
6. Once the above step is completed, you will see the CafeSip source tree on the panel. First select the jiplet project and choose the sub-directory called "trunk" to select the latest code base. The trunk has the latest software but may not always work and  even may not compile. If you want to create a project that is more stable, under the jiplet project, select the labels/stable sub-directory instead.  If you are working on a branch, you may have to choose a different sub-directory.
   
7. Right-click on the trunk, from the context menu, select the Checkout option. The Eclipse IDE will contact the repository to gather project information. We have included all the Eclipse project files with the jiplet source code so that the project can be setup easily.
   
8. From the Checkout dialog box, select Next. Uncheck the "Use default workspace location". Instead enter the location of the directory where you created the cafesip directory above ($CAFESIP_HOME).  Clck on the Finish button.
   
9. The Eclipse IDE will download the source code and create the project. Depending on your connection speed, the download time will vary. The download is more than 15MB. Once the download is completed, you will see the project on the Package Explorer panel.
   
   
   Top

Run the build

1. From the Package Explorer, open the build.xml file. From the outline, select the target "build".
   
2. Run the target by right-clicking and selecting the Run As->Ant Build menu items.
   
3. When you execute the above targets, you would have built the entire project.
   
4. Alternatively, run the targets explained below to execute individual tasks:

• compile:  Generate XML parser classes and compile the entire source code
• build-standalone: Create the standalone deployment. You must run the compile target before running this target.
  
• build-jboss: Create the jboss deployment. You must run the compile target before running this target.
• build-console: Create the console deployment. You must run the compile target before running this target.
• Select the jiplet project from the project explorer, right-click and select the Refresh menu item so that Eclipse picks up all the generated Java files. Although this may not be necessary, you may also want to build the project using the Project menu. The Eclipse project should not display any errors at this point.
  

Run it!

1. Jiplet container: Select the jiplet project from the Package Explorer. From the Run menu and select Run... menu item. Select Java Application. Right-click and select the "New" menu item. Enter a name and setup the rest of the parameters as follows:
   
   
   Runtime vm parms =-Dorg.apache.commons.logging.Log=org.apache.commons.logging.impl.Log4JLogger -Djiplet.container.home=$CAFESIP_HOME/jiplet -Djiplet.jmx.enabled=true -Djiplet.jmx.rmi.port=9999 
   
   
             Class = org.cafesip.jiplet.standalone.boot.Main
   
   
2. Jiplet console:  Run it as a standard webapp under a servlet container like Tomcat. You'll need to add user/password for logging into the webapp - if you're using Tomcat, add your username/password in Tomcat's conf/tomcat-users.xml file. Read the configuration howto for more details.

1. Setup an environment variable called JBOSS_HOME pointing to the directory where Jboss is installed.
2. Start the Jboss server by executing the following command:
   
   $ cd $JBOSS_HOME/bin
   $ run -c default
3. Run the ant target - deploy-jboss. Note that you must have run the compile, build-jboss and build-console targets.
   

Search this website 

Send questions or comments about this web site to webmaster@cafesip.org.
Copyright © 2005, CafeSip.org.
Licensed under the CafeSip License.
The CafeSip.org projects, web site and web facilities have been sponsored by QUIK Computing

Top of page