1. Accumulo, Nutch, and Gora

    In this post I will outline the steps necessary to use Accumulo and Gora to store content retrieved by Nutch.

    Apache Accumulo

    Accumulo Logo

    For those of you unfamiliar with Accumulo, it is an incubating Apache project and …

    "Accumulo is a sorted, distributed key/value store based on Google’s BigTable design. It is built on top of Apache HadoopZookeeper, and Thrift. It features a few novel improvements on the BigTable design in the form of cell-level access labels and a server-side programming mechanism that can modify key/value pairs at various points in the data management process.”

    Accumulo is conceptually very similar to HBase, but it has some nice features that HBase is currently lacking.  Some of these features are:

    • Cell level security
    • No fat row problem - i.e. entire rows don’t need to fit in RAM
    • No limitation on Column Families or when Column Families can be created
    • Server side, data local, programming abstraction called Iterators.  Iterators are incredibly useful for adding functionality to Tablet Servers such as data local filtering, aggregation, and search.  
    • Check out this example application that shows off some of the features mentioned above: THE WIKIPEDIA SEARCH EXAMPLE EXPLAINED, WITH PERFORMANCE NUMBERS.

    Apache Gora

    Gora Logo

    Gora is a object relational/non-relational mapping for arbitrary data stores including both relational (MySQL) and non-relational data stores (HBase, Cassandra, Accumulo, etc).  It was designed for Big Data applications and has support (interfaces) for Apache Pig, Apache Hive, Cascading, and generic Map/Reduce.

    Apache Nutch

    Nutch Logo

    Nutch is a highly scalable web crawler built over Hadoop Map/Reduce.  It was designed from the ground up to be an Internet scale web crawler.  This is a great overview of Nutch’s architecture: Nutch as a Web Data Mining Platform

    Accumulo + Nutch + Gora

    I generally prefer git over svn, in this post I use the source code hosted on github.

    1. Obtain all sources (and Accumulo patch for GORA)

    git clone git://github.com/apache/nutch.git
    git clone git://github.com/apache/gora.git
    git clone git://github.com/apache/accumulo.git
    wget https://issues.apache.org/jira/secure/attachment/12507986/GORA-65-1.patch

    2. Configure and Build Each Project:

    Standard build and maven install for accumulo

    cd accumulo
    mvn package install

    Patching GORA for Accumulo Support

    Gora needs to be patched for support for Accumulo.  This patch should be considered beta, but I found it works good enough for experimenting with Nutch/GORA.  Note: -DskipTests is used because some of the tests seemed to hang indefinitely, so I skipped them for now.

    cd ../gora
    patch -p0 < ../GORA-65-1.patch
    mvn package install -DskipTests

    Building Nutch/GORA

    So, getting Nutch/GORA to build was a bit of a challenge.  I will outline some of the hoops I had to jump through.  File paths mentioned below are assuming you are in the nutch project directory.

    Run the following commands to checkout the nutchgora branch of Nutch.

       cd ../nutch
       git checkout origin/nutchgora
    • Modify the ivy/ivy.xml file. Change gora-core and gora-sql dependencies rev from "0.1.1-incubating" to "0.2-SNAPSHOT".  This is to match the patched version we just installed. Also, add the following lines:
    • Modify the ivy/ivysettings.xml file.  Add the following line to the top of the <resolvers> section. This will configure ant/ivy to use your local maven repository when resolving dependencies.  This is necessary because the patched version of GORA and the latest Accumulo version are not in any public maven repos.

      <ibiblio name="local" root="file://${user.home}/.m2/repository/"
      pattern="${maven2.pattern.ext}"  m2compatible="true"  />


    3. Deploy and Run

    Configure Accumulo and its Dependencies

    For this post I am only going to cover the basics for getting these systems to run on a single machine. Deploying and running over a cluster may be covered in another post.

    Configure and Start Hadoop

    cd ..
    wget ftp://apache.cs.utah.edu/apache.org//hadoop/common/hadoop-0.20.2/hadoop-0.20.2.tar.gz
    tar zxvf hadoop-0.20.2.tar.gz

    Add the following to hadoop-0.20.2/conf/core-site.xml


    Add the following to hadoop-0.20.2/conf/mapred-site.xml


    Set the JAVA_HOME variable in hadoop-0.20.2/conf/hadoop-env.sh. Here is an example from my system: export JAVA_HOME=/usr/lib/jvm/java-6-sun-

    At this point, you should have a bare bones configured hadoop installation. It is time to start it…

    Run the following commands:

    mkdir -p ~/tmp/hadoop
    cd hadoop-0.20.2
    ./bin/hadoop namenode -format

    If you configured everything properly, you should be able to open in a web browser and see a page that looks like this. If there is a message saying that the Namenode is in safe mode, wait a minute or two and refresh the page. It should go away.

    You should also be able to open in a web browser and see a page that looks like this:

    In both of these status webpages you should be able to see a 1 listed after "Live Nodes" and "Nodes" respectively.

    Configure and Start Zookeeper

    cd ..
    wget ftp://apache.cs.utah.edu/apache.org/zookeeper/zookeeper-3.4.3/zookeeper-3.4.3.tar.gz
    tar zxvf zookeeper-3.4.3.tar.gz

    Add the following to zookeeper-3.4.3/conf/zoo.cfg. Create this file if it does not exist. NOTE: replace _USERNAME_ with your username.

    # The number of milliseconds of each tick
    # The number of ticks that the initial
    # synchronization phase can take
    # The number of ticks that can pass between
    # sending a request and getting an acknowledgement
    # the directory where the snapshot is stored.
    # the port at which the clients will connect

    Edit bin/zkEnv.sh. Right after the following lines.


    Add this line:


    cd zookeeper-3.4.3
    export ZOO_LOG_DIR=$HOME/blogpost/zookeeper-3.4.3/logs
    mkdir $ZOO_LOG_DIR
    mkdir ~/tmp/zookeeper-data

    At this point, you should have a configured zookeeper installation, it’s time to start it…

    ./bin/zkServer.sh start

    If you configured zookeeper and it successfully started you should be able to run the following command:

    ./bin/zkCli.sh -server

    It will output a bunch of logging messages, this is fine. Press <ENTER>, and then you should be dropped into a shell this a prompt that looks like the following:

    [zk: 0]

    Type ls / and then <ENTER>. You should see a single line of output (followed again by a prompt) that looks like the following:


    If so, then zookeeper is configured and running properly. When you first run the zkCli.sh command, if you see stack traces that look like this:

    java.net.ConnectException: Connection refused
        at sun.nio.ch.SocketChannelImpl.checkConnect(Native Method)
        at sun.nio.ch.SocketChannelImpl.finishConnect(SocketChannelImpl.java:701)
        at org.apache.zookeeper.ClientCnxnSocketNIO.doTransport(ClientCnxnSocketNIO.java:286)
        at org.apache.zookeeper.ClientCnxn$SendThread.run(ClientCnxn.java:1035)

    Then it means zookeeper failed to start for some reason, isn’t listening on, or you may have a local firewall blocking access to that port.

    Configure and Start Accumulo

    cd ../accumulo
    mvn package -P assemble
    cp src/assemble/target/accumulo-1.5.0-incubating-SNAPSHOT-dist.tar.gz ../
    cd ../
    tar zxf accumulo-1.5.0-incubating-SNAPSHOT-dist.tar.gz
    cd accumulo-1.5.0-incubating-SNAPSHOT/conf
    rename s/.example// *.example
    # basically disabling the custom security policy file for now
    # since I had issues getting accumulo to work with it enabled
    mv accumulo.policy accumulo.policy.example

    Edit accumulo-env.sh. At the top of the file, define HADOOP_HOME, ZOOKEEPER_HOME, and JAVA_HOME. Here is an example:

    export HADOOP_HOME=$HOME/hadoop-0.20.2
    export ZOOKEEPER_HOME=$HOME/zookeeper-3.4.3
    export JAVA_HOME=/usr/lib/jvm/java-6-sun-

    Edit accumulo-site.xml.

    Set the logger.dir.walog property.


    Set the instance.secret property.


    Run the following commands:

    mkdir $HOME/tmp/walogs
    cd ../

    At this point you should have a fully configured Accumulo installation. It is time to initialize it and start it…

    ./bin/accumulo init

    You should see similar output to this. I set my instance name to "inst" and my password to "secret". You may want to do the same for the sake of this tutorial or make sure to set the correct config parameters later.

    23 08:15:26,635 [util.Initialize] INFO : Hadoop Filesystem is hdfs://
    23 08:15:26,637 [util.Initialize] INFO : Accumulo data dir is /accumulo
    23 08:15:26,637 [util.Initialize] INFO : Zookeeper server is localhost:2181
    Warning!!! Your instance secret is still set to the default, this is not secure. 
    We highly recommend you change it.
    You can change the instance secret in accumulo by using: bin/accumulo 
    org.apache.accumulo.server.util.ChangeSecret oldPassword newPassword. 
    You will also need to edit your secret in your configuration file by adding the property 
    instance.secret to your conf/accumulo-site.xml. Without this accumulo will not operate correctly
    Instance name : inst
    Enter initial password for root: ******
    Confirm initial password for root: *****
    23 08:15:34,100 [util.NativeCodeLoader] INFO : Loaded the native-hadoop library
    23 08:15:34,337 [security.ZKAuthenticator] INFO : Initialized root user with 
    username: root at the request of user !SYSTEM

    Note: If it appears to hang after you entered the instance name, zookeeper may not be running. <CTRL>-C the accumulo init and make sure zookeeper is running.

    Now run:


    After this finishes, you should be able to open in a web browser and see a page very similar to this:

    The important items to note on this page are the is a 1 after the Tablet Servers, Live Data Nodes, and Trackers in the “Accumulo Master”, “NameNode”, and “JobTracker” tables, respectively. There should also be entry in the “Zookeeper” table.

    4. Crawl

    At this point, you should have a fully functional Hadoop, Zookeeper, and Accumulo install, so we are ready to run a Nutch web crawl. Create a file with URLs, one per line, call it seeds.txt and place it in your home directory. I added the following URLs to my seeds file:


    Run the following commands:

     cd ../nutch/
     ./runtime/local/bin/nutch crawl file://$HOME/seeds.txt -depth 1

    You should see some log messages printed to the console, but hopefully no stack traces. If you see a stack trace, you may need to go back and check your configs to make sure they match the ones we created earlier.

    After the crawler finishes, you should be able to explore it using the accumulo shell.

     cd ../accumulo-1.5.0-incubating-SNAPSHOT/bin/
     ./accumulo shell -u root -p secret

    Further details and exploration of this data in Accumulo will have to wait for another blog post.

    I ended up posting all the modified code from Gora (accumulo patch) and Nutchgora (patches for getting gora-accumulo working) to my github. Check it out.


    Gora+accumulo patch

    Let me know if you have any questions…


    Update (3/2): someone told me that they had problems getting nutch to build and that this patch worked for them (even though the patch is for GORA). I would be curious if anyone else has this same issue. Here is the error they encountered when building with ant:

    [ivy:resolve] :: problems summary ::
    [ivy:resolve] :::: WARNINGS
    [ivy:resolve]           ::::::::::::::::::::::::::::::::::::::::::::::
    [ivy:resolve]           ::          UNRESOLVED DEPENDENCIES         ::
    [ivy:resolve]           ::::::::::::::::::::::::::::::::::::::::::::::
    [ivy:resolve]           :: log4j#log4j;1.2.15: configuration not found in log4j#log4j;1.2.15: 'master'.

    2 years ago  /  2 notes

    1. covert-io posted this