Developer Setup

Developer Setup

Install and Configure Eclipse

• Download Eclipse from http://eclipse.org/downloads/. We recommend getting the Eclipse IDE for Java EE Developers version.
• Launch Eclipse. The first time it runs, it will prompt you to choose a workspace location.
• Install Git support
  • In Eclipse, select Help->Install New Software....
  • In the Work with dropdown, select the Helios link.
  • In the text box below the dropdown, enter "git" to filter the available software.
  • Click on the checkbox next to Eclipse EGit.
  • Click on Next> and follow the prompts to install the component.

Pull down source

Follow this tutorial to retrieve the Maqetta source from GitHub into your Eclipse workspace. Just make sure to plugin the correct repository URL (git@github.com:maqetta/maqetta.git) when required.

Set up and launch the Maqetta server

1. Create an OSGi Framework launch configuration
   • In Project Explorer, select 'davinci.core'.
   • Using the context menu, Run As > Run Configurations... > OSGi Framework
2. In the Bundles tab, de-select all the bundles ("Deselect All").
3. Select the following bundles manually:
   • davinci.core
   • davinci.dojo_1_5
   • davinci.html
   • org.eclipse.equinox.http.jetty
     • This one is much further down in the list of bundles. You can filter the list by typing "jetty" into the text box above the Bundles list.
   • Recommended for typical build scenarios, but technically optional:
     • davinci.jqueryui_1_8
     • davinci.product
     • davinci.review
     • davinci.yui_2_6_0
   • If above bundles are not visible in the bundles tab within the "run configurations" window, you might have to import each project (davinci.* and org.commons.* projects) manually, adding each project to the workspace.
4. Click the "Add Required Bundles" button (important).
5. In the "VM Arguments" pane, add "-Dorg.eclipse.equinox.http.jetty.context.path=/maqetta"
6. Optionally (highly recommended) use a port other than 80 (e.g., 55555):
   • Select "(x)= Arguments" tab
   • In the "VM Arguments" pane, add "-Dorg.eclipse.equinox.http.jetty.http.port=8080" (or 55555)
     • Note: 8080 is a fairly common port number. To minimize conflict, pick a port number between 50000 and 59999, such as 55555.
7. Optionally set the user files directory (current dir will be used if not set) to tell Maqetta where to write users' created applications:
   • Select the "(x)= Arguments" tab
   • In the "VM Arguments" pane, add "-Dmaqetta.baseDirectory=/path/into/which/maqetta/writes/its/output/files"
8. In order to run Maqetta in local/single-user mode (i.e., without login prompts and where local user can access entire local file system):
   • Select "(x)= Arguments" tab
   • In the "VM Arguments" pane, add "-Dmaqetta.localInstall=true"
9. Run the launch configuration:
   • In the Eclipse console, you should see an "osgi>" prompt. At that point, the Eclipse server is running and browsers can navigate to this server (see instructions in next section)
   • If you need to terminate the server, click on the red square in the Eclipse console view.

Load Maqetta in a browser

In a web browser, load http://localhost/maqetta (or http://localhost:55555/maqetta or whichever port you selected above).