Installation
Follow this procedure to install the Oracle NoSQL Database.
-
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
, whereM.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). -
Extract the contents of the Oracle NoSQL Database package (
kv-M.N.O.zip
orkv-M.N.O.tar.gz
) to create the$KVHOME
directory. For example,$KVHOME
is thekv-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. -
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.