Dev: Building

Building from source is very easy (although it may take a while when doing it for the first time). The requirements are Java (version 1.5 or higher), Subversion, Git and Maven.

First, check out and build the latest OpenXRI:

svn co https://openxri.svn.sourceforge.net/svnroot/openxri/openxri4j/trunk openxri
cd openxri
mvn clean install
cd ..

Now check out the Project Danube source tree from our Github repository at http://github.com/peacekeeper/personaldatastore/:

git clone http://github.com/peacekeeper/personaldatastore.git personaldatastore

Building the parent Maven module pdsproject will build all components of Project Danube:

cd personaldatastore
cd pdsproject
mvn clean install
cd ..

Once your build succeeds, there are several ways of getting a Personal Data Store up and running, e.g. you may want to run a PDS just for yourself, or for your users, etc.

The easiest way to get started is to run the pds-core component with the default pds-core-single PDS instance factory, which will simply run a single PDS for yourself, based on configuration settings:

cd pds.core
mvn jetty:run

Your PDS should now be running at localhost:8080. To check if it is working, you can access http://localhost:8080/ in your browser. Or you can execute the following curl commands to send a $get XDI message for retrieving the $ context descriptor, or the I-Number the PDS is associated with:

curl http://localhost:8080/ -H "Accept: application/x3+json" -H "Content-Type: text/xdi+x3" -d "[=sender[\$get[[\$]]]]"
curl http://localhost:8080/ -H "Accept: application/x3+json" -H "Content-Type: text/xdi+x3" -d "[=sender[\$get[[=yourname]]]]"

Another thing you can try is run the PDS Web interface (pds-web):

cd ..
cd pds.web
mvn jetty:run

For more information, see the pages of individual components of PDS Project!

I want to update to the latest version!

To update your copy of the code to the most recent version, do this:

cd personaldatastore
git pull
cd pdsproject
mvn clean install

I am getting build errors!

If you get build errors, this may be due to older versions of either OpenXRI or XDI4j. In this case, try updating OpenXRI, and try deleting XDI4j from your Maven repository:

rm -rf ~/.m2/repository/org/eclipse/higgins/xdi4j
cd openxri
svn update

After this, build both OpenXRI and Project Danube again according to instructions above.

I am still getting build errors!

Post to our Google Group, and we will help you out!