Smoke Testing the System

There are several things you can do to ensure that your KVStore is up and fully functional.

  1. Run the ping command.

    > java -jar KVHOME/lib/kvstore.jar ping -port 5000 -host node01
    Pinging components of store mystore based upon topology sequence #107
    mystore comprises 300 partitions on 3 Storage Nodes
    Datacenter:Boston [dc1]
    Storage Node [sn1] on node01:5000   Datacenter: Boston [dc1] Status:
    RUNNING Ver: 11gR2.1.0.28
           Rep Node [rg1-rn1] Status:RUNNING,MASTER at sequence number:31
    haPort:5011
    Storage Node [sn2] on node02:5000   Datacenter: Boston [dc1] Status:
    RUNNING Ver: 11gR2.1.0.28
           Rep Node [rg1-rn2] Status:RUNNING,REPLICA at sequence number:31
    haPort:5011
    Storage Node [sn3] on node03:5000   Datacenter: Boston [dc1] Status:
    RUNNING Ver: 11gR2.1.0.28
           Rep Node [rg1-rn3] Status:RUNNING,REPLICA at sequence number:31
    haPort:5011 
  2. Run the simple "hello world" example. Go to the KVHOME directory and compile the example:

    javac -cp lib/kvclient.jar:examples examples/hello/*.java 

    Then run the example (from any directory):

    java -cp KVHOME/lib/kvclient.jar:KVHOME/examples \
         hello.HelloBigDataWorld \
         -host <hostname> -port <hostport> -store <kvstore name> 

    This should write the following line to stdout:

    Hello Big Data World!
  3. Look through the Javadoc. You can access it from the documentation index page, which can be found at KVHOME/doc/index.html.

If you run into installation problems or want to start over with a new store, then on every node in the system:

  1. Stop the node using:

    java -jar KVHOME/lib/kvstore.jar stop -root KVROOT 
  2. Remove the contents of the KVROOT directory:

    rm -rf KVROOT
  3. Start over with the steps described in Installation Configuration.