Installation

Follow this procedure to install the Oracle NoSQL Database.

  1. Choose a directory where the Oracle NoSQL Database package files (libraries, Javadoc, scripts, and so forth) should reside. It is recommended that you use the same directory path on all Storage Nodes in the installation. 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 Storage Node, and not on a Network File System.

    Note:

    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 represent the software release.major.minor numbers. You can achieve this easily by using unzip or untar on the distribution into a common directory (/var/kv in this example).

  2. Extract the contents of the Oracle NoSQL Database package (kv-M.N.O.zip or kv-M.N.O.tar.gz) to create the $KVHOME directory. For example, $KVHOME is the kv-M.N.O/ directory created by extracting the package). If $KVHOME resides on a shared network directory (which is not recommended) you need only unpack it on one Storage Node. If $KVHOME is local to each Storage Node, unpack the package on each Storage Node.

  3. Verify the installation using the following command on one of the Storage Nodes:

    java -Xmx64m -Xms64m -jar $KVHOME/lib/kvclient.jar

    You should see some output that looks like this:

    23.1.21 2023-04-18 21:25:44 UTC  Build id: 477e7f102ab4 Edition: Client

    where 23.1.21 is the database version number.

    Note:

    Oracle NoSQL Database is a distributed system and the runtime needs to be installed on every Storage Node in the data store. While the entire contents of the Oracle NoSQL Database package do not need to be installed on every Storage Node, the contents of the lib directory must be present.