Notes on setting up Open Anzo from source

These instructions are for building the projects using Eclipse. Since the OpenAnzo build utilizes a target platform specific to OpenAnzo, we recommend using a clean workspace specifically for OpenAnzo development. The system can also be built in the command line using Maven.

OpenAnzo must be built using Java 5 or greater.

Check out the code

1. From  http://svn.openanzo.org/svn/openanzo/ checkout everything in:(WARNING: explicitly select all of the projects rather than just selecting 'trunk' and checking out. )

openanzo/trunk/*
dependencies/trunk/*

NOTE: Once the code is done checking out, you will see build errors. You aren't done yet. Continue on to solve those build errors.

Setup the Target Platform

  1. Go to the Window -> Preferences menu.
  2. Under Plug-in Development -> Target Platform, in the Pre-defined Targets section, click on the Browse... button. Select org.openanzo.targetplatform/openanzo-devel-target.target and click Reload.
  3. Click the Load Target button.

At this point, things should build with zero errors. If you see errors. Try doing a Project -> Clean....

Check for Warnings

If you see any errors or warnings in the code, then you may have something incorrectly setup. Here are some things to try in that case.

  • Do a Project -> Clean....
  • Did you remember to load the target platform? Under Plug-in Development -> Target Platform, in the Pre-defined Targets section, click on the Browse... button. Select org.openanzo.targetplatform/openanzo-devel-target.target and click Reload.
  • Did you set all of the required Eclipse settings described above? Especially those regarding ignoring or not ignoring warnings? Check your Eclipse config according to the instructions above.
  • Did you check out all of the projects needed? Did you follow the instructions above correctly? If so, perhaps the instructions above aren't complete, if so, please update them once you find the issue.

Running OpenAnzo

  1. Go to the Run -> Run Configurations... menu.
  2. Under the OSGi Framework tree, choose OpenAnzo OSGI.
  3. Click Run
  4. In the console window you will see an osgi> prompt. There are 2 OpenAnzo commands to check the status of components:
  • ds <waiting|ready|all> will provide the status of OpenAnzo services that depend on each other. ds waiting will show what services haven't started because they are dependent on another unavailable service or the service hasn't been configured.
  • datasources This command will show all the registered datasources that the system knows about.
  1. You can also try going to  http://localhost:8080/status/ to see if there were any problems starting bundles. This requires the sysadmin/123 credentials.