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/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.dependencies.bundles/openanzo-devel-target.target.
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.openanzoanzo.dependencies.bundles/openanzo-devel-target.target.
• 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.

5. 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.