Skip to content
Ken Gilmer edited this page Nov 17, 2011 · 2 revisions

Connector Build

Overview

BUGSwarm-Connector Connector is a BUG application designed to showcase the BUGswarm middleware system. The connector uses a combination of ReST web services and XMPP messages to publish information, respond to peer requests, and expose device and status information online.

Connector is designed to be usable by any general purpose Swarm peer but is optimized for the Bug Labs Swarm Management Application (Manager). This web app communicates with connector via XMPP. Any data that is registered or sent to Swarm server by default is meant for consumption by the Manager.

Dependencies

Connector relies on the following libraries and frameworks:

  • OSGi R4 : For BUG services, device access, and web configuration interface.
  • Jackson : For JSON handling
  • Smack/Smackx : For XMPP protocol support
  • Touge : for ReST client

Build

Connector bundles and source dependencies are all built via the shell script /com.buglabs.bug.swarm.connector/build-connector.sh.

The script has set of parameters that are used to enable testing and determine where the built artifacts are placed.

  • WORKSPACE : The root of the build, defaults to the current local directory
  • BUILD_BRANCH : The branch that should be used with the source dependencies in the bug-osgi repo.
  • REPORT_DIR : The directory where junit report files should go.
  • TEST_HOST : A set of configuration elements used in test automation.

An example build, at which /tmp/dist would contain the build artifacts.

cd /tmp
git clone git://github.com/buglabs/bugswarm-connector.git
cd bugswarm-connector
BUILD_BRANCH=master com.buglabs.bug.swarm.connector/build-connector.sh