You start KVLite by using the
kvlite utility, which can be found in
KVHOME/lib/kvstore.jar. If you use this utility without any command line options, then KVLite will run with the following default values:
The store name is
The hostname is the local machine.
The registry port is
The directory where Oracle NoSQL Database data is placed (known as KVROOT) is
The administration process is turned on.
Security is turned on.
This means that any processes that you want to communicate with KVLite can only connect to it on the local host (127.0.0.1) using port 5000. If you want to communicate with KVLite from some machine other than the local machine, then you must start it using non-default values. The command line options are described later in this chapter.
> java -Xmx256m -Xms256m -jar KVHOME/lib/kvstore.jar kvlite
To avoid using too much heap space, you should specify the
-Xms flags for Java when running administrative and utility commands.
When KVLite has started successfully, it writes one of two statements to stdout, depending on whether it created a new store or is opening an existing store (the following assumes security is enabled):
Generated password for user admin: password User login file: ./kvroot/security/user.security Created new kvlite store with args: -root ./kvroot -store <kvstore> -host localhost -port 5000 -secure-config enable
The password is randomly generated.
Opened existing kvlite store with config: -root ./kvroot -store <kvstore name> -host <localhost> -port 5000 -secure-config enable
<kvstore name> is the name of the store and <localhost> is the name of the local host. It takes about 10 - 60 seconds before this message is issued, depending on the speed of your machine.
Note that you will not get the command line prompt back until you stop KVLite.