There are several ways to verify your installation and ensure that KVLite is running. Perform one of these steps to verify your installation:

• Start a new shell and run the following command:

  $ jps -m

  You should see a similar output showing KVLite (and possibly other things as well) running in your machine:

  2674 kvstore.jar kvlite
  3118 Jps -m

• Or, cd into the kv-23.1.21 directory and ping your KVLite instance. The details of the output will vary but you should see a running store.

  $ cd kv-23.1.21
  $ java -Xmx64m -Xms64m -jar lib/kvstore.jar ping -host localhost -port 5000 -security kvroot/security/user.security

  Expected output:

  Pinging components of store kvstore based upon topology sequence #14
  10 partitions and 1 storage nodes
  Time: 2023-05-23 06:15:34 UTC   Version: 23.1.21
  Shard Status: healthy: 1 writable-degraded: 0 read-only: 0 offline: 0 total: 1
  Admin Status: healthy
  Zone [name=KVLite id=zn1 type=PRIMARY allowArbiters=false masterAffinity=false]   RN Status: online: 1 read-only: 0 offline: 0
  Storage Node [sn1] on phoenix126166: 5000    Zone: [name=KVLite id=zn1 type=PRIMARY allowArbiters=false masterAffinity=false]    Status: RUNNING   Ver: 23.1.21 2023-05-19 18:31:46 UTC  Build id: 477e7f102ab4 Edition: Community    isMasterBalanced: true	serviceStartTime: 2023-05-23 06:13:24 UTC
  	Admin [admin1]		Status: RUNNING,MASTER	serviceStartTime: 2023-05-23 06:13:29 UTC	stateChangeTime: 2023-05-23 06:13:29 UTC	availableStorageSize: 2 GB
  	Rep Node [rg1-rn1]	Status: RUNNING,MASTER sequenceNumber: 322 haPort: 5003 availableStorageSize: 9 GB storageType: HD	serviceStartTime: 2023-05-23 06:13:32 UTC	stateChangeTime: 2023-05-23 06:13:32 UTC
  

  If you have started KVLite in an unsecured mode, ping the KVLite instance without using the -security parameter:

  $ cd kv-23.1.21
  $ java -Xmx64m -Xms64m -jar lib/kvstore.jar ping -host localhost -port 5000

• Or, run the kvclient test application using the following commands:

  $ cd kv-23.1.21
  $ java -Xmx64m -Xms64m -jar lib/kvclient.jar

  This should write a similar release output to stdout:

  23.1.21 2023-05-19 18:31:46 UTC  Build id: 477e7f102ab4 Edition: Client

• Or, if you have not already, download the examples package and unpack it so that the examples directory is in KVHOME. In this tutorial, we have already downloaded and extracted the examples package.
  1. Compile the Hello example program:

     $ export KVHOME=<the directory where you have unzipped the CE package> 
     $ javac -cp lib/kvclient.jar:examples examples/hello/HelloBigDataWorld.java
     

  2. Run the example using all default parameters:

     $ cd $KVHOME
     $ java -Xmx64m -Xms64m -Doracle.kv.security=./kvroot/security/user.security \
     	-cp lib/kvclient.jar:examples hello.HelloBigDataWorld \
     	-port 5000 -store kvstore -host localhost

     • Note: In case of an unsecured installation, do not specify the security parameter and run the example:

       $ java -Xmx64m -Xms64m -cp lib/kvclient.jar:examples hello.HelloBigDataWorld \
       	-port 5000 -store kvstore -host localhost

     Or, run it using non-default parameters, if you started KVLite using non-default values:

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

     Expected output:

     Hello Big Data World!