distributed-bitmap-engine

DBIE is a distributed application supporting bitmap index storage and querying.

Getting started

Be sure to check out the submodules:

git clone --recurse-submodules https://github.com/Puget-Sound-Bitmaps/distributed-bitmap-engine.git

Docker support

Docker image
To run the application/experiments yourself, you can use Docker containers. To build the images, run:

docker-compose build

The commands to enter a terminal as either a master or slave are, respectively:

docker run -it dbie_master bash
docker run -it dbie_slave bash

Running the system

It's important to note that running these commands has the side effect of generating a SLAVELIST file which contains the IP addresses of all the slaves. You'll need to modify these scripts or manually generate these lists if you're using different IP addresses than those of Docker containers in the default bridge network. Make sure to spawn the master container first, followed by the slaves.

Master node

If you're using docker:

./tpc-test.sh n

where n is the number of nodes.

Slave node

./start-slave.sh

Paper

The corresponding capstone paper for this project can be found here. You can render the paper yourself by running latexmk in report; doing so requires pdfTeX.

Authors

Distributed System

• Sam Burdick
• Jahrme Risner

Bitmap Engine

• Alexia Ingerson
• David Chiu
• Alexander Harris
• Patrick Ryan
• Ian White
• Sam Burdick
• Jahrme Risner

Acknowledgements

These projects (Bitmap Engine and DBIE) have been advised by Professor David Chiu at the University of Puget Sound.