Key-Value
Key-Value Storage is a global server configuration property that defines how Iotellect Server stores its data in the NoSQL database. Its fields are mapped to the server configuration file.
Cluster Role
Key name in the configuration file: databaseKvClusterRole
Value type: Integer
Possible values: 0 for None, 1 for Master and 2 for Failover
Default value: 0
Defines role of this KV node in the DB failover cluster.
 | This setting can affect the operation of Iotellect Server. The role of the key-value database cluster should be equal to the role of the Iotellect Server cluster, except for the case of the Active / Active cluster configuration. Also switching the database to cluster mode involves switching to transaction mode, which affects performance. Reverse switching does not return the database to non-transactional mode. Database IP address is taken from server IP address parameter. |
| To reset a replication group to a single member when the replicated environment is opened set Cluster Role to None. |
Primary Database Port
Key name in the configuration file: databaseKvClusterPrimaryDbPort
Value type: Integer
Possible values: The port must be outside the range of "Well Known Ports" (zero through 1023).
Default value: 5001
Port associated with this node. User for communication between failover cluster nodes. Database IP address is taken from server IP address parameter.
Key-Value Cluster Databases
Key name in the configuration file: databaseKvClusterHelperUrl
Value type: String
Possible values: hostname[:port][,hostname[:port]]*
Default value:
Identifies other key-value databases in a failover cluster by their host:port pairs. Port number must match Primary Database Port defined on other nodes.
| Attention! If there are several network cards on other nodes, make sure that the indicated IP addresses are the same as selected by other DB nodes. |
Database Priority in a Cluster
Key name in the configuration file: databaseKvClusterPriority
Value type: Integer
Possible values: 0 or more
Default value: 100
Priority to be associated with this failover cluster node. Nodes with higher priority will be elected cluster master earlier than nodes with lower priority. Zero priority means a node will never become the master.
Memory Size
Key name in the configuration file: databaseKvCacheSize
Value type: Integer
Possible values: 0 or more
Default value: 100 Mb
Configures the memory available to the database system, in bytes.
Minimum File Utilization Percent
Key name in the configuration file: confDatabaseKvMinUtilization
Value type: Integer
Possible values: 0 to 50
Default value: 30
Identifies the percentage of the database log file space that must be used for utilized records. If the percentage of log file space used by utilized records is too low, then the database cleaner process removes obsolete records until this threshold is reached.
Cleaner Thread Number
Key name in the configuration file: databaseKvCleanerThreads
Value type: Integer
Possible values: 1 to Integer.MAX_VALUE
Default value: 5
The number of threads allocated by the cleaner for log file processing. If the cleaner backlog becomes large, try increasing this value.
Cleaner Activator
Key name in the configuration file: databaseKvCleanerActivator
Value type: String
Possible values: databaseKvCleanerByteThreshold or databaseKvCleanerWakeupInterval
Default value: databaseKvCleanerWakeupInterval
Defines whether cleaning starts upon disk utilization threshold violation or periodically.
Cleaner Activation Threshold
Key name in the configuration file: databaseKvCleanerByteThreshold
Value type: Integer
Possible values: 1 to Integer.MAX_VALUE
Default value: 40 Mb
The cleaner checks disk utilization every time we write this many bytes to the log.
Cleaner Activation Interval
Key name in the configuration file: databaseKvCleanerWakeupInterval
Value type: Long
Possible values: 0 to Long.MAX_VALUE
Default value: 0
The cleaner checks whether cleaning is needed if this interval elapses without any writing.
Transactions Commit Interval
Key name in the configuration file: databaseKvTransactionsCommitInterval
Value type: Integer
Possible values: 0 to Integer.MAX_VALUE
Default value: 0
The time interval in during which transactions may be grouped to amortize the cost of write.
Transactions Commit Threshold
Key name in the configuration file: databaseKvTransactionsCommitThreshold
Value type: Integer
Possible values: 0 to Integer.MAX_VALUE
Default value: 0
The threshold value defines the number of transactions that may be grouped to optimize write operations. Only for transactional mode.
Maximum Replication Message Size
Key name in the configuration file: confDatabaseKvMaxReplicationMessageSize
Value type: Long
Possible values: 262144 to Long.MAX_VALUE
Default value: 1048576
The maximum message size (in bytes) which will be accepted by this failover cluster node. Used to prevent DOS attacks.
Checkpointer Activator
Key name in the configuration file: databaseKvCheckpointerActivator
Value type: String
Possible values: databaseKvCheckpointerWakeupInterval or databaseKvCheckpointerWriteInterval
Default value: databaseKvCheckpointerWakeupInterval
Checkpointer activation mode.
Checkpointer Activation Interval
Key name in the configuration file: databaseKvCheckpointerWakeupInterval
Value type: Long
Possible values: 0 to Long.MAX_VALUE
Default value: 3000
The checkpointer wakeup interval in microseconds, i.e. time interval between two adjacent writes.
Checkpointer Activation Threshold
Key name in the configuration file: databaseKvCheckpointerWriteInterval
Value type: Long
Possible values: 1 to Integer.MAX_VALUE
Default value: 20000000
Amount of non-written data that activates the checkpointer.
Max Disk Usage Limit
Key name in the configuration file: databaseKvMaxDisk
Value type: Long
Possible values: 0 to Long.MAX_VALUE
Default value: 2147483648
An upper limit on the number of bytes used for data storage. If the limit is exceeded, write operations will be prohibited. If set to zero, no usage limit is enforced.
Free Disk Limit
Key name in the configuration file: databaseKvFreeDisk
Value type: Long
Possible values: 0 to Long.MAX_VALUE
Default value: 100000000
A lower limit on the number of bytes of free space to maintain on a volume. If the limit is exceeded, write operations will be prohibited. If Free Disk is set to zero, no free space limit is enforced. This is not recommended.
Was this page helpful?