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. See:

    > java -Xmx64m -Xms64m \
    -jar KVHOME/lib/kvstore.jar ping -port 5000 \
    -host node01 -security 
    USER/security/admin.security
    Pinging components of store mystore based upon topology sequence #316
    300 partitions and 3 storage nodes
    Time: 2018-09-28 06:57:10 UTC   Version: 18.3.2
    Shard Status: healthy:3 writable-degraded:0 read-only:0 offline:0
    Admin Status: healthy
    Zone [name=Boston id=zn1 type=PRIMARY allowArbiters=false masterAffinity=false]
    RN Status: online:9 offline:0 maxDelayMillis:1 maxCatchupTimeSecs:0
    Storage Node [sn1] on node01:5000
       Zone [name=Boston id=zn1 type=PRIMARY allowArbiters=false masterAffinity=false]
       RN Status: online:1 offline:0
       Status: RUNNING
       Ver: 18.3.2 2018-09-17 09:33:45 UTC  Build id: a72484b8b33c
          Admin [admin1]          Status: RUNNING,MASTER
          Rep Node [rg1-rn1]      Status: RUNNING,REPLICA
            sequenceNumber:231 haPort:5011 available storage size:14 GB delayMillis:1 catchupTimeSecs:0
          Rep Node [rg2-rn1]      Status: RUNNING,REPLICA
            sequenceNumber:231 haPort:5012 available storage size:12 GB delayMillis:1 catchupTimeSecs:0
          Rep Node [rg3-rn1]      Status: RUNNING,MASTER
            sequenceNumber:227 haPort:5013 available storage size:11 GB
    Storage Node [sn2] on node02:6000
       Zone: [name=Boston id=zn1 type=PRIMARY allowArbiters=false masterAffinity=false]
       Status: RUNNING
       Ver: 18.3.2 2018-09-17 09:33:45 UTC  Build id: a72484b8b33c
          Rep Node [rg1-rn2]      Status: RUNNING,MASTER
            sequenceNumber:231 haPort:6010 available storage size:13 GB
          Rep Node [rg2-rn2]      Status: RUNNING,REPLICA
            sequenceNumber:231 haPort:6011 available storage size:18 GB delayMillis:1 catchupTimeSecs:0
          Rep Node [rg3-rn2]      Status: RUNNING,REPLICA
            sequenceNumber:227 haPort:6012 available storage size:16 GB delayMillis:1 catchupTimeSecs:0
    Storage Node [sn3] on node03:7000
       Zone: [name=Boston id=zn1 type=PRIMARY allowArbiters=false masterAffinity=false]
       Status: RUNNING
       Ver: 18.3.2 2018-09-17 09:33:45 UTC  Build id: a72484b8b33c
          Rep Node [rg1-rn3]      Status: RUNNING,REPLICA
            sequenceNumber:231 haPort:7010 available storage size:12 GB delayMillis:1 catchupTimeSecs:0
          Rep Node [rg2-rn3]      Status: RUNNING,MASTER
            sequenceNumber:231 haPort:7011 available storage size:12 GB
          Rep Node [rg3-rn3]      Status: RUNNING,REPLICA
            sequenceNumber:227 haPort:7012 available storage size:11 GB delayMillis:1 catchupTimeSecs:0
    
  2. 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 -Xmx64m -Xms64m \
    -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 Parameters.