Building Aranea
August 6th, 2007 by Toomas RömerI have been away from Aranea for almost a year. Now that I’m back I need to have my development envrionment set up. As I’m doing it the third time now (my laptop), I thought I’ll share the experience of getting an Aranea checkout built and tested (via sample app). This will differ from setting up an development environment but still will provide some insight.
What do you need?
- JDK at least 1.4
- SVN client
- Apache Ant
First off do a checkout of the project. The trunk branch is named latest in Changelogic - so we’ll be working with the latest and greatest.
svn checkout http://svn.araneaframework.org/repos/aranea/branches/latest aranea
A directory aranea was created by the checkout command. Now you have all the source and build files present but you’re still missing the libraries to compile the source code. Execute:
ant fetch-libs
The script contacts the ibiblio maven repository using the ivy dependency manager and fetches the jar files. This can take from 3 minutes to 18 (my current record), the time depends on what not 
Lets compile the code and the examples:
ant build-all
On my 2Ghz laptop running at 800Mhz it took 52 seconds. find . -iname “*java” -exec cat {} \; | wc -l shows 82653 lines of source files.
So now you have aranea built and ready to see the example applications. As we’ll just check the main application right now, we need to start the bundled database. Open up another shell in the aranea directory. Traverse to examples/main. Run:
ant run-database
This will start the bundled HSQLDB with the sample data. Traverse to examples/main with another shell and execute:
ant run-app
Now you have launched jetty webserver on port 2000 and JPDA dt_socket connection on port 5999. Head over to http://localhost:2000/mainExample/main and you should see a login screen. Click “Bypass login” and you’re in to see the demo app.
Well you’re done now. You have the source, built class files and working samples. See the other samples in the examples directory (they all obey the ant run-app target) and check out what we have in store.
If your fingers are still itching then head off to the issue tracker. Choose a bug. Debug & fix it. Test it. Send a patch our way.
If you had any troubles with the guide just drop a comment about it we’ll try to solve your issues.
PS. If you’re in Barcelona and wondering where to stay the night give Hotel Aranea a try (not affiliated, have not stayed there but what a name ).