featurebase/README.md
Ben Johnson 1d1cb134ec godep
This commit moves dependency management to use godep and the
new experimental vendoring support in Go 1.5.

NOTE: You must set `GO15VENDOREXPERIMENT` in your bash environment
for vendoring to work properly! See the updated `README` for details.
2015-09-03 13:52:45 -06:00

1.4 KiB

pilosa

Pilosa is a bitmap index database.

Getting Started

Pilosa uses the new Go 1.5 vendoring experiment. To enable this, you'll need to export an environment variable in your .profile:

export GO15VENDOREXPERIMENT=1

Then you can download the source by running go get:

$ go get github.com/umbel/pilosa

Now you can install the pilosa binary:

$ go install github.com/umbel/pilosa/...

Pilosa requires that etcd is running locally for coordinating the cluster:

# In another terminal window
$ etcd

Now run pilosa with the default configuration:

pilosa

This setup assumes that cassandra and etcd are running locally and that cassandra keyspace pilosa has been setup as describe in the file index/storage_cass.go.

If you don't want backend storage you can comment out storage_backend in the config file and it will just operate out of memory.

Development

Updating dependencies

To update dependencies, you'll need to install godep:

$ go get -u github.com/tools/godep

Then save the dependencies in your project:

$ godep save ./...

Make sure you have set the GO15VENDOREXPERIMENT environment variable!

Running tests

Because of a bug in Go 1.5, you'll need to run make test to exclude tests the the vendor/ directory.