Building and running the freebusy aggregator
Building the freebusy aggregator is the same process as building any customized version of bedework. The instructions for building bedework are at http://www.bedework.org/downloads/dev/docs/BedeworkDeploymentManual.pdf. We will try to provide an abbreviated set of instructions here as building the demonstration freebusy aggregator does not requirte much customization.
Getting the source
All the required code for the demo version is part of the bedework distribution. Go to the main bedework site at http://bedework.org and follow the download links. As the freebusy aggregator is under development, follow the instructions for downloading the development binary version and updating from the svn repository.
Unzip the quickstart, which will create a directory quickstart-x.y where "x.y" is the version. We shall refere to this fully specified directory as QUICKSTART. Next cd into that directory, delete the directory "bedework" and checkout the latest source:
svn checkout http://svn.bedework.org/bedework/trunk bedework
The bedework build and deployment process is determined by two files, a properties file and an xml run-time configuration file. In addition a build properties file may be specified which sets override values for properties.
The required property files to build a demonstration aggreagtor are at QUICKSTART/bedework/config/configs/freebusy.
Either copy the build.properties file in the above directory to home-dir/bedework.build.properties or invoke the quickstart ant process with the parameter
cp QUICKSTART/bedework/config/configs/freebusy/build.properties $HOME/bedework.build.properties cd QUICKSTART ./ant deploy.debug
cd QUICKSTART ./ant -Dorg.bedework.user.build.properties=QUICKSTART/bedework/config/configs/freebusy/build.properties deploy.debug
This will build all the components required for the demonstration of the freebusy aggregator and deploy them in the tomcat server contained as part of the quickstart distribution.
To start the database in the quickstart, open a new window and
cd QUICKSTART ./ant hsqldb
We use some simple database code to maintain the user information. For the demonstration system we use the quickstart hsql database.
A useful client for interacting with the database is Aqua Data Studio found at http://www.aquafold.com/downloads.html.
Using that or any other client add the following tables:
create table fb_users (fbaccount longvarchar, fbauth_user longvarchar, fbauth_pw longvarchar, fbhost longvarchar, fbport integer, fbsecure char(1), fburl longvarchar, fbdepth longvarchar, primary key(fbaccount))
Users can be added through the aggregators registration page or by inserting them directly into the db with sql of the form:
insert into fb_users (fbaccount, fbauth_user, fbauth_pw, fbhost,fbport,fbsecure,fburl,fbdepth) values ( 'firstname.lastname@example.org', 'douglm', 'a-password', 'localhost', 8080, 'F', '/ucaldav/user/douglm', '0'); insert into fb_users (fbaccount, fbauth_user, fbauth_pw, fbhost,fbport,fbsecure,fburl,fbdepth) values ( 'email@example.com', 'johnsa', 'a-password', 'localhost', 8080, 'F', '/ucaldav/user/johnsa', '0');
Running the aggregator
To run the aggregator start tomcat
cd QUICKSTART ./ant tomcatstart
This starts the tomcat server which runs the freebusy aggregator application as well as the bedework calendar server and the CalDAV proxies. Then in your browser go to http://localhost:8080/fbagg/