kvlite

KVLite is a simplified version of the Oracle NoSQL Database. It provides a single storage node, single shard store, that is not replicated. It runs in a single process without requiring any administrative interface.

Below are the command line options that you can use with the kvlite utility.

java -jar KVHOME/lib/kvstore.jar kvlite
[-root <rootDirectory>]  # defaults to: ./kvroot
[-store <storeName>] # defaults to: kvstore
[-host <hostname>] # defaults to: local host name
[-port <port>] # defaults to: 5000
[-storagedirsizegb <GB>] # defaults to: 10
[-noadmin] # defaults to: false
[-secure-config <enable|disable>] # defaults to: enable
[-restore-from-snapshot <name of snapshot>] # defaults to: no restore
[-admin-web-port <admin web service port>] # defaults to: -1

You can specify the parameter values the first time you start KVLite. The parameter values are recorded in a config file and are used when KVLite is restarted. The config file is stored in the root directory. To change your initial values, either delete your root directory before starting KVLite, or specify the -root option with a different root directory than you initially used. Following are the descriptions of the command line options:

• root <path>: Identifies the path to the root directory. The path provided can be an absolute path or a relative path. The database files are stored in this location. If the database files do not exist, they are created for you.

  Default value: ./kvroot

• -store <storename>: Identifies the name of the data store. You should avoid using characters in the data store name that might interfere with its use within a file path. Valid characters are all alphanumeric characters, hyphen, underscore, and period.

  Default value: kvstore

• -host <hostname>: Identifies the name of the host on which KVLite is running. If you want to access this instance of KVLite from remote machines, you must supply the actual hostname of the machine. Otherwise, specify localhost for this option.

  Default value: <host name of the machine>

• -port <port>: Identifies the port on which KVLite is listening for client connections. This is sometimes referred to as the registry port.

  Default value: 5000

• -storagedirsizegb <GB>: Identifies the maximum amount of available disk space in GB for a KVLite database. If the disk usage of the KVLite database exceeds a value that is 5GB less than the specified value, KVLite suspends all write operations until you delete some existing records and free up enough space to satisfy the disk storage requirement. If you set storagedirsizegb to 0, KVLite opportunistically uses all the available space.

  The system maintains 5 GB of free space for recovery purposes in case the configured disk limit is exceeded.

  Default value: 10

• -noadmin: Identifies if the administration service needs to be started. If -noadmin parameter is provided, then the administration service is not started.

  The administration service is the service that runs the various admin CLI commands.

• secure-config: Identifies if security needs to be enabled for the store. If enabled, all clients connecting to the store must present security credentials.

  Default value: enable

• -restore-from-snapshot:

  Identifies the snapshot from which the store can be restored. You can restore a store directly from a snapshot. For example:

  -restore-from-snapshot 240424-104506-mySnapshot

  where, 240424-104506-mySnapshot represents the directory name of the snapshot to restore. This procedure restores the store to the time you created the snapshot. If your store was active after snapshot creation, all modifications made since the snapshot are lost.

  Default value: null

• -admin-web-port <admin web service port>: Identifies the TCP/IP port on which the admin web service is started. If a positive integer value is not specified, then the admin web service does not start up. For more details on the admin web service, see REST API for Administering Oracle NoSQL Database.

  Default value: -1