Integrating Muradora Project in MyEclipse

We develop Muradora using MyEclipse. This allows us to have access to the full MyEclipse debugging facility.

Prerequisites

• Eclipse is configured with MyEclipse plugin (a commercial license is needed for > 30 day trial).
• Fedora is correctly setup (this can be on a remote host) along with all the other dependencies for Muradora. These include gsearch, melcoe-pep, and melcoe-pdp packages.
• Tomcat 5 or Tomcat 6 is installed on your machine. You also need to make sure that the XForms Orbeon web application is also installed on this Tomcat. Note you need to rename the orbeon.war to ops.war before installing it on your Tomcat webapps.

Instructions

• Configure Tomcat to allow Muradora webapps and Orbeon to share the same application contexts. Edit $TOMCAT/conf/server.xml and make sure it contains the following

        <Host name="localhost"  appBase="webapps"
              unpackWARs="true" autoDeploy="true"
              xmlValidation="false" xmlNamespaceAware="false">
          <Context path="/muradora" docBase="muradora" debug="1" crossContext="true"/>
          <Context path="/ops" docBase="ops" debug="1" crossContext="true"/>
  

• Download the latest Muradora source and unpack it to a temporary directory, eg. $HOME/download/muradora

• In Eclipse, go to MyEclipse menu and select Preferences. In the new window, navigate to Servers/Tomcat, select your version of Tomcat, and provide the settings to where your Tomcat resides. Note: On Linux/Unix systems, you should make sure that the Tomcat directory is writable by the user running Eclipse. Don't forget to enable this Tomcat server.

• In Eclipse, switch to MyEclipse Java Enterprise Perspective and create a new "Web Project" called "muradora". MAke sure you enable the JSTL 1.1 support and J2EE spec to 1.4.

• Right-click over the new muradora Project and select import. Select import from the File Systems and navigate to the top level of the unpacked muradora directory

• Right-click over the "muradora Project" and select "Properties". Under Java Build Path, and under the Source tab, add a new Folder and select the "generated" directory.

• Under the "Order and Export" Tab, select all the libraries for export

• In the main Eclipse Workbench window, click on the "Deploy MyEclipse J2EE Project To Server" Button

• In the pop-up window, "add" a new deployment for Muradora. Select your Tomcat server in the drop-down list and click Finish. Note: when you makes changes to muradora that cannot be automatically detected by the running Tomcat, you will need to re-deploy muradora by clicking on the Deploy button above and select the re-deploy option

• Navigate to the muradora.properties file and make changes to it to reflect the server settings for where you installed the Fedora repository. If you use the DAR+ASM module, you will also need to make changes to the file dar_config.xml to reflect where the ASM service is located.

• Start up Tomcat to run Muradora

• You can now place a breakpoint in any Muradora java code (including java code in jsp pages) and MyEclipse will automatically bring you to the debugging view when that code is reached. In the debugging view, you can inspect the current value of variables as well as step into/over code sections.

Back to Developer's Guide