Key-Value Database

Key-value database is a Berkeley DB engine that is embedded into Iotellect Server and runs in-process. It's ideally suitable for keeping system and device configuration.

Key-value database usage is currently deprecated in favor of more generic and flexible NoSQL database.

Key-Value Storage Configuration

A separate group of settings in database section of server global configuration allows to configure performance and failover clustering options for key-value storage.

To activate a Key-Value database, change Configuration Storage property to Key-Value Storage. No additional configuration changes are normally required if a single Key-Value database is used without a failover cluster. The cluster consists of Master Node and one or more Failover Nodes.

To use the Key-Value database in a failover cluster scenario:

  • Setup two or more instances of Iotellect Server.

  • Enable Key-Value Storage on both of them.

  • Change Cluster Role configuration setting of the one Key-Value Storage to Master. Change roles of the other Key-Value Storage to Failover.

  • Set Key-Value Cluster Databases on each Failover Key-Value Storage to point to other Key-Value Storages in the cluster.

  • Restart all servers

Key-Value Storage Folder

Key-value database stores its data in the /key_value_data subfolder of Iotellect Server installation folder.

Thus, to copy server configuration from one machine to another it's effectively necessary to copy /key_value_data folder to a target server replacing existing folder.

Was this page helpful?