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

Building

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

-Dorg.bedework.user.build.properties=QUICKSTART/bedework/config/configs/freebusy/build.properties

For example:

cp QUICKSTART/bedework/config/configs/freebusy/build.properties $HOME/bedework.build.properties
cd QUICKSTART
./ant deploy.debug

or

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.

The database

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 (
                               'douglm@rpi.edu',
                               '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 (
                               'johnsa@rpi.edu',
                               '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/

>>> The Aggregator User Interface