Differences between revisions 8 and 9
Revision 8 as of 2013-01-14 02:29:20
Size: 2182
Editor: AaronMcCurry
Comment:
Revision 9 as of 2013-06-07 13:05:53
Size: 2219
Editor: AaronMcCurry
Comment: I want to create a new QuickStart page for the new release of Blur, this page is still valid for 0.2-dev
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
## page was renamed from QuickStart

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:

  • ZooKeeper installed and running.

  • Hadoop installed
  • Java installed

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)