Library Version 12.1.3.0

Utility commands
Prev | Appendix A. KVStore Command Reference | Next

## Utility commands

You can access utility commands through `"java -jar"`.

    java -Xmx256m -Xms256m \
    -jar KVHOME/lib/kvstore.jar <command>

This appendix contains the following information on the commands:

### makebootconfig

    java -Xmx256m -Xms256m \
    -jar KVHOME/lib/kvstore.jar makebootconfig [-verbose]
    -root <rootDirectory> -host <hostname> -hahostname <hostname>
    -harange <startPort,endPort> -port <port> [-admin <adminPort>]
    -store-security [none | configure | enable]
    [-config <configFile>][-storagedir <path>] [-capacity <n_rep_nodes>]
    [-num_cpus <ncpus>][-memory_mb <memory_mb>]
    [-servicerange <startPort,endPort>]
    [-mgmt {snmp|jmx|none}] [-pollport <snmp poll port>]
    [-traphost <snmp trap/notification hostname>]
    [-trapport <snmp trap/notification port>]

where:

- `-admin <adminPort>` The port on which the web-based Admin Console is contacted. It only needs to be free on the node which runs the admin process. The value defaults to "0", which means that there will be no admin on this node.

- `-capacity <n_rep_nodes>` The total number of Replication Nodes a Storage Node can support. The value defaults to "1".

- `-config <configFile>` Only specified if more than one Storage Node Agent process will share the same root directory. This value defaults to "config.xml".

- `-hahostname <hostname>` Can be used to specify a separate network interface for store replication traffic. This defaults to the hostname specified using the -host flag.

- `-harange <startPort,endPort>` A range of free ports which the Replication Nodes use to communicate among themselves. These ports should be sequential and there must be at least as many as the specified capacity for this node.

- `-store-security [none | configure | enable]` Specifies if security will be used or not. If `-store-security none` is specified, no security will be used. If `-store-security configure` is specified, security will be used and the security configuration utility will be invoked as part of the makebootconfig process. If `-store-security enable` is specified, security will be used. You will need to configure security either by utilizing the security configuration utility or by copying a previously created configuration from another system.

- `-host <hostname>` Identifies a host name associated with the node on which the command is run. This hostname identifies the network interface used for communication with this node.

- `-memory_mb <memory_mb>` The total number of megabytes of memory that is available in the machine. If the value is 0, the store will attempt to determine the amount of memory on the machine, but the value is only available when the JVM used is the Oracle Hotspot JVM. The default value is "0".

- `-num_cpus <ncpus>` The total number of processors on the machine available to the Replication Nodes. If the value is 0, the system will attempt to query the Storage Node to determine the number of processors on the machine. This value defaults to "0".

- `-port <port>` The TCP/IP port on which Oracle NoSQL Database should be contacted. Sometimes referred to as the registry port. This port must be free on the node on which this command is run.

- `-root <rootDirectory>` Identifies where the root directory should reside.

- `-servicerange <startPort,endPort>` A range of ports that may be used for communication among administrative services running on a Storage Node and its managed services. This parameter is optional and is useful when services on a Storage Node must use specific ports for firewall or other security reasons. By default the services use anonymous ports. The format of the value string is "startPort,endPort." The value varies with the capacity of the Storage Node.

- `-storagedir <path>` Specify a path to the directory to be used for a Replication Node. This flag may be used more than once in the command to specify multiple storage directories, but the number should not exceed the capacity for the node. If no storage directory is specified, Replication Nodes use a directory under the root directory.

  The use of the -storagedir argument must be coordinated with the use of the capacity argument. For example, if your Storage Node hosts four disks, you would specify a capacity of four and have four -storagedir arguments.

Creates a configuration file used to start a not-yet-deployed Storage Node to be used in an instance of Oracle NoSQL Database. The file must not already exist. You only need to specify the admin option(the Admin Console port) on the node which hosts the initial Oracle NoSQL Database administration processes. To create the initial "boot config" file used to configure the installation see Installation Configuration.

OracleNoSQL Database allows Java Management Extensions (JMX) or Simple Network Management Protocol (SNMP) agents to be optionally available for monitoring, in addition to the native monitoring provided by the Admin CLI and the Admin Console. In order to enable JMX or SNMP in the storage node's boot configuration file, you can use the -mgmt, -pollport, -traphost and -trapport options. See Standardized Monitoring Interfaces for more information.

### start

    java -Xmx256m -Xms256m \
    -jar KVHOME/lib/kvstore.jar start [-verbose]
    -root <rootDirectory> [-config <bootstrapFileName>]

Starts the Oracle NoSQL Database Storage Node Agent (and if configured, store) in the root directory.

### stop

    java -Xmx256m -Xms256m \
    -jar KVHOME/lib/kvstore.jar stop [-verbose]
    -root <rootDirectory> [-config <bootstrapFileName>]

Stops the Oracle NoSQL Database Storage Node Agent and services related to the root directory.

### restart

    java -Xmx256m -Xms256m \
    -jar KVHOME/lib/kvstore.jar restart [-verbose]
    -root <rootDirectory> [-config <bootstrapFileName>]

Stops and then starts the Oracle NoSQL Database Storage Node Agent and services related to the root directory.

### runadmin

    java -Xmx256m -Xms256m \
    -jar KVHOME/lib/kvstore.jar runadmin [-verbose]
    -host <hostname> -port <port> [single command and arguments]

Runs a utility which provides a command line interface (CLI). It is used to perform store configuration.

### load

    java -Xmx256m -Xms256m \
    -jar KVHOME/lib/kvstore.jar load [-verbose]
    -source <backupDir> -host <hostname> -port <port>
    -store <storeName> [-status <pathToFile>]

where:

- `-host <hostname>` identifies the host name of a node in your store.

- `-port <port>` identifies the registry port in use by the store's node.

- `-source <backupDir>` identifies the on-disk location where the snapshot data is stored.

- `-status <pathToFile>` is an optional parameter that causes the status of the load operation to be saved in the named location on the local machine.

- `-store <storeName>` identifies the name of the store.

Program used to restore a store from a previously created snapshot. By using this tool, you can restore the store to any topology, not just the one that was in use when the snapshot was created. `Load` should be used only to restore to a new, empty store. Do not use this with an existing store because it only writes records if they do not already exist. See Using the Load Program for more information.

### ping

    java -Xmx256m -Xms256m \
    -jar KVHOME/lib/kvstore.jar ping [-verbose]
    -host <hostname> -port <port>

Attempts to contact a store to get status of running services. By using the `ping` command, you can ensure that the Oracle NoSQL Database client library can contact the Oracle NoSQL Database Storage Agent(SNA). You can use the -host option to check an SNA on a remote host.

### version

    java -Xmx256m -Xms256m \
    -jar KVHOME/lib/kvstore.jar version

Prints version.

### generateconfig

    java -Xmx256m -Xms256m \
    -jar KVHOME/lib/kvstore.jar generateconfig [-verbose]
    -host <hostname> -port <port> -sn <StorageNodeId> -target <zipfile>

Generates configuration files for the specified storage node. The generateconfig command creates the target zipfile which contains the required configuration to re-create the storage node. The top-level directory in the zipfile is the store's root directory.

### help

    java -Xmx256m -Xms256m \
    -jar KVHOME/lib/kvstore.jar help <commandName>

Prints usage info. With no arguments the top-level shell commands are listed. With a command name, additional detail is provided.

Prev | Up | Next
Appendix A. KVStore Command Reference | Home | Appendix B. Initial Capacity Planning