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
    300 partitions and 3 storage nodes
    Time: 2015-03-04 21:07:44 UTC   Ver: 12.1.3.2.15
    Shard Status: total:1 healthy:1 degraded:0 noQuorum:0 offline:0
    Zone [name=Boston id=zn1 type=PRIMARY]
        RN Status: total:3 online:3 maxDelayMillis:0 maxCatchupTimeSecs:0
    Storage Node [sn1] on node01:5000 
        Zone: [name=Boston id=zn1 type=PRIMARY]  Status: RUNNING
        Ver: 12cR1.3.3.0 2015-03-04 06:35:02 UTC Build id: 8e70b50c0b0e
            Admin [admin1]          Status: RUNNING,MASTER
            Rep Node [rg1-rn1]      Status:RUNNING,MASTER
                sequenceNumber:31 haPort:5011
    Storage Node [sn2] on node02:5000
        Zone: [name=Boston id=zn1 type=PRIMARY]   Status: RUNNING
        Ver: 12cR1.3.2.15 2015-03-04 06:35:02 UTC Build id: 8e70b50c0b0e
            Rep Node [rg1-rn2]      Status:RUNNING,REPLICA
                sequenceNumber:31 haPort:5011 delayMillis:0
                catchupTimeSecs:0
    Storage Node [sn3] on node03:5000
        Zone: [name=Boston id=zn1 type=PRIMARY]   Status: RUNNING
        Ver: 12cR1.3.2.15 2015-03-04 06:35:02 UTC Build id: 8e70b50c0b0e
            Rep Node [rg1-rn3]      Status:RUNNING,REPLICA
                sequenceNumber:31 haPort:5011 delayMillis:0
                catchupTimeSecs:0
    
  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.