Previous Next JavaScript must be enabled to correctly display this content

## Installation

Before you install Oracle NoSQL Database, decide on the directories to store the various database package files and to store data. Set the following environment variables with the appropriate directory path.

- - `$KVHOME -` This is the directory to store all the Oracle NoSQL Database package files (libraries, Javadoc, scripts, and so forth). It is recommended that you use the same directory path for `$KVHOME` on each of the Storage Nodes in the installation. To make future software upgrades easier, adopt a convention for `$KVHOME` that includes the release number. For example, use a `$KVHOME` location such as `/var/kv/kv-M.N.O`, where `M.N.O` represent the software release.major.minor numbers.
  - `$KVROOT -` This is the directory to store Oracle NoSQL Database data.

It is recommended that both the `$KVHOME` and `$KVROOT` directories are local to the Storage Node, and not on a Network File System.

Note:

Use different directories for `$KVHOME` and `$KVROOT`. An example is shown below.

    export $KVHOME=$HOME/nosql/kv-24.1.11
    export $KVROOT=$KVHOME/kvroot

Steps to install the Oracle NoSQL Database:

1. Download the Oracle NoSQL Database bundle. You can download either Community Edition or Enterprise Edition software.
   - Community Edition: Oracle NoSQL Database Community Edition (CE) software is licensed pursuant to the Apache 2.0 License (Apache 2.0).
   - Enterprise Edition: Oracle NoSQL Database Enterprise Edition (EE) software is licensed pursuant to the Oracle commercial license.
   To understand the difference between editions, see NoSQL Database Option Differences. If you have more than one Storage Node, copy the downloaded software to each of the Storage Nodes.
2. Extract the contents of the Oracle NoSQL Database package (`kv-M.N.O.zip` or `kv-M.N.O.tar.gz`) to `$KVHOME`. If `$KVHOME` resides on a shared network directory (which is not recommended) you need to only unpack it once. If `$KVHOME` is local to each Storage Node, unpack the package on each Storage Node. Unzipping the package installs the Oracle NoSQL Database.

       unzip kv-ee-24.1.11.zip

3. Set the appropriate values for`$KVHOME` ( where you have unzipped the Oracle NoSQL Database package) and `$KVROOT`.
   Example:

       export $KVHOME=$HOME/nosql/kv-24.1.11
       export $KVROOT=$KVHOME/kvroot

4. Verify the software installation using the following command:

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

   You should see output that looks like this:

       24.1.11 2024-04-05 21:25:44 UTC
       Build id: 477e7f102ab4 Edition:Client

   where `24.1.11` is the database version number.

The software installation is complete. You can continue to configure your data store.