Quick Start - 0.2-dev

Clone

Clone the apache project by typing:

git clone https://git-wip-us.apache.org/repos/asf/incubator-blur.git
git checkout 0.2-dev

Building

Next build the project by running a maven install from the "src" directory.

Execute:

cd incubator-blur/src
mvn install
# or for a faster install
mvn install -DskipTests

Prerequisites

You will at a minimum need the following:

NOTE: Also you will need to know what the HADOOP_HOME directory and the JAVA_HOME directory.

Installing

Copy the resulting incubator-blur/src/distribution/target/apache-blur-0.2.0-SNAPSHOT-bin.tar.gz to a directory of your choice.

Execute:

tar -xzvf apache-blur-0.2.0-SNAPSHOT-bin.tar.gz

Configuring

Edit:

apache-blur-0.2.0-SNAPSHOT/conf/blur-env.sh

Set JAVA_HOME and HADOOP_HOME to appropriate values.

# JAVA_HOME is required
# export JAVA_HOME=/usr/lib/j2sdk1.6-sun

# HADOOP_HOME is required
# export HADOOP_HOME=/var/hadoop-0.20.2

Starting

To start the daemon run the start-all.sh script.

Execute:

apache-blur-0.2.0-SNAPSHOT/bin/start-all.sh

Shell

To start the shell run blur shell in the bin directory.

Execute:

apache-blur-0.2.0-SNAPSHOT/bin/blur shell localhost:40020

Once in the shell, tables and be created, enabled, disabled, and removed. Type help to get a list of the commands.

Simple Shell Example

The below example creates a table and stores the contents of the table in a local directory of /data/testTableName which will only work if you are running blur in a single instance. Normally if you are running a hadoop cluster this will be a hdfs URI for example hdfs://host:port/blur/tables/testTableName.

blur> create testTableName file:///data/testTableName 1
blur> add testTableName fieldName:testing
blur> search testTableName fieldName:testing
Totalhits 1
--------------------------
fieldName | testing

QuickStart-0.2.dev (last edited 2013-06-07 13:05:53 by AaronMcCurry)