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 -Xmx256m -Xms256m \
    -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
    Storage Node [sn1] on node01:5000 
    Zone: [name=Boston id=zn1 type=PRIMARY]
    Status: RUNNING Ver: 12cR1.3.0.1 2013-12-18 06:35:02 UTC  
    Build id: 8e70b50c0b0e
           Rep Node [rg1-rn1] Status:RUNNING,MASTER at sequence number:31
    haPort:5011
    Storage Node [sn2] on node02:5000 
    Zone: [name=Boston id=zn1 type=PRIMARY]
    Status: RUNNING Ver: 12cR1.3.0.1 2013-12-18 06:35:02 UTC  
    Build id: 8e70b50c0b0e
           Rep Node [rg1-rn2] Status:RUNNING,REPLICA at sequence number:31
    haPort:5011
    Storage Node [sn3] on node03:5000 
    Zone: [name=Boston id=zn1 type=PRIMARY]
    Status: RUNNING Ver: 12cR1.3.0.1 2013-12-18 06:35:02 UTC  
    Build id: 8e70b50c0b0e
           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 -Xmx256m -Xms256m \
    -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 -Xmx256m -Xms256m \
    -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.