The following procedures describe how to install Oracle NoSQL Database:

  1. Pick a directory where the Oracle NoSQL Database package files (libraries, Javadoc, scripts, and so forth) should reside. It is easiest if that directory has the same path on all nodes in the installation. You should use different directories for the Oracle NoSQL Database package files (referred to as KVHOME in this document) and the Oracle NoSQL Database data (referred to as KVROOT). Both the KVHOME and KVROOT directories should be local to the node (that is, not on a Network File System).


    To make future software upgrades easier, adopt a convention for KVHOME that includes the release number. Always use a KVHOME location such as /var/kv/kv-M.N.O, where M.N.O are the release.major.minor numbers. This can be easily achieved by simply unzip/untaring the distribution into a common directory (/var/kv in this example).

  2. Extract the contents of the Oracle NoSQL Database package ( or kv-M.N.O.tar.gz) to create the KVHOME directory (i.e. KVHOME is the kv-M.N.O/ directory created by extracting the package). If KVHOME resides on a network shared directory (not recommended) then you only need to unpack it on one machine. If KVHOME is local to each machine, then you should unpack the package on each node.

  3. Verify the installation by issuing the following command on one of the nodes:

    java -Xmx256m -Xms256m -jar KVHOME/lib/kvclient.jar

    You should see some output that looks like this:

    11gR2.M.N.O (....)

    where M.N.O is the package version number.


    Oracle NoSQL Database is a distributed system and the runtime needs to be installed on every node in the cluster. While the entire contents of the Oracle NoSQL Database package do not need to be installed on every node, the contents of the lib and doc directories must be present. How this distribution is done is beyond the scope of this manual.